O que é MCP? Conectando ferramentas externas ao Claude Code (2026)

O que é MCP? (Model Context Protocol)

O MCP (Model Context Protocol) é um padrão aberto que permite a aplicações de IA se conectarem a sistemas, ferramentas e fontes de dados externos de uma forma consistente. A Anthropic apresentou o protocolo no fim de 2024 e o tornou open source para que qualquer pessoa possa construir um servidor compatível (Anthropic, "Introducing the Model Context Protocol", Nov 25, 2024).

A analogia mais fácil: o MCP é uma porta USB-C para a IA. Antes do USB-C, cada dispositivo precisava do próprio cabo. Depois do USB-C, uma única porta dá conta de tudo. O MCP faz o mesmo pela IA - um único padrão de conexão no lugar de uma pilha de integrações avulsas.

O problema que o MCP resolve é o problema M x N. Se você tem M apps de IA e N ferramentas, o jeito antigo exigia escrever M x N integrações separadas. Com o MCP, cada ferramenta precisa de apenas um servidor MCP, e cada app só precisa "falar" MCP - então a conta encolhe para M + N. É exatamente por isso que o MCP se espalhou tão rápido: escreva um servidor MCP para o seu banco de dados e todo app compatível com MCP (Claude Code, Claude Desktop e uma lista crescente de IDEs) já pode usá-lo na hora.

Resumindo, o MCP é a camada padronizada de "conectar a IA aos dados". Neste guia, foco em como ele funciona dentro do Claude Code - onde você de fato digita comandos e vê resultados.

Qual MCP? Model Context Protocol vs. os outros significados

Um aviso sobre a sigla: "MCP" tem significados demais. Neste guia, MCP quer dizer Model Context Protocol - o protocolo de IA da Anthropic, do fim de 2024. Não é Microsoft Certified Professional (a certificação), Master Control Program (o vilão de Tron) nem Multi-Chip Package (o termo de empacotamento de chips). Se você veio atrás de um desses, este não é o artigo que você procura.

Mais uma coisa que vale esclarecer: muitos tutoriais de MCP explicam o protocolo pelo Claude Desktop. Este guia é especificamente sobre MCP para o Claude Code (o CLI) - onde você conecta servidores pela linha de comando e os usa direto no seu fluxo de programação.

Por que o Claude Code precisa de MCP?

Por padrão, um modelo de IA só sabe o que você cola na janela de chat. Ele não consegue ler sozinho os arquivos do seu projeto, não consegue acessar seu repositório privado no GitHub, não consegue consultar um banco de dados e não consegue abrir um navegador. Tudo o que está fora do texto que você entrega a ele é um ponto cego.

O MCP elimina esse ponto cego. Assim que você conecta um servidor MCP ao Claude Code, o assistente consegue:

• Ler e escrever arquivos fora do seu diretório de trabalho atual (servidor Filesystem).
• Consultar um banco de dados para responder com dados reais em vez de adivinhar (servidor Postgres/SQLite).
• Trabalhar com um repositório: ver issues, abrir PRs, ler o histórico de commits (servidor GitHub).
• Controlar um navegador: abrir páginas, preencher formulários, tirar screenshots (servidor Playwright).
• Buscar documentação atual ou pesquisar na web (servidor Context7, Brave/Exa).

Esse é o passo que transforma o Claude Code de um chatbot que responde perguntas em um agente de IA que toma ações reais: em vez de só dizer "você deveria rodar uma migração", ele consegue consultar o schema sozinho, escrever a migração e abrir um PR. O MCP é a camada que permite que esse comportamento de "conectar a ferramentas externas" aconteça de forma padronizada e controlada.

Aqui vai um exemplo ilustrativo (ilustrativo, não um benchmark registrado) para mostrar a diferença. Sem MCP: você pergunta "por que o endpoint /orders está lento?", e o Claude Code só consegue ler o código que você colou e adivinhar a partir daí. Com MCP (servidor Postgres): o Claude Code roda EXPLAIN ANALYZE na consulta real, vê que a tabela orders está sem um índice, propõe uma migração concreta e abre um PR pelo servidor GitHub. Mesma pergunta - mas a resposta sai do achismo e vai para a evidência.

O ponto-chave: o MCP não adiciona "inteligência" ao modelo - ele adiciona sentidos e mãos. O modelo raciocina igual a antes, mas agora ele consegue ver dados reais e agir sobre sistemas reais, dentro das permissões que você concede.

Como o MCP funciona? Host, Client, Server

A arquitetura do MCP tem três papéis principais. Entenda esses três e você entende o protocolo inteiro.

• Host - o app de IA que você usa. Aqui, esse é o Claude Code. O Host coordena tudo, decide qual ferramenta chamar e detém o direito de aprovação.
• Client - vive dentro do Host. Cada client gerencia exatamente uma conexão com um servidor. Conecte 3 servidores e o Host cria 3 clients.
• Server - um programa externo que fornece capacidades. Cada servidor expõe três tipos de coisa: tools (ações que a IA pode chamar, por exemplo "criar uma issue"), resources (dados legíveis, por exemplo o conteúdo de um arquivo) e prompts (modelos de prompt prontos).

