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
- Crie um token em Conta, MCP e API (rotule-o com o nome do agente, p. ex. «Cursor da empresa»).
- 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.
| Ferramenta | Devolve | Argumentos |
|---|---|---|
visibilidade_resumo | Visibilidade 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ção | weeks (1 a 52, por omissão 12) |
perguntas_monitorizadas | Perguntas com o último estado por motor; failed é uma medição falhada e não conta como ausente | nenhum |
fontes_citadas | Hosts 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_ciclo | No plano Parceiros, dotação, usados e restantes; nos outros planos, o que o ciclo mediu e corrigiu | nenhum |
unidades | As unidades de todos os projetos, com cidade, morada e o estado da ficha Google | nenhum |
visibilidade_por_unidade | Visibilidade por semana de cada unidade, no total e por motor; a semana sem medição vem null | weeks (1 a 52, por omissão 12), location_ids (opcional) |
correcoes_da_unidade | As correções em vigor numa unidade, as dela e as do site inteiro | location_id |
links_nas_respostas | Os 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 respondeu | project_id e state (opcionais) |
fontes_por_divisao | As 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 iniciada | days (1 a 90, por omissão 30), project_ids (opcional) |
analise_do_site | A ú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ão | nenhum |
rascunhos | Os 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 nada | nenhum |
concorrentes | Em 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_probed | days (1 a 90, por omissão 30) |
trafego_da_ia | Visitas 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 null | nenhum |
acoes | A 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 uma | status (opcional) |
temas | Os temas que agrupam as perguntas de cada site, com as perguntas ativas de cada um e as que ainda não têm tema | nenhum |
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.