Gerador de configuração MCP
Crie a configuração do servidor MCP para Claude Desktop, Claude Code, Cursor, VS Code, Codex CLI, Gemini CLI ou Devin Desktop (anteriormente Windsurf): informe um comando ou o URL de um servidor e copie o JSON ou TOML junto com o arquivo onde deve ser inserido.
Entrada
Saída
| Localização | Arquivo |
|---|---|
macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
Windows | %APPDATA%\Claude\claude_desktop_config.json |
Linux | ~/.config/Claude/claude_desktop_config.json |
Servidores remotos | Configurações > Conectores > Adicionar conector personalizado |
Leia-me
O que é MCP?
O Model Context Protocol (MCP) é um padrão aberto que permite que assistentes de IA usem ferramentas e dados por meio de servidores. Um servidor pode ser um programa local que o assistente inicia no seu computador e com o qual se comunica pela entrada e saída padrão (stdio), ou um servidor remoto que o assistente acessa por HTTP. Cada assistente guarda seus servidores em seu próprio arquivo de configuração, e cada arquivo tem um formato um pouco diferente.
Como usar
- Escolha seu cliente: o assistente ou editor que você usa.
- Dê ao servidor um nome composto por letras, números, hifens e sublinhados.
- Para um servidor local, insira o comando que o inicia (como
npx,uvxoudocker), os argumentos, um por linha, e eventuais variáveis de ambiente, como chaves de API, no formatoKEY=value. Se você colou uma linha de comando inteira no campo de comando, o botão de separar dentro dele move tudo o que vem depois da primeira palavra para os argumentos. - Para um servidor remoto, escolha URL remota e insira a URL do servidor e eventuais cabeçalhos, como
Authorization: Bearer <token>. - Copie a configuração para o arquivo indicado em Onde será inserido ou baixe-a. Se o arquivo já tiver servidores, adicione a nova entrada ao lado deles, dentro de
mcpServers([mcp_servers]no Codex), em vez de substituir o arquivo inteiro. - Reinicie o aplicativo ou recarregue os servidores MCP dele.
Para o Claude Code, o Codex CLI, o Gemini CLI e o VS Code, a caixa Comando também mostra o comando de terminal que adiciona o servidor para você.
Clientes
| Cliente | Arquivo de configuração | É bom saber |
|---|---|---|
| Claude Desktop | claude_desktop_config.json |
Contém apenas servidores locais. Os servidores remotos são adicionados no aplicativo, em Configurações > Conectores > Adicionar conector personalizado. |
| Claude Code | .mcp.json na raiz do projeto |
Já o claude mcp add armazena os servidores em ~/.claude.json, apenas para você. |
| Cursor | .cursor/mcp.json no projeto ou ~/.cursor/mcp.json |
|
| VS Code com GitHub Copilot | .mcp.json na raiz do espaço de trabalho ou ~/.copilot/mcp-config.json |
O formato antigo servers em .vscode/mcp.json serve apenas para o harness local obsoleto do VS Code. |
| Codex CLI | ~/.codex/config.toml |
Um arquivo TOML. Os cabeçalhos de um servidor remoto só podem ser definidos no arquivo, não com codex mcp add. |
| Gemini CLI | .gemini/settings.json no projeto ou ~/.gemini/settings.json |
Os servidores remotos usam httpUrl. |
| Devin Desktop (Windsurf) | ~/.config/devin/mcp_config.json ou .devin/mcp_config.json |
O Windsurf passou a se chamar Devin Desktop. As chaves pessoais vão em .devin/mcp_config.local.json, que fica fora do controle de versão. |
O Chrome salva um download chamado .mcp.json como mcp.json, então adicione de volta o ponto inicial ao mover o arquivo para o lugar certo.
Como manter as chaves seguras
Os arquivos de configuração guardam as chaves de API em texto simples. Não faça commit de um arquivo de projeto com chaves reais em um repositório compartilhado. A maioria dos clientes consegue ler uma chave do seu ambiente em vez do arquivo, cada um com sua própria sintaxe, descrita na respectiva documentação.
Tudo é montado no seu navegador, então os comandos, URLs e chaves que você insere não são enviados para lugar nenhum.