Mapeando direto no Claude Code: o Claude Code é o Host, e cada servidor MCP que você adiciona é um "conector" independente. Quer trabalhar com o GitHub? Conecte o servidor GitHub. Precisa consultar um banco de dados? Conecte o servidor Postgres. Os conectores não sabem uns dos outros; é no Host que tudo se junta.

No fio: o MCP usa JSON-RPC para o Host e o Server conversarem. Há dois transportes principais que você vai encontrar:

• Local (stdio) - o servidor roda como um processo na sua máquina e se comunica pela entrada/saída padrão. Bom para o sistema de arquivos, um banco de dados local, ferramentas que rodam na sua máquina pessoal.
• Remoto (HTTP/SSE) - o servidor roda em um endpoint remoto. Bom para serviços em nuvem e servidores compartilhados por uma equipe.

Um fluxo típico de requisição: você dá um comando no Claude Code, o Host decide qual ferramenta é necessária, o Client correspondente envia uma requisição JSON-RPC ao Server, o Server executa e devolve um resultado (mais recursos, se houver), e o Host entrega esse resultado ao modelo para compor uma resposta. Antes de uma ferramenta de fato rodar, o Host insere a sua etapa de aprovação - é aí que você mantém o controle de toda escrita ou exclusão.

Conecte seu primeiro servidor MCP ao Claude Code (um exemplo real)

Chega de teoria. Esta é a parte que você já pode digitar agora. O Claude Code gerencia servidores MCP com o comando claude mcp. A sintaxe para adicionar um servidor:

claude mcp add <name> <command to run the server> [args...]

Exemplo 1 - adicione o servidor Filesystem para que o Claude Code possa ler e escrever em um diretório específico:

claude mcp add filesystem npx -y @modelcontextprotocol/server-filesystem /path/to/your-project

Exemplo 2 - adicione o servidor GitHub (ele precisa de um token pessoal via variável de ambiente, nunca escrito direto no comando):

claude mcp add github --env GITHUB_TOKEN=$GITHUB_TOKEN -- npx -y @modelcontextprotocol/server-github

Depois de adicionar um, abra uma sessão do Claude Code e digite /mcp para ver os servidores conectados e o status deles:

/mcp

Um ponto importante sobre ser seguro por design: na primeira vez que o Claude Code quer chamar uma ferramenta de um servidor MCP, ele pede a sua aprovação (human-in-the-loop). Você vê exatamente qual ferramenta está prestes a rodar e com quais argumentos antes de dizer sim. Não clique em "aprovar" no piloto automático.

Sobre escopo (onde a configuração é salva), o Claude Code deixa você conectar um servidor no nível local (só a sua máquina), no nível de projeto (compartilhado no repositório por um arquivo de configuração) ou no nível de usuário (todos os seus projetos) - escolha o escopo conforme aquele servidor deva ser privado ou compartilhado.

Assim que o /mcp reportar um servidor como connected, você pode pedir ao Claude Code que faça o trabalho em linguagem simples e ele vai escolher a ferramenta certa - por exemplo, "liste as 5 issues abertas mais recentemente" faz com que ele chame uma ferramenta do servidor GitHub. Se um servidor reportar um erro de conexão, os culpados de sempre são um caminho de pacote errado, uma variável de ambiente de token faltando ou um runtime que não está instalado. Remover o servidor com claude mcp remove <name> e adicioná-lo de novo é a solução rápida quando a configuração deu errado.

Se você quiser se aprofundar em um servidor específico, veja o passo a passo sobre como conectar o servidor MCP do GitHub ao Claude Code com um exemplo de PR de ponta a ponta.

Servidores MCP populares que vale conhecer (2026)

O ecossistema MCP já é enorme. Aqui estão os servidores que vale conhecer primeiro, com uma dica de quando usar cada um:

Essa lista é só um ponto de partida. Para achar mais, diretórios como o Glama ou o repositório awesome-mcp-servers no GitHub catalogam centenas de servidores por categoria. Para detalhes de configuração de um específico, veja o guia sobre como conectar o servidor MCP do GitHub ao Claude Code.

Como o MCP é diferente de Skills, Subagents e Hooks?

Quem está começando vive confundindo esses quatro, porque todos eles "estendem" o Claude Code. A distinção rápida:

• MCP = a camada que conecta a ferramentas e dados externos (GitHub, DB, navegador).
• Skills = capacidades empacotadas (instruções + scripts) que deixam o Claude melhor em uma classe de tarefa.
• Subagents = sub-agentes especializados que rodam a própria tarefa com o próprio contexto.
• Hooks = automação disparada por evento (por exemplo, rodar o linter depois que um arquivo é editado).

A frase simples: o MCP cuida de conectar para fora, e os outros três cuidam de como o Claude trabalha por dentro. Veja o detalhamento completo em como Skills, Subagents, Hooks e MCP se diferenciam.

