WebMCP

Alexandra Klepper

Publicado em: 18 de maio de 2026

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, oferecendo suporte à experiência do usuário. Isso pode melhorar significativamente a performance e a confiabilidade da atuação do agente.

**Termo principal** :_atuação_ é o ato de um agente simular cliques manuais do mouse e entrada de texto, como se fosse o usuário humano interagindo com seu site. Essas podem ser tarefas únicas, como clicar em um link ou inserir conteúdo em um formulário, ou tarefas complexas, como concluir uma compra.

Os agentes de IA são uma tecnologia mais recente. Eles podem ajudar os usuários humanos a concluir 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.

**Observação** :o WebMCP foi projetado para se alinhar ao Protocolo de Contexto de Modelo (MCP).

Por que usar o WebMCP?

O WebMCP pode ajudar você a preencher a lacuna entre aplicativos da Web e agentes, melhorando a eficiência, a confiabilidade e a conclusão de tarefas, fornecendo regras de interação. Em vez de um agente revisar o elemento, como um botão ou um campo, para entender a finalidade dele, o site declara a finalidade 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 etapa 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 sejam concluídas conforme o esperado. Isso também mantém sua marca e as escolhas de design centradas no ser humano intactas.

O WebMCP oferece suporte a:

• 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 se beneficiar, para que os usuários possam concluir tarefas com mais facilidade. Você pode acompanhar esse processo no GitHub.

Casos de uso

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

• Ajude seus clientes a receber suporte. Se você fornecer 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 representante a navegar mais rapidamente até o formulário correto e preencher os campos com informações fornecidas pelo usuário.
• Melhore a reserva de viagens. Ajude os agentes a reservar viagens complexas, com várias cidades e vários passageiros, em menos etapas.

Algumas ações podem ser confidenciais, 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 para os campos do formulário corretamente. Por exemplo, você pode diferenciar se um campo exige um nome completo ou um nome e sobrenome separados.
• Oferecer suporte a interações de agentes em interfaces centradas no ser humano: 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 reserva de eventos.
• Depuração de aplicativos mais rápida: você pode 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, ficam ocultas em menus aninhados.

Seu caso de uso está ausente? Ou você tem uma ideia que gostaria de compartilhar para o WebMCP? Participe do programa de visualização antecipada 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 acesse chrome://flags/#enable-webmcp-testing
2. Defina a flag como Ativada.
3. Reinicie o Chrome para aplicar as mudanças.

Usar APIs do WebMCP

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

• API imperativa: defina 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 ferramentas são processadas em JavaScript, uma guia do navegador ou uma WebView precisa ser aberta para fornecer uma interface visível e um contexto do navegador. Em outras palavras, não há suporte para agentes ou ferramentas de acessibilidade 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 chamáveis.

Demonstração

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

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

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

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

Instale a extensão do inspetor de ferramentas de contexto de modelo 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 pode interagir corretamente com as ferramentas do WebMCP.

Com a extensão, você pode:

• Ver quais ferramentas estão registradas em uma página, monitorando a API navigator.modelContext.
• Chamar ferramentas e executar funções manualmente.
• Verificar se o esquema JSON está definido corretamente e se o navegador pode analisar os dados conforme a ferramenta espera.
• Visualizar 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 verificar se ele pode identificar e invocar corretamente as ferramentas do WebMCP apropriadas. Seus comandos são enviados ao modelo gemini-2.5-flash.

**Observação** :isso é separado dos recursos do Gemini no Chrome.

Interagir e compartilhar feedback

O WebMCP está em discussão ativa e sujeito a mudanças no futuro. Se você testar essas APIs e tiver feedback, gostaríamos de recebê-lo.

• Leia a explicação do WebMCP, faça perguntas e participe da discussão.
• Leia as práticas recomendadas do WebMCP.
• Revise a implementação do Chrome no Chrome Status.
• Participe do programa de visualização antecipada para conferir as novas APIs e acessar nossa lista de e-mails.
• Se você tiver feedback sobre a implementação do Chrome, registre um bug do Chromium.