Servidores MCP para Claude Code

Uma configuração do Model Context Protocol que justifica seu uso, além das armadilhas que custam tempo de verdade.

O MCP transforma o Claude Code de um gerador de código em uma ferramenta capaz de ler seu repositório, consultar um banco de dados, controlar um navegador e abrir um PR. A configuração do MCP é independente do gateway — ela muda quais ferramentas estão disponíveis, não para onde vão as chamadas ao modelo.

Um .mcp.json que vale a pena usar

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

Coloque-o na raiz do repositório; o Claude Code o detecta e pede uma única vez que você confirme que confia nele.

As armadilhas

• A solicitação de confiança é um recurso. O Claude Code se recusa a carregar servidores MCP do projeto até que você os aprove, em cada projeto. Esse é o limite de segurança, não um bug.
• Dê ao servidor de banco de dados um papel somente de leitura. Um servidor MCP executa qualquer SQL que o modelo gerar; um papel somente de leitura torna um comando alucinado DROP fisicamente impossível.
• Restrinja os escopos dos tokens. Para o GitHub, repo mais read:org é suficiente. Não forneça a ele um PAT clássico com todos os escopos.
• A saída do MCP faz parte do contexto. Um resultado com 200 linhas ou o conteúdo completo de uma página é reenviado a cada turno subsequente. Saídas extensas de ferramentas são o principal motivo pelo qual sessões com agentes ficam caras.