WebMCP

Alexandra Klepper
Alexandra Klepper
GitHub Bluesky

Publicado em: 18 de maio de 2026, Última atualização: 5 de junho de 2026

O WebMCP é um padrão da Web proposto para ajudar você a criar e expor ferramentas estruturadas para agentes de IA. Ele 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 a performance 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 de agente e pode ser adicionado como uma melhoria progressiva.

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 para 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 ação, que pode ter várias etapas e deixa cada uma delas aberta à interpretação do agente.

Os sites podem compartilhar uma finalidade explícita, como pesquisa ou compra, definindo um tool. As 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 sua marca e as escolhas de design centradas no ser humano intactas.

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 seus 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, talvez tenha um fluxo de suporte complexo para responder a muitas perguntas diferentes. Você pode usar o WebMCP para ajudar um agente 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 solicitar 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 atendentes a mapear os dados coletados da conversa com o usuário e preencher os campos do formulário corretamente. Por exemplo, é possível diferenciar se um campo exige um nome completo ou um primeiro e um último nome separados.
  • Interações de agentes de suporte em interfaces que priorizam humanos: alguns campos são projetados 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 compartilhe 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 seu 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 visualização da Web para fornecer uma interface visível e um contexto do navegador. Em outras palavras, não há suporte para agentes ou ferramentas assistivas que chamam 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.

Segurança e permissões

As APIs WebMCP são controladas por requisitos de isolamento de origem e pela política de permissões.

Isolamento de origem

O WebMCP só está disponível em documentos isolados por origem. Isso garante que a origem do documento permaneça estável durante todo o ciclo de vida da ferramenta.

Se um documento tiver o document.domain ativado (por exemplo, usando o cabeçalho HTTP Origin-Agent-Cluster: ?0), as APIs WebMCP serão desativadas.

Política de permissões

As duas APIs são controladas pela política de permissões tools. A política usa como padrão self, que permite o registro de ferramentas em contextos de nível superior e de mesma origem, e o desativa para iframes de origem cruzada.

Para permitir ferramentas do WebMCP em um iframe entre origens, adicione o atributo allow="tools" ao iframe.

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 um chat de 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. Use comandos em linguagem natural para determinar se o agente interage com as ferramentas do WebMCP conforme o esperado.

Com a extensão, você pode:

  • Monitore a API WebMCP 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 apropriadas do WebMCP. Por padrão, seus comandos são enviados 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.