WebMCP

Alexandra Klepper
Alexandra Klepper
GitHub Bluesky

Publicado em: 18 de maio de 2026

O WebMCP é um padrão da Web proposto para ajudar você a criar e expor ferramentas estruturadas para agentes de IA. O WebMCP fornece JavaScript e anota elementos de formulário HTML para que os agentes saibam exatamente como interagir com os recursos da página e oferecer suporte à experiência do usuário. Isso pode melhorar significativamente o desempenho e a confiabilidade da ação do agente.

Os agentes de IA são uma tecnologia mais recente. Eles podem ajudar os usuários humanos a concluir melhor tarefas altamente complexas e técnicas. O WebMCP oferece maior precisão para a conclusão de tarefas agênticas e pode ser adicionado como um aprimoramento progressivo.

Por que usar o WebMCP?

O WebMCP pode ajudar a diminuir a distância entre aplicativos da Web e agentes, melhorando a eficiência, a confiabilidade e a conclusão de tarefas ao fornecer regras de interação. Em vez de um agente analisar o elemento, como um botão ou um campo, para entender a finalidade dele, o site declara o propósito do elemento para que ele seja usado corretamente.

Isso é mais confiável do que a atuação, que pode ter várias etapas e deixa cada uma aberta à interpretação do agente.

Os sites podem compartilhar uma finalidade explícita, como pesquisa ou compra, definindo uma ferramenta. Essas ferramentas são executadas na sua página da Web de forma visível, para que os usuários confiem que as tarefas serão concluídas conforme o esperado. Isso também mantém intactas as escolhas de design centrado nas pessoas e da sua marca.

O WebMCP é compatível com:

  • Descoberta: uma maneira padrão de as páginas registrarem ferramentas com agentes, como checkout ou filter_results.
  • Esquemas JSON: definições explícitas de entradas e saídas esperadas para reduzir alucinações ou mal-entendidos.
  • Estado: um entendimento compartilhado do contexto da página atual para que o agente saiba quais recursos estão disponíveis para agir em tempo real.

Nosso objetivo é criar APIs que qualquer navegador com recursos de agente possa implementar e aproveitar para que os usuários concluam tarefas com mais facilidade. Você pode acompanhar esse processo no GitHub.

Casos de uso

Há muitas maneiras de usar o WebMCP na Web. Exemplo:

  • Ajude seus clientes a receber suporte. Se você fornece um software aos clientes, pode ter um fluxo de suporte complexo para responder a muitas perguntas diferentes. Você pode usar o WebMCP para ajudar um representante a navegar mais rapidamente até o formulário certo e preencher os campos com as informações fornecidas pelo usuário.
  • Melhorar as reservas de viagens. Ajude os agentes a reservar viagens complexas, para várias cidades e com vários passageiros em menos etapas.

Algumas ações podem ser sensíveis, como fazer uma compra. Você pode incluir um comando para pedir a interação do usuário com uma caixa de diálogo de confirmação.

Na prática, suas ferramentas podem realizar as seguintes tarefas:

  • Preencher formulários estruturados: crie uma ferramenta submit_application para ajudar os agentes a mapear os dados coletados da conversa com o usuário e preencher os campos do formulário corretamente. Por exemplo, você pode diferenciar se um campo exige um nome completo ou um primeiro e um último nome separados.
  • Ofereça suporte a interações de agentes em interfaces que priorizam humanos: alguns campos são criados para usuários humanos, mas podem não ser compreendidos por agentes. Você pode criar uma ferramenta date_pick que permita uma seleção complexa de data e hora em uma reserva ou agendamento de evento.
  • Depuração mais rápida de aplicativos: é possível criar uma ferramenta run_diagnostics em uma página de configurações do desenvolvedor para que um agente possa acionar correções que, de outra forma, ficariam ocultas em menus aninhados.

Seu caso de uso não está listado? Ou você tem uma ideia que quer compartilhar para o WebMCP? Participe do programa de acesso antecipado e deixe seu feedback.

Primeiros passos

O WebMCP está disponível como uma flag do Chrome para desenvolvimento local. Ele estará disponível em um teste de origem no Chrome 149.

Para ativar o WebMCP localmente:

  1. Abra o Chrome e navegue até chrome://flags/#enable-webmcp-testing.
  2. Defina a flag como Ativada.
  3. Reinicie o Chrome para aplicar as mudanças.

Usar APIs WebMCP

Há duas APIs que você pode usar para configurar as ferramentas do site:

  • API imperativa: define diferentes tipos de ferramentas com JavaScript padrão, como entrada de formulário, ferramentas de navegação, gerenciamento de estado ou outras funções.
  • API declarativa: adicione anotações a formulários HTML padrão para criar uma ferramenta WebMCP.

Limitações

Embora o WebMCP tenha como objetivo simplificar tarefas complexas para agentes e humanos, há algumas limitações:

  • Contexto de navegação necessário: como as chamadas de função são processadas em JavaScript, é preciso abrir uma guia do navegador ou uma WebView para fornecer uma interface visível e um contexto do navegador. Em outras palavras, não há suporte para agentes ou ferramentas assistivas para chamar ferramentas em um estado sem interface.
  • Mais sobrecarga para interfaces complexas: se o site for muito complexo, provavelmente será necessário refatorar ou adicionar JavaScript para processar o estado do aplicativo e da interface.
  • Capacidade de descoberta de ferramentas: os clientes e navegadores precisam acessar um site diretamente para saber se ele tem ferramentas que podem ser chamadas.

Demonstração

Exemplos de demonstrações que abrangem implementações imperativas e declarativas estão disponíveis:

Você também pode analisar e explorar o código-fonte da demonstração no GitHub.

Imitar o chat de um agente com a extensão do inspetor

Instale a extensão Model Context Tool Inspector para testar um agente e ver como as ferramentas do WebMCP funcionam em demonstrações ao vivo ou nos seus próprios aplicativos. Você pode inserir comandos em linguagem natural para verificar se um agente consegue interagir corretamente com as ferramentas do WebMCP.

Com a extensão, você pode:

  • Monitore a API navigator.modelContext para saber quais ferramentas estão registradas em uma página.
  • Chamar ferramentas e executar funções manualmente.
  • Verifique se o esquema JSON está definido corretamente e se o navegador pode analisar os dados como a ferramenta espera.
  • Confira a saída estruturada ou as mensagens de erro retornadas pela ferramenta para garantir que elas estejam escritas com clareza e formatadas corretamente, para que um agente possa entender.

Converse com o agente usando linguagem natural para ver se ele consegue identificar e invocar corretamente as ferramentas WebMCP adequadas. Seus comandos são enviados por padrão ao modelo gemini-3-flash-preview.

Engajamento e como compartilhar feedback

O WebMCP está em discussão e sujeito a mudanças no futuro. Se você testar essas APIs e tiver feedback, envie sua opinião.