Os melhores servidores MCP para Claude Code (e a configuração que realmente funciona)

O Protocolo de Contexto de Modelo transforma o Claude Code de um gerador de código em algo que pode ler seu repositório,
consultar um banco de dados, controlar um navegador e enviar um PR. O problema é que a maioria das postagens sobre "configuração MCP" para.
filesystem e nunca menciona as armadilhas. Aqui está uma configuração que eu realmente uso, além das armadilhas.

Uma .mcp.json que merece seu lugar

Coloque isso na raiz do seu repositório; o Claude Code o detecta automaticamente e pede que você confie nele uma vez.

{
  "mcpServers": {
    "filesystem": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "${workspaceFolder}"] },
    "github":     { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"], "env": { "GITHUB_TOKEN": "..." } },
    "git":        { "command": "uvx", "args": ["mcp-server-git", "--repository", "${workspaceFolder}"] },
    "fetch":      { "command": "uvx", "args": ["mcp-server-fetch"] },
    "playwright": { "command": "npx", "args": ["-y", "@playwright/mcp@latest"] }
  }
}

(Pacote completo com um servidor postgres e notas por ferramenta:
https://github.com/iskandaryv/anthropic-gateway-examples/tree/main/mcp)

As armadilhas que custam tempo real

• O prompt de confiança é um recurso. O Claude Code se recusa a carregar servidores MCP do projeto até que você os aprove — por projeto. Essa é a fronteira de segurança, não um bug.
• Dê ao postgres um papel somente leitura. Um servidor MCP executa qualquer SQL que o modelo emita. Um papel somente leitura torna um DROP alucinado fisicamente impossível.
• Limite o token do GitHub. repo + read:org é suficiente. Não entregue um PAT clássico com todos os escopos.
• A saída do MCP é contexto. Um resultado de consulta de 200 linhas ou uma busca de página completa é reenviado na próxima vez. Grandes saídas de ferramentas aumentam rapidamente o uso de tokens — a coisa que torna sessões agentes caras.

Funciona da mesma forma através de um gateway

A fiação do MCP é independente de onde as chamadas do modelo vão. Se o Claude Code fala com a API oficial ou um
gateway compatível com Anthropic, os servidores
são configurados de forma idêntica — o gateway apenas muda ANTHROPIC_BASE_URL, não .mcp.json.

Conclusões

• Comece com filesystem + git + github; adicione navegador/banco de dados apenas quando uma tarefa precisar deles.
• Trate cada servidor como um executor não confiável — tokens de menor privilégio, papéis de DB somente leitura.
• Fique de olho no uso de tokens: resultados de ferramentas são o custo oculto de um loop agente.

Divulgação: Eu administro ClaudeAPIKey.dev, um gateway de API compatível com Anthropic
— mencionado acima apenas porque a configuração do MCP não é afetada por isso. "Claude" é uma marca registrada da
Anthropic; não estamos afiliados à Anthropic.