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

  1. Escolha seu cliente: o assistente ou editor que você usa.
  2. Dê ao servidor um nome composto por letras, números, hifens e sublinhados.
  3. Para um servidor local, insira o comando que o inicia (como npx, uvx ou docker), os argumentos, um por linha, e eventuais variáveis de ambiente, como chaves de API, no formato KEY=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.
  4. Para um servidor remoto, escolha URL remota e insira a URL do servidor e eventuais cabeçalhos, como Authorization: Bearer <token>.
  5. 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.
  6. 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.