Riscos e notas de segurança ao usar MCP

Esta é a parte que a maioria dos tutoriais pula, mas é a que mais importa quando você usa MCP de verdade. O MCP é poderoso, e "poderoso" quer dizer "manuseie com cuidado".

• Prompt injection por ferramentas/recursos: o conteúdo que um servidor MCP devolve (uma issue, uma página web, um arquivo) pode conter instruções maliciosas que empurram a IA a agir contra a sua intenção. Não presuma que tudo o que um servidor devolve é seguro.
• Confiar em servidores de terceiros: um servidor MCP é código rodando na sua máquina ou com acesso aos seus dados. Instale só de fontes confiáveis (oficiais, ou open source que você consiga verificar) e leia o código antes de conectá-lo.
• Mantenha a pessoa no circuito: não desligue a etapa de aprovação de ferramentas só por comodidade. Para qualquer escrita ou exclusão (gravar um arquivo, rodar uma query, dar push em um commit), revise primeiro e depois aprove.
• Não deixe segredos no código: passe tokens e chaves de API por variáveis de ambiente, nunca inline no comando ou comitados no repositório.

Um bom hábito: comece com o menor número de servidores possível e dê a cada servidor apenas o escopo mínimo de que ele precisa (por exemplo, aponte o Filesystem para a pasta exata do projeto, não para o seu drive inteiro). Para dados sensíveis, prefira uma conta ou um token só de leitura quando tudo o que você precisa é ler.

Sendo bem direta: o MCP não é perfeitamente seguro - a segurança depende de quais servidores você escolhe e de como você concede permissões. Trate cada servidor como um software que você está instalando, não como um recurso inofensivo que já vem ligado por padrão.

Atalho: servidores MCP incluídos em um kit

Configurar cada servidor MCP na mão - achar o pacote, lidar com o token, escolher o escopo, checar a conexão - consome tempo se você precisa de vários. Alguns kits de Claude Code já vêm com um conjunto de integrações MCP prontas, para você pular a ligação manual. Por exemplo, o Marketing Kit já traz mais de 12 integrações MCP prontas voltadas a fluxos como geração de leads e e-mail/SEO. Se ficou curiosa, você pode conferir os preços do AgentKit (20% de desconto pelo link) - o Marketing Kit está listado a US$ 99, e a página não menciona cobrança recorrente.

Perguntas frequentes (FAQ)

O MCP é gratuito?

O protocolo MCP em si é um padrão aberto e gratuito. A maioria dos servidores MCP populares (Filesystem, GitHub, Postgres e por aí vai) é open source e de uso gratuito. Seu único custo fica no serviço a que um servidor se conecta (por exemplo, o plano de API de um serviço em nuvem).

Como o MCP é diferente de uma API comum?

Uma API comum é uma integração avulsa para cada par app-serviço. O MCP é um padrão compartilhado: escreva um servidor MCP e todo app compatível com MCP pode usá-lo, sem reintegração. Por baixo dos panos, um servidor MCP muitas vezes ainda chama essas APIs - o MCP é a camada padronizadora por cima.

Onde os servidores MCP rodam - local ou remoto?

Os dois. Um servidor local (stdio) roda como um processo na sua máquina, bom para o sistema de arquivos e um banco de dados pessoal. Um servidor remoto (HTTP/SSE) roda em um endpoint remoto, bom para serviços em nuvem e servidores compartilhados por uma equipe.

Preciso saber programar para instalar um servidor MCP?

Para usar, não. Com servidores prontos, você só roda um único comando claude mcp add e pronto. Você só precisa programar se quiser construir um novo servidor MCP por conta própria.

O MCP é seguro?

A segurança depende de quais servidores você escolhe e das permissões que você concede. Os principais riscos são prompt injection e servidores de terceiros não confiáveis. Instale só de fontes confiáveis, mantenha a etapa de aprovação de ferramentas ligada e não deixe segredos no código. O MCP não é perfeitamente seguro.

Quantos servidores MCP o Claude Code suporta?

Não há um limite rígido declarado publicamente - você pode conectar muitos servidores ao mesmo tempo, cada um como seu próprio client. Na prática, mantenha a quantidade no que você precisa para a sessão ficar enxuta e as permissões fáceis de controlar.

Conclusão e próximos passos

O MCP é o padrão aberto que transforma o Claude Code de um assistente de chat em um agente de IA que se conecta ao mundo real: arquivos, bancos de dados, GitHub, o navegador. Agora você já conhece a definição, a arquitetura Host-Client-Server, como rodar claude mcp add e os riscos a observar. O próximo passo mais natural é praticar: abra um terminal e experimente claude mcp add com um servidor. Depois, leia como conectar o servidor MCP do GitHub ao Claude Code para montar um fluxo de ponta a ponta, e como Skills, Subagents, Hooks e MCP se diferenciam para escolher a ferramenta certa para cada trabalho.

· Fontes de referência: modelcontextprotocol.io (docs, build de 2026-07-28) e Anthropic - Introducing MCP (Nov 25, 2024).