WACrew

Blog

O que é MCP (Model Context Protocol), explicado sem jargão

MCP é o padrão aberto que liga assistentes de IA a ferramentas e dados. Entenda host, cliente e servidor, ferramentas, recursos e prompts, com exemplos práticos.

Por Rodrigo Sumioshi 5 min de leitura
Neste artigo
  1. O problema que o MCP resolve
  2. As três peças: host, cliente e servidor
  3. O que um servidor MCP oferece
  4. Local ou remoto: como a conexão acontece
  5. Como é usar um servidor MCP
  6. Exemplos de servidores MCP
  7. MCP x API comum
  8. Segurança: o que observar
  9. Resumo

Se você usa Claude, Cursor ou outro assistente de IA, já deve ter visto a sigla MCP em algum tutorial. MCP quer dizer Model Context Protocol, um padrão aberto para conectar aplicações de IA a ferramentas e dados externos. A própria documentação oficial compara o protocolo a uma porta USB-C: um encaixe único que serve para muitos aparelhos.

Este guia explica o que é MCP sem pressupor que você programa, e depois mostra o mínimo de detalhe técnico para quem quer usar no dia a dia.

O problema que o MCP resolve

Um modelo de linguagem, sozinho, só conhece o que estava nos dados de treino e o que você cola na conversa. Ele não lê seu calendário, não abre seus arquivos e não consulta o banco de dados da empresa.

Antes do MCP, cada aplicação resolvia isso do seu jeito. Uma integração feita para um assistente não servia em outro. Quem mantinha uma ferramenta precisava escrever uma versão para cada produto de IA.

A Anthropic publicou o MCP como código aberto em novembro de 2024 com a ideia oposta. Você escreve a integração uma vez, como um servidor MCP, e qualquer aplicação compatível passa a usar.

As três peças: host, cliente e servidor

A documentação de arquitetura define três papéis:

  • Host: a aplicação de IA que você usa, como Claude Code, Claude Desktop, Cursor ou VS Code.
  • Cliente MCP: um componente dentro do host que mantém a conexão com um servidor. O host cria um cliente para cada servidor.
  • Servidor MCP: o programa que oferece as ferramentas e os dados. Pode rodar no seu computador ou na nuvem.

Um exemplo concreto. Você abre o Claude Code e ele conecta em dois servidores, um que lê arquivos e outro que consulta o WhatsApp. São duas conexões independentes, cada uma com seu cliente. O modelo enxerga as ferramentas dos dois e escolhe qual usar a cada pergunta.

O que um servidor MCP oferece

Um servidor pode expor três tipos de coisa:

TipoO que éExemplo
Ferramentas (tools)Ações que o modelo pode chamar"enviar mensagem", "criar evento", "rodar consulta"
Recursos (resources)Dados para dar contextoo conteúdo de um arquivo, um registro do banco
PromptsModelos de instrução prontos"revisar este código", "resumir esta reunião"

Na prática, ferramentas são o que mais aparece. Quando alguém diz "instalei um MCP do GitHub", quer dizer que o assistente ganhou ferramentas para abrir issue, ler pull request e coisas assim.

Local ou remoto: como a conexão acontece

O protocolo define dois jeitos principais de transporte:

  • stdio: o host inicia o servidor como um processo no seu computador e conversa com ele pela entrada e saída padrão. É o caso típico de servidores instalados com npx ou uvx.
  • Streamable HTTP: o servidor roda em outro lugar e o host conversa com ele por HTTP. Serve para serviços na nuvem e aceita autenticação, com OAuth recomendado.

As mensagens trocadas seguem o formato JSON-RPC 2.0, mas você não precisa saber disso para usar. Os SDKs e os hosts cuidam dessa parte.

Como é usar um servidor MCP

Para quem só quer usar, o trabalho é registrar o servidor no seu assistente. No Claude Code, por exemplo, um servidor local é adicionado com um comando:

claude mcp add meu-servidor -- npx -y nome-do-pacote

No Cursor, a mesma coisa vai num arquivo mcp.json:

{
  "mcpServers": {
    "meu-servidor": {
      "command": "npx",
      "args": ["-y", "nome-do-pacote"]
    }
  }
}

Depois disso, você conversa normalmente. "Quais clientes estão esperando resposta?" faz o modelo procurar entre as ferramentas disponíveis a que resolve a pergunta. Detalhamos os dois casos em Claude Code com MCP e Cursor com MCP.

Exemplos de servidores MCP

  • Arquivos e repositórios: ler e editar arquivos, consultar o histórico do Git.
  • Bancos de dados: rodar consultas em PostgreSQL ou SQLite.
  • Ferramentas de trabalho: Notion, Linear, Sentry, Google Agenda.
  • Mensageria: o servidor MCP de WhatsApp do WACrew dá ao agente 36 ferramentas para ler grupos e conversas, transcrever áudio, ver prints e responder no ritmo de uma pessoa. Ele está publicado no npm como wacrew-mcp e no registro oficial de servidores MCP.

O repositório oficial de servidores de referência e o registro oficial são bons pontos de partida para achar outros.

MCP x API comum

Uma dúvida frequente é qual a diferença entre MCP e uma API REST. A API é feita para programadores chamarem de dentro do código. O MCP é feito para o modelo descobrir sozinho quais ações existem, ler a descrição de cada uma e decidir quando chamar.

Por isso a descrição das ferramentas importa tanto num servidor MCP. É o texto que o modelo lê para escolher. Uma ferramenta mal descrita é ignorada ou chamada na hora errada.

Muitos servidores MCP, inclusive, são uma camada fina em cima de uma API que já existia.

Segurança: o que observar

Conectar um assistente a ferramentas reais traz riscos reais. Alguns cuidados básicos:

  1. Instale só servidores de fonte confiável. Um servidor local roda com as permissões do seu usuário.
  2. Use chaves com o mínimo de permissão. Se o servidor precisa só ler, não dê chave de escrita.
  3. Mantenha a aprovação ligada para ações sensíveis. Claude Code e Cursor pedem confirmação antes de usar ferramentas, e vale manter isso para envio de mensagem, pagamento ou exclusão.
  4. Desconfie de conteúdo externo. Um texto lido de uma página ou mensagem pode tentar dar ordens ao modelo. Ferramentas que agem para fora precisam de revisão.

Resumo

MCP é um padrão aberto que liga aplicações de IA a ferramentas e dados. O host é o assistente que você usa, o servidor é o programa que oferece as ferramentas, e o cliente faz a ponte entre os dois. Você instala um servidor uma vez e ele funciona em qualquer assistente compatível.

Se você quer ver o MCP aplicado a um caso de verdade, o guia como conectar o WhatsApp ao Claude Code mostra o passo a passo com um servidor de código aberto.