Skip to content

Document the local MCP server for every agent - #331

Merged
mando merged 1 commit into
mainfrom
mando/docs-local-mcp-server
Aug 11, 2026
Merged

Document the local MCP server for every agent#331
mando merged 1 commit into
mainfrom
mando/docs-local-mcp-server

Conversation

@mando

@mando mando commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds docs/mcp-server.md (sidebar: Reference → MCP Server), a setup and tool
reference for the local MCP endpoint shipped in #299.

  • Setup per agent: Claude Code, Claude Cowork and Claude Desktop (through an
    mcp-remote bridge, since the desktop app starts connectors as a command
    rather than calling an address), Codex, Cursor, Gemini CLI, VS Code, plus a
    note that Claude Chat can't reach a local address at all.
  • Checking the connection: a tools/list probe, and what 404 and 405 mean.
  • Tool reference: a question-to-tool table, the shared
    since/until/source/project filters, then all six tools with their
    parameters, caps and a request and response pair each.
  • Session text: what the two Settings toggles gate, and what search and
    detail results leave out while text access is off.
  • Without MCP: the CLI and HTTP fallbacks, moved here from Connect Your Agent.

Two client snippets on the existing page were wrong and are fixed here. Gemini
CLI needs httpUrl (it reads url as SSE, which this endpoint refuses with 405),
and Codex needs experimental_use_rmcp_client = true or it only starts
command-based servers.

connect-your-agent.md keeps 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:build passes, and every anchor the two pages link resolves
    against the generated HTML.
  • Every example response is real output, captured by seeding the synthetic
    demo store (scripts/demo.ts) and querying /mcp against it. No real
    session data or local paths.
  • Verified the documented gates: agent access off returns 404, text access
    off makes get_session_transcript return its explanatory refusal and drops
    the opening prompt from search rows.

🤖 Generated with Claude Code

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>
@mando
mando merged commit 337f644 into main Aug 11, 2026
1 check passed
@mando
mando deleted the mando/docs-local-mcp-server branch August 11, 2026 20:25
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.

1 participant