WebMCP: Prepare Seu Site para Agentes de IA Sem Screen Scraping

Agentes de IA já podem operar websites lendo texto, inspecionando árvores de acessibilidade e clicando em controles visíveis. Isso funciona, mas pede ao agente que faça engenharia reversa de uma interface projetada para humanos.

WebMCP propõe um modelo diferente: um site pode expor ações suportadas como ferramentas estruturadas. Em vez de adivinhar qual botão completa uma reserva, um agente pode descobrir uma ferramenta bookSlot com uma descrição, entradas tipadas e um resultado definido.

WebMCP é atualmente uma capacidade emergente do Chrome e uma tecnologia de teste de origem, não um padrão de produção entre navegadores. Isso a torna útil para estudar e experimentar, mas ainda é cedo para usá-la como o único caminho para um fluxo de trabalho importante.

Por que a automação baseada em tela é frágil

Um humano pode olhar para uma página e entender que “Continuar” avança um checkout. Um agente tem que inferir esse significado a partir do texto ao redor e do estado da interface.

Essa abordagem pode falhar quando:

• os rótulos dos botões mudam
• um layout responsivo move os controles
• um modal cobre o próximo passo
• a página é renderizada de forma diferente para outra conta
• um teste A/B muda a interface
• uma ação tem um efeito colateral importante que não é óbvio a partir do rótulo

Uma ferramenta estruturada dá ao navegador e ao agente um contrato mais claro.

O modelo básico do WebMCP

Um site registra ferramentas. Cada ferramenta tem um nome, descrição, esquema de entrada e implementação. Um navegador compatível pode expor essas ferramentas a um agente, e o agente fornece argumentos estruturados.

Para um formulário de consulta, o fluxo conceitual se parece com isto:

1. O site registra bookSlot.
2. A ferramenta descreve os campos necessários, como data, hora, nome e e-mail.
3. O navegador apresenta a ferramenta a um agente dentro do contexto de origem e permissão da página.
4. O agente solicita ou confirma as informações necessárias.
5. O próprio código do site realiza a reserva.

O agente não precisa adivinhar o caminho DOM para um botão de envio.

Ferramentas declarativas para formulários existentes

A API declarativa é projetada para formulários HTML padrão. Um formulário pode ser anotado com um nome de ferramenta e descrição, enquanto seus controles se tornam parâmetros da ferramenta.

<form
  action="/consultations"
  method="post"
  toolname="book_consultation"
  tooldescription="Reserve um slot de consulta de 30 minutos"
>
  <label>
    Data
    <input name="date" type="date" required>
  </label>

  <label>
    E-mail
    <input name="email" type="email" required>
  </label>

  <button type="submit">Reservar</button>
</form>

A ideia importante é a melhoria progressiva. O formulário deve permanecer um formulário real e utilizável para pessoas e navegadores que não suportam WebMCP.

Ferramentas imperativas para ações de aplicação

Algumas ações não se mapeiam facilmente para um formulário. A API imperativa permite que o código da aplicação registre uma ferramenta com um esquema JSON e uma função de execução.

document.modelContext.registerTool({
  name: "checkOrderStatus",
  description: "Retornar o status mais recente de um pedido pertencente ao usuário logado",
  inputSchema: {
    type: "object",
    properties: {
      orderId: { type: "string" }
    },
    required: ["orderId"]
  },
  execute: async ({ orderId }) => {
    return await api.getOrderStatus(orderId);
  }
});

A ferramenta deve chamar a mesma camada de aplicação confiável usada pela interface normal. WebMCP é uma superfície de interação, não um substituto para autorização ou regras de negócios.

As responsabilidades de segurança não desaparecem

Uma ação estruturada pode ser mais confiável do que a extração de tela, mas também pode tornar uma capacidade sensível mais fácil de invocar. Trate cada chamada de ferramenta como entrada não confiável.

Boas regras incluem:

• autenticar e autorizar no servidor
• validar cada entrada novamente no servidor
• tornar ações de leitura e alteração de estado fáceis de distinguir
• exigir confirmação para compras, exclusões, publicações ou alterações de conta
• retornar os dados mínimos necessários
• registrar chamadas de ferramentas importantes para auditoria e depuração
• usar proteção contra idempotência para ações que não devem ser executadas duas vezes

Nunca assuma que uma ferramenta é segura porque foi chamada através de um agente de navegador.

Comece com ações estreitas e de alta confiança

A melhor primeira ferramenta geralmente não é “controle toda a minha aplicação.” Escolha uma ação com entradas claras, saída previsível e uma verificação de permissão no lado do servidor existente.

Candidatos úteis incluem:

• pesquisar documentação pública
• verificar o status de um pedido
• calcular uma cotação sem comprar
• encontrar horários de consulta disponíveis
• salvar um rascunho sem publicá-lo

Essas ações são mais fáceis de testar do que uma ferramenta ampla que oculta muitas decisões.

Como avaliar uma ferramenta WebMCP

Teste mais do que o caminho feliz.

Pergunte-se se o agente:

• escolhe a ferramenta para o pedido de usuário correto
• evita-a para pedidos não relacionados
• pede informações obrigatórias ausentes
• rejeita valores inválidos de forma clara
• explica uma falha sem inventar um resultado
• solicita confirmação antes