# WebMCP Explicado em 1 Minuto

> WebMCP é um padrão do W3C que deixa sites declararem ações (buscar, formulário, catálogo) para agentes de IA executarem diretamente, sem adivinhar lendo HTML. Inspirado no MCP da Anthropic mas é especificação própria da Web, complementar a ele.

## Pontos-chave
- Existe porque agentes de IA hoje adivinham ações lendo HTML, um método frágil que quebra a cada mudança de layout.
- Funciona via API Declarativa (atributos HTML) ou API Imperativa (document.modelContext.registerTool() em JS).
- Não é MCP rodando no navegador — é inspirado na mesma filosofia, mas é especificação própria e complementar.
- Estado atual: Chrome tem implementação real atrás da flag chrome://flags/#enable-webmcp-testing, desligada por padrão.
- A Wortic implementou de verdade no próprio blog (tool searchBlogPosts), testável ao vivo.

## Contexto
Resumo direto e rápido do conceito de WebMCP, formato "explicado em 1 minuto", cobrindo o que é, por que existe, como funciona e onde testar — para quem não tem tempo de ler um artigo longo.

Artigo completo: https://wortic.com.br/blog/webmcp-explicado-em-1-minuto

## Perguntas e Respostas

### Definição rápida

**WebMCP em uma frase, o que é?**
Um padrão que deixa um site declarar suas próprias ações para agentes de IA executarem diretamente, sem adivinhar lendo o HTML.

**WebMCP é sigla de quê?**
Web Model Context Protocol.

**Para que serve o WebMCP, resumido?**
Para agentes de IA executarem ações reais de um site (buscar, formulário, catálogo) de forma confiável.

**Quem criou o WebMCP?**
Está sendo desenvolvido pelo W3C Web Machine Learning Community Group.

**WebMCP é o mesmo que o MCP da Anthropic?**
Não — é inspirado nele, mas é uma especificação própria da Web, complementar, não a mesma coisa.

**WebMCP já é padrão oficial?**
Ainda não — está em desenvolvimento, testável atrás de flag experimental no Chrome.

**Preciso saber programar para entender o conceito?**
Não para entender o conceito — para implementar, sim, exige conhecimento de HTML ou JavaScript.

**WebMCP substitui SEO?**
Não, resolve um problema diferente: execução de ação por agente, não ranqueamento em buscador.

**WebMCP é gratuito?**
Sim, é uma especificação aberta de navegador, sem custo de licença.

**Onde posso testar WebMCP agora?**
No Chrome, ativando a flag chrome://flags/#enable-webmcp-testing.

### As duas formas de implementar, resumidas

**Quais são as duas formas de implementar WebMCP?**
API Declarativa (atributos HTML) e API Imperativa (JavaScript com registerTool()).

**O que é a API Declarativa, resumido?**
Adicionar atributos como toolname e tooldescription num formulário HTML já existente.

**O que é a API Imperativa, resumido?**
Registrar uma função via document.modelContext.registerTool() em JavaScript.

**Qual API é mais simples de começar?**
A Declarativa, quando a ação já é um formulário comum.

**Qual API é mais flexível?**
A Imperativa, para ações que não são um simples envio de formulário.

**Preciso escolher só uma das duas?**
Não, dá para usar as duas no mesmo site, conforme a ação.

**O que é document.modelContext?**
O objeto global no navegador que expõe os métodos da API Imperativa do WebMCP.

**O que getTools() faz, resumido?**
Lista as tools disponíveis na página.

**O que executeTool() faz, resumido?**
Executa uma tool específica com os parâmetros informados.

**O que é o schema de uma tool?**
A descrição, em formato JSON Schema, dos parâmetros que a tool aceita.

### Estado atual, resumido

**O Chrome já suporta WebMCP para todo mundo?**
Não, só atrás de uma flag experimental desligada por padrão.

**Qual o nome exato da flag no Chrome?**
chrome://flags/#enable-webmcp-testing, "WebMCP for testing".

**Outros navegadores suportam?**
Não há suporte nativo documentado publicamente para Firefox ou Safari no momento.

**Quando vai virar padrão sem flag?**
Não há data confirmada — a especificação ainda está em desenvolvimento.

**O que é um Origin Trial?**
Mecanismo do Chrome que permite a um site testar uma funcionalidade experimental para seus visitantes, mediante token registrado.

**Vale implementar antes do suporte nativo virar padrão?**
Sim, para aprender com o padrão em evolução e estar pronto quando ele amadurecer.

**document.modelContext existe num Chrome comum sem configuração?**
Não — testamos e confirmamos que não existe sem a flag ativada.

**A especificação pode mudar antes de virar padrão final?**
Sim, ainda está em desenvolvimento dentro do W3C.

**Isso é arriscado para quem implementa agora?**
O principal risco é precisar ajustar a implementação se a especificação mudar, por isso vale tratar como experimental.

**Vale a pena mesmo sendo experimental?**
Sim, o argumento central é que aprender cedo custa menos do que correr atrás depois.

