API de uptime e ferramentas MCP do CoreDash: monitores e verificações
Liste, adicione, altere e elimine monitores de uptime com a sua chave de API do CoreDash, consulte as respetivas verificações ou deixe um agente de IA fazê-lo via MCP.
Arjen Karel - linkedin
Last update: 2026-10-19
Trusted by market leaders · Client results
Autenticação
Os endpoints de uptime aceitam os mesmos tokens Bearer que o resto da API do CoreDash:
- Chave de API de projeto (
cdk_...): vê os monitores associados a esse projeto RUM. Um monitor criado com ela fica associado a esse projeto. - Master key (
cdk_master_..., API de agência): todos os monitores da conta, mais os monitores associados a projetos que a conta pode abrir. - Token OAuth MCP: o mesmo âmbito de uma chave de projeto.
Endpoints
| Método e path | O que faz |
|---|---|
GET /api/uptime/monitors | Todos os monitores com o estado, última verificação, uptime a 7 dias e o resultado das últimas 48 verificações. |
POST /api/uptime/monitors | Adiciona um monitor. Devolve 201 e o monitor. A primeira verificação corre em menos de um minuto. |
GET /api/uptime/monitors/:id | Um monitor com as verificações recentes, as mais recentes primeiro. ?limit= até 2100 (7 dias com verificação de origem). |
PATCH /api/uptime/monitors/:id | Altera os campos enviados. paused: true para as verificações. |
DELETE /api/uptime/monitors/:id | Elimina o monitor e o histórico de verificações. |
POST /api/uptime/monitors/:id/check | Pede uma verificação imediata. Devolve 202; o resultado chega em cerca de um minuto. |
Adicionar um monitor
| Campo | Significado |
|---|---|
url | Obrigatório. Um URL completo http ou https. |
name | Nome de apresentação. Por omissão: o host do URL. |
project_id | Apenas com master key: associa o monitor a um projeto RUM para a comparação do TTFB. |
origin_ip | IP público do servidor. Adiciona a verificação de origem, que contorna o DNS e a CDN. Uma string vazia remove a verificação. |
headers | Até 5 headers de pedido, [{ "name", "value" }], para uma regra de firewall que deixe passar o checker. |
expect_status | O status que conta como up. Por omissão: 200. |
paused | Apenas em PATCH. true para as verificações, false retoma-as. |
Estrutura de um monitor
O state pode ser:
up: a última verificação passou.failing: a última verificação falhou, a anterior passou.down: duas verificações falhadas seguidas, logo ambos os servidores viram a falha.blocked: um 403, um 429 ou um challenge da Cloudflare. Consulte como deixar passar o checker.warn: qualquer status diferente daquele que conta como up.pendingoupaused.
Uma verificação com falha tem um error: dns, connect, connect_timeout, timeout (30 segundos), tls, redirects ou network. O IP de origem e os valores dos headers só são devolvidos em GET /api/uptime/monitors/:id. As listas e as respostas do MCP mascaram-nos.
Ferramentas MCP
O servidor MCP do CoreDash tem seis ferramentas de uptime a par das ferramentas de RUM. Com uma master key, não precisam de project_id.
| Ferramenta | Para que serve |
|---|---|
list_uptime_monitors | "Está tudo operacional?" |
get_uptime_monitor | "O checkout esteve em baixo esta semana, e desde quando?" Devolve as verificações recentes e o uptime correspondente. |
create_uptime_monitor | "Monitoriza também a página de login." |
update_uptime_monitor | Altera o URL, o IP de origem ou os headers, ou pausa um monitor. |
delete_uptime_monitor | Remove um monitor e o respetivo histórico. |
check_uptime_now | "Verifica novamente agora." |
