API uptime i narzędzia MCP CoreDash: monitory i sprawdzenia
Listuj, dodawaj, zmieniaj i usuwaj monitory uptime za pomocą klucza API CoreDash, odczytuj ich sprawdzenia albo pozwól agentowi AI zrobić to przez MCP.
Arjen Karel - linkedin
Last update: 2026-10-19
Uwierzytelnianie
Endpointy uptime przyjmują te same tokeny Bearer co reszta API CoreDash:
- Klucz API projektu (
cdk_...): widzi monitory powiązane z tym projektem RUM. Monitor, który nim utworzysz, zostaje powiązany z tym projektem. - Klucz master (
cdk_master_..., Agency API): wszystkie monitory na koncie plus te powiązane z projektami, do których konto ma dostęp. - Token OAuth MCP: ten sam zakres co klucz projektu.
Endpointy
| Metoda i ścieżka | Co robi |
|---|---|
GET /api/uptime/monitors | Wszystkie monitory ze stanem, ostatnim sprawdzeniem, uptime z 7 dni oraz wynikiem ostatnich 48 sprawdzeń. |
POST /api/uptime/monitors | Dodaje monitor. Zwraca 201 i utworzony monitor. Pierwsze sprawdzenie uruchamia się w ciągu minuty. |
GET /api/uptime/monitors/:id | Pojedynczy monitor z ostatnimi sprawdzeniami, od najnowszych. ?limit= do 2100 (7 dni ze sprawdzaniem origin). |
PATCH /api/uptime/monitors/:id | Zmienia przesłane pola. paused: true zatrzymuje sprawdzanie. |
DELETE /api/uptime/monitors/:id | Usuwa monitor i historię jego sprawdzeń. |
POST /api/uptime/monitors/:id/check | Zleca natychmiastowe sprawdzenie. Zwraca 202; wynik pojawia się w ciągu około minuty. |
Dodaj monitor
| Pole | Znaczenie |
|---|---|
url | Wymagane. Pełny adres URL http lub https. |
name | Nazwa wyświetlana. Domyślnie: host z adresu URL. |
project_id | Tylko dla klucza master: łączy monitor z projektem RUM na potrzeby porównania TTFB. |
origin_ip | Publiczne IP serwera. Dodaje sprawdzanie origin, które omija DNS i CDN. Pusty ciąg znaków je usuwa. |
headers | Do 5 nagłówków żądania, [{ "name", "value" }], pod regułę firewalla przepuszczającą checker. |
expect_status | Status uznawany za up. Domyślnie 200. |
paused | Tylko PATCH. true zatrzymuje sprawdzanie, false je wznawia. |
Jak wygląda monitor
state przyjmuje jedną z wartości:
up: ostatnie sprawdzenie powiodło się.failing: ostatnie sprawdzenie nie powiodło się, a poprzednie przeszło.down: dwa nieudane sprawdzenia z rzędu, więc oba serwery odnotowały błąd.blocked: kod 403, 429 lub challenge Cloudflare. Zobacz jak przepuścić checker.warn: każdy inny status niż ten uznawany za up.pendinglubpaused.
Nieudane sprawdzenie zawiera error: dns, connect, connect_timeout, timeout (30 sekund), tls, redirects lub network. IP serwera origin i wartości nagłówków zwraca tylko GET /api/uptime/monitors/:id. Listy i odpowiedzi MCP je maskują.
Narzędzia MCP
Serwer MCP CoreDash ma obok narzędzi RUM sześć narzędzi do uptime. Z kluczem master nie wymagają one project_id.
| Narzędzie | Do czego służy |
|---|---|
list_uptime_monitors | „Czy wszystko działa?” |
get_uptime_monitor | „Czy checkout nie działał w tym tygodniu i od kiedy?” Zwraca ostatnie sprawdzenia i uptime z tego okresu. |
create_uptime_monitor | „Monitoruj też stronę logowania.” |
update_uptime_monitor | Zmień URL, IP serwera origin lub nagłówki albo wstrzymaj monitor. |
delete_uptime_monitor | Usuń monitor i jego historię. |
check_uptime_now | „Sprawdź to teraz ponownie.” |