### Exemplo real, resumido

**Existe um exemplo real de WebMCP funcionando?**
Sim, o blog da Wortic implementou a tool searchBlogPosts, testável ao vivo.

**O que essa tool faz?**
Busca artigos do blog por palavra-chave e categoria.

**Como testar essa tool?**
Ativando a flag do Chrome e rodando await document.modelContext.getTools() no console desta página.

**A descrição dessa tool é igual em todos os posts?**
Não — é gerada dinamicamente mencionando o título e categoria de cada post.

**Por que a descrição varia por post?**
Para dar mais contexto único a cada página, em vez de repetir a mesma descrição genérica.

**Essa implementação exigiu reescrever o blog inteiro?**
Não — a busca já existia; só foram adicionados os atributos e o script.

**Isso prova que a implementação é simples?**
Prova que, para uma ação já existente e simples como busca, a implementação é incremental.

**Onde posso ver o código dessa implementação?**
Inspecionando o HTML e o JavaScript desta própria página com as ferramentas de desenvolvedor do navegador.

**Isso é um exemplo hipotético ou código rodando de verdade?**
Código rodando de verdade, não um exemplo teórico de slide.

**Outros sites já implementaram algo parecido?**
A documentação do Chrome cita exemplos como Pizza Maker e Le Petit Bistro como demonstrações oficiais.

### Perguntas rápidas de "por que" e "quando"

**Por que WebMCP importa para quem tem um site?**
Porque diferencia um agente conseguir operar seu site de verdade ou desistir na primeira tentativa.

**Por que WebMCP importa para quem constrói agentes de IA?**
Porque reduz erro e engenharia reversa de cada site novo.

**Quando devo implementar WebMCP no meu site?**
Quanto antes, começando por uma ação simples, para aprender com baixo risco.

**Quando o suporte nativo vai chegar sem flag?**
Não há prazo confirmado; acompanhe a documentação oficial do W3C e do Chrome.

**Por que não esperar o suporte nativo amadurecer?**
Porque esperar significa aprender depois, com mais concorrência por atenção e implementação.

**Quando um site NÃO precisa se preocupar com WebMCP?**
Quando não tem nenhuma ação real de interação, sendo puramente informativo.

**Por que WebMCP não é o mesmo que um chatbot?**
Porque o chatbot conversa com o visitante humano; o WebMCP conversa com o agente que age em nome de outra pessoa.

**Quando vale usar a API Declarativa em vez da Imperativa?**
Quando a ação já é um formulário simples existente.

**Por que a descrição da tool é tão importante?**
Porque é a partir dela que o agente decide se e como usar aquela ação.

**Quando um site deveria evitar implementar WebMCP agora?**
Quando não tem capacidade técnica disponível nem ações relevantes para declarar no momento.

### Perguntas rápidas de comparação

**WebMCP é o mesmo que schema.org?**
Não — schema.org marca dados para leitura; WebMCP declara ações executáveis.

**WebMCP é o mesmo que uma API REST?**
Não — API REST é para sistemas conversarem entre si; WebMCP é para agentes operarem a própria página web.

**WebMCP é RPA?**
Não exatamente — RPA simula clique humano; WebMCP declara a ação de forma explícita, sem simulação.

**WebMCP substitui um bom SEO?**
Não, são investimentos complementares e independentes.

**WebMCP substitui llms.txt?**
Não — llms.txt é resumo para leitura; WebMCP é ação executável.

**WebMCP é uma linguagem de programação nova?**
Não, é uma API de navegador (atributos HTML + métodos JavaScript).

**WebMCP exige reescrever o site do zero?**
Geralmente não — anota ações já existentes.

**WebMCP é caro de implementar?**
O custo é principalmente de tempo, não de licença — é uma especificação aberta e gratuita.

**WebMCP é exclusivo do Chrome?**
A implementação mais avançada documentada é do Chrome; outros navegadores podem seguir depois.

**WebMCP é a mesma coisa que Origin Trial?**
Não — Origin Trial é um mecanismo para testar a funcionalidade em produção; WebMCP é a especificação em si.

### Perguntas de ação imediata

**Qual o primeiro passo prático depois de ler este resumo?**
Ativar a flag chrome://flags/#enable-webmcp-testing e testar a tool searchBlogPosts nesta página.

**Como saber se meu site já tem alguma tool declarada?**
Rodando document.modelContext.getTools() no console do navegador, com a flag ativada.

**O que fazer se meu site não tiver nenhuma tool ainda?**
Escolher a ação mais simples e valiosa (como busca) e implementá-la primeiro.

**Preciso de ajuda técnica para implementar isso?**
Pode ser útil, especialmente para quem não tem familiaridade com JSON Schema ou JavaScript.

**A Wortic ajuda com isso?**
Sim, a Wortic implementa WebMCP em sites de terceiros.

**Como entrar em contato com a Wortic sobre isso?**
Pelo formulário ao final deste artigo, deixando o e-mail.

