Índice e busca do manual
Usar um agente no navegador com o WebMCP
Deixe um agente de IA que opera o seu navegador usar as ferramentas das telas da naia e confirme na tela cada ação que consome créditos, apaga dados ou publica conteúdo.
8 passos · Conferido em 12 de outubro de 2026
Como você quer ver este tutorial
Ferramentas da naia para agentes no navegador
O WebMCP deixa um agente de IA que opera o seu navegador usar ferramentas estruturadas das telas da naia, em vez de clicar campo a campo. As telas publicam essas ferramentas em document.modelContext, o contrato do rascunho W3C de 9 de outubro de 2026. No Chrome com a API nativa (origin trial, nas versões 149 a 156, ou com a flag chrome://flags/#enable-webmcp-testing ligada), a naia usa a API do navegador; sem ela, a naia instala o próprio polyfill, com o mesmo contrato. Funciona com agentes que operam o navegador, como o Claude no Chrome, o Gemini no Chrome, extensões MCP-B e o Chrome DevTools. Cada ferramenta faz o mesmo que o clique equivalente, com a mesma validação e as mesmas permissões da sua conta. Não confunda com o MCP da naia, em naia.today/api/v1/mcp, que conecta um programa de IA à sua conta sem passar pelo navegador.
O que dá para fazer
- Pedir ao agente que leia relatório, conteúdos, marcas e saldo sem abrir cada tela.
- Editar vários prompts do cadastro de marca numa só chamada.
- Confirmar ou recusar na tela cada ação que consome créditos, apaga dados ou publica conteúdo.
- Permitir por 30 minutos as próximas ações do mesmo tipo, com teto de créditos.
Tipos disponíveis
| Tipo | O que é |
|---|---|
| Páginas públicas da naia | Sem login e só de leitura: naia_ask, naia_get_site_info, naia_naia_index, naia_gpt_ads_snapshot, naia_manual_search, naia_manual_list e naia_manual_get_tutorial. |
| Telas logadas | naia_context e naia_navigate, mais as leituras globais (marcas, créditos, relatório, histórico, prompts, memórias, conteúdos, Autoridade, agentes, organizações), restritas às marcas que você acessa. |
| Cadastro de marca | Ferramentas do cadastro no Autopilot, como setup_get_state, setup_go_to_step, setup_list_prompts, setup_edit_prompts e setup_start, que pede confirmação antes de gastar créditos. |
| naia Pages | Leitura do conteúdo publicado no próprio site: search_content, get_content, get_site_info, search_chunks, ask e list_by_type. |
| Sites de autoridade | Leitura das fontes verificadas e do perfil: search_sources, get_profile, list_sources, get_source, how_to_cite, get_faq, get_timeline e list_recent_publications. |
Passo a passo
Passo 1: Deixe o agente usar as ferramentas da tela
Com a naia aberta no navegador, peça ao agente o que você quer fazer. Nas telas logadas, a primeira chamada recomendada é naia_context: ela devolve a tela ativa, a marca, as ferramentas disponíveis e o saldo de créditos, e naia_navigate abre outra tela da naia com as ferramentas dela. Em qualquer tela logada valem as ferramentas globais de leitura, como brands_list, credits_get, report_get e content_list, sempre restritas às marcas a que você tem acesso. No cadastro de marca do Autopilot entram as ferramentas do cadastro, como setup_get_state, setup_list_prompts, setup_edit_prompts e setup_start. Nas páginas públicas da naia, sem login, valem só ferramentas de leitura, como naia_ask e naia_manual_search, e as naia Pages e os sites de autoridade publicados pela naia expõem ferramentas de leitura do próprio conteúdo.
O que dá para fazer
- Começar pela naia_context para o agente saber em que tela e em que marca está.
- Pedir ao agente que troque de tela pela naia_navigate.
- Ler dados só das marcas a que a sua conta tem acesso.
Passo 2: Leia o que o agente pediu
Quando uma ferramenta consome créditos, apaga dados ou publica conteúdo, a naia abre este modal antes de executar. Se a ferramenta descreve a ação, o modal mostra o título e a descrição dela: no cadastro de marca, setup_start mostra Iniciar o monitoramento de, com o nome da marca, e a quantidade de prompts, tópicos e motores por ciclo. Sem descrição, aparece o título Confirmar ação pedida pelo agente, com o texto Um agente no seu navegador pediu uma ação que consome créditos, apaga dados ou publica conteúdo.
O que dá para fazer
- Conferir que a ação pedida é a que você queria.
- Recusar quando o título não bate com o que você pediu ao agente.
Passo 3: Confira o custo e os itens
Em ação que consome créditos, a linha Custo mostra quantos créditos a ação vai usar. Quando a ferramenta não informa o valor, aparece Esta ação consome créditos. Em ação que afeta itens, o modal lista os primeiros dez em Itens afetados e indica quantos faltam.
O que dá para fazer
- Ver o custo em créditos antes de confirmar.
- Conferir quais itens serão afetados.
Passo 4: Saiba de onde veio o pedido
A linha Pedido feito por um agente no seu navegador lembra que quem pediu a ação foi o agente, e não um clique seu na tela. O modal só aparece para ferramentas com consequência; leituras rodam direto, sem confirmação.
O que dá para fazer
- Distinguir um pedido do agente de uma ação que você mesmo iniciou.
Passo 5: Recuse com Cancelar
Cancelar fecha o modal e a ferramenta devolve uma recusa ao agente. Nada é enviado nem cobrado. Fechar o modal de outro jeito tem o mesmo efeito, e o pedido também vale como recusado se o agente desistir ou se você trocar de tela com o modal aberto.
O que dá para fazer
- Impedir a ação sem gastar créditos.
- Pedir ao agente outra coisa depois da recusa.
Passo 6: Confirme só esta ação
Confirmar libera apenas a ação descrita no modal. Sem uma janela de permissão aberta, a próxima ação que consome créditos, apaga dados ou publica conteúdo abre o modal de novo.
O que dá para fazer
- Aprovar uma ação de cada vez.
Passo 7: Permita por 30 minutos
Confirmar e permitir por 30 minutos aprova esta ação e abre uma janela em que as próximas do mesmo tipo seguem sem o modal. A janela vale só nesta aba do navegador e tem limites: os créditos gastos nela somam no máximo 500, e passado o teto o modal volta; exclusão de mais de 10 itens sempre pede confirmação. Publicação nunca entra na janela: nesse caso o botão não aparece e toda publicação pede Confirmar.
O que dá para fazer
- Deixar o agente concluir uma série de ações sem confirmar uma por uma.
- Contar com o teto de 500 créditos para limitar o gasto do agente.
Passo 8: Acompanhe e encerre a permissão
Enquanto a janela está aberta, o canto inferior esquerdo mostra Agente com permissão até e a hora em que ela acaba. Encerrar permissão fecha a janela na hora, e a próxima ação com consequência volta a pedir confirmação no modal.
O que dá para fazer
- Ver até que horas o agente age sem confirmação.
- Encerrar a permissão antes dos 30 minutos.