Gerador de configuração MCP — Claude, Cursor, VS Code, Windsurf e Codex
Defina um servidor MCP uma vez e obtenha o arquivo de configuração ou o comando exato para Claude Desktop, Claude Code, Cursor, VS Code, Windsurf e Codex.
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/you/projects"
]
},
"github": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.githubcopilot.com/mcp/",
"--header",
"Authorization:${MCP_HEADER_1}"
],
"env": {
"MCP_HEADER_1": "Bearer ${GITHUB_PAT}"
}
}
}
}
- Arquivo: no macOS ~/Library/Application Support/Claude/claude_desktop_config.json, no Windows %APPDATA%\Claude\claude_desktop_config.json (abra em Settings > Developer > Edit Config). Feche o Claude completamente e abra de novo depois de salvar.
- Servidores remotos são conectados via mcp-remote (requer Node.js). Nos planos pagos, você pode adicionar a URL em Settings > Connectors, que cuida do OAuth para você.
- O Claude Desktop não expande ${VAR} neste arquivo; substitua esses marcadores por valores reais.
Roda inteiramente no seu navegador. Configurações costumam conter tokens de API, então nada do que você digita ou cola é enviado ou armazenado. Ver todas as ferramentas grátis.
Encontrou um problema ou algo que poderia ser melhor? Lemos todas as mensagens e corrigimos rápido.
Este gerador de configuração MCP escreve as configurações de servidor do Model Context Protocol para todos os principais clientes de IA a partir de um único formulário. Cada cliente quer um arquivo um pouco diferente: Claude Desktop e Cursor usam um objeto "mcpServers", o VS Code usa "servers" com um "type" obrigatório, o Windsurf chama a URL remota de "serverUrl", o Claude Code precisa de "type" nas entradas remotas e o Codex usa tabelas TOML. Informe o comando ou a URL uma vez e copie a versão certa para a ferramenta que você usa.
O validador faz o caminho inverso: cole uma configuração que não está carregando e ele aponta o erro de JSON, o campo ausente ou a chave que o cliente não lê, e depois carrega os servidores no formulário para você convertê-los. Ele verifica a estrutura, não se o pacote do servidor existe ou se o token é válido; se um servidor continuar falhando, consulte o log de MCP do cliente.
Como usar
- Clique em uma predefinição, como Filesystem ou GitHub, ou adicione um servidor em branco.
- Para um servidor local, defina o comando (npx, uvx, docker) e coloque cada argumento em uma linha. Para um servidor remoto, defina a URL e os eventuais cabeçalhos.
- Se quiser, marque a opção que mantém os segredos fora do arquivo e substitui os valores por referências ${VAR}.
- Escolha o seu cliente e copie ou baixe a saída, salvando-a no caminho indicado abaixo dela.
- Reinicie o cliente (feche o Claude Desktop por completo) para ele recarregar a configuração. Para corrigir um arquivo existente, cole-o em Validar e converter.
Perguntas frequentes
Onde fica o claude_desktop_config.json?
No macOS, fica em ~/Library/Application Support/Claude/claude_desktop_config.json e, no Windows, em %APPDATA%\Claude\claude_desktop_config.json. O jeito mais fácil de abri-lo é em Settings > Developer > Edit Config no Claude Desktop. Feche o Claude por completo e abra de novo depois de salvar, porque o arquivo só é lido na inicialização.
Qual é a diferença entre o .mcp.json do Claude Code e o claude mcp add?
O claude mcp add registra um servidor pelo terminal. Com o escopo padrão local, ele fica salvo em ~/.claude.json só para você e o projeto atual; --scope user o disponibiliza em todos os seus projetos; --scope project o grava no .mcp.json na raiz do projeto, para a equipe compartilhá-lo pelo controle de versão. Cada entrada no .mcp.json deve ter um "type" (stdio, http ou sse); uma entrada com url mas sem type é lida como stdio e falha.
Por que o VS Code ignora a minha configuração mcpServers?
O VS Code lê o .vscode/mcp.json com uma chave de nível superior "servers", e não "mcpServers", e cada servidor precisa de "type": "stdio", "http" ou "sse". Por isso, um arquivo copiado do README de um servidor para Claude ou Cursor não carrega nada. Cole-o no validador e converta-o para o formato do VS Code.
Como mantenho as chaves de API fora da configuração MCP?
Referencie variáveis de ambiente em vez de colar os valores. O Claude Code expande ${VAR} e ${VAR:-default}; Cursor e Windsurf usam ${env:VAR}; o VS Code aceita ${env:VAR} e prompts ${input:id}, que guardam o segredo com segurança; o Codex repassa variáveis com env_vars, env_http_headers e bearer_token_env_var. O Claude Desktop não expande variáveis na configuração, então os valores ali precisam ser literais.
Como adiciono um servidor MCP remoto ao Claude Desktop?
O arquivo de configuração do Claude Desktop só inicia comandos locais. Nos planos pagos, você pode adicionar a URL de um servidor remoto em Settings > Connectors, que também cuida do login OAuth. Caso contrário, faça a ponte com o mcp-remote: o comando é npx com os argumentos -y, mcp-remote e a URL do servidor, mais opções --header para autenticação. O gerador escreve essa ponte para você quando você escolhe o Claude Desktop.
Qual é a diferença entre os transportes stdio, HTTP e SSE?
Servidores stdio rodam como um processo local que o cliente inicia e com o qual se comunica pela entrada e saída padrão, o que serve para ferramentas que leem arquivos ou rodam na sua máquina. Servidores Streamable HTTP rodam remotamente em uma URL e são o padrão atual para servidores hospedados. O SSE é o transporte remoto mais antigo; o Claude Code o marca como obsoleto e o Codex só aceita Streamable HTTP, então prefira HTTP quando um servidor oferecer os dois.
Locais e formatos dos arquivos de configuração MCP
• Claude Desktop: claude_desktop_config.json em ~/Library/Application Support/Claude (macOS) ou %APPDATA%\Claude (Windows). Nível superior "mcpServers"; as entradas têm command, args e env.
• Claude Code: .mcp.json na raiz do projeto (escopo de projeto) ou ~/.claude.json (escopos local e de usuário, gerenciados pelo claude mcp add). Nível superior "mcpServers", com "type" em cada entrada.
• Cursor: .cursor/mcp.json no projeto ou ~/.cursor/mcp.json global. "mcpServers"; entradas remotas usam "url" e "headers".
• VS Code: .vscode/mcp.json no workspace, ou o arquivo do usuário aberto com "MCP: Open User Configuration". Nível superior "servers", mais "inputs" opcional.
• Windsurf: ~/.codeium/windsurf/mcp_config.json. A documentação do Windsurf agora fica sob o Devin Desktop, que usa ~/.config/devin/mcp_config.json (macOS/Linux) ou %APPDATA%\devin\mcp_config.json. Entradas remotas usam "serverUrl".
• Codex: ~/.codex/config.toml, ou .codex/config.toml em um projeto confiável. Uma tabela [mcp_servers.<name>] por servidor, com command/args/env ou url mais bearer_token_env_var e http_headers.
Motivos comuns para um servidor MCP não carregar
• O comando inteiro está em "command" ("npx -y @scope/server"). O cliente procura um executável com esse nome completo. Coloque npx em command e o resto em args, um item por vez.
• Uma vírgula sobrando no final ou um comentário // no JSON. Só o mcp.json do VS Code aceita comentários; os outros clientes exigem JSON estrito.
• npx ou uvx não encontrados. Apps com interface gráfica no macOS nem sempre herdam o PATH do seu shell; use como comando o caminho completo retornado por `which npx`.
• A chave de nível superior errada: "servers" em um arquivo do Claude ou do Cursor, ou "mcpServers" no VS Code.
• Uma entrada remota sem "type" no .mcp.json do Claude Code, que então é tratada como comando local.
• O cliente não foi reiniciado. O Claude Desktop só lê o arquivo na inicialização; Cursor e VS Code mostram o status dos servidores nos painéis de configuração MCP.
Notas de segurança antes de adicionar um servidor
Um servidor MCP roda com as suas permissões: um servidor de sistema de arquivos pode ler e alterar todas as pastas que você listar, e um servidor de banco de dados pode executar consultas com as credenciais que você fornecer. Conceda o menor escopo que funcione, como uma única pasta de projeto, um usuário de banco somente leitura ou um token do GitHub de permissões granulares limitado aos repositórios de que você precisa.
Instale servidores do publicador oficial, fixe as versões de tudo o que mexe em produção e prefira servidores remotos com OAuth a tokens de longa duração colados em um arquivo. Trate a saída das ferramentas como entrada não confiável: uma página web ou issue buscada por um servidor pode conter instruções direcionadas ao modelo.
Ferramentas grátis relacionadas
- Formatador de JSON — Formate, minifique e valide JSON, com erros de parsing localizados por linha e coluna. No seu navegador, sem upload.
- Criador de templates de prompt — Escreva um prompt com variáveis no formato {{variables}}, preencha por formulário ou CSV e exporte um prompt por linha como texto, CSV ou arquivos de batch da OpenAI e da Anthropic.
- Calculadora de custo de API de LLM — Compare o custo da sua carga de trabalho em mais de 40 modelos, com cache, descontos de batch, faixas de contexto longo e tokens de raciocínio. Preços com fonte e data.
- Gerador de llms.txt — Crie um llms.txt conforme a especificação a partir de um formulário, uma lista de URLs ou do seu sitemap, valide um arquivo existente e gere regras de robots.txt para crawlers de IA.