CoreDash Uptime APIとMCPツール：モニターとチェック
CoreDash APIキーでUptimeモニターの一覧取得、追加、変更、削除、チェック結果の確認が行えます。MCP経由でAIエージェントに任せることも可能です。
Arjen Karel - linkedin
Last update: 2026-10-19
Trusted by market leaders · Client results
認証
Uptimeエンドポイントは、他のCoreDash APIと同じBearerトークンを受け付けます：
- プロジェクトAPIキー（
cdk_...）：対象のRUMプロジェクトに紐づくモニターを参照できます。このキーで作成したモニターは、そのプロジェクトに紐づきます。 - マスターキー（
cdk_master_...、Agency API）：アカウント内の全モニターと、そのアカウントが開けるプロジェクトに紐づくモニターを参照できます。 - MCP OAuthトークン：プロジェクトAPIキーと同じスコープです。
エンドポイント
| メソッドとパス | 処理内容 |
|---|---|
GET /api/uptime/monitors | すべてのモニターのステータス、最終チェック、過去7日間の稼働率、直近48回のチェック結果を取得します。 |
POST /api/uptime/monitors | モニターを追加します。201と作成されたモニターを返します。初回のチェックは1分以内に実行されます。 |
GET /api/uptime/monitors/:id | 指定したモニターの直近のチェック結果（新しい順）を取得します。?limit=は最大2100件（オリジンチェック有効時で7日分）です。 |
PATCH /api/uptime/monitors/:id | 指定したフィールドの値を更新します。paused: trueでチェックを停止します。 |
DELETE /api/uptime/monitors/:id | モニターとチェック履歴を削除します。 |
POST /api/uptime/monitors/:id/check | 即時チェックをリクエストします。202を返し、約1分後に結果が反映されます。 |
モニターの追加
| フィールド | 説明 |
|---|---|
url | 必須。完全なhttpまたはhttpsのURL。 |
name | 表示名。デフォルトはURLのホスト名です。 |
project_id | マスターキーのみ。TTFB比較のため、モニターをRUMプロジェクトに紐づけます。 |
origin_ip | サーバーのパブリックIP。DNSやCDNを経由しないオリジンチェックを追加します。空文字列を指定すると解除されます。 |
headers | 最大5個のリクエストヘッダー（[{ "name", "value" }]）。チェッカーを通過させるファイアウォールルールに使用します。 |
expect_status | 正常（up）と判定するステータスコード。デフォルトは200です。 |
paused | PATCH専用。trueでチェックを停止し、falseで再開します。 |
モニターのデータ構造
stateには次のいずれかが入ります：
up：直近のチェックが成功しています。failing：前回のチェックは成功し、直近のチェックのみが失敗しています。down：2回連続で失敗し、両方のサーバーで失敗が確認された状態です。blocked：403、429、またはCloudflareのチャレンジが発生しています。チェッカーのアクセス許可を参照してください。warn：正常（up）判定以外のステータスコードが返されています。pendingまたはpaused。
失敗したチェックにはerrorが含まれます。値はdns、connect、connect_timeout、timeout（30秒）、tls、redirects、networkのいずれかです。オリジンIPとヘッダーの値が返されるのはGET /api/uptime/monitors/:idのみです。一覧取得やMCPのレスポンスではマスクされます。
MCPツール
CoreDash MCPサーバーには、RUMツールに加えて6つのUptimeツールが用意されています。マスターキーを使用する場合、project_idは不要です。
| ツール | 用途 |
|---|---|
list_uptime_monitors | 「すべて正常に稼働しているか？」 |
get_uptime_monitor | 「今週チェックアウトはダウンしたか？ いつから落ちていたか？」直近のチェック結果とその期間の稼働率を返します。 |
create_uptime_monitor | 「ログインページも監視して」 |
update_uptime_monitor | URL、オリジンIP、ヘッダーの変更、またはモニターの一時停止。 |
delete_uptime_monitor | モニターとチェック履歴の削除。 |
check_uptime_now | 「今すぐ再チェックして」 |
