antonio leandro

claude, na prática

MCP in the Claude Developer Platform

tutorial · 04 · agentes · Anthropic · · ~2 min de leitura do original

a tese

integrar modelo a sistema externo não precisa ser trabalho de par: mcp define um protocolo aberto no meio, e o mesmo servidor passa a atender claude, chatgpt, vs code e cursor sem adaptação

o que fica

  1. MCP separa quem tem o modelo de quem tem o dado: o servidor expõe capacidade, o cliente decide o que usar, e nenhum dos dois precisa conhecer o outro.
  2. O protocolo cobre três categorias de capacidade — fontes de dados, ferramentas e workflows na forma de prompts especializados — e não só chamada de função.
  3. A adesão é o produto: Claude, ChatGPT, VS Code e Cursor falam MCP, então escrever um servidor vale para todos eles de uma vez.
  4. A analogia oficial é a porta USB-C, e ela carrega a promessa inteira do padrão: o valor está no conector ser o mesmo, não em ele ser melhor que o cabo anterior.
  5. A documentação é versionada por data no próprio caminho da url, o que significa que o padrão muda e a versão precisa entrar na sua decisão de integração.
  6. Esta página é porta de entrada, não especificação: ela justifica o padrão e aponta para as trilhas de servidor, cliente e apps, sem descrever o protocolo.

o problema

Um modelo de linguagem sozinho não alcança nada. Ele não abre o seu calendário, não lê o banco de produção, não consulta o Notion do time. Para fazer qualquer uma dessas coisas, alguém precisa escrever a ponte — e por muito tempo essa ponte foi escrita duas vezes para cada combinação. Quem construía a aplicação de ia escrevia um adaptador por sistema externo. Quem tinha o sistema externo, se quisesse aparecer dentro de várias aplicações, escrevia um adaptador por aplicação.

O custo disso não é o primeiro adaptador, é o enésimo. Cada integração nova é código que precisa de manutenção, e nenhuma delas é reaproveitável fora do par que a originou. O resultado prático é que a capacidade de um agente fica limitada não pelo modelo, mas por quantas pontes a empresa que fez o cliente teve fôlego de escrever. A documentação da Anthropic coloca o ganho nesses termos: MCP existe para reduzir tempo e complexidade de desenvolvimento tanto para quem constrói a aplicação quanto para quem integra com ela.

a ideia

Colocar um padrão no meio. Em vez de a aplicação de ia conhecer o Notion e o Notion conhecer a aplicação, os dois conhecem o protocolo. O texto usa a analogia da porta USB-C: o valor não está no conector ser tecnicamente superior, está em ser o mesmo em todo lugar. É uma analogia honesta justamente porque é modesta — MCP não promete capacidade nova, promete que a capacidade existente deixe de ser reescrita.

A consequência da modéstia é que o padrão só vale se for adotado. Um protocolo aberto com um cliente é uma api com nome bonito. O argumento de “construir uma vez e integrar em todo lugar” depende inteiramente da lista de quem fala o protocolo, e essa lista é a parte substantiva da página.

como funciona

Há dois lados. O servidor MCP expõe capacidade; a aplicação de ia é o cliente que consome. O que um servidor pode expor cai em três categorias, e a distinção importa: fontes de dados (arquivos locais, bancos), ferramentas (busca, cálculo) e workflows — que a documentação descreve como prompts especializados. Essa terceira categoria é a que costuma passar despercebida por quem chega achando que MCP é só uma padronização de tool calling: o servidor também pode entregar procedimento, não apenas dado e ação.

A documentação abre três trilhas de construção: servidores, clientes e MCP Apps, aplicações interativas que rodam dentro do cliente de ia. Os detalhes de arquitetura e de transporte não estão nesta página — ela é a porta de entrada e aponta para a especificação, cujo caminho traz a versão datada, 2026-07-28.

o que isso custou

Esta página não declara nenhuma limitação, e isso em si é informação: é material de entrada, escrito para convencer, e o leitor que quiser o trade-off precisa ir para a especificação. Mas dois custos aparecem na própria estrutura do que ela propõe.

O primeiro é de confiança. Os exemplos que a documentação escolhe são calendário, Notion, bancos de dados da organização inteira — ou seja, o padrão existe para que o agente aja sobre dado real em nome do usuário. Cada servidor conectado é código de terceiro dentro do caminho de decisão do modelo, e a página não trata de permissão, autenticação ou isolamento.

O segundo é de versionamento. Um padrão aberto muda, e o caminho datado da documentação mostra que este muda com data carimbada. Integração contra padrão em movimento é dívida: o servidor que você escreve hoje é compromisso com uma revisão, não com uma abstração estável.

onde isso aparece hoje

O ecossistema é o argumento. Claude e ChatGPT falam MCP; VS Code, Cursor e MCPJam também. É a rara situação em que fornecedores concorrentes de modelo convergiram no mesmo conector, e é por isso que escrever um servidor virou tarefa de rotina em vez de aposta.

A partir daqui, o caminho natural passa por Model Context Protocol, que é o anúncio do padrão, e por Tool use with Claude, o modelo de ferramentas sobre o qual a padronização se apoia. Quem vai escrever um servidor deveria passar antes por Writing effective tools for AI agents — a interface que você expõe é lida por um modelo, não por um cliente http. E o custo de contexto que muitos servidores conectados criam é exatamente o assunto de Code execution with MCP.

lido na íntegra por pipeline de llm, revisado por antonio leandro antes de publicar ·