Adicionar um MCP server a qualquer agente de IA para programação: Claude Code, Cursor, Codex, Gemini CLI, VS Code e mais 8 (2026)

• Claude Code: claude mcp add --transport http NAME URL para um server remoto, ou claude mcp add NAME -- COMMAND para um local. O escopo local é o padrão; --scope project grava um .mcp.json compartilhado e --scope user deixa o server disponível em todos os seus projetos.
• Cursor: mcpServers em .cursor/mcp.json para um projeto, ou ~/.cursor/mcp.json para todos os projetos.
• OpenAI Codex: codex mcp add NAME -- COMMAND, ou uma tabela [mcp_servers.NAME] em ~/.codex/config.toml.
• Gemini CLI: gemini mcp add NAME COMMAND, que grava no .gemini/settings.json do projeto por padrão. Adicione -s user para ~/.gemini/settings.json.
• VS Code (GitHub Copilot): um objeto servers de nível superior em .vscode/mcp.json, ou o arquivo do perfil de usuário aberto com MCP: Open User Configuration.
• Copilot cloud agent no GitHub: Settings do repositório, depois Copilot, depois MCP servers. Cole um JSON com um objeto mcpServers.
• OpenCode: a chave mcp de nível superior em opencode.json.
• Cline: mcpServers em cline_mcp_settings.json. A CLI o mantém em ~/.cline/data/settings/cline_mcp_settings.json.
• Amp: amp mcp add NAME -- COMMAND ou amp mcp add NAME URL, ou amp.mcpServers em ~/.config/amp/settings.json ou .amp/settings.json.
• Kiro: mcpServers em .kiro/settings/mcp.json (workspace) ou ~/.kiro/settings/mcp.json (usuário).
• Factory Droid: droid mcp add NAME URL_OR_COMMAND --type stdio|http|sse, salvo em ~/.factory/mcp.json. Equipes compartilham servers em .factory/mcp.json.
• Junie: mcpServers em .junie/mcp/mcp.json (projeto) ou ~/.junie/mcp/mcp.json (usuário).
• Zed: context_servers no seu arquivo de configurações do Zed.
• goose: extensões sob a chave extensions de ~/.config/goose/config.yaml, ou goose configure, depois Add Extension.

Um server local é um comando que o agente inicia na sua máquina e com o qual conversa via stdio. Um server remoto é uma URL. Na maioria das configs JSON, uma entrada local tem command, args e env, e uma entrada remota tem url e headers opcionais. Cursor, Kiro e Junie aceitam esse formato em mcpServers.

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    },
    "remote-server": {
      "url": "https://example.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp"]

[mcp_servers.figma]
url = "https://mcp.figma.com/mcp"

{
  "servers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp"
    }
  }
}

{
  "mcp": {
    "context7": {
      "type": "local",
      "command": ["npx", "-y", "@upstash/context7-mcp"]
    },
    "remote-server": {
      "type": "remote",
      "url": "https://example.com/mcp"
    }
  }
}

• O VS Code usa servers, não mcpServers, em .vscode/mcp.json. Um arquivo copiado do Cursor precisa dessa chave renomeada.
• O OpenCode quer type local ou remote, e o command dele é um único array que inclui os argumentos.
• O Gemini CLI usa url para servers SSE e httpUrl para servers HTTP streamable.
• O Cline trata uma entrada remota sem type como SSE legado. Defina type como streamableHttp para usar o transporte recomendado.
• O Copilot cloud agent precisa de um array tools em cada server (use ["*"] para todas as ferramentas), e só secrets e variáveis cujos nomes começam com COPILOT_MCP_ chegam à config.
• O Zed coloca os servers em context_servers, e um server remoto sem header Authorization inicia o fluxo OAuth padrão do MCP.
• O Codex é TOML, não JSON: uma tabela [mcp_servers.NAME] por server.

• O Claude Code pede aprovação em sessões interativas antes de usar servers com escopo de projeto do .mcp.json.
• O Amp exige amp mcp approve NAME antes que um server em .amp/settings.json rode. Servers nas suas configurações globais não precisam de aprovação.
• O Kiro mescla os arquivos do workspace e do usuário, e as configurações do workspace vencem. autoApprove lista ferramentas que rodam sem prompt, e "*" aprova todas.
• Gemini CLI: trust: true em um server ignora todas as confirmações de chamadas de ferramenta dele. Use só em servers que você controla.
• Cline: o array autoApprove lista as ferramentas que o Cline pode chamar sem perguntar. Mantenha só ferramentas seguras.
• Factory Droid: servers adicionados com droid mcp add vão para a sua config de usuário. Servers de projeto em .factory/mcp.json não podem ser removidos com droid mcp remove, então edite o arquivo.

• Claude Code: /mcp, que também é onde você faz login em servers OAuth.
• Codex: /mcp na TUI mostra os servers ativos. codex mcp login NAME faz login em servers OAuth.
• Gemini CLI: /mcp mostra o status de conexão de cada server.
• Factory Droid: /mcp abre o gerenciador interativo.
• Junie CLI: /mcp lista os servers com escopo e status.
• Amp: amp mcp doctor.

• Claude Code: claude mcp add, .mcp.json e escopos
• Cursor: mcp.json, interpolação de env e OAuth
• Codex: codex mcp add e [mcp_servers] no config.toml
• Gemini CLI: gemini mcp add e mcpServers no settings.json
• GitHub Copilot: mcp.json do VS Code e o cloud agent
• OpenCode: servers locais e remotos no opencode.json
• Cline: cline_mcp_settings.json
• Amp: amp mcp add e aprovação do workspace
• Kiro: .kiro/settings/mcp.json, autoApprove e OAuth
• Factory Droid: droid mcp add e locais do mcp.json
• Junie: .junie/mcp/mcp.json e /mcp
• Zed: context_servers e permissões de ferramentas
• goose: extensions no config.yaml
• Explore mais de 80 MCP servers oficiais com snippets de instalação