Pular para o conteúdo

IA & automação · Guia

O que é um MCP server e para que ele serve

Um MCP server é um programa que expõe dados e ações de um sistema, como ERP, CRM ou banco de dados, a agentes de IA por meio do Model Context Protocol (MCP), um padrão aberto. Qualquer aplicação compatível descobre as ferramentas do servidor e as usa com as permissões definidas, sem uma integração diferente para cada agente.

Master TimmAtualizado em 6 min de leitura

O que é o Model Context Protocol (MCP)

O MCP é um protocolo aberto que padroniza como aplicações de IA se conectam a dados e ferramentas externas. Foi criado pela Anthropic e hoje é mantido pela Agentic AI Foundation, ligada à Linux Foundation. Claude, ChatGPT, Cursor, Gemini, Microsoft Copilot e VS Code estão entre os produtos que o suportam.

  • Host: A aplicação de IA que a pessoa usa, como um assistente, uma IDE ou o agente da própria empresa.
  • Cliente: O conector, dentro do host, que conversa com um servidor MCP.
  • Servidor: O programa que oferece os dados e as ações de um sistema; é a peça que a empresa constrói sobre o próprio ERP, CRM ou API.

As mensagens seguem o JSON-RPC 2.0. Um servidor pode rodar como processo local, ligado ao host pela entrada e saída padrão (stdio), ou como serviço remoto via HTTP (Streamable HTTP), o caso comum quando várias pessoas e vários agentes usam o mesmo sistema.

Ferramentas, recursos e prompts: o que um MCP server expõe

A especificação define três primitivas que um servidor pode oferecer. A diferença entre elas está em quem decide usá-las: o modelo, a aplicação ou a pessoa.

As três primitivas de um MCP server e quem decide usar cada uma
PrimitivaQuem decide usarExemplo em um ERP
Ferramentas (tools)Funções que executam uma consulta ou uma açãoO modelo, durante a tarefaConsultar o status de um pedido ou abrir um chamado
Recursos (resources)Dados e conteúdo que dão contextoA aplicação, que anexa o conteúdoO catálogo de produtos ou a política de devolução
PromptsModelos de instrução prontosA pessoa, que escolhe o modeloUm comando de resumo do cliente no assistente

Cada ferramenta tem nome, descrição e um JSON Schema dos parâmetros. O modelo escolhe a ferramenta a partir dessa descrição, então nomes claros e descrições precisas pesam tanto quanto o código. A ferramenta também pode declarar o formato da resposta (outputSchema), o que permite validar o resultado antes de entregá-lo ao modelo.

MCP server, API REST ou integração direta: quando usar cada um

Um MCP server não substitui a API do sistema. Na maioria dos casos, ele é uma camada fina sobre ela, pensada para ser usada por modelos. A pergunta que decide é quem vai consumir a integração.

API REST, tool calling no código do agente e MCP server: quando usar cada um
AbordagemQuem consomeQuando usar
API RESTContrato entre sistemas, chamado por códigoOutros sistemas e desenvolvedoresIntegrações determinísticas, sem um modelo de linguagem no meio
Tool calling diretoFunções declaradas no código de um agenteUm único agente ou aplicaçãoUm agente só, com poucas ferramentas, mantido pelo mesmo time
MCP serverFerramentas e dados publicados por um protocolo abertoVários agentes, IDEs e assistentesQuando o mesmo sistema vai servir a mais de um agente ou produto de IA

Com MCP, a lógica de negócio e as regras de acesso continuam no sistema de origem. O servidor traduz o sistema para a linguagem das ferramentas e limita o que o modelo pode fazer nele.

Segurança: permissões, autenticação e auditoria

