A resposta curta
A maioria dos apps de IA guarda os servidores MCP em um arquivo JSON, sob a chave mcpServers. O VS Code usa servers, o Zed context_servers e o Codex uma tabela TOML. Encontre seu app abaixo, edite o arquivo, depois feche e reabra o app. Limites de ferramentas são raros: o VS Code permite 128 por requisição; o Windsurf, 100.
Neste guia
Onde fica o arquivo de configuração MCP de cada app?
A maioria dos apps tem um arquivo para todos os seus projetos e outro para um único projeto. A tabela mostra os dois, como abri-los e a chave sob a qual seus servidores ficam.
| App | Arquivo de configuração | Chave |
|---|---|---|
Claude Codeclaude mcp add, ou /mcp em uma sessão |
~/.claude.json. O .mcp.json de um projeto foi feito para ser compartilhado com sua equipe. | mcpServers |
| Claude DesktopSettings, Developer, Edit Config |
| mcpServers |
| Cursor |
| mcpServers |
VS CodeComando: MCP: Open User Configuration |
| serversO formato próprio do VS Code. Um .mcp.json portátil na raiz do projeto usa mcpServers. |
| WindsurfA documentação do Windsurf agora fica no Devin Desktop |
| mcpServers |
| Gemini CLI |
| mcpServers |
Codexcodex mcp add <name> -- <command> |
| [mcp_servers.<name>]Uma tabela TOML por servidor. |
| LM StudioAba Program, Install, Edit mcp.json |
| mcpServers |
| ClineÍcone MCP Servers, aba Configure, Configure MCP Servers |
CLINE_MCP_SETTINGS_PATH para mover o arquivo. No VS Code, ele fica na pasta de configurações do usuário. | mcpServers |
| Roo CodeMCP settings, Edit Global MCP ou Edit Project MCP |
| mcpServers |
| Amazon QPainel de chat, ícone de ferramentas |
default.json. O ~/.aws/amazonq/mcp.json mais antigo e o .amazonq/mcp.json ainda são lidos por padrão. | mcpServersNo mcp.json mais antigo. |
ZedComando: zed: open settings file |
| context_servers |
~ é a sua pasta de usuário: C:\Users\you no Windows.
Como configurar um servidor MCP remoto em cada app?
Um servidor remoto (HTTP) precisa de uma URL, mas cada app dá nomes diferentes aos campos. A mesma entrada não pode ser colada de um app em outro.
| App | Campos | Bom saber |
|---|---|---|
| Claude Code |
| |
| Claude Desktop | — | Não é escrito neste arquivo. Adicione-o como um conector personalizado em Connectors, nas configurações do app. |
| Cursor |
| |
| VS Code |
| |
| Windsurf |
| Qualquer um dos dois nomes serve para o endereço. |
| Gemini CLI |
| httpUrl é streamable HTTP, url é SSE. |
| Codex |
| Escrito na tabela TOML do servidor. |
| LM Studio |
| |
| Cline |
| Use sse para o transporte mais antigo. |
| Roo Code |
| Use sse para o transporte mais antigo. |
| Amazon Q | — | Definido no painel MCP: escolha http como transporte, depois a URL e cabeçalhos opcionais. |
| Zed |
|
Qual é o limite de ferramentas MCP em cada app?
Limites de ferramentas são raros. Dois apps declaram um. Os outros lidam com listas longas de ferramentas à sua maneira.
| App | Limite | O que faz com listas longas de ferramentas |
|---|---|---|
| VS Code | 128 ferramentas por requisição | Acima disso, o VS Code informa Cannot have more than 128 tools per request. Desmarque ferramentas ou servidores inteiros no seletor de ferramentas, ou defina github.copilot.chat.virtualTools.threshold para que o VS Code agrupe ferramentas parecidas. |
| Windsurf | 100 ferramentas por vez | Desligue ferramentas uma a uma com disabledTools na entrada do servidor. |
| Cursor | Nenhum declarado | Costuma-se citar 40 ferramentas. A documentação do Cursor não indica limite, e o post dele de janeiro de 2026 descreve o carregamento das descrições de ferramentas MCP sob demanda. |
| Claude Code | Nenhum declarado | O Tool Search vem ativado por padrão: só os nomes das ferramentas entram no seu contexto até que uma ferramenta seja usada. |
| Codex | Nenhum declarado | Cada servidor aceita listas enabled_tools e disabled_tools. |
| Amazon Q | Nenhum declarado | Cada ferramenta é definida como Ask, Always allow ou Deny. |
O Claude Desktop, o Gemini CLI, o LM Studio, o Cline, o Roo Code e o Zed não indicam limite de ferramentas.
Um limite diz respeito a quantas ferramentas cabem. O custo dessas ferramentas em tokens é outra questão, e o guia abaixo a responde. Por que o MCP consome tantos tokens
Por que seu servidor MCP não aparece?
Siga esta lista. Ela acompanha o guia de solução de problemas do projeto MCP, escrito para o Claude Desktop. Os quatro primeiros passos valem para qualquer app.
- Feche o app por completo e reabra
O guia do Claude Desktop manda fechá-lo por completo e iniciá-lo de novo depois de editar o arquivo. Outros apps podem recarregar sozinhos: reabra o seu se o servidor não aparecer.
- Confira o JSON e a chave
Um erro de sintaxe, como uma aspa faltando ou uma vírgula sobrando, pode impedir o app de ler o arquivo. Depois confira a chave:
mcpServersna maioria dos apps,serversno VS Code,context_serversno Zed. - Use caminhos absolutos
Os caminhos em
argsprecisam ser absolutos, não relativos. - Rode o comando por conta própria
Cole o comando e os argumentos do servidor em um terminal. Se falhar ali, o app também não consegue iniciá-lo.
- Leia os logs
O Claude Desktop grava
mcp.loge ummcp-server-NAME.logpor servidor, em~/Library/Logs/Claudeno macOS e em%APPDATA%\Claude\logsno Windows. - No Windows, confira o APPDATA
Se um log mostrar
${APPDATA}dentro de um caminho, adicioneAPPDATAaoenvdo servidor com seu valor completo, comoC:\Users\you\AppData\Roaming\.
Você precisa editar esses arquivos à mão?
Não para vê-los todos em um só lugar. O Delta MCP lê as configurações MCP de doze apps de IA, os das tabelas acima, sem alterar nada, e lista cada servidor que encontra.
Para usar esses servidores pelo Delta MCP, ele migra um app adicionando uma única entrada, chamada mcpdelta. Ele desativa a entrada direta de cada servidor que move e guarda o original, para devolvê-lo como estava. Dez apps são migrados para você; o Codex e o Zed são configurados à mão por enquanto. Antes de cada alteração, ele salva uma cópia datada do arquivo.
Perguntas
Onde fica o claude_desktop_config.json?
No macOS, é ~/Library/Application Support/Claude/claude_desktop_config.json, e no Windows, %APPDATA%\Claude\claude_desktop_config.json. O jeito mais rápido é Settings, Developer, Edit Config, que cria o arquivo se ele não existir. O Claude Desktop é oferecido para macOS e Windows.
Onde fica o mcp.json do Cursor?
~/.cursor/mcp.json guarda os servidores de todos os seus projetos, e .cursor/mcp.json dentro de um projeto guarda os daquele projeto. Os dois usam a chave mcpServers.
Onde fica o mcp.json do VS Code?
O de um projeto é .vscode/mcp.json. O seu fica na pasta do seu perfil de usuário: rode MCP: Open User Configuration para abri-lo. O VS Code grava os servidores em servers, não em mcpServers.
Qual é o limite de ferramentas MCP no VS Code?
Uma requisição de chat pode ter no máximo 128 ferramentas ativadas por vez, e o VS Code informa Cannot have more than 128 tools per request quando você passa disso. Desmarque ferramentas ou servidores no seletor de ferramentas, ou defina github.copilot.chat.virtualTools.threshold para que o VS Code agrupe ferramentas parecidas.
O Cursor tem limite de ferramentas MCP?
A documentação dele não indica nenhum; o número que costuma ser citado é 40 ferramentas. Em janeiro de 2026, o Cursor descreveu o carregamento das descrições de ferramentas MCP sob demanda.
Por que minha configuração MCP não funciona em outro app?
A chave e os campos de servidor remoto são diferentes. A maioria dos apps usa mcpServers; o VS Code usa servers, o Zed context_servers e o Codex uma tabela TOML. Um servidor remoto é url no Cursor, serverUrl ou url no Windsurf, httpUrl ou url no Gemini CLI e type mais url no Claude Code e no VS Code.
O Claude Desktop pode usar servidores MCP remotos pelo arquivo de configuração?
Não. Servidores remotos são adicionados como conectores personalizados nas configurações do app. Os servidores em claude_desktop_config.json são um mecanismo à parte, e não estão disponíveis no Cowork nem no claude.ai.
Onde o Claude Code guarda os servidores MCP?
Seus próprios servidores, e os de cada projeto, ficam em ~/.claude.json. O .mcp.json na raiz de um projeto foi feito para ser compartilhado com sua equipe. Adicione um servidor com claude mcp add ou com /mcp em uma sessão. Os dois arquivos usam a chave mcpServers.
Onde fica o mcp_config.json do Windsurf?
A documentação do Windsurf agora fica no Devin Desktop e indica ~/.config/devin/mcp_config.json no macOS e no Linux, e %APPDATA%\devin\mcp_config.json no Windows. Versões anteriores do Windsurf usam ~/.codeium/windsurf/mcp_config.json. Os servidores ficam em mcpServers, e o Windsurf aceita 100 ferramentas por vez.
Fontes
- Claude Code, Connect Claude Code to tools via MCP (documentation) Os arquivos ~/.claude.json e .mcp.json, a chave mcpServers, o tipo http, Tool Search ativado por padrão.
- Model Context Protocol, Connect to local MCP servers Os caminhos de arquivo do Claude Desktop, Edit Config, a reinicialização, os passos de solução de problemas e as pastas de logs.
- Claude Help Center, Get started with custom connectors using remote MCP Servidores remotos são conectores personalizados, separados do claude_desktop_config.json.
- Cursor, Model Context Protocol (documentation) Os arquivos mcp.json global e de projeto, mcpServers, url e headers; nenhum limite de ferramentas indicado.
- Cursor, Dynamic context discovery (6 de jan. de 2026) Descrições de ferramentas MCP carregadas sob demanda.
- Cursor forum, About limitation of the number of MCP tools O relato de um usuário sobre um limite de 40 ferramentas.
- VS Code, Add and manage MCP servers in VS Code (documentation) Os arquivos mcp.json do workspace e do usuário, a chave servers, o .mcp.json portátil, o tipo http.
- VS Code, Use tools with agents (documentation) O limite de 128 ferramentas e seu erro, o seletor de ferramentas, ferramentas virtuais.
- Windsurf, Cascade MCP Configuration (documentation, now on Devin Desktop’s site) O caminho de configuração, mcpServers, serverUrl ou url, o limite de 100 ferramentas, disabledTools.
- Gemini CLI, MCP servers with Gemini CLI (documentation) Os arquivos settings.json, mcpServers, httpUrl e url.
- OpenAI Codex, Model Context Protocol (documentation) config.toml, a tabela mcp_servers, url, enabled_tools e disabled_tools, codex mcp add.
- LM Studio, Use MCP Servers (documentation) Edit mcp.json, mcpServers, url e headers.
- Cline, MCP (documentation) cline_mcp_settings.json e sua pasta, a aba Configure, streamableHttp.
- Roo Code, Using MCP in Roo Code (documentation) O mcp_settings.json global e o .roo/mcp.json do projeto, streamable-http.
- AWS, MCP configuration for Q Developer in the IDE default.json e o mcp.json mais antigo, o transporte http, permissões de ferramentas.
- Zed, Model Context Protocol (documentation) Os caminhos do settings.json, context_servers, url e headers.
- Delta MCP, Supported AI apps (documentation) Os doze apps que o Delta MCP reconhece, os arquivos que ele lê e como migra cada um.
Continue lendo
- Como reduzir o consumo de tokens do MCP e por que é altoComo reduzir o consumo de tokens do MCP: meça com /context, veja os dois custos (lista de ferramentas e idas e voltas) e compare as soluções, até o Tool Search.
- MCP vs CLI para agentes de IA: de onde vem a conta de tokensMCP ou CLI para seu agente de IA? O custo de cada um em tokens, o que as medições mostram, quando a CLI ganha, quando o MCP ganha e onde o código vence os dois.
