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)

  1. Nas definições do Claude, abre os conectores e adiciona um conector personalizado.
  2. Indica o endereço https://dashboard.pt/api/mcp.php.
  3. Inicia sessão no Dashboard.PT, se te for pedido.
  4. 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_cronjobsCronjobs, 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_monitorsMonitores: estado, disponibilidade e validade do SSL e do domínio
list_dashboardsDashboards e número de gráficos de cada um
list_graphsGráficos, de todos os dashboards ou de um só
get_graph_dataPontos de dados de um gráfico, com intervalo de datas opcional
list_alertsRegras de alerta e quando dispararam pela última vez
list_remindersLembretes, 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, key ou secret saem 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
PlanosPLUS e GOLD. Nos outros, o servidor responde 403
TransporteStreamable HTTP (só POST, sem sessão)
Versões do protocolo2025-03-26, 2025-06-18 e 2025-11-25
AutorizaçãoOAuth 2.1 com PKCE S256 e registo dinâmico de clientes (RFC 7591)
Validade dos tokensAcesso: 1 hora. Renovação: 30 dias, trocado a cada uso
Limite por horaChamadas a ferramentas, somadas aos pedidos à API: 1000 nos planos PLUS e GOLD
Alternativa ao OAuthChave 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