Agentes de IA (MCP)
O Dashboard.PT tem um servidor MCP (Model Context Protocol), a norma que permite a agentes de IA consultar outros serviços. Depois de o ligares, podes perguntar ao agente, por exemplo, que cronjobs estão com erro ou quando expira o SSL de um site, e ele vai buscar a resposta à tua conta.
Visão geral
O que convém saber
- Planos PLUS e GOLD. A ligação está disponível apenas nestes planos. Se a conta mudar para outro plano, o agente deixa de ter acesso até voltar a um destes.
- Só leitura. O agente pode consultar dados, mas não pode criar, alterar, executar nem apagar nada.
- Só a tua conta. O agente vê apenas os dados da conta que autorizaste.
- Endereço do servidor:
https://dashboard.pt/api/mcp.php
⚠ Privacidade: o que o agente consulta é enviado ao fornecedor de IA que escolheste, que pode tratar os dados fora da Europa, segundo as condições dele. Isto inclui nomes de cronjobs e monitores, URLs, valores dos gráficos e as notas dos teus lembretes. A ligação é opcional: só acontece se a autorizares.
Ligar um agente
Os nomes dos menus podem mudar, porque dependem de cada aplicação.
Claude (web e Desktop)
- Nas definições do Claude, abre os conectores e adiciona um conector personalizado.
- Indica o endereço
https://dashboard.pt/api/mcp.php. - Inicia sessão no Dashboard.PT, se te for pedido.
- Confirma o endereço de retorno claude.ai na página de autorização e carrega em Autorizar.
Claude Code
Adiciona o servidor e depois autoriza-o com o comando /mcp dentro do Claude Code:
claude mcp add --transport http dashboard-pt https://dashboard.pt/api/mcp.php
ChatGPT e outros clientes
O servidor segue a norma MCP, com transporte Streamable HTTP e OAuth 2.1, por isso pode funcionar noutros clientes compatíveis. O ChatGPT só permite adicionar servidores próprios em modo de programador, em alguns planos. Ainda não confirmámos a ligação com o ChatGPT.
O que o agente pode consultar
| Ferramenta | O que devolve |
|---|---|
list_cronjobs | Cronjobs, com os que estão em erro primeiro. Permite filtrar por estado e pesquisar no nome |
get_cronjob_executions | Últimas execuções de um cronjob: estado HTTP, duração e início do texto da resposta |
list_monitors | Monitores: estado, disponibilidade e validade do SSL e do domínio |
list_dashboards | Dashboards e número de gráficos de cada um |
list_graphs | Gráficos, de todos os dashboards ou de um só |
get_graph_data | Pontos de dados de um gráfico, com intervalo de datas opcional |
list_alerts | Regras de alerta e quando dispararam pela última vez |
list_reminders | Lembretes, por defeito só os pendentes |
Segurança
- A autorização é sempre pedida. A página mostra o endereço de retorno, porque o nome da aplicação é ela própria que o indica. Se o endereço não for o que esperas, recusa.
- Credenciais ocultas. Nas URLs, os valores de parâmetros como
token,keyousecretsaem como***. Os cabeçalhos e o corpo dos pedidos dos cronjobs nunca são enviados, só os nomes dos cabeçalhos. - Um limite desta proteção. Um segredo no caminho da URL, ou escrito no nome de um cronjob ou no título de um lembrete, não é detetado.
- Texto de terceiros. As respostas dos cronjobs vêm de outros sites. O servidor marca-as como não fiáveis, mas um texto malicioso pode tentar influenciar o agente, por isso revê o que ele sugerir.
Desligar um agente
Na página Chaves API, a secção Aplicações ligadas mostra cada ligação, com a data e o último uso. Carrega em Desligar para revogar o acesso de imediato. Para voltar a usá-la, tens de a autorizar de novo.
Resumo técnico
| Item | Detalhes |
|---|---|
| Planos | PLUS e GOLD. Nos outros, o servidor responde 403 |
| Transporte | Streamable HTTP (só POST, sem sessão) |
| Versões do protocolo | 2025-03-26, 2025-06-18 e 2025-11-25 |
| Autorização | OAuth 2.1 com PKCE S256 e registo dinâmico de clientes (RFC 7591) |
| Validade dos tokens | Acesso: 1 hora. Renovação: 30 dias, trocado a cada uso |
| Limite por hora | Chamadas a ferramentas, somadas aos pedidos à API: 1000 nos planos PLUS e GOLD |
| Alternativa ao OAuth | Chave API no cabeçalho Authorization: Bearer, nos clientes que permitam definir cabeçalhos |
Quer experimentar? O plano gratuito não tem limite de tempo.
Criar conta gratuita