跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用,一键添加 incident.io,然后将你的 AI 客户端(Claude、ChatGPT、Copilot 或 Cursor)指向生成的 MCP 端点。无需 Docker,无需 git clone,无需任何工程经验。
AnythingMCP 已收录在 Claude 的连接器目录中:一键添加到 Claude (在新标签页中打开),然后登录并选择 Claude 可以使用哪些 MCP 服务器。
摘要
在任意 AI 智能体中使用 incident.io 事件响应:列出并查看带更新和时间线的事件,查询严重级别、状态、角色、类型和自定义字段,管理行动项和后续跟进,读取并解决告警,查看谁在值班,通过升级呼叫相关人员,浏览用户、团队和目录。它还能宣布和编辑事件并发布更新。
试试这样问
incident.io 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → incident.io、粘贴凭证、生成 MCP API key,即可完成。无 Docker、无
git clone、无本地服务器。
incident.io + Claude
在任意 AI 智能体中使用 incident.io 事件响应:列出并查看带更新和时间线的事件,查询严重级别、状态、角色、类型和自定义字段,管理行动项和后续跟进,读取并解决告警,查看谁在值班,通过升级呼叫相关人员,浏览用户、团队和目录。它还能宣布和编辑事件并发布更新。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
INCIDENT_IO_API_KEY
步骤 1 — 获取凭证
配置大约需要 2 分钟。你需要一个 incident.io 账户和一个 API 密钥。
- 在 incident.io 打开 Settings, API keys(
https://app.incident.io/settings/api-keys),点击 Add new。只有管理员或有权管理 API 密钥的角色可以操作。 - 为密钥命名并勾选它可以做的事情。读取至少需要 view data(viewer),以及查看目录、排班和值班的权限;私有事件需要单独的权限。写入还要加上创建事件、编辑事件、管理行动项和后续跟进、创建升级等权限。密钥缺少权限的工具会返回 403。
- 复制密钥(只显示一次),不带前缀
Bearer,粘贴到INCIDENT_IO_API_KEY。连接器会把它作为 Bearer 令牌发送到https://api.incident.io。 - 安装连接器并运行
incident_io_get_identity:它会显示密钥名称、组织的仪表板 URL 以及授予密钥的角色,例如 viewer、incident_creator、incident_editor、on_call_viewer 或 escalation_creator。
当前发生了什么:用 status_category: ["live"](应用中显示为 Active)或 ["triage"] 调用 incident_io_list_incidents,按从新到旧返回编号、名称、摘要、状态、严重级别、类型、模式、可见性、角色、自定义字段、时间戳、Slack 频道和永久链接。可以按状态类别、状态、严重级别(用 severity_gte 表示"至少这么严重")、类型、模式以及创建或更新日期筛选,并用 filter_mode 的 all 或 any 组合;按自定义字段和角色筛选的条件放在 extra_filters 中。之后用 incident_io_get_incident 获取包含持续时间指标和复盘链接的完整事件,用 incident_io_list_incident_updates 获取更新,用 incident_io_list_incident_timeline_items 按顺序获取备注、置顶消息和更新。除非你明确查询,test 和 tutorial 模式的事件不会显示。
用于查找 id 的配置:incident_io_list_severities、incident_io_list_incident_statuses、incident_io_list_incident_roles、incident_io_list_incident_types、incident_io_list_custom_fields、incident_io_get_custom_field、incident_io_list_custom_field_options 和 incident_io_list_incident_timestamps。AI 会先读取这些信息,再用其中的 id 进行筛选、创建或编辑。
处理一个事件:
incident_io_create_incident宣布事件,可设置名称、摘要、严重级别、状态、类型、可见性(public 或 private)、模式、角色、自定义字段值和时间戳。必须提供idempotency_key和visibility。模式test可以在不产生真实事件的情况下试用,retrospective用于记录过去的事件。incident_io_create_incident_update为响应人员和相关方发布更新,同时可以更改状态和严重级别。incident_io_edit_incident修改名称、摘要、严重级别、状态(切换到 closed 类别的状态即为解决)、角色、自定义字段、时间戳、会议链接或 Slack 频道名称。只修改你传入的字段;notify_incident_channel会在频道中通知此次变更。- 事件期间的行动项:
incident_io_list_actions、incident_io_get_action、incident_io_create_action、incident_io_update_action(outstanding、completed、not_doing)。 - 事件之后的后续跟进:
incident_io_list_follow_ups、incident_io_get_follow_up、incident_io_create_follow_up、incident_io_update_follow_up,包含优先级、类别、标签、负责人或团队,以及关联的外部工单(Jira、Linear 等)。更新行动项或后续跟进会整体替换,因此 AI 每次都会一并发送当前的文本和状态。
告警:incident_io_list_alerts(按 firing 等状态、来源、去重键或日期筛选)、incident_io_get_alert、用于查看哪些告警属于哪个事件的 incident_io_list_incident_alerts,以及在来源不会发送解决事件时手动解决触发中告警的 incident_io_resolve_alert;根据告警路由,由它触发的事件和升级也可能一起解决。告警来源(Datadog、Grafana、Prometheus、CloudWatch、HTTP、邮件、心跳等)通过 incident_io_list_alert_sources 和 incident_io_get_alert_source 读取,其中不包含密钥令牌。
值班:incident_io_list_schedules 和 incident_io_get_schedule 显示轮换、层级和当前班次;incident_io_list_schedule_entries 返回某个时间窗口内应用覆盖后的最终排班,也就是回答"现在谁在值班"。incident_io_list_escalation_paths 和 incident_io_list_escalations 显示会呼叫谁以及发生了什么;incident_io_create_escalation 按升级路径或直接按用户 id 呼叫相关人员。
组织和目录:incident_io_list_users(按邮箱或 Slack id 查找某人)、incident_io_get_user、incident_io_list_teams、incident_io_list_catalog_types、incident_io_get_catalog_type、incident_io_list_catalog_entries(用 identifier 查找单个条目)和 incident_io_get_catalog_entry。
写入之前:新的 standard 事件会打开 Slack 或 Teams 频道并通知相关人员,更新会分享给响应人员和订阅者,升级会呼叫值班人员。AI 会先展示将要执行的操作,等你确认后才执行。重试创建时它会复用同一个 idempotency_key,这样重试不会产生第二个事件、更新或呼叫。
安装时停用的工具:没有。全部 43 个工具(包括写入工具)都已启用;密钥能做什么,由你在 incident.io 中为它勾选的权限决定。
数据格式:id 是 ULID(26 个字符,例如 01FCNDV6P870EA6S7TK1DSYDG0);便于阅读的编号在 reference 中(INC-123)。时间为 UTC 的 ISO 8601,日期筛选使用 YYYY-MM-DD。API 中的状态类别:triage、live(Active)、learning(Post-incident)、paused、closed、declined、canceled、merged。严重级别的 rank 越高越严重。自定义字段的返回结果不含选项列表,选项由 incident_io_list_custom_field_options 返回。
分页:列表返回带 after 的 pagination_meta;AI 把该值传入 after 再次调用,直到它不再出现。page_size 默认 25,大多数列表最多 250。incident_io_list_schedule_entries 通过把 pagination_meta.after 放入 entry_window_start 来翻页。
限制:每个密钥每分钟 1,200 次请求。
常见错误:401 表示密钥错误或已被删除。403 表示密钥缺少该调用所需的权限;incident_io_get_identity 会显示它的角色,在 Settings, API keys 中勾选缺少的权限即可。404 表示 id 不存在。422 是校验错误,errors 会指出字段,例如不允许的状态变更。429 表示触发了速率限制,请等待一分钟。
该连接器不会删除事件、行动项、后续跟进或目录条目,不会创建或修改告警来源、排班或升级路径,也不会返回告警来源的密钥令牌。
步骤 2 — 安装 adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
步骤 3 — 在 Claude 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
推荐路径:在 claude.ai web 上工作,无需触碰任何配置文件。
- 在 Claude 中打开 Customize → Connectors。
- 点击 +,然后点击 Add custom connector。
- 输入名称(例如
incident.io)和远程 MCP 服务器 URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID,然后点击 Add。 - 点击 Connect,登录 AnythingMCP(OAuth)并允许访问。
下面所有工具都会出现在你的聊天中,开始输入提示。
可用工具
| Tool | What it does |
|---|---|
incident_io_get_identity | Show which API key the connector uses: its name, the organisation's dashboard URL and the roles (permissions) granted to it, e.g. viewer… |
incident_io_list_incidents | List incidents, newest first: id, reference (INC-123), name, summary, status and status category, severity, type, mode, visibility, role… |
incident_io_get_incident | Get one incident with everything on it: reference, name, summary, status, severity, type, mode, visibility, role assignments, custom field… |
incident_io_create_incident | Declare an incident: name, summary, severity, status, type, visibility and mode, with role assignments and custom field values |
incident_io_edit_incident | Edit an incident: rename it, change its summary, severity or status (resolve it by moving to a closed status), assign roles, set custom… |
incident_io_list_incident_updates | List the updates of an incident (or of all incidents), newest first: message, new status and severity, who posted it and when |
incident_io_create_incident_update | Post an update to an incident: a message for responders and stakeholders, optionally moving it to another status or severity at the same… |
incident_io_list_incident_timeline_items | List the timeline of one incident: the items added to it (notes, pinned messages, updates) with their time and author, in order |
incident_io_list_severities | List the severities configured in incident.io (e.g |
incident_io_list_incident_statuses | List the incident statuses (e.g |
incident_io_list_incident_roles | List the incident roles (e.g |
incident_io_list_incident_types | List the incident types (e.g |
incident_io_list_custom_fields | List the custom fields of incidents with id, name, description and type (single_select, multi_select, text, link, numeric), and for… |
incident_io_get_custom_field | Get one custom field: name, description, type and, for catalog fields, the catalog type it draws its values from |
incident_io_list_custom_field_options | List the options of a single or multi select custom field: id (value_option_id), value and sort key |
incident_io_list_incident_timestamps | List the incident timestamps tracked for every incident (reported at, accepted at, impact started, resolved at, ...) with their ids, for… |
incident_io_list_actions | List actions (tasks done during an incident), optionally of one incident: id, description, status (outstanding, completed, not_doing)… |
incident_io_get_action | Get one action: description, status, assignee, incident and completion time |
incident_io_create_action | Add an action to an incident: a task to do now, optionally assigned to a user |
incident_io_update_action | Update an action: mark it completed or not_doing (or outstanding again), reassign it or change its text |
incident_io_list_follow_ups | List follow-ups (work to do after an incident), optionally of one incident or team: id, title, description, status, priority, assignee… |
incident_io_get_follow_up | Get one follow-up: title, description, status, priority, category, assignee, labels, incident and the linked external issue |
incident_io_create_follow_up | Add a follow-up to an incident: a title, optional description, assignee or team, priority, category and labels |
incident_io_update_follow_up | Update a follow-up: complete it or mark it not_doing, reassign it, change priority, labels or text |
incident_io_list_alerts | List alerts received from monitoring tools, newest first: id, title, description, status (firing, resolved), alert source, deduplication… |
incident_io_get_alert | Get one alert with its title, description, status, source, deduplication key, attributes, source URL and times |
incident_io_resolve_alert | Resolve a firing alert by hand, e.g. when the source will not send a resolve event |
incident_io_list_incident_alerts | List the links between alerts and incidents: which alerts are attached to an incident, or which incidents an alert belongs to |
incident_io_list_alert_sources | List the alert sources (Datadog, Grafana, Prometheus, CloudWatch, HTTP, email, heartbeat, ...) with id, name, type, the template that… |
incident_io_get_alert_source | Get one alert source: name, type, template (title, description, attributes), filters, owning teams and source-specific options |
incident_io_list_schedules | List on-call schedules with id, name, time zone, rotations and layers, and (with page_size 25 or less) the current and next shifts |
incident_io_get_schedule | Get one on-call schedule: time zone, rotations with their layers, handover times and members, and the current shifts |
incident_io_list_schedule_entries | Show who is on call on a schedule in a time window: the final entries after overrides, each with user, start and end |
incident_io_list_escalation_paths | List the escalation paths (who gets paged in which order, through which schedules and users) with id and name |
incident_io_list_escalations | List escalations (pages sent to people) with id, title, status (pending, triggered, acked, resolved, expired, cancelled, snoozed, ...)… |
incident_io_create_escalation | Page people: start an escalation that follows an escalation path, or notifies the given users directly, with a title included in every… |
incident_io_list_users | List the users of the organisation with id, name, email, Slack user id and role |
incident_io_get_user | Get one user: name, email, Slack user id, base role and custom roles |
incident_io_list_teams | List the teams of the organisation with id and name; team ids are used for follow-ups and alert source ownership |
incident_io_list_catalog_types | List the catalog types (services, teams, features, environments, ...) with id, name, description, type name, attribute schema and whether… |
incident_io_get_catalog_type | Get one catalog type with its attribute schema (names, types, which attributes link to other types) |
incident_io_list_catalog_entries | List the entries of one catalog type (e.g. every service) with id, name, external id, aliases, rank and attribute values |
incident_io_get_catalog_entry | Get one catalog entry with its attribute values; with expand true also the entries that link to it |
示例提示
- “现在有哪些活跃的事件?请列出每个事件的严重级别、状态、事件负责人和最新更新。”
- “Platform 排班现在是谁在值班,下一个接班的是谁?”
- “总结 INC-123 的时间线,并列出未完成的后续跟进及其负责人。”
- “宣布一个名为‘结账延迟’、严重级别为 Minor 的私有测试事件。创建前先给我看详细信息。”
- “Datadog 的哪些告警仍在触发?其中有没有关联到事件的?”
FAQ
Claude Code 和 Claude Desktop 一样工作吗? 是的,两者都指向 https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。
下一步
这份指南对你有帮助吗?