MÓDULO 3.3 / 9 DE 9
WebMCP: seu site conversando com agentes
Explicar o que muda quando agentes visitam sites, o que é WebMCP e qual é o primeiro passo concreto: diagnosticar o próprio site e corrigir o básico.
Página da área: eventos.inema.pro/webmcp/ · no menu: “sites que conversam com agentes”
1O que é WebMCP
O que é
WebMCP é uma forma de a própria página descrever o que sabe fazer para agentes de IA. Sem WebMCP, o agente precisa localizar campos, clicar, digitar e interpretar a tela, e isso quebra quando o layout muda. Com WebMCP, a página expõe ferramentas com nome, descrição, schema de argumentos e resposta, e o agente chama a ferramenta certa pelo nome. Há dois caminhos: a ferramenta declarativa, em que um formulário que já existe ganha um toolname e uma descrição, e a imperativa, em que JavaScript registra capacidades com JSON Schema, tratando estado, erros, cancelamento e fallback. É uma tecnologia experimental, hoje atrás de Origin Trial no navegador, ou seja, liberada em caráter de teste.
Por que aprender
É a diferença entre o agente adivinhar e o site dizer. O site passa a decidir o que é permitido, o que precisa de confirmação e o que pode ser cancelado.
Conceitos-chave
operar pixels x conversar com capacidades; ferramenta declarativa; ferramenta imperativa; JSON Schema; Origin Trial
Na prática
Sem WebMCP, o agente digita o nome do curso, clica no botão azul e "acha que deu certo". Com WebMCP, o site expõe verificar_vagas e iniciar_inscricao; o agente chama a primeira, confirma que há vaga, e a segunda exige confirmação humana antes de concluir.
✓ Faça
Escolha um formulário do seu site e escreva o nome e a descrição de uma linha que ele teria como ferramenta.
✗ Evite
Julgar a área pelo nome: leia a tese na página antes de decidir se ela é para você.
2O próximo visitante é um agente
O que é
A página lista seis mudanças. Do lado de quem visita: agentes já operam o navegador, preenchendo formulários e concluindo tarefas; buscar virou perguntar a um assistente, o que cria o problema de GEO e AEO; e o padrão está nascendo agora. Do lado de quem publica: o site deixa de ser só uma tela e ganha um catálogo de capacidades por cima da jornada humana; descoberta vira requisito, com robots.txt, sitemap.xml, llms.txt, JSON-LD, Open Graph e uma identidade clara; e a segurança fica com o site, não com o modelo. GEO e AEO são as práticas de aparecer e ser citado nas respostas de assistentes de IA, e não só em buscadores.
Por que aprender
Se você é dono do site, as três últimas mudanças são a sua lista de trabalho. Quem entende as limitações cedo aprende com custo baixo.
Conceitos-chave
agentes no navegador; buscar virou perguntar; GEO e AEO; catálogo de capacidades; descoberta; segurança no site
Na prática
Uma escola percebe que alunos perguntam a um assistente "qual curso de agentes começa este mês" em vez de buscar no site. A resposta depende do que o modelo consegue extrair das páginas dela, e o SEO clássico sozinho não resolve.
3Diagnóstico gratuito: Readiness
O que é
O WebMCP Readiness, em webmcp.inema.pro, abre a URL num navegador descartável, reúne sinais observáveis e transforma o scan num plano de correção. É um scanner passivo: consulta robots.txt, sitemap.xml e llms.txt e não executa nenhuma ferramenta do site. Você recebe nota geral e quatro notas independentes, WebMCP, SEO, GEO e AEO, com evidências, alertas, bloqueadores, até 12 correções priorizadas e os cursos indicados para cada lacuna, num relatório em JSON. O scan aprofunda só a URL informada; o sitemap é inventariado, mas suas páginas não são rastreadas. Os scanners avançados por fase aparecem no relatório como planejados, não como prontos.
Por que aprender
Começar pelo diagnóstico mostra onde o seu site está antes de estudar. E a página deixa claro o limite: indexação, ranking ou citação por IA, o scanner não promete nada disso.
Conceitos-chave
scanner passivo; navegador descartável; nota geral + quatro notas; até 12 correções; relatório JSON; o que exige revisão humana
Na prática
Uma agência roda o scan na página de contato de um cliente e recebe o bloqueador "sem llms.txt" no topo do plano. Ela corrige, roda de novo e usa as duas notas para mostrar o avanço, sem prometer ranking.
Sequência para experimentar
- Abra a página da área ao lado desta aula.
- Rode o scan em https://webmcp.inema.pro/ com a página principal do seu site e salve o relatório JSON como linha de base.
- Anote em uma frase o que mudou no seu entendimento.
4Oito camadas de um site pronto
O que é
A página organiza a arquitetura em oito camadas, na ordem em que a formação constrói. As quatro primeiras são o site se descrevendo: descoberta (o agente acha o site?), ferramentas (o que o site sabe fazer?), contrato (como se chama e o que volta?) e estado e erros (e quando dá errado?). As quatro últimas são o site se protegendo: controle (quem confirma?), permissões (quem pode chamar?), backend e MCP (onde mora a verdade?) e evals e observabilidade (está funcionando mesmo?). A regra que atravessa todas: a LLM escolhe a ferramenta; o site decide se ela pode rodar. O diagnóstico já mede a camada 1 inteira e os sinais observáveis das camadas 2 e 5.
Por que aprender
As camadas mostram que expor uma ferramenta é só o começo. Sem confirmação, permissões e autorização no backend, um agente pode acionar algo que não deveria.
Conceitos-chave
descoberta; ferramentas; contrato; estado e erros; controle; permissões; backend e MCP; evals
Na prática
Uma loja expõe a ferramenta de consulta de pedido. A descrição diz "só consulta", o backend confere se quem chama pode ver aquele pedido, e qualquer alteração exige confirmação humana. Logs mostram depois se a ferramenta fez o que dizia.
✓ Faça
Marque, para o seu site, quais das oito camadas você já cobre e qual pergunta de camada você não saberia responder hoje.
✗ Evite
Pular para a ferramenta ou o curso sem entender o problema que a área resolve.
5Seis correções para esta semana
O que é
Antes de qualquer fase da formação, a página traz seis correções que o dono do site faz, cada uma ligada a um item que o scanner verifica. Primeiro, rode o scan e anote as notas como linha de base. Segundo, publique os três arquivos públicos: robots.txt, sitemap.xml atualizado e um llms.txt que apresenta o site para modelos de IA. Terceiro, arrume o básico de SEO que o agente também lê: title, description, canonical, headings em ordem, alt nas imagens, Open Graph e JSON-LD. Quarto, escreva para quem responde perguntas, com respostas diretas, definições, listas e tabelas; quinto, mostre quem está por trás, com entidade, autoria, data de atualização e evidências. Sexto, escolha como primeira ferramenta um formulário que não muda nada perigoso, como uma busca ou consulta de status.
Por que aprender
São correções que não exigem programar ferramentas e já sobem as notas. A página resume o método: corrija, rode de novo, veja a nota subir.
Conceitos-chave
linha de base; robots.txt, sitemap.xml, llms.txt; SEO básico; AEO: respostas diretas; GEO: autoria e evidências; primeira ferramenta segura
Na prática
Um consultor autônomo publica o llms.txt, acrescenta data de atualização e autoria nos artigos e cria uma seção de perguntas frequentes com respostas curtas. Na semana seguinte, as notas de GEO e AEO do scan sobem, sem nenhuma linha de JavaScript nova.
6A formação e onde continuar
O que é
A Formação WebMCP tem uma visão geral e quatro fases, todas abertas e em português: Builder (construir), Integrator (integrar), Agent Developer (orquestrar) e Expert (operar). Cada fase tem quatro módulos de seis tópicos e usa JavaScript; quem não programa começa pela visão geral e pelo diagnóstico e leva as fases para o time. As camadas 1 e 2 são ensinadas no Builder, 3 e 4 no Integrator, 5 e 6 no Agent Developer, e 7 e 8 no Expert. Ao lado, a página indica o AIV 2026 para AEO e GEO, o curso de Computer Use com o GPT-6 Astra e o Super-Agentes, além de projetos como o Kit do Arquiteto de Agentes, o INEMACCBOT e o os-agentes. O convite final é direto: o melhor primeiro módulo é o seu próprio site.
Por que aprender
Saber em qual fase cada camada é ensinada permite entrar na formação pelo ponto do seu papel, em vez de começar tudo do zero.
Conceitos-chave
visão geral; Builder; Integrator; Agent Developer; Expert; quatro módulos de seis tópicos; cursos ao lado
Na prática
Uma dona de loja virtual faz o diagnóstico e a visão geral. O desenvolvedor da equipe começa pelo Builder para transformar a busca de produtos em ferramenta declarativa, e a parte de permissões fica para quando ele chegar ao Agent Developer.
Critérios para revisar sua ficha
Use esta rubrica depois do laboratório. Cada linha pede uma evidência; marcar leitura não significa que a ficha foi feita.
| Critério | Evidência esperada | Se não passou |
|---|---|---|
| Tese | A área cabe em uma frase sua, fiel à página. | Releia o topo da página e o tópico 1. |
| Público | Você sabe dizer para quem a área é e para quem não é. | Volte ao tópico 2 e escreva um exemplo do seu trabalho. |
| Blocos | Você nomeia as partes centrais da área. | Use o diagrama do módulo como roteiro. |
| Primeiro passo | Você escolheu um passo concreto e pequeno. | Copie o primeiro passo que a própria página recomenda. |
| Porta de entrada | Você sabe qual curso, kit ou projeto abrir primeiro. | Consulte o tópico 6 e a faixa de acesso da página. |
| Fonte | Cada afirmação da ficha tem origem na página. | Troque o que você supôs pelo que a página diz. |
MÃO NA MASSA / ~10 MIN
O diagnóstico do seu site
Deixe a página da área aberta: https://eventos.inema.pro/webmcp/. Use um exemplo do seu trabalho, sem dados pessoais ou de clientes.
Prompt: plano WebMCP para o meu site
Cole no Claude, no ChatGPT ou no Codex. Troque o que estiver entre < e > pela sua situação.
Leia https://eventos.inema.pro/webmcp/.
Rodei o diagnóstico em https://webmcp.inema.pro/ para o meu site: <URL do seu site>.
Resultado do scan (cole o JSON ou as notas e bloqueadores): <cole aqui>.
1. Explique cada bloqueador em linguagem simples e diga a qual das oito camadas ele pertence.
2. Monte a lista desta semana usando as seis correções da página, na ordem certa para o meu caso.
3. Sugira UMA primeira ferramenta declarativa a partir de um formulário meu que não muda nada perigoso: nome, descrição e argumentos.
4. Separe o que o scanner consegue provar do que exige revisão humana (autorização no backend, idempotência, descrição x efeito real).
5. Indique a fase da Formação WebMCP por onde eu ou meu time devemos começar.
Não prometa ranking, indexação ou citação por IA.
Critério de pronto
Explicar o que muda quando agentes visitam sites, o que é WebMCP e qual é o primeiro passo concreto: diagnosticar o próprio site e corrigir o básico. Guarde a ficha com a tese, o público, o primeiro passo e a porta de entrada.
Abrir a página da área ↗Confira o que ficou
O scanner encontrou uma ferramenta declarada num script do seu site. Isso garante que ela está protegida e funciona para todo visitante?
Ver resposta comentada
Não. O scanner prova o que é observável; autorização real no backend, idempotência, correspondência entre descrição e efeito e se a definição está registrada para todo visitante exigem revisão humana.
Se sua resposta foi diferente, volte ao tópico correspondente e escreva a diferença em uma frase. A checagem não bloqueia seu estudo.
Resumo do módulo
- operar pixels x conversar com capacidades; ferramenta declarativa; ferramenta imperativa; JSON Schema; Origin Trial
- agentes no navegador; buscar virou perguntar; GEO e AEO; catálogo de capacidades; descoberta; segurança no site
- scanner passivo; navegador descartável; nota geral + quatro notas; até 12 correções; relatório JSON; o que exige revisão humana
- descoberta; ferramentas; contrato; estado e erros; controle; permissões; backend e MCP; evals
- linha de base; robots.txt, sitemap.xml, llms.txt; SEO básico; AEO: respostas diretas; GEO: autoria e evidências; primeira ferramenta segura
- visão geral; Builder; Integrator; Agent Developer; Expert; quatro módulos de seis tópicos; cursos ao lado
Consulte a fonte
Páginas lidas em 28/09/2026. O conteúdo das áreas muda; a página oficial vale mais que este resumo.