Dê a qualquer site uma interface WebMCP

Hoje estamos lançando uma prévia para desenvolvedores do WebMCP na Cloudflare. Ative-o e os agentes de navegador podem começar a trabalhar com seu site, sem código e sem nada mudado em sua origem. A Cloudflare adiciona uma pequena ponte às suas páginas, que registra um conjunto de ferramentas para o agente de um visitante usar.

A web foi construída com a suposição de que há uma pessoa do outro lado: alguém para ler a página, clicar em botões e preencher formulários. Mas agora, cada vez mais visitas vêm de agentes de IA, em uma Internet feita para humanos. A abordagem usual tem sido crawlers, que copiam conteúdo de volta para um servidor e, muitas vezes, não dão ao site original nenhum tráfego e pouco do crédito. Existe uma maneira melhor, e não envolve scraping.

WebMCP é um novo padrão de navegador, enviado experimentalmente no Chrome 146, que aparece na página como document.modelContext. Um site pode optar por expor um conjunto de ferramentas para agentes executando no navegador, significando que os agentes não precisam mais adivinhar seu caminho através de uma página construída para humanos. Isso permite que os agentes tenham uma experiência de navegação diferente da do usuário e usem tokens em tarefas, não na navegação. O detalhe: o site precisa implementá-lo.

A Cloudflare tem trabalhado em ambas as extremidades disso. BrowserRun, nosso navegador remoto, já adicionou suporte ao WebMCP, para que um agente possa descobrir e chamar as ferramentas que um site expõe. Cloudflare Radar em breve oferecerá suas próprias ferramentas WebMCP. Esta prévia é sobre o outro lado: uma maneira de dar a qualquer site na Cloudflare essas ferramentas com um único interruptor e sem código.

Uma prévia para desenvolvedores do WebMCP na Cloudflare

Implementar o WebMCP manualmente é um pequeno projeto: projetar as ferramentas a serem expostas, conectá-las à sua interface e mantê-las funcionando à medida que o padrão evolui. Queríamos que fosse mais simples do que isso: apenas alternar uma configuração para habilitar as ferramentas.

Essas ferramentas vêm em pacotes — grupos de ferramentas relacionadas que podem ser ativadas juntas. Elas são construídas para crescer: à medida que adicionamos pacotes, um site pode optar por mais apenas ativando-os, sem necessidade de reimplantação. Estamos incluindo dois pacotes de ferramentas nesta prévia para desenvolvedores, que funcionam totalmente no navegador.

O que isso faz e como funciona

Nossa implementação compreende duas partes, ambas na frente de sua origem. Nenhuma toca no código do seu site e ambas funcionam da mesma maneira, seja seu site estático ou um aplicativo de página única.

Primeiro, uma injeção na borda. Quando seu site tem o WebMCP ativado no seu Painel da Cloudflare, usamos o HTMLRewriter para adicionar uma linha a cada resposta HTML: uma pequena referência a um script de ponte que também servimos. Tanto a tag quanto o script que ele carrega vêm da borda, da mesma origem, então nada mais sobre a página muda:

O atributo data-packs é a lista de pacotes a serem ativados. Se você tiver um servidor Model Context Protocol (MCP) existente, o data-mcp-url aponta para seu próprio servidor MCP (default para a mesma origem /mcp).

Segundo, a ponte. Isso roda na página e encontra a superfície WebMCP. Se o navegador não tiver uma, ele retorna e não faz nada, então a página se comporta exatamente como antes.

A partir daí, a ponte compõe os pacotes nomeados em data-packs em uma lista de ferramentas e registra cada um com .registerTool. Um pacote é apenas um conjunto de descritores de ferramentas MCP e seus manipuladores. Pacotes estáticos, como Credenciais de Conteúdo, declaram suas ferramentas antecipadamente. Um pacote dinâmico, como o pacote Site MCP Server, descobre suas ferramentas na inicialização antes de registrar qualquer coisa.

Nesta prévia, cada ferramenta roda totalmente no navegador do visitante. Não há ida e volta para um servidor nosso. O pacote de Credenciais de Conteúdo busca uma imagem e analisa seus primeiros kilobytes de metadados de proveniência de conteúdo localmente. O pacote Site MCP Server se comunica diretamente com o endpoint do seu servidor MCP a partir da página, na origem do visitante e com sua sessão existente.

O código da ponte é servido por um trabalhador rodando na borda. Isso nos deixa espaço para expandir a oferta — pacotes futuros poderão chamar esse trabalhador para tarefas que a página não pode fazer sozinha, como resumir um sitemap com Workers AI ou consultar um índice de busca de IA.

Para um agente, todas essas são ferramentas MCP comuns. Usamos os próprios tipos Tool e CallToolResult do Model Context Protocol, então um agente que já se comunica com servidores MCP pode controlar uma página sem nada especial adicionado. O navegador é apenas mais um lugar onde o MCP roda. O exemplo abaixo mostra como a ponte transforma uma de suas próprias ferramentas MCP em uma ferramenta que o agente do visitante pode chamar.

Verificando metadados de conteúdo

Também estamos desenvolvendo pacotes para ler diferentes tipos de metadados. Por exemplo, credenciais para participantes do programa C2PA podem ser recuperadas usando o pacote de Credenciais de Conteúdo. scan_images_c2pa varre cada imagem e retorna um breve resumo de cada uma:

Para uma análise mais detalhada, inspect_image_c2pa decodifica o manifesto completo de uma imagem: seu histórico de edições, o autor declarado e o certificado de assinatura. É um leitor TypeScript simples que toca apenas alguns kilobytes dos metadados na frente da imagem, não a imagem em si. Por enquanto, ele lê e relata a credencial, em vez de verificá-la criptograficamente: cada resultado carrega signatureVerified: false, para que um agente não confunda uma reivindicação decodificada com uma verificada.

Experimente

Comece com o WebMCP indo para Agent Readiness > Labs no Painel da Cloudflare. Aqui você pode ativar o WebMCP para um domínio e escolher quais pacotes adicionar: tanto Credenciais de Conteúdo quanto Site MCP Server estão ativados por padrão, e mais pacotes aparecerão aqui à medida que os enviarmos. Essa é toda a configuração. Não há nada para implantar e nada para mudar em sua origem, e o próximo HTML que seu site enviar incluirá a ponte.

Para confirmar que está ativo, peça ao seu site qualquer página HTML e procure a linha que a Cloudflare injetou:

Você não precisa do seu próprio agente para ver as ferramentas funcionando. Aponte BrowserRun, o navegador remoto da Cloudflare, para sua URL, e ele descobrirá e chamará as ferramentas que seus pacotes registraram, exatamente como o faria o agente de um visitante. Esse é todo o ciclo: o BrowserRun dá aos agentes um navegador para agir, esta prévia dá ao seu site as ferramentas para serem acionadas, e eles se encontram usando o padrão aberto. As ferramentas se comportam da mesma maneira, seja o navegador em um laptop de alguém ou rodando sem cabeça na nuvem.

Por que construímos isso

Nosso trabalho é ajudar a tornar a Internet melhor, e à medida que a Internet muda, precisamos fornecer aos proprietários de domínios ferramentas que permitam que novos visitantes, agentes de IA, interajam sem uma reconstrução completa. É um passo em direção a uma web que ainda pode prosperar quando os visitantes não são sempre humanos.

Esta é uma prévia para desenvolvedores, e queremos seu feedback. Ative-o, experimente em seu próprio site e nos diga como foi no Discord dos Desenvolvedores da Cloudflare ou no fórum da Comunidade.