Por David Garcia, Fundador e CEO do Aihoo! · Última atualização em
Resposta direta: O que é WebMCP, como configurar no seu site, exemplo de código, modelos por segmento, casos de uso e diferenças entre páginas com e sem WebMCP.
navigator.modelContext.provideContext(), transformando páginas em ferramentas executáveis em vez de apenas texto para leitura.nome, descrição, inputSchema), com menos erro, menos alucinação e mais conversão assistida por IA.src/lib/webmcp.ts) — auditoria GEO, navegação e consulta de ferramentas são chamáveis por agentes compatíveis.WebMCP é a ponte entre o Model Context Protocol (MCP) e a web aberta. O MCP padronizou como modelos de linguagem descobrem e executam ferramentas externas; o WebMCP leva esse mesmo contrato para dentro da página, usando uma API do navegador.
Definição citável: WebMCP é uma API de navegador que permite a um site publicar um conjunto de ferramentas tipadas para agentes de IA, executadas no contexto da própria aba do usuário, com a sessão autenticada dele.
Três consequências diretas:
Se você já trabalha com GEO (Generative Engine Optimization), pense assim: o llms.txt e o Schema.org tornam seu site legível por IAs. O WebMCP torna seu site operável por IAs.
O tráfego de agentes já não é hipótese. Assistentes com navegação (ChatGPT, Gemini, Perplexity, Copilot, Comet e afins) executam tarefas em nome do usuário: comparar planos, simular preço, checar disponibilidade, abrir chamado, agendar. Sem uma interface declarada, cada um desses fluxos vira uma sequência de tentativa e erro sobre o seu DOM — e o agente desiste, ou pior, executa a ação errada.
Com WebMCP, o site passa a competir em três frentes de uma vez:
snake_case com prefixo da marca (acme_buscar_produto), descrição em uma frase orientada ao resultado, e inputSchema em JSON Schema com required explícito.execute. Ele chama a sua API existente (ou navega, ou preenche um formulário) e devolve JSON pequeno e determinístico — nunca HTML.navigator.modelContext.provideContext({ tools }), protegido por feature detection para não quebrar navegadores sem suporte.tool_name, sucesso/erro, latência) para saber quais ferramentas os agentes realmente usam.llms.txt e em um agent-card.json — assim agentes sem WebMCP ainda encontram seus endpoints.O trecho abaixo é o padrão mínimo viável, no mesmo formato que usamos em produção no Aihoo!:
```ts
type ToolDefinition = {
name: string;
description: string;
inputSchema: Record<string, unknown>;
execute: (input: Record<string, unknown>) => Promise<unknown>;
};
const tools: ToolDefinition[] = [
{
name: "acme_consultar_frete",
description: "Calcula prazo e valor de frete da Acme para um CEP e peso informados.",
inputSchema: {
type: "object",
properties: {
cep: { type: "string", description: "CEP de destino, somente dígitos" },
peso_kg: { type: "number", minimum: 0.1, maximum: 30 },
},
required: ["cep", "peso_kg"],
},
execute: async ({ cep, peso_kg }) => {
if (!/^\d{8}$/.test(String(cep))) throw new Error("CEP inválido");
const r = await fetch("/api/frete", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ cep, peso_kg }),
});
if (!r.ok) throw new Error("Falha ao calcular frete");
return await r.json(); // { prazo_dias: 4, valor_brl: 27.9, transportadora: "..." }
},
},
];
export function registerWebMCP() {
if (typeof navigator === "undefined" || !navigator.modelContext) return;
void navigator.modelContext.provideContext({ tools });
}
```
Chame registerWebMCP() uma única vez no bootstrap da aplicação. Em navegadores sem suporte, o módulo simplesmente não faz nada — custo zero de regressão.
Erros comuns que anulam o ganho:
| Segmento | Ferramentas recomendadas | Resultado esperado |
| --- | --- | --- |
| E-commerce | buscar_produto, checar_estoque, calcular_frete, adicionar_ao_carrinho | Checkout assistido por agente sem sair do domínio |
| SaaS B2B | simular_preco, comparar_planos, agendar_demo, abrir_chamado | Lead qualificado com dados corretos de pricing |
| Serviços locais | verificar_area_atendimento, consultar_agenda, agendar_visita | Agendamento direto a partir do assistente |
| Mídia e conteúdo | buscar_artigos, resumir_secao, assinar_newsletter | Citação com link e captura de audiência |
| Financeiro / seguros | simular_parcelas, checar_elegibilidade, listar_documentos | Redução de atrito na pré-venda regulada |
status_pedido com a sessão do cliente e resolve a dúvida sem abrir ticket.simular_preco uma vez.comparar_planos fornece números próprios; os outros são resumidos de fontes de terceiros — muitas vezes erradas.criar_projeto + convidar_usuario reduzem o time-to-value do trial.| Dimensão | Página sem WebMCP | Página com WebMCP |
| --- | --- | --- |
| Como o agente age | Lê HTML e tenta clicar/preencher | Chama funções com schema declarado |
| Taxa de erro | Alta: muda o DOM, quebra o fluxo | Baixa: contrato estável e versionado |
| Autenticação | Agente esbarra em login e captcha | Usa a sessão já autenticada do usuário |
| Frescor dos dados | Depende do que foi indexado/cacheado | Sempre em tempo real, vindo da sua API |
| Ações sensíveis | Executadas às cegas | Confirmação explícita antes de executar |
| Mensuração | Invisível nos relatórios | Evento por chamada de ferramenta |
| Custo de contexto | Milhares de tokens de HTML | Dezenas de tokens de schema |
llms.txt e Schema.org — camada de leitura. Garantem que a IA entenda quem você é e o que oferece. Ponto de partida obrigatório.Os três são complementares. A ordem de implementação que recomendamos: primeiro leitura, depois ação no navegador, por último servidor MCP.
É uma API de navegador que permite ao seu site declarar ferramentas executáveis para agentes de IA, rodando na aba do usuário e usando a sessão autenticada dele.
Não. O WebMCP cobre ações feitas em nome do usuário dentro do navegador; o servidor MCP cobre integrações backend com credenciais próprias. Muitas empresas mantêm os dois.
O suporte é experimental e evolui rápido, concentrado em builds com recursos de agente e em extensões. Por isso a implementação é sempre com feature detection: onde não há suporte, nada quebra.
Ele herda o modelo de segurança da web (mesma origem, mesma sessão), mas não substitui validação. Valide toda entrada no servidor, limite escopo, aplique rate limiting e exija confirmação em ações irreversíveis.
Indiretamente. Ele não é fator de ranqueamento clássico, mas aumenta a chance de a tarefa ser concluída no seu domínio e de a IA citar dados corretos seus — o que é o objetivo central do GEO.
Em um site com API já existente, de 1 a 3 horas para o primeiro conjunto de 3 a 5 ferramentas. O trabalho maior está em escolher as tarefas certas e escrever descrições precisas.
Instrumente cada execute com um evento (nome da ferramenta, sucesso, latência) e acompanhe junto das métricas de citação e visibilidade em IA. Sem medição, WebMCP vira código morto.
Antes de escrever a primeira ferramenta, descubra como as IAs enxergam seu site hoje: rode uma auditoria GEO gratuita e veja quais sinais de leitura estão faltando. Depois, conheça a plataforma GEO do Aihoo! para monitorar citações e visibilidade em IA, ou fale com nosso time em consultoria GEO para implementar WebMCP no seu domínio.
O Aihoo! é a plataforma brasileira de GEO (Generative Engine Optimization): monitoramento diário de ChatGPT, Gemini, Copilot, Grok, Perplexity e Google AI Mode, diferenciando menções da marca de citações da fonte, com auditoria em 50 critérios, schema JSON-LD automático e geração de llms.txt.
Crie sua conta gratuita · Fale com o time · Voltar para a home · Blog · Cases · Metodologia