Deixe seu site
pronto para agentes

Fontes Online-Mind2Web: agentes falham em cerca de 4 de 10 tarefas reais· Um snapshot de página custa de 12k a 77k tokens· WindTunnel: tools contra cliques, cronometrado· Rascunho do WebMCP, W3C Web Machine Learning CG (editores do Google e da Microsoft)· Status de implementação (origin trials no Chrome e no Edge)· Chrome: origin trial do WebMCP· Chrome Platform Status· Microsoft Edge: origin trial do WebMCP· Explainer do Microsoft Edge· Nosso método de benchmark

document.modelContext.registerTool({
  name: "search_products",
  description: "Search the catalog by keyword.",
  inputSchema: { type: "object", properties: { query: { type: "string" } } },
  annotations: { readOnlyHint: true },
  async execute({ query }) {
    // Expected failures are answers, never rejections: hosts drop rejection reasons.
    try { return JSON.stringify(await searchCatalog(query)); }
    catch { return JSON.stringify({ error: "Catalog unavailable, try again shortly." }); }
  }
});

Fontes Rascunho do WebMCP· Explainer do WebMCP· Especificação do MCP· Shopify nos dois

• #319 Ferramentas compartilhadas Uma tag script registra search_page, fetch_as_markdown e get_page_context do webmcpx; search_site, quando você passa a sua busca.
• #282 Erros que orientam o agente As ferramentas do webmcpx devolvem falhas esperadas como resultado: um código de erro estável, uma flag retryable e uma dica.
• #292 Resultados paginados Toda ferramenta do webmcpx usa o mesmo formato de resultado, com limites de saída e paginação por truncated + next_cursor.
• #293 modelContext congelado O webmcpx só chama registerTool(), nunca faz atribuição. Testado contra um modelContext congelado.
• #360 Instruções ocultas Removidas do texto da página em tempo de execução; o linter as aponta e o --fix as tira do código-fonte.
• #359 Limites de tamanho O webmcpx lint verifica as regras de nome e aponta descrições acima do que o Chrome orienta.
• #255 Limite de ferramentas O webmcpx lint avisa acima de 20 ferramentas por página e dá erro acima de 100 (regra nossa, não do rascunho).

• Q1

  O que é WebMCP?

  Uma API de navegador, em rascunho no W3C Web Machine Learning Community Group: a página registra ferramentas com document.modelContext.registerTool(), e o agente de IA chama essas ferramentas em vez de ler screenshots ou o HTML da página. Tudo roda na própria aba do usuário.

• Q2

  Como uso WebMCP no Claude Code ou no Codex?

  Rode claude mcp add webmcpx -- npx -y webmcpx mcp (no Codex: codex mcp add webmcpx -- npx -y webmcpx mcp). Aí seu agente abre as páginas no próprio Chromium e recebe as ferramentas WebMCP de cada página, mais as padrão, em qualquer site.

• Q3

  Como deixo meu site pronto para agentes?

  Adicione a tag script do webmcpx: toda página ganha ferramentas padrão (busca, leitura, contexto da página) sem mais nenhum código. Depois registre suas próprias ações, como buscar ou adicionar ao carrinho, com tool(). Escaneie seu site aqui para conferir.

• Q4

  Funciona no Firefox e no Safari?

  Sim. Quando o navegador não tem WebMCP próprio, o webmcpx carrega o polyfill WebMCP do W3C, em páginas HTTPS. Chrome, Firefox e Safari enxergam as mesmas ferramentas.

• Q5

  WebMCP é um padrão do W3C?

  Ainda não. É um rascunho do W3C Web Machine Learning Community Group (2 de novembro de 2026). Chrome e Edge o rodam em origin trials, a Mozilla é neutra e o WebKit tem objeções. O webmcpx acompanha o rascunho e carrega o polyfill do W3C, então suas ferramentas funcionam agora e acompanham a spec.

• Q6

  É seguro deixar agentes chamarem as ferramentas do meu site?

  As ferramentas rodam na própria aba do usuário, com as permissões dele, e não podem fazer nada que a página já não pudesse fazer. As ferramentas padrão do webmcpx só leem o que a página mostra, com caracteres invisíveis removidos. Marque com consequentialHint as suas ferramentas que alteram algo, para que os agentes possam perguntar ao usuário antes, e deixe o linter apontar instruções ocultas nas descrições das ferramentas.

• Q7

  WebMCP é a mesma coisa que MCP?

  Não. O WebMCP pega emprestado o modelo de ferramentas do MCP, mas é uma API de navegador, não o protocolo MCP: as ferramentas vivem na página e rodam na aba do usuário. Um complementa o outro, e o servidor MCP do webmcpx conecta os dois.