Diagnóstico grátis no ChatGPT e nas AI Overviews →

Fazer diagnóstico

Com o mesmo token da API, pode ligar ao Notado um agente de IA que use MCP, como o Claude Code, o Cursor ou o Gemini CLI. O agente passa a consultar os dados do seu painel. O acesso é só de leitura: o agente não altera nada no Notado.

O acesso por token está incluído no plano Parceiros. Nos planos Base, Essencial e Negócio não está incluído. Um token de uma organização sem API recebe uma recusa que o diz.

O Claude Desktop e o ChatGPT ainda não ligam: pedem OAuth e o Notado usa um token fixo.

Ligar em dois passos

  1. Crie um token em Conta, MCP e API (rotule-o com o nome do agente, p. ex. «Cursor da empresa»).
  2. No seu cliente MCP, aponte ao servidor Notado:
{
  "mcpServers": {
    "notado": {
      "type": "http",
      "url": "https://notado.pt/mcp/notado",
      "headers": { "Authorization": "Bearer notado_O_SEU_TOKEN" }
    }
  }
}

O endereço certo para a sua instalação aparece em Conta, MCP e API, no campo «URL do servidor MCP», pronto a copiar. O limite é de 60 pedidos por minuto, por token, em cada uma das duas portas (API e MCP).

O que o agente vê

O servidor tem quinze ferramentas, todas só de leitura e limitadas à organização do token. As que têm endpoint na API devolvem os mesmos dados; fontes_por_divisao, concorrentes, trafego_da_ia, acoes e temas só existem aqui. As três por unidade servem as redes com várias localizações.

FerramentaDevolveArgumentos
visibilidade_resumoVisibilidade por semana; a semana sem medição vem null, e não 0. cited_without_name conta à parte as respostas que citam o site sem nomear o negócio: não entra na ausência e vem null na semana sem mediçãoweeks (1 a 52, por omissão 12)
perguntas_monitorizadasPerguntas com o último estado por motor; failed é uma medição falhada e não conta como ausentenenhum
fontes_citadasHosts citados e hosts lidos sem citação, contados só nas medições em que o motor revelou o que leu (hoje ChatGPT, Perplexity e Claude)days (1 a 90, por omissão 30)
creditos_do_cicloNo plano Parceiros, dotação, usados e restantes; nos outros planos, o que o ciclo mediu e corrigiunenhum
unidadesAs unidades de todos os projetos, com cidade, morada e o estado da ficha Googlenenhum
visibilidade_por_unidadeVisibilidade por semana de cada unidade, no total e por motor; a semana sem medição vem nullweeks (1 a 52, por omissão 12), location_ids (opcional)
correcoes_da_unidadeAs correções em vigor numa unidade, as dela e as do site inteirolocation_id
links_nas_respostasOs endereços do site que os motores mostraram nas respostas, com o estado de cada um. partido e inacessivel contam em separado: o primeiro é a página, o segundo é o site que recusou o pedido ou não respondeuproject_id e state (opcionais)
fontes_por_divisaoAs fontes citadas de cada site, divididas por quem a resposta nomeou: só a marca, ambos, só concorrentes. Um estado diferente de split fica por medir; os concorrentes vêm com o nome, também num site de saúde, porque a ligação é da conta com sessão iniciadadays (1 a 90, por omissão 30), project_ids (opcional)
analise_do_siteA última análise legível de cada site: nota, nota anterior, categorias, verificações com falha e histórico. Um site sem análise legível vem not_probed com a nota null: está por medir, e não a zero. Uma categoria pode vir por medir ou não aplicável, com a razãonenhum
rascunhosOs rascunhos de cada site, escritos só a partir de factos confirmados. approved só é verdadeiro enquanto o texto for o que foi aprovado; blocked marca os que têm frases sem facto confirmado, e blocked_reasons diz porquê. Aprovar não publica nadanenhum
concorrentesEm quantas das respostas lidas na janela cada concorrente foi nomeado, com o número de respostas lidas ao lado. Sem respostas lidas, a visibilidade vem null e o estado not_probeddays (1 a 90, por omissão 30)
trafego_da_iaVisitas que chegaram de respostas de IA, por motor e por semana, nas últimas doze semanas. Um motor sem nenhum dia medido vem not_probed com visits nullnenhum
acoesA fila de ações de cada site por ordem de importância: abertas, em curso e feitas, com o grupo e o impacto de cada umastatus (opcional)
temasOs temas que agrupam as perguntas de cada site, com as perguntas ativas de cada um e as que ainda não têm temanenhum

visibilidade_resumo, perguntas_monitorizadas, fontes_citadas, visibilidade_por_unidade e fontes_por_divisao aceitam também language, com pt-PT ou en, como a API: uma língua por chamada, nunca as duas somadas, e sem ela cada site lê a língua com mais perguntas ativas, o português em caso de empate. Um site que não mede a língua pedida vem em languages com not_measured («Não medido em inglês»), que não é ausência.

Pedidos prontos

Em Conta, Pedidos para o agente, ou no botão «Pedidos prontos» do ecrã MCP e API, há pedidos para colar no seu assistente, por categoria, cada um com as ferramentas que lê. Escolha o site e os dias num formulário e copie o texto já completo. A página de ajuda explica como funcionam.

O que perguntar ao agente

  • «Qual foi a minha visibilidade nas últimas 8 semanas, e em que semana mudou?»
  • «Que sites leram os motores sem os citar, nos últimos 30 dias?»
  • «O que já medimos e corrigimos neste ciclo?»
  • «Que unidade perdeu mais visibilidade nas últimas quatro semanas?»
  • «Que concorrente foi mais nomeado este mês, e em quantas respostas lidas?»
  • «Quais são as cinco ações abertas mais importantes do meu site?»

Sem token válido, o agente vê as ferramentas mas cada chamada devolve um erro e nenhum dado. Uma chamada sem token não devolve 401 como a API. O ecrã de API mostra a última utilização de cada token, seja de um script ou de um agente.

Ainda com dúvidas? Escreva para [email protected]. Respondemos em 1 dia útil, ou em 2 dias úteis no Notado Base, nos dias úteis, das 10:00 às 18:00, hora de Lisboa.

Continuar a ler