MCP Roots, Sampling e Logging: caminhos de migração após a depreciação em 2026-07-28

O que é

Situação em 25 de outubro de 2026. A revisão 2026-07-28 marca Roots, Sampling e Logging como obsoletos. Antes de remover código de compatibilidade, conferir novamente os avisos individuais, o registro de funcionalidades obsoletas e a política de ciclo de vida. O registro indica que a remoção poderá ocorrer, no mínimo, na primeira revisão lançada em ou após 2027-07-28. Isso permite uma mudança futura na especificação, não define uma data de desativação automática.

As funcionalidades obsoletas permanecem na especificação. Recomenda-se que novas implementações evitem adotá-las e que as existentes migrem. Os cronogramas de remoção dos SDKs são definidos separadamente. A política geral também permite um processo acelerado documentado para riscos de segurança que atendam aos critérios, portanto a janela normal de doze meses não é uma promessa incondicional para todas as situações.

Por que importa

As três funcionalidades têm finalidades diferentes. Roots comunica locais relevantes do sistema de arquivos, Sampling delega uma solicitação ao modelo para o cliente e Logging entrega notificações de log do protocolo. A substituição pode transferir responsabilidades entre cliente, servidor e operador. Uma migração que apenas remove os indicadores de capacidade pode deixar tarefas necessárias sem implementação.

Roots tem caráter explicitamente informativo: o MCP não impõe o confinamento do acesso ao sistema de arquivos. Atualmente, Sampling dá ao cliente controle sobre o acesso ao modelo e as permissões. Logging do protocolo é distinto dos logs operacionais do servidor. Preservar essas distinções ao escolher substituições.

Como aplicar

• Substituir Roots por contexto explícito. As opções documentadas são parâmetros de ferramentas, URIs de recursos ou configurações do servidor que descrevam diretórios e arquivos. Validar caminhos e permissões no componente que os acessa. Preservar o consentimento do usuário e os controles de acesso adequados; o fornecimento de um diretório não comprova que o chamador tenha permissão para lê-lo. Enquanto Roots for mantido nesta revisão, anunciar a capacidade em cada requisição e trocar mensagens roots/list pelo mecanismo de solicitação de entrada.
• Substituir Sampling por integração direta com o provedor. A especificação recomenda integrar diretamente com APIs de provedores de modelos de linguagem. Tratar isso como uma mudança de responsabilidade, não como simples troca de nome: documentar qual componente obtém acesso ao modelo e quais dados envia. A interface antiga de Sampling oferecia controle pelo cliente e recomendava revisão humana. Preservar uma revisão equivalente onde a aplicação a exigir e testar o fluxo de recusa. Durante a transição, declarar as capacidades de Sampling em cada requisição e evitar as opções obsoletas de contexto entre servidores.
• Direcionar os logs operacionais a um destino adequado. Os caminhos documentados são stderr para transportes stdio e OpenTelemetry para observabilidade estruturada. Manter segredos e informações pessoais fora das mensagens de log e controlar o acesso aos logs coletados. Se a compatibilidade ainda exigir Logging do protocolo, o servidor declara logging; os clientes solicitam um nível com io.modelcontextprotocol/logLevel em _meta.
• Testar os logs restritos à requisição. Um servidor não deve emitir notifications/message quando a requisição omitir o nível. As mensagens permitidas pertencem ao fluxo de resposta dessa requisição, nunca ao fluxo de assinatura. Verificar se a seleção de verbosidade de um cliente não pode afetar a requisição de outro.
• Desativar cada dependência separadamente. Como procedimento de implantação proposto, inventariar os consumidores, introduzir a substituição, verificar o mesmo fluxo de trabalho permitido e só então deixar de anunciar a capacidade obsoleta. Guardar evidências de quais clientes ainda precisam dela.

Armadilhas

A integração direta com modelos não herda automaticamente a interface de consentimento do cliente anterior. Um novo destino de logs não preserva automaticamente o mascaramento de dados. Um parâmetro de caminho não cria uma sandbox. A depreciação é motivo para planejar essas mudanças com cuidado, não uma permissão para enfraquecer seus controles.