(docs): expand MCP client setup instructions#74
Conversation
- Add /mcp auth step for Claude Code - Update Claude Desktop path to Settings -> Developer -> Local MCP servers, note Team/Enterprise custom-connector restriction (Owners only) - Add codex mcp login step and GUI screenshot for Codex - Add sections for Gemini CLI, GitHub Copilot CLI, Zed, Warp, JetBrains AI Assistant/Junie, and Cline (mcp-remote bridge where the client lacks remote OAuth support) - Add setup screenshots for Claude Desktop, Cursor, and Codex
Greptile SummaryThis PR expands the "Connect your client" section of the README with more complete setup instructions for existing clients (Claude Code, Claude Desktop, Cursor, Codex) and adds seven new client sections (Gemini CLI, GitHub Copilot CLI, Zed, Warp, JetBrains AI Assistant/Junie, Cline). Configuration formats and command syntax were cross-checked against official docs and appear accurate.
Confidence Score: 5/5Docs-only change — no source code is modified, so no runtime regressions are possible. The configuration formats and CLI commands across all seven new client sections were verified against official documentation (Gemini CLI, GitHub Copilot CLI, Zed, Warp, JetBrains, Cline). No incorrect instructions or broken paths were found. The only pre-existing concern (Warp navigation wording) was already flagged in a prior review thread. No files require special attention. Important Files Changed
Reviews (2): Last reviewed commit: "(docs): render OAuth flow diagram as PNG..." | Re-trigger Greptile |
SVG rendering on GitHub was poor; the SVG stays in docs/ as the editable source, rendered at 2x via rsvg-convert.
What
Expands the "Connect your client" section of the README:
/mcpauthenticate step afterclaude mcp add.mcp-remotestdio bridge as the fallback.codex mcp login appwritestep, plus the GUI alternative (with screenshot).npx mcp-remotestdio bridge.ChatGPT was intentionally left out for now — we'll pursue an official ChatGPT app directory listing instead of documenting the developer-mode flow.
Notes
Docs-only change (README +
docs/images/).