CoreDash Uptime API 与 MCP 工具：监控项与检查记录

通过 CoreDash API 管理 Uptime 监控项

通过 REST 读取并修改 CoreDash 项目的 Uptime 监控项，直接使用现有的 RUM API key 即可。AI agent 则可通过 MCP 读取。

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

Uptime 监控项的 API key

Uptime 端点支持 CoreDash API 和 Agency API 的 key。

在项目侧边栏的 Connect Your AI 页面创建 project key：输入名称，点击 Generate API key。在项目设置的 API Keys (MCP) 下也能找到这些 key。只有项目所有者才能创建。agency 账户可在侧边栏的 Agency API 页面获取 master key。项目一旦过期，其 project key 的每次调用都会返回 401。

项目的 guest 只能读取监控项。添加、修改、移动和删除监控项，需要你拥有该项目。

Claude 等 AI 连接的 OAuth token（mcp_at_）仅有只读权限。使用它调用 POST、PATCH 和 DELETE 会返回 403。

Uptime 端点

源站 IP 与请求头的值为敏感信息。POST、PATCH 以及 GET /api/uptime/monitors/:id 会返回这些值。列表接口与 MCP 工具则会省略 origin_ip，并将所有请求头的值显示为 ••••。

Monitor 对象

summary 和 rum 字段

列表与单个监控项均包含 summary：rounds_7d 和 down_rounds_7d 统计最近 7 天的检查轮次，uptime_7d 是其中没有 down 检查的轮次百分比，recent 包含最近 48 轮记录（时间由远及近），每条记录对应那轮的最差结果。最近 7 天内无检查记录的监控项，其 summary: null。

单个监控项还包含 rum：取自项目的 RUM 数据，即最近 7 天真实访客的 p75 TTFB，用于与检测节点的 ttfb_ms 对比。项目尚无 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 轮记录；本例仅展示最近两轮。

Check 对象与检查结果

每 30 分钟检查一轮所有监控项，由两台服务器交替执行：:00 由 scan1 执行，:30 由 scan2 执行。一轮检查始终模拟访客访问路径，经由 DNS 和 CDN（edge）。设置了源站 IP 时，还会直接检查服务器本身（origin）。API 不提供在两轮之间触发即时检查的接口。检查记录保留 30 天。

每次检查都会发送 user agent CoreDash/1.0 (uptime; +https://www.coredash.app/bot)。当监控项的 URL 属于项目自身的站点（即其 host，带或不带 www，或子域名）时，检查还会附带 X-CoreDash-Bot 请求头，其值为项目设置中 CoreDash bot token 选项卡下的密钥。其他站点的监控项不会附带该 token。重定向时，该 token 遵循自定义 headers 的规则：仅在重定向保持在监控项 host 上时才会继续携带。若自行配置了名为 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 }'

使用 master key 时，可通过 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 }。

Uptime API 错误与限制

错误响应格式为 { "error": "..." }，状态码为以下之一：

限制：每个项目最多 25 个监控项，每个监控项最多 5 个自定义请求头，单个监控项的 GET 请求最多返回 2100 条检查记录，检查历史保留 30 天。

Uptime MCP 工具

位于 https://app.coredash.app/api/mcp 的 CoreDash MCP server 在 RUM 工具之外还提供了两个 Uptime 工具，以及用于查询当前 key 权限范围内项目的 list_projects。这三个工具均为只读。添加、修改或删除监控项，需在控制台操作，或使用 CoreDash API key 调用上述 REST 端点。这些工具无需 project_id：project key 直接读取所属项目，master key 或 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 包装格式，结果以 JSON 字符串形式保存在 result.content[0].text 中。若监控项不存在，该位置会返回 { "error": "Monitor not found" }，且 result.isError 为 true。

更多关于 Uptime 与 CoreDash API 的内容

• Uptime 监控：CoreDash 的检查机制以及控制台中的呈现方式。
• CoreDash API：project key、JSON-RPC 格式及 RUM 工具。
• Agency API：master key 以及通过 REST 管理项目。
• CoreDash bot：user agent、X-CoreDash-Bot 请求头及 IP 地址列表。
• 在防火墙中放行 CoreDash：适用于状态显示为已拦截的监控项。