CoreDash アップタイムAPIとMCPツール: モニターとチェック結果

CoreDash API経由のアップタイムモニター

RUMデータで利用中のAPIキーを使って、REST経由でCoreDashプロジェクトのアップタイムモニターを参照・変更できます。AIエージェントからはMCP経由で読み取れます。

curl https://app.coredash.app/api/uptime/monitors \
  -H "Authorization: Bearer cdk_your_key"

アップタイムモニター用のAPIキー

アップタイムのエンドポイントでは、CoreDash API と Agency API のキーが使用できます。

プロジェクトキーを作成するには、サイドバーの「Connect Your AI」ページで名前を入力し、「Generate API key」をクリックします。同じキーはプロジェクト設定の「API Keys (MCP)」にも表示されます。作成できるのはプロジェクトのオーナーのみです。マスターキーは、Agencyアカウントのサイドバーにある「Agency API」ページから取得します。プロジェクトの有効期限が切れると、そのプロジェクトキーを使った呼び出しにはすべて401が返されます。

プロジェクトのゲストはモニターを参照できます。追加、変更、移動、削除には、自身が所有するプロジェクトが必要です。

ClaudeなどのAI連携によるOAuthトークン（mcp_at_）は読み取り専用です。これを使って POST、PATCH、DELETE を実行すると403が返されます。

アップタイムのエンドポイント

オリジンIPとヘッダーの値は機密情報です。これらが返されるのは POST、PATCH、および GET /api/uptime/monitors/:id のみです。一覧取得とMCPツールでは origin_ip が除外され、各ヘッダー値は •••• とマスク表示されます。

monitorオブジェクト

summaryフィールドとrumフィールド

一覧取得と個別モニター取得のどちらにも summary が含まれます。rounds_7d と down_rounds_7d は直近7日間の総ラウンド数とダウンしたラウンド数をカウントし、uptime_7d はダウン判定がなかったラウンドの割合（％）を示します。recent には直近48ラウンドの最も悪かった結果が古い順に格納されます。直近7日間にチェック実績がないモニターでは summary: null になります。

個別モニターのレスポンスには rum も含まれます。チェッカーの ttfb_ms と比較できるよう、プロジェクトのRUMデータに基づく直近7日間の実訪問者のTTFB（p75）を示します。プロジェクトにRUMデータがない間は null です。

GET /api/uptime/monitors/:id

curl "https://app.coredash.app/api/uptime/monitors/6ad68c7a844fad80b752fd16?limit=2" \
  -H "Authorization: Bearer cdk_your_key"

{
  "monitor": {
    "id": "6ad68c7a844fad80b752fd16",
    "name": "Checkout",
    "url": "https://www.example.com/checkout/",
    "project_id": "655f1f77bcf86cd799439011",
    "paused": false,
    "expect_status": 200,
    "origin_check": true,
    "origin_ip": "203.0.113.10",
    "headers": [{ "name": "X-Staging-Auth", "value": "k7Qp2vX9mR4tL8wZ" }],
    "state": "up",
    "last_check_at": "2026-10-20T08:00:09.000Z",
    "last_up_at": "2026-10-20T08:00:09.000Z",
    "down_since": null,
    "last_down": { "from": "2026-10-18T19:00:11.000Z", "to": "2026-10-18T20:00:10.000Z" },
    "check_requested_at": null,
    "last": {
      "edge": { "at": "2026-10-20T08:00:09.000Z", "server": "scan1", "mode": "edge", "outcome": "up", "status": 200, "ttfb_ms": 212, "total_ms": 388, "connect_ms": 14, "redirects": 0, "final_url": "https://www.example.com/checkout/", "error": null, "error_text": null, "cloudflare": true, "cache_status": "DYNAMIC" },
      "origin": { "at": "2026-10-20T08:00:09.000Z", "server": "scan1", "mode": "origin", "outcome": "up", "status": 200, "ttfb_ms": 640, "total_ms": 702, "connect_ms": 9, "redirects": 0, "final_url": "https://www.example.com/checkout/", "error": null, "error_text": null, "cloudflare": false, "cache_status": null },
      "origin_is_cdn": false
    },
    "cert_expires": "2027-01-02T23:59:59.000Z",
    "created_at": "2026-10-06T09:12:41.000Z"
  },
  "summary": {
    "rounds_7d": 336,
    "down_rounds_7d": 2,
    "uptime_7d": 99.4,
    "recent": [
      { "at": "2026-10-20T07:30:10.000Z", "outcome": "up" },
      { "at": "2026-10-20T08:00:09.000Z", "outcome": "up" }
    ]
  },
  "checks": [
    { "at": "2026-10-20T08:00:09.000Z", "server": "scan1", "mode": "edge", "outcome": "up", "status": 200, "ttfb_ms": 212, "total_ms": 388, "connect_ms": 14, "redirects": 0, "final_url": "https://www.example.com/checkout/", "error": null, "error_text": null, "cloudflare": true, "cache_status": "DYNAMIC" },
    { "at": "2026-10-20T08:00:09.000Z", "server": "scan1", "mode": "origin", "outcome": "up", "status": 200, "ttfb_ms": 640, "total_ms": 702, "connect_ms": 9, "redirects": 0, "final_url": "https://www.example.com/checkout/", "error": null, "error_text": null, "cloudflare": false, "cache_status": null }
  ],
  "rum": { "ttfb_p75": 1920, "rating": "poor", "period": "last 7 days" }
}

実際のレスポンスでは recent に48ラウンド分が格納されますが、この例では直近2件のみを表示しています。

checkオブジェクトと判定結果

