Document the local MCP server for every agent - #331
Merged
Conversation
Adds docs/mcp-server.md: how to point each agent at the local MCP endpoint (Claude Code, Claude Cowork and Claude Desktop through an mcp-remote bridge, Codex, Cursor, Gemini CLI, VS Code), a probe for checking the connection, and a reference for the six tools with request and response examples taken from the demo store. Fixes two client snippets that could not have connected. Gemini CLI needs `httpUrl`; it reads `url` as SSE, which this endpoint refuses. Codex needs `experimental_use_rmcp_client = true`, or it only starts command-based servers. Connect Your Agent keeps its job (what agent access is, the two toggles and the reasoning) and links to the new page for setup, tool detail and the non-MCP fallbacks instead of repeating them. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds
docs/mcp-server.md(sidebar: Reference → MCP Server), a setup and toolreference for the local MCP endpoint shipped in #299.
mcp-remotebridge, since the desktop app starts connectors as a commandrather than calling an address), Codex, Cursor, Gemini CLI, VS Code, plus a
note that Claude Chat can't reach a local address at all.
tools/listprobe, and what 404 and 405 mean.since/until/source/projectfilters, then all six tools with theirparameters, caps and a request and response pair each.
detail results leave out while text access is off.
Two client snippets on the existing page were wrong and are fixed here. Gemini
CLI needs
httpUrl(it readsurlas SSE, which this endpoint refuses with 405),and Codex needs
experimental_use_rmcp_client = trueor it only startscommand-based servers.
connect-your-agent.mdkeeps its own job (what agent access is, the two toggles,the reasoning) and links to the new page rather than repeating setup, tool detail
or the fallbacks.
Test plan
bun run docs:buildpasses, and every anchor the two pages link resolvesagainst the generated HTML.
demo store (
scripts/demo.ts) and querying/mcpagainst it. No realsession data or local paths.
off makes
get_session_transcriptreturn its explanatory refusal and dropsthe opening prompt from search rows.
🤖 Generated with Claude Code