Source: https://aiprimetech.io/pt/docs/guides/mcp-servers/ [Início](/pt/) / [Documentação](/pt/docs/) / Servidores MCP para Claude Code # 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. Copiar página [ Ver como Markdown](/pt/docs/guides/mcp-servers.md) [ Perguntar ao ChatGPT](https://chatgpt.com/?q=Read%20https%3A//aiprimetech.io/docs/guides/mcp-servers.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.) [ Perguntar no Claude](https://claude.ai/new?q=Read%20https%3A//aiprimetech.io/docs/guides/mcp-servers.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.) 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. Comece com filesystem, git e github. Adicione servidores de navegador e banco de dados somente quando uma tarefa específica precisar deles — cada servidor carregado acrescenta seu esquema ao custo de tokens de cada solicitação. [Claude CodeConfiguração básica](/pt/docs/guides/claude-code/)[Uso de ferramentasComo funciona a chamada de ferramentas](/pt/docs/api-reference/tool-use/)[Controle de custosPor que a saída das ferramentas importa](/pt/docs/guides/cost-control/) [AnteriorOpenClaw](/pt/docs/guides/openclaw/)[PróximoConfiguração de chave de API por ferramenta](/pt/docs/guides/api-key-configuration/)