Referência de configuração de clientes MCP
Cada cliente MCP lê os servidores de um local próprio, usando uma chave específica e, às vezes, um formato diferente. Esta tabela mostra onde cada um procura, qual formato espera e se oferece suporte a OAuth para servidores remotos.
| Cliente | Arquivo de configuração | Chave de nível superior | Formato | OAuth remoto | Adicionar via CLI |
|---|---|---|---|---|---|
| Claude Desktop | ~/Library/Application Support/Claude/claude_desktop_config.json | mcpServers | json | Sim | Não |
| Claude Code | .mcp.json | mcpServers | json | Sim | Sim |
| Cursor | .cursor/mcp.json | mcpServers | json | Sim | Não |
| VS Code (GitHub Copilot) | .vscode/mcp.json (key 'servers') or portable .mcp.json (key 'mcpServers') | servers | json | Sim | Sim |
| Windsurf / Devin Desktop | .devin/mcp_config.json (Devin CLI / Devin Local project scope) | mcpServers | json | Sim | Sim |
| Zed | ~/.config/zed/settings.json | context_servers | json | Sim | Não |
| OpenAI Codex CLI | .codex/config.toml (trusted projects only) | mcp_servers | toml | Sim | Sim |
| Gemini CLI | .gemini/settings.json | mcpServers | json | Sim | Sim |
| ChatGPT | Apenas pela tela de configurações | — | — | Sim | Não |
| OpenClaw | ~/.openclaw/openclaw.json | mcp.servers | json5 | Sim | Sim |
| Cline | ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json | mcpServers | json | Não documentado | Sim |
| Continue | .continue/mcpServers/<name>.yaml (or drop a Claude/Cursor/Cline-style mcp.json into .continue/mcpServers/) | mcpServers | yaml | Não documentado | Não |
| JetBrains AI Assistant | Apenas pela tela de configurações | mcpServers | json (pasted in UI) | Não documentado | Não |
Diferenças que podem prejudicar a configuração
VS Code usa servers
.vscode/mcp.json lista as entradas em servers, não em mcpServers. Por isso, uma configuração do Cursor ou Claude colada sem alterações não será carregada. Os formatos portáteis mais recentes .mcp.json e ~/.copilot/mcp-config.json usam mcpServers.
Gemini CLI: httpUrl, não url
O Gemini CLI determina o transporte pelo nome do campo. httpUrl indica Streamable HTTP, url indica o transporte SSE antigo e command indica stdio. Um servidor remoto moderno precisa de httpUrl.
OpenClaw e Cline usam SSE por padrão
Se você não especificar o transporte em uma entrada remota, ambos usam o SSE legado. Defina transport como streamable-http no OpenClaw e type como streamableHttp no Cline.
Claude Code exige um type
Em .mcp.json, uma entrada remota com url, mas sem type, é um erro. Adicione type http ao lado de url; entradas stdio usam type stdio.
Codex usa TOML, uma tabela por servidor
Codex não usa um arquivo JSON. Cada servidor tem sua própria tabela [mcp_servers.<name>] em config.toml, args é um array TOML e env_vars encaminha secrets do seu shell pelo nome.
Continue espera uma lista YAML
No Continue, mcpServers é uma lista de entradas, cada uma com um name, e não um mapa indexado por nome. Cada arquivo de bloco também precisa ter name, version e schema: v1 no início.