A especificação trata cada ferramenta como execução de código e recomenda que uma pessoa sempre possa negar uma chamada. Na prática, a segurança de um MCP server depende de poucos controles, aplicados desde a primeira versão.

  • Permissão mínima: Cada ferramenta faz só o que a tarefa exige, e consulta e alteração ficam em ferramentas separadas, com escopos diferentes.
  • Autenticação: Servidores remotos usam OAuth 2.1, como define a especificação; o token vale só para aquele servidor e nunca é repassado a outro sistema.
  • Aprovação humana: Ações sensíveis, como pagar, apagar ou enviar dados para fora, pedem confirmação antes de executar.
  • Validação: O servidor valida toda entrada, limita a taxa de chamadas e sanitiza as saídas, porque o resultado de uma ferramenta pode trazer instruções maliciosas (prompt injection).
  • Auditoria: Cada chamada fica registrada com quem pediu, os parâmetros usados e o que voltou.

Como começar um MCP server sobre o ERP ou o CRM

O caminho mais seguro é começar pequeno e só com leitura, e ampliar conforme os testes mostram que o agente usa as ferramentas do jeito certo.

  1. Escolha as tarefas: Liste as perguntas e ações de que os agentes precisam, como consultar pedidos ou estoque, e quem no negócio valida o resultado.
  2. Comece pela leitura: Publique primeiro ferramentas de consulta e recursos; ações que alteram dados entram depois, com aprovação humana.
  3. Desenhe as ferramentas: Poucas, com nomes claros, descrições objetivas e parâmetros validados por JSON Schema.
  4. Proteja o acesso: OAuth 2.1 com escopos por ferramenta no servidor remoto, ou credenciais do ambiente no servidor local.
  5. Teste com agentes reais: Um dataset de pedidos reais e de borda mostra se o modelo escolhe a ferramenta certa, com os parâmetros certos.
  6. Opere com traces: Registre cada chamada, a latência e os erros, e versione o servidor junto com a API que ele expõe.

No Zorbit, produto próprio da Master Timm que orquestra agentes de código, um plugin MCP reúne cerca de 74 ferramentas. Em conjuntos desse tamanho, nomes e descrições claros são o que permite ao modelo escolher a ferramenta certa.

Serviço relacionado

Engenharia de IA & LLM

Agentes de IA, RAG e MCP em produção, não em demo.

Conversa inicial gratuita · Resposta em até 1 dia útil

Veja também: Automação de processos com IA e Automação de software com IA.

Perguntas frequentes

O MCP funciona com qualquer modelo de IA?

Funciona com qualquer aplicação que implemente um cliente MCP, seja qual for o modelo por trás dela. O protocolo não depende de Claude, GPT ou Gemini: o que importa é o host suportar MCP e o modelo saber chamar ferramentas (tool calling), o que a maioria dos modelos atuais faz.

Dá para expor só consultas, sem permitir alterações no sistema?

Sim, e é o jeito recomendado de começar. O servidor publica só ferramentas de consulta e recursos, usa uma credencial de leitura no sistema de origem e, quando é remoto, escopos OAuth que não permitem escrita. Ações que alteram dados entram depois, uma a uma, com aprovação humana.

É seguro instalar MCP servers de terceiros?

Só depois de uma avaliação, porque um servidor MCP executa código e alimenta o modelo com conteúdo. A especificação manda tratar as descrições e anotações das ferramentas como não confiáveis, a menos que venham de um servidor confiável. Confira a origem e a versão, rode o servidor com permissões mínimas e revise o que cada ferramenta pode acessar.

Quem mantém o MCP server depois que ele entra em produção?

O time que mantém o sistema exposto, porque o servidor muda junto com a API e com as regras de negócio. Ele fica versionado ao lado da API, com testes automatizados, evals das ferramentas e traces de uso. Quando a Master Timm constrói o servidor, a documentação e a transferência para o seu time fazem parte da entrega.

Fontes

Master Timm · Atualizado em

Conte o seu desafio

Conte o contexto: o problema, o prazo e o que já existe. Você fala direto com quem vai fazer o trabalho.

Pedir conversa inicial

Conversa inicial gratuita · Resposta em até 1 dia útil