WebMCP: Um novo contrato entre agentes de IA e websites

Você provavelmente já ouviu falar do MCP da Anthropic, o protocolo que conecta a IA e nossos dados. Agora, o Google está levando essa ideia um passo adiante, trazendo-a diretamente para o navegador. Conheça WebMCP.

Se você já viu um agente de IA tentando interagir com um site, provavelmente viu ele raspando todo o DOM, baixando um dump de toda a página HTML, tirando capturas de tela e só depois entendendo o que pode fazer. Essa operação leva tempo e é um desperdício de tokens preciosos.

WebMCP propõe uma nova maneira para os desenvolvedores definirem uma interface pública para seus sites que os agentes de IA podem descobrir e usar para interagir com eles. Isso é definitivamente mais rápido e barato.

Eu construí uma pequena demonstração de carrinho de compras para explorar as APIs propostas. Você pode encontrá-la aqui.

O que é WebMCP, exatamente?

A ideia central é que um site pode publicar um contrato estruturado (um conjunto de ferramentas nomeadas com esquemas explícitos) que qualquer agente de IA pode descobrir e usar de forma confiável. Em vez de o agente reverter a engenharia da sua interface, seu site simplesmente diz: "Aqui estão as coisas que você pode fazer, e aqui está exatamente como fazê-las."

A especificação define três pilares:

• Descoberta: uma maneira padrão para os agentes consultarem quais ferramentas uma página expõe
• Esquemas: definições explícitas de entrada/saída
• Estado: um entendimento compartilhado do que está atualmente disponível na página

Pense nisso como um servidor MCP, mas embutido no navegador e ligado diretamente ao DOM ao vivo da página.

⚠️ Disponibilidade

WebMCP é um padrão proposto experimental por trás de uma flag do Chrome. Se você quiser brincar com isso, você precisa:

• Chrome: Versão 146.0.7672.0 ou superior
• Flags: A flag "WebMCP para testes" deve estar habilitada (chrome://flags/#enable-webmcp-testing)

ℹ️ Para inspecionar funções registradas, executá-las manualmente ou testá-las com um agente, instale a extensão Model Context Tool Inspector do Chrome.

Duas APIs, duas filosofias

WebMCP oferece duas maneiras complementares de expor ferramentas.

A API Imperativa

A API Imperativa é uma abordagem focada em JavaScript. Você registra ferramentas programaticamente via window.navigator.modelContext, dando a cada uma um nome, uma descrição, um esquema JSON para suas entradas e uma função execute que é executada quando um agente a chama.

window.navigator.modelContext.registerTool({
  name: "addToCart",
  description: "Adicionar um produto ao carrinho de compras",
  inputSchema: {
    type: "object",
    properties: {
      product_id: { type: "string" },
      quantity:   { type: "number" }
    },
    required: ["product_id"]
  },
  execute: ({ product_id, quantity }) => {
    // sua lógica aqui
    return { content: [{ type: "text", text: `Adicionado ${quantity}x ${product_id}` }] };
  }
});

registerTool registra uma única ferramenta sem tocar nas outras. Quando você precisa registrar várias ferramentas de uma vez, provideContext é a chamada certa:

window.navigator.modelContext.provideContext({
  tools: [
    {
      name: "getCart",
      // ...
    },
    // ...
  ],
});

‼️ Cuidado: provideContext substitui TODAS as ferramentas registradas — incluindo as declarativas.

Esse é um detalhe sutil, mas importante. Quando você chama provideContext, não apenas adiciona ferramentas, mas apaga todo o conjunto existente e o substitui. Isso inclui quaisquer ferramentas que o navegador já registrou a partir de seus formulários HTML declarativos.

Já existe uma discussão aberta sobre essa função e parece que os desenvolvedores não estão muito felizes com essa API.

Se você precisar remover uma ferramenta específica a qualquer momento, pode usar unregisterTool:

window.navigator.modelContext.unregisterTool("addTodo");

A De