O que é MCP no Claude Code
- MCP é a sigla de Model Context Protocol, um padrão aberto que permite ao Claude Code conversar com ferramentas e fontes de dados externas de forma estruturada, sem gambiarra.
- Na prática, um servidor MCP é uma ponte: ele expõe ações e dados (consultar um banco, ler um repositório, buscar um arquivo) que o Claude Code passa a poder usar durante a tarefa.
- A vantagem é dar contexto real ao agente — em vez de o Claude Code adivinhar a estrutura do seu banco, ele consulta via MCP e age sobre dados verdadeiros.
- Existem servidores MCP prontos para serviços populares (como GitHub, Supabase e sistemas de arquivos) e você também pode criar servidores próprios para ferramentas internas da sua operação.
Como adicionar um servidor MCP
- Servidores MCP no Claude Code são declarados em um arquivo de configuração (tipicamente um .mcp.json), onde você lista o nome do servidor, o comando que o inicia e os parâmetros necessários.
- Muitos servidores rodam via npx — você aponta o comando para o pacote do servidor (por exemplo, o servidor oficial de um serviço) e o Claude Code o inicia sob demanda quando precisa daquela ferramenta.
- Credenciais sensíveis (tokens, chaves de API) entram como variáveis de ambiente na configuração do servidor, e não devem ser commitadas em repositório público — mantenha-as em arquivos ignorados pelo Git.
- Depois de configurar, reinicie a sessão do Claude Code; ele carrega os servidores MCP disponíveis e passa a oferecer aquelas ações como ferramentas que pode chamar durante o trabalho.
Casos de uso reais de MCP
- Conectar um banco de dados (como Supabase ou Postgres) por MCP deixa o Claude Code ler o schema e as tabelas reais antes de escrever uma query ou montar uma migration — menos suposição, menos erro.
- Um servidor MCP de GitHub permite que o agente abra issues, leia pull requests e navegue pelo histórico do repositório como parte do fluxo de trabalho, sem você sair do terminal.
- Servidores de sistema de arquivos ou de busca dão ao Claude Code acesso controlado a documentos e dados fora da pasta do projeto, útil para tarefas que cruzam várias fontes.
- Para operações próprias, criar um servidor MCP interno expõe APIs da sua empresa (CRM, webhooks, dashboards) de forma padronizada para o agente usar com segurança.
Cuidados e limites do MCP
- MCP amplia o que o Claude Code consegue tocar, então trate permissões com cuidado: um servidor com acesso de escrita a um banco de produção pode fazer mudanças reais — comece com acesso de leitura.
- Nem todo servidor MCP é igual em qualidade; servidores oficiais e mantidos são mais confiáveis que pacotes obscuros, principalmente quando recebem suas credenciais.
- Erros de conexão MCP costumam ser de configuração: comando errado, token sem permissão ou variável de ambiente ausente — verifique a configuração antes de suspeitar do Claude Code.
- O MCP dá poder, mas não dispensa revisão: continue aprovando as ações do agente, sobretudo quando ele opera sobre dados ou sistemas reais via um servidor MCP.
// Dado próprio ZX LAB
Na ZX LAB, conectamos o Claude Code via MCP a Supabase, GitHub e ferramentas internas para que ele leia dados reais antes de agir — em vez de adivinhar. É o mesmo padrão de integração que usamos nos pipelines ensinados nos cursos de entrada de R$37.