面向智能体、CI/CD 和自动化的可用性监控 API

可从脚本、CI/CD、内部工具和自主智能体中使用 KEEPitALIVE API，通过受限权限管理运行工作。

智能体可以管理什么

在具备所需范围且不超出账户套餐限制的情况下，智能体可以读取监控器健康状态和历史记录；创建、更新、暂停、恢复、分组、共享和删除监控器；管理事件和评论；配置触发器、通知资源、状态页、嵌入和 API 密钥。API 已版本化，并使用 OpenAPI 规范记录。

安全使用 API

为特定自动化创建受限 API 密钥，而不是共享权限宽泛的个人凭据。变更前获取当前状态，遵守验证和速率限制，并在可用时使用已记录的幂等控制。对破坏性更改、凭据轮换、计费和账户删除要求明确的人工批准。

curl -H "Authorization: Bearer $KEEPITALIVE_API_KEY" \
  https://keepitalive.dev/api/v1/monitors

使用 MCP 连接 AI 智能体

KEEPitALIVE MCP 服务器让 MCP 客户端能够使用同一受限 API 密钥查看和管理监控。它默认连接到生产 API，未配置模式时使用 write 模式。若要以最小权限开始，请显式设置 read 模式；当需要智能体执行可逆的运维更改时，再启用 write 模式。

{
  "mcpServers": {
    "keepitalive": {
      "command": "npx",
      "args": ["-y", "@keepitalive/mcp"],
      "env": {
        "KEEPITALIVE_API_KEY": "kia_live_...",
        "KEEPITALIVE_MCP_MODE": "read"
      }
    }
  }
}

选择最小的工具范围

read 仅提供监控和事件数据。默认的 write 会增加可逆操作，例如创建或编辑监控器、暂停或恢复检查以及更新事件。full 还会增加永久删除工具。API 密钥范围始终是严格的权限边界；MCP 模式只能进一步收窄这些范围。

构建运行闭环

CI 任务可以在部署后创建或更新监控器。智能体可以使用检查历史调查事件、添加评论、暂停已知维护窗口，或配置触发器以通知现有工作流。请保持自动化操作范围小、可观察且可逆。

使用权威契约

API 参考说明端点和认证。OpenAPI 是工具可读取的权威来源，智能体指南则说明智能体更改生产资源前的审批和安全预期。

相关内容