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 manual setup instructions work with the current CLI and remain valid when per-client defaults ship.

---

Note

Low Risk
Documentation-only changes to MCP client setup guides with no runtime or security logic changes.

Overview
Updates MCP client setup docs so manual and CLI-assisted installs show the full mcp-remote OAuth pattern: per-client callback ports (e.g. 46093–46097), --static-oauth-client-metadata so consent shows the real client name instead of MCP CLI Proxy, and a dedicated MCP_REMOTE_CONFIG_DIR so multiple tools can authorize in parallel without sharing tokens.

Antigravity, Windsurf, and Zed JSON examples gain port, metadata, and env blocks plus post-install checks against CLI output. Goose updates Desktop/CLI commands, the goose:// install link, and CLI YAML guidance. Claude adds a Configure Claude Desktop with mcp-remote section for users who installed via kernel mcp install --target claude.

Each page documents cache migration: close the app, delete the old mcp-remote-v1 cache (default or under a custom dir), and reauthorize—noting that clearing a shared cache signs out other clients using it.

^{Reviewed by Cursor Bugbot for commit 0704e44. 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 24, 2026, 8:13 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}

[masnwilliams]

Reviewed the client-specific OAuth examples and migration guidance. No blocking quality findings. Please merge the matching CLI change before publishing these instructions. Non-blocking follow-up: narrow the existing troubleshooting instruction that clears ~/.mcp-auth, since it also removes the new per-client caches.

[cursor]

Risk assessment: Very Low

Re-checked this pull request after docs(mcp): clarify manual OAuth setup before CLI defaults (0704e44). 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 new commit only rewords those pages: it tells readers to compare a CLI-installed entry with the manual example, and it drops claims that the latest CLI automatically assigns a per-client auth cache.

• No application code, docs-site config, infrastructure, or authentication implementation changed.
• Blast radius is the published client setup guides.
• The diff is small (+47 / −12) and limited to those pages.
• No CODEOWNERS file applies to these paths, so code owner review is not required.

Existing approval stands. Not approving again.

  

_{Sent by Cursor Automation: Assign PR reviewers}