docs: document remote MCP OAuth on hosts without a local browser

[atharvadeosthale]

Summary

• Document that hosted MCP OAuth uses a localhost callback, which stays on the remote loopback when the client runs over SSH, on a droplet, or on any host without a local browser.
• Walk through Claude Code's --no-browser login as the worked example: open the printed auth URL locally, then paste the http://localhost:.../callback URL back into the remote prompt.
• Mirror the same Claude Code steps on the Claude Code install page, with a link to the remote MCP section.

Test plan

• Open /docs/tooling/ai/mcp-servers/api#remote and confirm the first paragraph is client-agnostic, then the Claude Code command and callback steps.
• Open /docs/tooling/ai/agents/claude-code and confirm --no-browser login plus the link to the remote section.
• Confirm the #remote anchor from the connection-details paragraph lands on the new section.

Made with Cursor

[appwrite]

Appwrite Website

Project ID: 69d7efb00023389e8d27

Sites (1)

Site	Status	Logs	Preview	QR
website 69d7f2670014e24571ca	Ready	View Logs	Preview URL

Website (appwrite/website)

Project ID: 684969cb000a2f6c0a02

Sites (1)

Site	Status	Logs	Preview	QR
website 68496a17000f03d62013	Queued	View Logs	Preview URL

---

Tip

Roll back Sites deployments instantly by switching between versions

[greptile-apps]

Greptile Summary

The PR documents remote-host OAuth for the hosted MCP server, using Claude Code’s no-browser flow as the worked example.

• Adds a remote-machine authentication section explaining the localhost callback and callback-URL handoff.
• Adds matching Claude Code setup instructions and links them to the shared remote-auth section.

Confidence Score: 5/5

The documentation-only PR appears safe to merge with no concrete actionable defects identified.

The new sections consistently describe the intended remote OAuth workflow, preserve the hosted-versus-self-hosted boundary, and use a valid cross-page anchor.

Important Files Changed

Filename	Overview
src/routes/docs/tooling/ai/agents/claude-code/+page.markdoc	Adds Claude Code remote-host login and callback-paste instructions, with a valid link to the shared remote-auth section.
src/routes/docs/tooling/ai/mcp-servers/api/+page.markdoc	Explains the hosted MCP OAuth localhost callback and adds a correctly anchored Claude Code remote-login example.

_{Reviews (1): Last reviewed commit: "docs: document remote MCP OAuth on hosts..." | Re-trigger Greptile}