O Notado é consumível por agentes de IA: o mesmo token da API liga o ChatGPT, o Claude, o Cursor ou o Gemini CLI da sua empresa aos dados do seu painel. Só leitura; nenhum agente escreve no produto por aqui.
Ligar em dois passos
- Crie um token em Definições → API (rotule-o com o nome do agente, p. ex. «Claude 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 URL certo para a sua instalação também está pronto a copiar no próprio ecrã de API, na secção «Agentes de IA». O tecto é o mesmo da API: 60 pedidos por minuto, por token.
O que o agente vê
Quatro ferramentas, todas de leitura, todas confinadas à organização do token, com as mesmas formas dos endpoints REST. O agente não pode ser melhor informado do que o seu painel.
| Ferramenta | Devolve | Argumentos |
|---|---|---|
visibilidade_resumo | Série semanal; semana sem medição vem null, nunca 0 | weeks (1 a 52, por omissão 12) |
perguntas_monitorizadas | Perguntas com o último estado por motor (failed não é ausente) | — |
fontes_citadas | Hosts citados vs. lidos-sem-citar, com o denominador honesto | days (1 a 90, por omissão 30) |
creditos_do_ciclo | No plano Parceiro, dotação, usados e restantes; nos outros planos, o que o ciclo mediu e corrigiu | — |
O que perguntar ao agente
- «Qual foi a minha visibilidade nas últimas 8 semanas, e em que semana mudou?»
- «Que fontes a IA lê sem citar, no meu sector?»
- «O que já medimos e corrigimos neste ciclo?»
Sem token válido, as ferramentas respondem com erro e nunca com dados. A última utilização fica registada no ecrã de API, venha ela de um script ou de um agente.