docs: add client configuration for Claude Desktop, Gemini CLI, Grok, ChatGPT, VS Code, and Windsurf - #70
Open
Totti0135 wants to merge 1 commit into
Open
Conversation
…ChatGPT, VS Code, and Windsurf The client configuration page covered Codex, Claude Code, and Cursor only. Add per-client walkthroughs for the remaining common MCP hosts: local stdio clients (Claude Desktop, VS Code, Windsurf, Gemini CLI) and cloud connector clients (ChatGPT developer mode, Grok), using each host's verified config format. Extend the client lists in both READMEs accordingly.
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
1 participant
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
docs/mcp-client-config.mdcovered only Codex, Claude Code, and Cursor. This PR extends it to the remaining common MCP hosts, with each host's configuration format verified against its current vendor documentation. Server behavior is unchanged — every path already works over stdio or Streamable HTTP; this closes a documentation gap only.Local stdio clients
claude_desktop_config.jsonlocation per platformclaude mcp addone-liner alongside the existing JSON.vscode/mcp.jsonwith theservers/type: "stdio"shape, noting thetype: "http"variant for the local HTTP server~/.codeium/windsurf/mcp_config.jsongemini mcp addfor stdio and--transport http,~/.gemini/settings.jsonvs.gemini/settings.jsonscopes, and the underscore-in-server-name caveat (tool names are derived from it)Cloud connector clients (tunnel + auth)
CODING_TOOLS_MCP_OAUTH_CLIENT_*)server_url+authorization(static bearer tunnel) insteadREADME updates (en + zh-CN)
Test plan
python -m tests.compliance.runner --suite docs-required— 4/4 OKinitialize(2025-11-25) +tools/list→ 18 tools onhttp://127.0.0.1:8765/mcpnotifications/initialized→tools/callread_file—isError: false,structuredContentpresentclaude mcp add,gemini mcp add(stdio + http), VS Code.vscode/mcp.json