WebMCP: fornecendo um 'catálogo de ferramentas' para agentes de IA

Menos cliques às cegas, mais ações confiáveis: uma abordagem padrão para tornar as interações web explícitas e seguras.

Os agentes de IA que "usam a web" (preenchem formulários, buscam botões, completam um checkout) frequentemente tropeçam por um motivo simples: a ação concreta na interface é ambígua. Um ser humano reconhece rapidamente um botão "Comprar", entende que um campo é "CEP", intui quais etapas são obrigatórias. Um agente, por outro lado, tende a estimar onde clicar e o que inserir, baseando-se em pistas visuais ou textuais que podem mudar continuamente.

Em outras palavras, o problema não é apenas "entender" a intenção: é executar a ação correta de forma robusta.

Por que hoje os agentes erram com tanta frequência

Grande parte das interfaces web modernas não expõe de forma explícita um mapa das ações possíveis. Mesmo quando usamos boas práticas (rótulos, aria-*), o agente pode ainda se deparar com:

• mais elementos semelhantes (divs "semelhantes a botões", CTAs duplicadas, variações responsivas);
• fluxos multi-etapas com validações e estados (desabilitado/carregando/erro);
• conteúdos dinâmicos (modal, drawer, componentes montados tardiamente);
• micro-interações não óbvias (autocompletamentos, máscaras, seletores).

O resultado é um comportamento "às cegas": tentativas, fallback, repetições e, frequentemente, etapas quebradas. Com um custo real: tempo, tokens, erros e frustração.

A ideia do WebMCP: um "diretório" de ferramentas acionáveis

WebMCP (proposta de padrão) introduz um conceito pragmático: permitir que os sites exponham aos agentes um diretório rotulado de "ferramentas" disponíveis na página.

Em vez de forçar o agente a inferir que:

• aquele campo é "endereço de entrega",
• aquele botão envia o pedido,
• aquella ação requer certos parâmetros,

…a página pode declarar isso de forma explícita. Assim, o agente não navega "tateando": já sabe quais ações são suportadas e como invocá-las.

Duas abordagens: declarativa e imperativa

WebMCP propõe duas modalidades complementares para descrever as ferramentas.

1) API declarativa: transformar formulários HTML em ferramentas

A abordagem mais imediata é a declarativa: começar com os formulários padrão e adicionar um atributo (por exemplo, um nome da ferramenta) que os torne registráveis como ferramentas.

É uma ideia poderosa porque:

• aproveita primitivas web consolidadas (formulários, campos de entrada, envio);
• reduz a necessidade de "wrappers específicos de IA";
• incentiva interfaces mais semânticas e menos frágeis.

Na prática, um formulário não é apenas "um pedaço de interface": torna-se uma ação invocável com nome e esquema previsível.

2) API imperativa: ferramentas personalizadas via JavaScript

Nem tudo é um formulário: existem calendários, configuradores, carrinhos complexos, fluxos guiados. Aqui entra a API imperativa: a partir do código, você pode registrar ferramentas personalizadas (por exemplo, com uma função como registerTool) e definir exatamente o que elas fazem e quais parâmetros aceitam.

Isso é particularmente útil quando:

• a ação requer mais etapas internas, mas você quer expô-la como "uma única operação";
• você precisa controlar validações, permissões ou limitação de taxa;
• você quer oferecer um contrato estável mesmo que a interface mude.

Um exemplo concreto: checkout sem tentativas em vão

Imagine um checkout de e-commerce. Sem um diretório de ferramentas, um agente poderia:

• clicar no botão errado (ou em um CTA duplicado);
• preencher campos na ordem errada;
• não entender por que o envio está desabilitado;
• se perder em uma modal de consentimento.

Com o WebMCP, a página pode expor ferramentas do tipo:

• inserir_dados_entrega (parâmetros: nome, endereço, cep, cidade…)
• aplicar_codigo_desconto (parâmetros: código)
• enviar_pedido (parâmetros: confirmação)

O agente não precisa "descobrir" a interface: invoca ferramentas conhecidas, com entradas explícitas, e o site gerencia a execução de forma controlada.

Implicações para quem faz frontend

Se essa direção ganhar força, mudará a forma como pensamos na integração com agentes:

• Projeto para ações: não apenas componentes visuais, mas operações com nome, parâmetros e resultados.
• Estabilidade: uma ferramenta pode permanecer inalterada mesmo que você redesenhe a interface.
• Acessibilidade e semântica: a abordagem declarativa valoriza HTML "verdadeiro" (formulários bem estruturados) em relação a interações puramente decorativas.
• Segurança: expor ferramentas explícitas pode reduzir comportamentos imprevisíveis; a ação passa por um contrato conhecido em vez de cliques arbitrários.

Estado atual: experimentação no Chrome

WebMCP está disponível como teste de origem para testes no Chrome (indicado uma versão 104.9 no material de referência). Isso significa que é pensado para experimentações controladas: útil para protótipos, avaliações de DX e primeiros casos de uso, sem considerá-lo "definitivo".

Síntese

WebMCP tenta resolver o ponto fraco dos agentes na web: o ato prático de interagir com uma interface complexa. A ideia de expor um diretório de ferramentas — através de uma API declarativa para formulários e uma imperativa para ferramentas personalizadas — muda o paradigma de "clique e espere" para "invocar uma ação explícita".

Se você constrói interfaces com fluxos críticos (checkout, onboarding, backoffice), vale a pena observar essa evolução: pode se tornar a maneira mais limpa de tornar seus caminhos mais confiáveis, automatizáveis e resilientes a mudanças na interface.

Artigo original: https://frontendfacile.it/blog/webmcp-dare-alle-pagine-web-un-catalogo-di-strumenti-per-agenti-ai