WebMCP

Alexandra Klepper

François Beaufort

Kasper Kulikowski

Publicado em: 18 de maio de 2026, última atualização: 7 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, para melhorar a experiência do usuário. Isso pode melhorar significativamente o desempenho e a confiabilidade da atuação do agente.

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 de agentes e pode ser adicionado como um aprimoramento progressivo.

Explicação	Web	Extensões	Status do Chrome	Intenção
GitHub	Teste de origem do		Ver	Intent to Experiment (em inglês)

Por que usar o WebMCP?

O WebMCP fornece regras de interação que preenchem a lacuna 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 o propósito dele, o site declara o propósito do elemento para que ele seja usado conforme o esperado.

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 um tool. As ferramentas são executadas na sua página da Web de forma visível, para que os usuários tenham certeza de que as tarefas foram 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 possam concluir tarefas com mais facilidade. Acompanhe esse processo no GitHub.

Casos de uso

Há muitas maneiras de usar o WebMCP. Exemplo:

• Ajude seus clientes a receber suporte. Se você fornece um software para clientes, pode ter 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 vários passageiros com menos etapas.

Algumas ações podem ser confidenciais, como fazer uma compra. É possível 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 do submit_application para ajudar os agentes a mapear a coleta de dados da conversa com o usuário para preencher os campos do formulário corretamente. Por exemplo, é possível diferenciar se um campo exige um nome completo ou um nome e sobrenome separados.
• Interações de agentes de suporte em interfaces voltadas para humanos: alguns campos são projetados para usuários humanos, mas podem não ser compreendidos pelos agentes. Você pode criar uma ferramenta de date_pick que permita uma seleção complexa de data e hora em uma reserva ou agendamento de evento.
• Depuração de aplicativos mais rápida: é 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á aqui? Ou você tem uma ideia que quer compartilhar para o WebMCP? Faça perguntas e participe de discussões no GitHub.

Primeiros passos

Participe do teste de origem da 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 acesse chrome://flags/#enable-webmcp-testing.
2. Defina a flag como Ativada.
3. Reinicie o Chrome para aplicar as mudanças.

Usar as APIs 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 um formulário HTML padrão para criar uma ferramenta WebMCP.

É possível depurar ferramentas do WebMCP e validar como o navegador analisa o esquema JSON com o Chrome DevTools.

Limitações

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

• Navegação headless: embora seja possível executar ferramentas do WebMCP em ambientes headless, essa API foi projetada principalmente para fluxos de trabalho de navegador local com um humano no circuito.
• Sobrecarga para interfaces complexas: se o site for muito complexo, talvez seja necessário refatorar ou adicionar JavaScript para processar o estado do aplicativo e da interface.
• Facilidade de descoberta de ferramentas: os clientes e navegadores precisam visitar 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. O padrão da política é 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

Confira exemplos de demonstrações que abrangem implementações imperativas e declarativas:

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

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

Imitar um agente para testar suas ferramentas

Criamos duas extensões do Chrome para ajudar você a entender como as ferramentas do WebMCP funcionam nas nossas demonstrações e nos seus aplicativos.

Instale o exemplo de extensão agêntica do Chrome para inspecionar, monitorar e executar ferramentas do WebMCP com comandos em linguagem natural. Em particular, essa extensão sempre confia nas anotações do WebMCP, que podem alertar o agente sobre ações sensíveis. Isso demonstra como uma ferramenta pode ter um desempenho diferente com anotações.

Por padrão, essa extensão usa um pequeno servidor Node com um SDK de IA. As chaves de API são obrigatórias e permanecem no servidor local. Seus comandos são enviados para o modelo gemini-3.6-flash por padrão, mas é possível modificar a escolha do modelo e o provedor de API no arquivo .env da extensão. Há campos para OpenAI, Google e Anthropic ou, como alternativa, é possível personalizar a extensão para usar um modelo de outro provedor.

Como alternativa, use um modelo do lado do cliente com a API Prompt. Isso não requer chaves de API, e os dados permanecem no dispositivo. Para fazer isso, ative chrome://flags/#prompt-api-tool-use.

Instale a extensão Model Context Tool Inspector para testar um agente e conferir 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.

Para usar o Gemini para chamar suas ferramentas, você precisa de uma chave de API, que é fornecida na interface da extensão. Seus comandos são enviados por padrão para o modelo gemini-3.6-flash. Você pode selecionar um modelo diferente do Gemini para testar ou personalizar o código da extensão para usar o modelo de outro provedor.

Engajamento e como compartilhar feedback

O WebMCP está em discussão ativa e sujeito a mudanças no futuro. Se você testar essas APIs e tiver feedback, entre em contato com nossa equipe.

• Participe do teste de origem do WebMCP e siga a implementação para o Chrome no Status do Chrome.
• Leia o documento explicativo do 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.