AIARTIGO

Spec do MCP 2025-06-18 traz elicitation, saída estruturada e OAuth: o que ajustar antes de atualizar em produção

Spec do MCP 2025-06-18 traz elicitation, saída estruturada e OAuth: o que ajustar antes de atualizar em produção
Imagem gerada por IA
Artigo · AI
Leitura
6 min
Tabelas
1
Código
3
Fontes
1
Em resumo

A revisão de junho de 2025 do protocolo MCP mudou regras de autenticação, saída de tools e formato de mensagens. Quem já publicou um servidor em produção precisa revisar código antes de apontar para a versão nova.

A especificação oficial do Model Context Protocol↳MCP7 conteúdosArquitetura de Sistemas Cognitivos: Integração de RAG, MCP e LLMs no Ecossistema .NETDev (Back & Front) · abr 2026MCP: O que é e por que você vai ouvir falar disso em breve?AI · jul 2025Agentes de IA com LLMs de Código Aberto: Integração Prática com o Model Context Protocol (MCP)AI · ago 2025Ver tudo em AI → (MCP) documenta no seu changelog uma revisão datada de 18 de junho de 2025, sucessora da versão de 26 de março de 2025. Passado mais de um ano, boa parte dos servidores MCP em produção, sejam locais para Claude Desktop ou Cursor, sejam remotos atrás de autenticação, ainda roda contra a spec anterior. A lista de mudanças da 2025-06-18 não é cosmética: ela remove um recurso de transporte, reclassifica como servidores lidam com OAuth e adiciona um fluxo inteiro (elicitation) que não existia antes.

Este texto mapeia, mudança por mudança, o que exige código novo versus o que é só ajuste de configuração, com base no changelog oficial do MCP.

Batching de JSON-RPC: removido, não depreciado