30分ごとに1回のラウンドが実行され、2台のサーバーが交互に全モニターをチェックします（毎時00分はscan1、30分はscan2）。各ラウンドでは、訪問者のアクセス経路と同様に、DNSとCDNを経由してURLをチェックします（edge）。オリジンIPが設定されている場合は、サーバー自身も直接チェックします（origin）。ラウンドの合間にモニターを手動チェックするAPIはありません。チェック結果は30日間保持されます。

すべてのチェックで、ユーザーエージェント CoreDash/1.0 (uptime; +https://www.coredash.app/bot) を送信します。モニターのURLがプロジェクト自身のサイト上にある場合（wwwの有無を問わない同一ホスト、またはサブドメイン）、プロジェクト設定の「CoreDash bot token」タブにあるシークレット値を X-CoreDash-Bot ヘッダーとして送信します。それ以外のサイトにあるモニターにはトークンは送信されません。リダイレクト時、トークンは設定した headers と同じルールに従います。リダイレクト先がモニターのホスト内に留まる場合にのみ引き継がれます。自身で設定した X-CoreDash-Bot という名前のヘッダーは破棄されます。詳細については CoreDash botのページ を参照してください。

チェック結果の判定基準

各ラウンドのチェック結果のうち、最も悪い判定によってモニターのステータスが決まります。悪い順に down、blocked、warn、up です。

モニターのステータス

サブスクリプションが終了したプロジェクト内のモニターは、設定と前回のステータスを維持します。プロジェクトの支払いが再開されるまでチェックは行われません。

モニターの追加、変更、削除

POST /api/uptime/monitors

curl -X POST https://app.coredash.app/api/uptime/monitors \
  -H "Authorization: Bearer cdk_master_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.example.com/checkout/",
    "name": "Checkout",
    "project_id": "655f1f77bcf86cd799439011",
    "origin_ip": "203.0.113.10",
    "headers": [{ "name": "X-Staging-Auth", "value": "k7Qp2vX9mR4tL8wZ" }],
    "expect_status": 200
  }'

レスポンスは201で、新しいモニター（オリジンIPとヘッダー値を含む）が返されます:

{
  "monitor": {
    "id": "6ad68c7a844fad80b752fd16",
    "name": "Checkout",
    "url": "https://www.example.com/checkout/",
    "project_id": "655f1f77bcf86cd799439011",
    "paused": false,
    "expect_status": 200,
    "origin_check": true,
    "origin_ip": "203.0.113.10",
    "headers": [{ "name": "X-Staging-Auth", "value": "k7Qp2vX9mR4tL8wZ" }],
    "state": "pending",
    "last_check_at": null,
    "last_up_at": null,
    "down_since": null,
    "last_down": null,
    "check_requested_at": "2026-10-20T09:12:41.000Z",
    "last": {},
    "cert_expires": null,
    "created_at": "2026-10-20T09:12:41.000Z"
  }
}

PATCH /api/uptime/monitors/:id

変更するフィールドのみを送信します。headers は配列全体が置き換わるため、維持するヘッダーもすべて含めて送信してください。以下はモニターを一時停止する例です:

curl -X PATCH https://app.coredash.app/api/uptime/monitors/6ad68c7a844fad80b752fd16 \
  -H "Authorization: Bearer cdk_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "paused": true }'

マスターキー使用時、project_id を指定するとモニターを移動できます（ルールは POST と同様）。

DELETE /api/uptime/monitors/:id

curl -X DELETE https://app.coredash.app/api/uptime/monitors/6ad68c7a844fad80b752fd16 \
  -H "Authorization: Bearer cdk_your_key"

削除の取り消しはできません。履歴を保持したままチェックを停止したい場合は、PATCH で { "paused": true } を送信してください。

アップタイムAPIのエラーと制限事項

エラーは { "error": "..." } の形式で、以下のいずれかのステータスとともに返されます:

制限事項: 1プロジェクトあたり最大25個のモニター、1モニターあたり最大5個の追加ヘッダー、個別モニターの GET で取得できるチェック結果は最大2100件、チェック履歴の保持期間は30日間です。

アップタイム監視用MCPツール

https://app.coredash.app/api/mcp で提供される CoreDash MCPサーバー には、RUMツールに加えて2つのアップタイムツールと、キーがアクセス可能なプロジェクトを一覧表示する list_projects が用意されています。これら3つはいずれも読み取り専用です。モニターの追加、変更、削除を行う場合は、アプリまたは上記のRESTエンドポイントでCoreDash APIキーを使用してください。各ツールで project_id の指定は不要です。プロジェクトキーはそのプロジェクト自身を参照し、マスターキーやClaudeなどのOAuth連携は所有または招待されている全プロジェクトを参照します。

curl -X POST https://app.coredash.app/api/mcp \
  -H "Authorization: Bearer cdk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_uptime_monitor",
      "arguments": { "monitor_id": "6ad68c7a844fad80b752fd16", "limit": 48 }
    }
  }'

レスポンスは CoreDash API のJSON-RPCラッパー形式で返され、結果は result.content[0].text にJSON文字列として格納されます。該当するモニターが存在しない場合はそこに { "error": "Monitor not found" } が入り、result.isError は true になります。

アップタイムとCoreDash APIの詳細

• アップタイム監視: CoreDashのチェック項目とアプリ画面での確認方法。
• CoreDash API: プロジェクトキー、JSON-RPC形式、RUMツール。
• Agency API: マスターキーとRESTによるプロジェクト操作。
• CoreDash bot: ユーザーエージェント、X-CoreDash-Bot ヘッダー、IPアドレス。
• ファイアウォールでCoreDashを許可する: ステータスが「Blocked」と表示されているモニター向け。