WebMCP: Transformando um Conversor de Arquivos em uma Ferramenta que Agentes de IA Podem Chamar - WebConverter

Nota do editor (2026-05). O Chrome 150 descontinuou o navigator.modelContext em favor do document.modelContext (conforme o PR #184 da especificação WebMCP, já que as ferramentas passam a ter escopo por Document). Os exemplos deste post usam o padrão de detecção de recurso compatível com versões futuras, recomendado pela equipe do Chrome:

const modelContext = document.modelContext || navigator.modelContext;
if (modelContext) {
  // Registrar ferramentas...
}

A própria integração do WebConverter usa exatamente esse fallback, então continua funcionando em navegadores que ainda trazem o identificador antigo.

O Model Context Protocol (MCP) padronizou como agentes de IA chamam ferramentas. O WebMCP traz essa ideia para a web aberta: em vez de um processo de servidor separado, o próprio site expõe ferramentas por meio de uma API do navegador, o document.modelContext, que um agente dentro do navegador pode descobrir e invocar. Acabamos de lançar uma integração WebMCP para o WebConverter, transformando cada conversão que o site pode fazer em uma ferramenta que o agente pode chamar e que ainda roda 100% localmente no seu navegador.

O que é o WebMCP?

O WebMCP é um rascunho de padrão web do W3C Web Machine Learning Community Group, projetado por engenheiros do Google e da Microsoft. Ele define um único ponto de entrada novo no objeto navigator do navegador: document.modelContext. Uma página chama registerTool() para publicar uma ferramenta nomeada, com uma descrição e um JSON Schema para suas entradas, e fornece uma função execute() que o navegador (ou um agente agindo por meio dele) invoca quando a ferramenta é chamada.

A diferença principal em relação ao MCP clássico: não há transporte separado, nem servidor localhost, nem token para gerenciar. A ferramenta é o próprio JavaScript da página. Para um conversor que coloca a privacidade em primeiro lugar, isso é decisivo: o agente ganha a capacidade, mas seu arquivo nunca sai da aba.

Por que um "MCP de conversão de arquivos" importa

Peça a um assistente de IA para converter um arquivo hoje e ele geralmente tem três opções ruins: enviar seu arquivo para uma API de terceiros, executar uma ferramenta no servidor que acessa seus dados ou recusar. Um conversor movido a WebMCP muda a conta: sem envio, sem chave de API, sem limite de requisições, sem custo e com carbono quase zero, porque o ciclo de envio, processamento e download nunca acontece.

As ferramentas que expusemos

O WebConverter registra duas ferramentas por meio do document.modelContext: list_supported_formats, que retorna os formatos de entrada legíveis e os formatos de saída graváveis para que um agente possa planejar uma conversão válida; e convert_image, que recebe um arquivo em base64 mais um formato de destino e retorna o arquivo convertido em base64 e uma URL data:. Como as ferramentas envolvem o pipeline de Worker existente, tudo o que o conversor de imagens pode fazer, um agente agora também pode.

Como construímos

A integração é um único script pequeno e adiado, carregado em todo o site. Ele define os descritores das ferramentas, registra-os com a API da especificação quando o document.modelContext existe, e também expõe um pequeno registro programático que espelha as mesmas definições, uma costura de automação documentada para que as ferramentas sejam testáveis e utilizáveis mesmo em navegadores que ainda não lançaram a API nativa. Tudo é envolvido de modo que um Worker ausente ou um WASM bloqueado nunca lance um erro na página hospedeira, e acrescenta apenas alguns kilobytes, sem nenhum WebAssembly novo.

Uma nota sobre confiança e segurança

Ferramentas que agentes podem chamar merecem escrutínio. As ferramentas do WebConverter são somente leitura por design: elas recebem bytes e retornam bytes. Nunca gravam em disco, nunca fazem requisições de rede, nunca leem outras abas e nunca persistem nada. Um agente que chama convert_image tem exatamente a mesma capacidade que um humano clicando em "converter" tem, e nem um bit a mais.

Experimente

Abra a página WebMCP para uma demonstração ao vivo que executa a ferramenta convert_image e uma referência completa dos schemas das ferramentas. Se você está construindo um agente, é assim que se parece uma ferramenta de conversão de arquivos honesta, privada e sem custo, e é apenas uma página web.