O que é MCP e por que conectá-lo ao Código Claude
Claude Code pode trabalhar não só com seus recursos embutidos, mas também com ferramentas externas através do protocolo MCP. Isso permite que você execute a análise do site, trabalho de design, verificações de segurança e muito mais diretamente do chat.
Para obter um servidor em execução, você precisa descrever uma vez como lançá-lo: qual comando é usado, quais argumentos são passados e quais chaves de acesso são necessárias. O principal desafio é que a configuração vive em diferentes lugares dependendo de qual versão você está usando.
Configuração no aplicativo desktop
Se você estiver usando a versão desktop, o arquivo de configurações está localizado em C:\Users\Boss\AppData\Roaming\Claude\claude_desktop_configO ficheiro não tem extensão, embora seja JSON. A maneira mais rápida de abri-lo é através do %APPDATA%\Claude variável — é aí que claude_desktop_config.json Vidas.
A estrutura é simples: mcpServers chave, dentro dela — o nome do servidor, e sob isso — command, args, e env.
json { "mcpServers": { "nome do servidor": { "comando": "comando", "args": ["argumentos"], "env": { "API KEY": "sua chave"}} } }
Por exemplo, para firecrawl (website analisando) você precisa executar npx -y firecrawl-mcp e passar o FIRECRAWL_API_KEY Chave. Pela Pencil (design) — especificar o caminho completo para o ficheiro exe e --app desktop argumento. No mesmo arquivo, você também pode adicionar, digamos, Burp Suite para tarefas de segurança.
Após salvar a configuração, certifique-se de fechar totalmente o aplicativo — não apenas minimizá-lo, mas realmente sair através da bandeja. No próximo lançamento, um ícone de martelo com o número de ferramentas disponíveis aparecerá na parte inferior de um novo chat. Se isso não acontecer — procure um erro no JSON.
Configurar servidores para a versão CLI
A versão terminal do Claude Code ignora a configuração da área de trabalho. Colocar qualquer coisa ali é inútil — o arquivo é silenciosamente ignorado. Em vez disso, o ficheiro C:\Users\USERNAME\.claude.json no diretório home é usado. Nota: este é um ficheiro, não um .claude pasta. A diferença é um ponto, e é fácil de perder.
Você pode adicionar um servidor de duas maneiras. O primeiro é através de um comando terminal: claude mcp add firecrawl --scope user -- npx -y firecrawl-mcp. O segundo é editar manualmente .claude.json. Se o arquivo ainda não existe, basta criá-lo. Se você precisa passar uma chave através de uma variável de ambiente, é mais conveniente editar o arquivo manualmente — a linha de comando não é adequada para isso.
Para um projeto específico, para evitar o transporte de configurações em todos os projetos de uma .mcp.json é criado na raiz. Este arquivo pode ser enviado para git se toda a equipe usar os mesmos servidores. A adição é assim: claude mcp add firecrawl --scope project -- npx -y firecrawl-mcp
Como verificar e gerenciar servidores
Dentro de uma sessão, a maneira mais fácil de verificar o status é através da /mcp comando — ele lista todos os servidores e mostra quais estão em execução. Para o terminal, existem comandos separados:
claude mcp list— todos os servidores e respectivos estatutos;claude mcp get firecrawl— pormenores de um servidor específico;claude mcp remove firecrawl --scope user— remover um servidor.
Erros comuns e como corrigi-los
Muitas vezes, um servidor não aparece devido a erros no JSON. Uma vírgula no final de um bloco, uma vírgula ausente entre servidores, parênteses inigualáveis — tudo isso faz com que o arquivo seja ignorado silenciosamente sem avisos. Verifique a sintaxe antes de reiniciar a aplicação.
Se vires npx: command not found ao iniciar um servidor, Node.js não está instalado ou não é adicionado ao PATH. Instale Node.js, reinicie o terminal e certifique-se node --version e npx --version versões de saída.
No Windows, também é importante escrever caminhos corretamente com espaços. Por exemplo, C:\Program Files\... em JSON precisa ser escapado com duplas contra-ataques: "C:\\Program Files\\Pencil\\resources\\...". Caso contrário, o aplicativo não vai encontrar o arquivo.