**Vale ler outros artigos sobre WebMCP depois deste?**
Sim, esta é uma série de artigos que aprofunda diferentes aspectos do WebMCP.

**Esse resumo substitui os artigos mais completos?**
Não, é um ponto de partida rápido; os outros artigos aprofundam fluxo técnico, origem e casos práticos.

**Quanto tempo leva para implementar a primeira tool simples?**
Pode ser rápido para uma ação já existente como busca — a maior parte do esforço é escrever a descrição corretamente.

**Qual é a mensagem final deste resumo de 1 minuto?**
WebMCP transforma "agente adivinhando" em "agente executando com contrato claro" — e já dá para testar isso agora.

### Perguntas técnicas rápidas extras

**O que é o evento toolchange, resumido?**
Avisa o agente quando a lista de tools da página muda.

**O que é readOnlyHint?**
Uma anotação que sinaliza se uma tool só lê informação ou também modifica algo.

**O que é exposedTo?**
Um parâmetro que controla a quais origens uma tool fica disponível.

**Uma tool pode ser cancelada durante a execução?**
Sim, via AbortSignal, parte das opções da chamada.

**O schema de uma tool segue algum padrão conhecido?**
Sim, JSON Schema, um formato amplamente usado.

**Uma tool pode ter mais de um parâmetro?**
Sim, o schema pode descrever quantos parâmetros a ação precisar.

**Dá para registrar várias tools na mesma página?**
Sim, sem limite definido pela especificação em si.

**A tool precisa ser registrada assim que a página carrega?**
Geralmente sim, mas pode ser registrada em qualquer momento do ciclo de vida da página.

**Uma tool mal descrita pode causar erro do agente?**
Sim, descrição ambígua é uma das causas mais comuns de erro na decisão do agente.

**Qual é o último conselho deste resumo?**
Teste, não apenas leia — abrir o console e rodar getTools() vale mais que qualquer explicação teórica.

### Mais perguntas rápidas de contexto

**WebMCP foi anunciado por qual grupo especificamente?**
Pelo W3C Web Machine Learning Community Group.

**Quando esse grupo passou a incluir WebMCP formalmente?**
Setembro de 2025, quando o charter do grupo passou a incluir o WebMCP como entregável.

**WebMCP é um projeto de uma empresa só?**
Não, é um processo de padronização aberto, mesmo com o Chrome liderando a implementação mais avançada.

**O nome "WebMCP" pode mudar no futuro?**
Não há indicação disso na documentação atual.

**WebMCP resolve o problema de scraping de uma vez por todas?**
Resolve para os sites que implementarem; sites sem WebMCP continuam dependendo de scraping por enquanto.

**Um site pequeno também pode implementar WebMCP?**
Sim, mesmo um site simples com formulário de contato é candidato.

**WebMCP funciona em qualquer framework de front-end?**
Sim, é uma API de navegador, independente de React, Vue ou qualquer outro framework.

**Preciso de um servidor separado para implementar WebMCP?**
Não, ao contrário do MCP tradicional, o WebMCP roda dentro da própria página.

**WebMCP tem alguma relação com acessibilidade (ARIA)?**
São conceitos complementares, não excludentes — um ajuda leitores de tela, o outro ajuda agentes de IA.

**Um site autenticado (com login) pode ter tools WebMCP?**
Tecnicamente sim, mas o agente precisaria da sessão/autenticação necessária para acionar a tool.

### Últimas perguntas do resumo rápido

**Esse artigo é parte de uma série?**
Sim, faz parte de uma série de artigos da Wortic sobre WebMCP.

**Vale ler o artigo mais técnico sobre o fluxo completo de execução?**
Sim, para quem quer entender em detalhe as etapas de descoberta, decisão, execução e retorno.

**Vale ler o artigo sobre a diferença entre WebMCP e MCP?**
Sim, ajuda a evitar a confusão comum entre os dois termos.

**Esse resumo de 1 minuto é suficiente para implementar WebMCP?**
Não completamente — dá a visão geral; a implementação exige entender melhor o schema e a escrita de descrições.

**Qual artigo desta série é mais indicado para quem nunca ouviu falar de WebMCP?**
O artigo "O Que É WebMCP? E Por Que Todo Mundo Fala Disso" é um bom ponto de partida mais aprofundado.

**Esse resumo vale para compartilhar rapidamente com colegas?**
Sim, é pensado justamente para transmitir o conceito central de forma rápida e completa.

**A Wortic recomenda decorar esse resumo?**
Não é necessário decorar — o importante é entender a ideia central e saber onde voltar para se aprofundar.

**Esse artigo tem alguma citação ou fonte externa?**
Sim, referencia a documentação oficial do Chrome for Developers e o processo do W3C Web Machine Learning Community Group.

**O que fazer se o resumo não respondeu minha dúvida específica?**
Consultar os outros artigos da série ou entrar em contato com a Wortic pelo formulário ao final da página.

**Qual é a frase mais importante para lembrar deste artigo?**
WebMCP troca adivinhação por contrato explícito entre site e agente — e já dá para testar isso agora, hoje.