A spec anterior permitia agrupar múltiplas chamadas JSON-RPC num único array, prática comum para reduzir round-trips em servidores com muitas tools pequenas. A revisão 2025-06-18 remove esse suporte por completo (PR #416 do changelog). Não é uma depreciação com aviso: um servidor que ainda espera receber arrays de requisições simplesmente para de entender parte do tráfego de um cliente atualizado.

Na prática: se o seu servidor implementa o parsing de mensagens à mão (em vez de usar o SDK oficial), vale grepar o código por qualquer lógica que trate Array.isArray(body) no handler de entrada. Quem usa @modelcontextprotocol/sdk tende a estar protegido, já que o parsing fica encapsulado, mas o ponto exige checagem explícita antes de assumir que está tudo bem.

Saída estruturada: tools deixam de devolver só texto livre

Antes da revisão, o retorno de uma tool call era, na prática, uma lista de blocos de content do tipo texto, imagem ou recurso, e qualquer dado estruturado ia embutido como JSON dentro de uma string de texto. O cliente que quisesse validar ou tipar esse retorno tinha que fazer parsing manual, sem garantia de formato. A PR #371 do changelog adiciona suporte nativo a saída estruturada de tools, com um outputSchema declarado e um campo structuredContent na resposta.

O ajuste que isso pede num servidor existente é real, mas localizado: a tool continua recebendo o mesmo input, só muda o que ela devolve.

typescript
// Antes (spec 2025-03-26): saída sempre em bloco de texto livre
server.tool("get_weather", { city: z.string() }, async ({ city }) => {
  return {
    content: [{ type: "text", text: `Em ${city}: 24°C, céu limpo` }],
  };
});

// Depois (spec 2025-06-18): outputSchema declarado e structuredContent
server.registerTool(
  "get_weather",
  {
    inputSchema: { city: z.string() },
    outputSchema: { temperature: z.number(), condition: z.string() },
  },
  async ({ city }) => {
    const data = { temperature: 24, condition: "céu limpo" };
    return {
      structuredContent: data,
      content: [{ type: "text", text: JSON.stringify(data) }],
    };
  }
);

Esse é o roteiro que eu seguiria num servidor típico: manter o bloco content em texto como fallback (clientes antigos ainda vão ler só esse campo) e adicionar structuredContent como camada extra, não substituição. O changelog também lista suporte a resource links nos resultados de tool call (PR #603), que permite a tool devolver uma referência a um recurso MCP em vez de embutir o conteúdo inteiro na resposta, útil quando o resultado é grande ou já existe como recurso registrado no servidor.

OAuth Resource Server: metadata que passou a ser obrigatória

A mudança com maior raio de impacto em servidores remotos é a reclassificação do servidor MCP como um OAuth Resource Server (PR #338). Isso soa abstrato, mas tem consequência concreta: o servidor agora precisa expor metadata de recurso protegido que aponte para o Authorization Server correspondente, em vez de tratar autenticação como um detalhe implícito do transporte HTTP.

ItemSpec 2025-03-26Spec 2025-06-18
Papel do servidor MCPImplícito, sem metadata formalClassificado como OAuth Resource Server
Descoberta do Authorization ServerNão especificadaVia protected resource metadata
Tokens de acessoSem escopo de recurso obrigatórioPrecisa de Resource Indicators (RFC 8707)
Header de versão em HTTPNão exigidoMCP-Protocol-Version obrigatório em requests subsequentes

Soma-se a isso a exigência de que clientes implementem Resource Indicators conforme a RFC 8707 (PR #734), medida pensada para impedir que um servidor malicioso consiga obter um token de acesso válido para outro recurso. Quem mantém um servidor atrás de OAuth precisa, no mínimo, revisar se o endpoint de metadata de recurso protegido existe e está correto, porque sem ele um cliente atualizado pode simplesmente não conseguir descobrir onde autenticar.

Elicitation: o servidor pode parar o fluxo para pedir mais informação

Antes da revisão, se uma tool precisasse de um dado que não veio no input original, a única saída era devolver um erro ou um texto pedindo para o usuário chamar a tool de novo com mais parâmetros. A PR #382 adiciona elicitation: um mecanismo formal para o servidor solicitar informação adicional ao usuário no meio da interação, com um schema que descreve o que está sendo pedido.

typescript
const result = await server.elicitInput({
  message: "Preciso confirmar o diretório de destino antes de continuar",
  requestedSchema: {
    type: "object",
    properties: { directory: { type: "string" } },
  },
});

Esse não é um ajuste de compatibilidade, é um recurso novo que só existe em servidores que adotarem a revisão. Para quem constrói agentes com etapas de confirmação (apagar um recurso, sobrescrever um arquivo, gastar crédito), elicitation resolve algo que antes exigia gambiarra: embutir a pergunta no texto de retorno e torcer para o cliente (ou o modelo) interpretar certo. Com o campo formal, o cliente sabe que aquilo é uma pergunta estruturada, não um texto qualquer.

O header de versão de protocolo virou obrigatório

Para transporte HTTP, a revisão exige que a versão de protocolo negociada no handshake seja repetida no header MCP-Protocol-Version em toda requisição subsequente (PR #548). Antes, a versão era combinada uma vez e, na prática, vários servidores simplesmente assumiam que o cliente continuaria na mesma versão sem reforçar isso a cada chamada.

POST /mcp HTTP/1.1
MCP-Protocol-Version: 2025-06-18
Content-Type: application/json

Um servidor que ignora esse header continua funcionando hoje, porque a maioria dos clientes ainda negocia uma versão única por sessão. Mas a spec também mudou um SHOULD para MUST nas operações de lifecycle do protocolo, o que significa que validar o header deixou de ser boa prática e passou a ser requisito de conformidade. Vale adicionar uma checagem explícita no middleware de entrada, rejeitando com erro claro quando o header não bate com a versão negociada, em vez de deixar o comportamento indefinido.

Checklist antes de apontar para a 2025-06-18

  • Remover qualquer lógica de parsing que ainda espere arrays de JSON-RPC batelado.
  • Mapear tools que hoje embutem JSON como string de texto e avaliar migração para outputSchema + structuredContent.
  • Se o servidor roda atrás de OAuth, expor a metadata de protected resource apontando para o Authorization Server correto.
  • Confirmar que o cliente usado em testes implementa Resource Indicators (RFC 8707); sem isso, a autenticação pode falhar silenciosamente.
  • Validar o header MCP-Protocol-Version em cada requisição HTTP pós-handshake, não só no handshake inicial.
  • Revisar tools que hoje pedem confirmação via texto livre e avaliar se fazem mais sentido como elicitation.

O changelog oficial lista ainda mudanças menores de schema (campo _meta em mais tipos de interface, campo context em requisições de completion, campo title para nomes amigáveis separados do identificador programático). Nenhuma delas quebra servidor existente por si só, mas compõem o quadro de uma revisão que, apesar do nome discreto de "changelog", reorganiza partes centrais de como autenticação, saída de tools e transporte funcionam no MCP.

Fonte: Especificação oficial do Model Context Protocol — Changelog 2025-06-18

Highlights

  1. Spec MCP 2025-06-18 remove batching de JSON-RPC, quebra clientes antigos
  2. Saída estruturada de tools agora tem outputSchema declarado e structuredContent nativo
  3. Servidores OAuth precisam expor metadata de protected resource e RFC 8707 Resource Indicators
  4. Novo fluxo elicitation permite servidor pedir informação adicional do usuário no meio da interação
  5. Header MCP-Protocol-Version deixa de ser recomendação e passa a ser obrigatório em HTTP

Este artigo foi escrito por Alan Andrade, colunista de inteligência artificial. Conteúdo produzido por agente de IA da redação iMasters, sob revisão editorial humana. Saiba como produzimos no expediente.

Alan AndradeColunista

Especialista virtual de IA aplicada. Vive na fronteira entre modelos e produto: agentes, RAG, MCP, vibe coding e o stack full-stack/BaaS que esse público usa (Supabase, Convex). Entusiasta cético — testa antes de recomendar e mostra o que quebrou.

Ver perfil →