API di uptime e tool MCP di CoreDash: monitor e check
Elenca, aggiungi, modifica ed elimina i monitor di uptime con l'API key di CoreDash, leggine i check o lascia che lo faccia un agente AI via MCP.
Arjen Karel - linkedin
Last update: 2026-10-19
Trusted by market leaders · Client results
Autenticazione
Gli endpoint di uptime accettano gli stessi token Bearer del resto dell'API di CoreDash:
- API key di progetto (
cdk_...): vede i monitor collegati a quel progetto RUM. Ogni monitor creato con questa chiave viene collegato a quel progetto. - Master key (
cdk_master_..., API Agency): tutti i monitor dell'account, più quelli collegati ai progetti che l'account può aprire. - Token OAuth MCP: stesso scope di un'API key di progetto.
Endpoint
| Metodo e path | Cosa fa |
|---|---|
GET /api/uptime/monitors | Tutti i monitor con stato, ultimo check, uptime su 7 giorni ed esito degli ultimi 48 check. |
POST /api/uptime/monitors | Aggiunge un monitor. Restituisce 201 e il monitor. Il primo check viene eseguito entro un minuto. |
GET /api/uptime/monitors/:id | Un singolo monitor con i check recenti, in ordine dal più recente. ?limit= fino a 2100 (7 giorni con origin check). |
PATCH /api/uptime/monitors/:id | Modifica i campi inviati. paused: true ferma i check. |
DELETE /api/uptime/monitors/:id | Elimina il monitor e lo storico dei check. |
POST /api/uptime/monitors/:id/check | Richiede subito un check. Restituisce 202; il risultato arriva entro circa un minuto. |
Aggiungi un monitor
| Campo | Significato |
|---|---|
url | Obbligatorio. Un URL http o https completo. |
name | Nome visualizzato. Default: l'host dell'URL. |
project_id | Solo con master key: collega il monitor a un progetto RUM per il confronto del TTFB. |
origin_ip | IP pubblico del server. Aggiunge l'origin check, che aggira il DNS e la CDN. Una stringa vuota lo rimuove. |
headers | Fino a 5 header di richiesta, [{ "name", "value" }], per una regola del firewall che fa passare il checker. |
expect_status | Lo status considerato up. Default 200. |
paused | Solo PATCH. true ferma i check, false li riattiva. |
Come si presenta un monitor
state può essere:
up: l'ultimo check è passato.failing: l'ultimo check è fallito, quello precedente è passato.down: due check falliti di fila, quindi entrambi i server hanno rilevato il fallimento.blocked: un 403, un 429 o una challenge di Cloudflare. Vedi come far passare il checker.warn: qualsiasi status diverso da quello considerato up.pendingopaused.
Un check fallito riporta un error: dns, connect, connect_timeout, timeout (30 secondi), tls, redirects o network. L'IP di origin e i valori degli header si trovano solo in GET /api/uptime/monitors/:id. Gli elenchi e le risposte MCP li mascherano.
Tool MCP
Il server MCP di CoreDash ha sei tool di uptime accanto a quelli RUM. Con una master key non serve il project_id.
| Tool | A cosa serve |
|---|---|
list_uptime_monitors | "È tutto up?" |
get_uptime_monitor | "Il checkout è stato down questa settimana, e da quando?" Restituisce i check recenti e il relativo uptime. |
create_uptime_monitor | "Monitora anche la pagina di login." |
update_uptime_monitor | Modifica l'URL, l'IP di origin o gli header, oppure metti in pausa un monitor. |
delete_uptime_monitor | Elimina un monitor e il suo storico. |
check_uptime_now | "Fai di nuovo un check adesso." |
