Skip to content

fix(mcp-gateway): correct quickstart docs - remove Test Connection button, update MCP URL to /m/ pattern - #1178

Open
sambharia wants to merge 1 commit into
mainfrom
fix/mcp-gateway-quickstart-docs
Open

sambharia wants to merge 1 commit into
mainfrom
fix/mcp-gateway-quickstart-docs

Conversation

@sambharia

@sambharia sambharia commented Nov 17, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Fixes two documentation bugs in the MCP Gateway Quickstart page.

Changes

Fix 1 — Remove non-existent "Test Connection" button (Step 1.3)

  • Before: Click **Test Connection**, then **Add Server**.
  • After: Click **Add Server** to save the integration.
  • There is no "Test Connection" button in the current UI.

Fix 2 — Update MCP server URL to unified /m/ pattern (Step 2 & Step 3)

  • Before: https://mcp.portkey.ai/deepwiki-test-mcp-server/mcp
  • After: https://aigw.portkey.ai/m/deepwiki-test-mcp-server/mcp
  • Updated in 3 places: the example URL block, the OAuth tab JSON, and the API Key tab JSON.
  • The unified GW mode uses /m/ as the standard pattern going forward.

Fix 3 — Authorization: Bearer (no change needed)

  • The doc already correctly uses x-portkey-api-key in headers. The product bug (Bearer token not working) should be tracked separately with engineering.

Copilot AI balanced review requested due to automatic review settings November 17, 2026 12:50
@mintlify

mintlify Bot commented Nov 17, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
portkey-docs 🟢 Ready View Preview Nov 17, 2026, 12:53 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

…tton, update MCP URL to /m/ pattern

- Remove non-existent 'Test Connection' button from Step 1.3; just 'Add Server'
- Update MCP server URL format from mcp.portkey.ai to aigw.portkey.ai/m/ (unified pattern)
- Update all 3 URL occurrences: example block, OAuth tab, and API Key tab

Co-authored-by: Cursor <cursoragent@cursor.com>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

No active review issues were identified for the quickstart’s UI and gateway URL updates.

No open issues 🎉

What changed in this PR

Updates the MCP Gateway quickstart to match the current UI and unified gateway URL format.

Changes:

  • Removes the instruction to click the nonexistent Test Connection button.
  • Updates the example URL and both authentication configurations to use https://aigw.portkey.ai/m/.
File Description
product/​mcp-gateway/​quickstart.mdx Corrects the save step and updates all three MCP URL examples.

Review effort: Balanced

This branch was successfully deployed

1 active deployment
staging — 6d1c2f96 Deployed Nov 17, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants