O contrato do MCP com contexto e ferramentas
Quando uma aplicação de modelo precisa de dados de fora ou de uma ferramenta, o contrato que eu acompanho é o Model Context Protocol, o MCP. Esta página detalha esse contrato no índice de protocolos.
O que a especificação descreve
A especificação oficial descreve o MCP como um protocolo aberto que liga aplicações de modelos de linguagem a fontes de dados e a ferramentas, e oferece um modo padronizado de compartilhar contexto, expor tools e montar integrações que se compõem. A comunicação usa mensagens JSON-RPC 2.0 entre três papéis: o host, a aplicação de LLM que inicia as conexões; o client, o conector dentro do host; e o server, o serviço que entrega contexto e capacidades.
A própria spec diz que o MCP toma alguma inspiração do Language Server Protocol, que padronizou o modo de acrescentar suporte a linguagens num ecossistema inteiro de ferramentas de desenvolvimento. No mesmo movimento, o MCP padroniza o modo de integrar contexto adicional e tools no ecossistema das aplicações de IA. A analogia é de padronização de ecossistema.
A introdução oficial do projeto usa outra imagem, a de um conector USB-C: assim como o USB-C padroniza a ligação entre dispositivos eletrônicos, o MCP padroniza a ligação entre aplicações de IA e sistemas externos. A intro oficial usa essa imagem como metáfora de um conector padronizado.
O server oferece resources, prompts e tools. Nesta revisão, a primitiva de elicitation no client cobre pedidos iniciados pelo server para obter informação adicional do usuário. A documentação de arquitetura delimita o escopo com clareza: o MCP se concentra no protocolo de troca de contexto, e não dita como a aplicação usa o modelo ou como gerencia o contexto recebido.
História e governança
O MCP foi criado na Anthropic por David Soria Parra e Justin Spahr-Summers, e aberto como padrão. A Linux Foundation anunciou depois a formação da Agentic AI Foundation, a AAIF, com contribuições fundadoras do MCP da Anthropic, do goose da Block e do AGENTS.md da OpenAI. O projeto passa a ser hospedado nessa fundação, sob a Linux Foundation. A nota da fundação chama o MCP de "the universal standard protocol for connecting AI models to tools, data and applications"; essa fórmula é da Linux Foundation, não da spec, e eu a deixo atribuída.
A página oficial de versionamento declara que o protocolo usa identificadores de versão no formato YYYY-MM-DD, e que a revisão Current, pronta para uso na formulação da própria página (ready for use), é 2026-07-28. Essa revisão pode continuar a receber mudanças compatíveis para trás. Eu trato 2026-07-28 como o identificador oficial dessa revisão.
Entre as mudanças que o changelog registra nessa revisão estão a remoção das sessões no nível do protocolo e do handshake initialize, a declaração de versão e de capacidades do client em cada pedido, no campo _meta, o RPC obrigatório server/discover, o padrão Multi Round-Trip Requests e o campo obrigatório resultType, com os valores complete ou input_required.
Como host, client e server se falam
O host coordena um ou vários clients. Cada client mantém a conexão com um server. O server pode rodar como processo local, em geral com transporte STDIO, ou de forma remota, em geral com Streamable HTTP. Em Streamable HTTP, o mesmo identificador de versão também viaja no header MCP-Protocol-Version.
Cada pedido declara a versão em _meta, na chave io.modelcontextprotocol/protocolVersion. O server deve implementar server/discover, para anunciar versões suportadas, capacidades e identidade. O client pode chamá-lo antes de outros pedidos, e também pode seguir em frente e tratar um erro de versão se não o chamar. O ciclo típico de ferramentas, na visão geral de arquitetura, vai de server/discover, que é opcional, a tools/list e tools/call, com a possibilidade de ouvir mudanças pela inscrição documentada na mesma página.
Há tutoriais oficiais para construir um server e um client, e uma página de SDKs que lista implementações em TypeScript, Python, C#, Go, Rust, Ruby, Java, Swift, PHP e Kotlin, em tiers distintos. Essa página avisa que cada SDK adota as revisões no próprio ritmo.
A spec, na seção de segurança da Overview, trata tools como execução arbitrária de código, a ser tratada com a cautela correspondente. O host deve obter consentimento explícito antes de invocar qualquer tool.
Um exemplo oficial
O exemplo abaixo é da documentação oficial de arquitetura da revisão 2026-07-28, na página https://modelcontextprotocol.io/docs/2026-07-28/learn/architecture. São mensagens JSON-RPC dessa revisão: um pedido tools/list e um pedido tools/call.
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/list",
"params": {
"_meta": {
"io.modelcontextprotocol/protocolVersion": "2026-07-28",
"io.modelcontextprotocol/clientInfo": {
"name": "example-client",
"version": "1.0.0"
},
"io.modelcontextprotocol/clientCapabilities": {
"elicitation": {}
}
}
}
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "weather_current",
"arguments": {
"location": "San Francisco",
"units": "imperial"
},
"_meta": {
"io.modelcontextprotocol/protocolVersion": "2026-07-28",
"io.modelcontextprotocol/clientInfo": {
"name": "example-client",
"version": "1.0.0"
},
"io.modelcontextprotocol/clientCapabilities": {
"elicitation": {}
}
}
}
}
O tutorial oficial para construir um server, em Python, começa com o recorte abaixo, também da documentação oficial, em https://modelcontextprotocol.io/docs/2026-07-28/develop/build-server. Copio o bloco como a própria página o publica, inclusive o cliente HTTP que ela nomeia.
from typing import Any
import httpx2
from mcp.server import MCPServer
# Initialize MCPServer
mcp = MCPServer("weather")
# Constants
NWS_API_BASE = "https://api.weather.gov"
USER_AGENT = "weather-app/1.0"
O encaixe que o A2A descreve
A spec do MCP não define o A2A. O encaixe oficial aparece no próprio A2A: o MCP liga um agente a ferramentas, APIs e dados; o A2A liga um agente a outros agentes; os dois se usam juntos. MCP, A2A e AGENTS.md aparecem como projetos sob a mesma AAIF.
O detalhe de cada mensagem está na especificação da revisão Current. Esta página situa o contrato; o mapa dos protocolos está no índice.
Fontes
- Especificação do MCP, revisão 2026-07-28
- Página de versionamento
- Visão geral de arquitetura
- Introdução oficial
- Tutorial para construir um server
- Página de SDKs
- Changelog da revisão 2026-07-28
- Projeto MCP na AAIF
- Nota da Linux Foundation sobre a formação da AAIF
- Anúncio da Anthropic
- Tópico A2A and MCP