Document named MCP OAuth clients and cache migration

[Sayan-]

Summary

• Show client-specific OAuth metadata, separate auth caches, and distinct callback ports in manual MCP setup examples.
• Update the Goose install link with its callback port and cache setting, and document reauthorization for earlier mcp-remote registrations.
• Explain how to clear an old shared or custom cache and the effect on other clients using it.

Validation

• Parsed the JSON examples, Goose commands, install link, and CLI-printed YAML to verify matching client names and callback ports. Verified separate caches and callback listeners for all five generated stdio configs using mcp-remote 0.14.3.
• Loaded all five edited client pages in the Mintlify preview; each returned HTTP 200.

The CLI change should ship before these instructions are published.

---

Note

Low Risk
Documentation-only changes to MCP setup guides; no runtime or auth code in this diff.

Overview
Updates MCP client docs so manual mcp-remote setups use per-client OAuth: a dedicated callback port (46093–46097), --static-oauth-client-metadata with the real client name (instead of MCP CLI Proxy), and MCP_REMOTE_CONFIG_DIR for an isolated auth cache so multiple clients can authorize at once.

Antigravity, Windsurf, and Zed JSON examples gain those args/env; Goose gets the same on Desktop/CLI commands and in the install deep link (renamed from one-click). Claude adds guidance for existing kernel mcp install --target claude users to rerun the CLI and reauthorize.

New prose explains cache migration (delete mcp-remote-v1 under default or custom cache paths) and that clearing a shared cache signs out other clients using it. The Zed sample drops the "source": "custom" field from the snippet.

^{Reviewed by Cursor Bugbot for commit b9013a6. Bugbot is set up for automated code reviews on this repo. Configure here.}

[mintlify]

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

Project	Status	Preview	Updated
Kernel	🟢 Ready	View Preview	Sep 23, 2026, 9:37 PM

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

[cursor]

Risk assessment: Very Low

This pull request changes five Mintlify reference pages under reference/mcp-server/clients/ (Antigravity, Claude, Goose, Windsurf, and Zed). The diff is documentation only: setup copy, example mcp-remote arguments (--static-oauth-client-metadata), and example MCP_REMOTE_CONFIG_DIR cache paths.

• No application code, docs-site config, infrastructure, or authentication implementation changed.
• Blast radius is the published client setup guides.
• The diff is small (+33 / −11) and limited to those pages.

Approving because this is a documentation-only change with no production logic or shared-system impact. Code owner review is not required on main.

  

_{Sent by Cursor Automation: Assign PR reviewers}

[cursor]

Risk assessment: Very Low

Re-checked this pull request after the latest commit (Document separate MCP OAuth callback ports). Risk is unchanged from the earlier approval.

The full diff is still five Mintlify reference pages under reference/mcp-server/clients/ (Antigravity, Claude, Goose, Windsurf, and Zed). The update only adds example OAuth callback ports (46093–46097) and matching setup copy to those pages.

• No application code, docs-site config, infrastructure, or authentication implementation changed.
• Blast radius is the published client setup guides.
• The diff is small (+40 / −11) and limited to those pages.

Existing approval stands. No code owner file applies to these paths, so code owner review is not required.

  

_{Sent by Cursor Automation: Assign PR reviewers}