WebMCP

Alexandra Klepper

Publicado em: 18 de maio de 2026. Última atualização: 1º de outubro 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 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 autônomas e pode ser adicionado como um aprimoramento progressivo.

Explicação	Web	Extensões	Status do Chrome	Intenção
GitHub	Teste de origem		Ver	Intenção de experimentar

Por que usar o WebMCP?

O WebMCP oferece regras de interação que reduzem a distância entre aplicativos da Web e agentes, melhorando a eficiência, a confiabilidade e a conclusão de tarefas. 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 conforme o esperado.

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 intactas as escolhas de design centradas no ser humano e na 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: uma compreensão compartilhada 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 agênticos 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 várias 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 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 nome e sobrenome 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 gostaria de compartilhar para o WebMCP? Faça perguntas e participe da discussão no GitHub.

Primeiros passos

Participe do teste de origem do WebMCP no Chrome 149. Saiba como começar a usar os testes de origem.

WebMCP local

O WebMCP está disponível como uma Chrome flag para desenvolvimento local:

1. Abra o Chrome e navegue até chrome://flags/#enable-webmcp-testing.
2. Defina a flag como Ativado.
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á limitações:

• Navegação sem interface: embora seja possível executar ferramentas do WebMCP em ambientes sem interface, essa API foi projetada principalmente para fluxos de trabalho de navegador local com um humano no loop.
• 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.

Política de permissões

As duas APIs são controladas pela Política de permissões tools. A política tem 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 entre origens.

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:

• O zaMaker do WebMCP usa a API imperativa do WebMCP.
• A demonstração de viagens (React) usa a API imperativa WebMCP.
• A demonstração do Le Petit Bistro usa a API declarativa do WebMCP.

Você também pode analisar e conferir 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 conforme o esperado pela ferramenta.
• 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 saber se ele consegue identificar e invocar corretamente as ferramentas 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.

• Participe do teste de origem do WebMCP e siga a implementação do Chrome no Chrome Status.
• Leia a explicação sobre o WebMCP, faça perguntas e participe da discussão.
• Leia as práticas recomendadas do WebMCP.
• Leia nossas orientações de segurança da ferramenta WebMCP e as práticas recomendadas.
• Se você tiver feedback sobre a implementação do Chrome, registre um bug do Chromium.