Rootly MCP

Rootly + AI - 适用于 ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini，以及任何支持 MCP 的 Agent

非官方。由社区构建的 Claude Code 技能和 Rootly API 的 MCP 服务。与 Rootly, Inc. 无关联，未获其认可或赞助。

_{▶ 观看 30 秒演示 - 演示数据为模拟数据；展示的每条命令都真实存在于 CLI 中。}

将每个 Rootly 事件、告警和轮值对象作为类型化命令使用 - 另有本地 SQLite 镜像，可离线即时回答相关事件、MTTR、覆盖缺口和轮值问题。可与您现有的 AI 配合使用 - ChatGPT（Plus/Pro+，暂停使用，等待重新发布此连接器；请参阅 mcp-install.md）、Claude Desktop、Codex、Claude Code、Claude Cowork 和 GitHub Copilot - 还可通过远程方式使用 Microsoft 365 Copilot / Copilot Studio 和 Google Gemini。免费、开源，可在您的笔记本电脑上运行。专为 MSP 所有者打造。无需编写代码。

适用于您的 Agent

安全说明（等待重新发布此连接器期间）。 请勿运行 HTTP 模式 （--transport http），即使是在 localhost 上也不行。此版本没有密码， 会监听所有网络接口，且早于浏览器重绑定防护，因此您打开的网页可以访问它。 MCP 工具也可以使用您的凭据执行更改。请使用默认的 stdio 传输方式。如果您为 远程 Agent 设置了隧道，请将其关闭。修复即将推出。

MSP 所有者实际使用的六种 Agent（可自行安装，现已可用）：

您的 AI Agent	如何安装 Rootly 技能
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 rootly-mcp（无需编辑 JSON）。
ChatGPT（付费套餐）	暂停使用，等待重新发布此连接器：ChatGPT 需要 HTTP 模式，而此版本的该模式不要求密码、会监听所有网络接口，并且您打开的网页可以访问它。请参阅 mcp-install.md 中的安全说明。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 rootly-mcp，然后选择 Agent 模式。

ChatGPT 需要远程 HTTPS 服务，这意味着要使用此连接器的 HTTP 模式；该模式目前暂停使用，等待重新发布此连接器：此版本的该模式不要求密码、会监听所有网络接口，并且您打开的网页可以访问它。请参阅 mcp-install.md 中的安全说明。

Microsoft 和 Google 技术栈也适用

安装量很大，但先如实提醒一下：这属于远程／企业路径，而不是你刚刚安装的本地二进制文件。

Agent	所需条件
Microsoft 365 Copilot / Copilot Studio	暂停使用，直至重新发布此连接器：Copilot Studio 需要使用 HTTP 模式，而此构建中的该模式不需要密码、会监听所有网络接口，并且可被你打开的网页访问。请参阅 mcp-install.md 中的安全说明。
Google Gemini	Gemini CLI 在本地运行，与 Claude Code 一样。Gemini 应用为远程应用，需要使用与 ChatGPT 相同的暂停启用的 HTTP 模式。请参阅 mcp-install.md。

原生支持 Skill 的 Agent（也涵盖在内）： Hermes 和 OpenClaw 可直接读取此 Skill 的 SKILL.md，并且支持 MCP——请参阅下方的安装章节。也可通过 MCP 与 Cursor、Windsurf、Cline、Continue.dev 和 Zed 配合使用。各工具的完整接入说明：docs/which-agent.md。

要使用多个 Agent？ 一条命令即可在所有 51 个以上受支持的 Agent 中安装：npx skills add Servosity/msp-skills@latest（需要 Node.js，然后运行每个 Skill 对应的安装程序来安装 CLI/MCP 二进制文件）。请参阅 docs/which-agent.md。

60 秒内完成安装

Claude Desktop 最快安装方式——一键安装 .mcpb

Claude Desktop 安装包： .mcpb 可在 macOS（Intel 和 Apple Silicon）、Windows x64 和 Linux x64 上启动。每个工具都会调用配套的 rootly-cli。从 2026-09-18 起发布的版本会在安装包内附带该 CLI；较早版本仅包含 MCP 服务，因此如果你的安装包缺少配套 CLI，请先运行下方的路径 A 或路径 B 安装程序（或将 ROOTLY_CLI_PATH 设为现有二进制文件的路径）。详情请参阅：#331。

下载 Rootly MCP（.mcpb）——然后打开 Claude Desktop > Settings > Extensions 并选择该文件。一键完成，无需 JSON，也无需使用 shell。（在发布页面查看所有 Rootly 版本。）

更喜欢 Claude Code 插件？添加一次 Marketplace，然后安装即可——无需列出目录，安装后立即可用：

/plugin marketplace add Servosity/msp-skills
/plugin install rootly@msp-skills

路径 A——将一条提示词粘贴到 AI Agent 中（推荐）

将以下内容复制到 Claude Code、Codex CLI 或 Claude Cowork 中：

在此 Agent 工作区中安装 Servosity/msp-skills 的 Rootly Skill 和 MCP 服务。如果此工作区使用 POSIX shell（macOS、Linux、WSL 或 Bash），请运行 bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/rootly/install.sh)。如果使用 Windows PowerShell，请运行 iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/rootly/install.ps1 | iex。然后按照 README 完成身份验证，并运行 rootly-cli --help 进行探索。

任何能够运行 shell 的 Agent 都可以使用相同的提示词。

路径 B——自行运行安装程序

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/rootly/install.ps1 | iex

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/rootly/install.sh)

安装程序会将 rootly-cli（CLI）和 rootly-mcp（MCP 服务）安装到用户的 bin 路径中。Claude Code、Codex 和 Cowork 会通过此目录中的 SKILL.md 发现 Skill。

验证：

rootly-cli --version

升级到最新版本

安装程序始终会获取当前版本——重新运行即可升级：

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/rootly/install.sh)

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/rootly/install.ps1 | iex

Claude Desktop .mcpb 用户：下载最新的 .mcpb（见本节顶部），然后在 Settings > Extensions 中重新选择该文件。Claude Code 插件用户：/plugin update rootly@msp-skills。

添加到 Claude Desktop、GitHub Copilot、Gemini CLI、Microsoft 365 Copilot 或其他 MCP 客户端

安装程序运行后，请参阅 mcp-install.md 和 docs/which-agent.md，了解各个 Agent 的连接方式——每个 Agent 都有一个专属章节，其中包括 GitHub Copilot 的 servers 键，以及远程 Microsoft 365 Copilot / Copilot Studio 的配置路径。Claude Desktop 的 Settings > Extensions 面板是最简单的方式；对于偏好编辑 JSON 的用户，mcp-install.md 中也记录了 MCP 配置块。

为 Hermes 安装

在 Hermes CLI 中：

hermes skills install servosity/msp-skills/skills/rootly --force

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/rootly --force

Hermes 原生支持 MCP，因此也可以直接使用 rootly-mcp 服务——安装方式相同，环境变量也相同。

为 OpenClaw 安装

告诉你的 OpenClaw Agent（复制以下内容）：

从 https://github.com/servosity/msp-skills/tree/main/skills/rootly 安装 rootly 技能。该技能说明如何通过 openclaw: frontmatter 块安装其所需的 CLI（rootly-cli）。

OpenClaw 尚未普遍开放；frontmatter 配置已预先提供，并将在 OpenClaw 发布后立即启用。

身份验证

设置 CLI 所需的凭据（从你的 Rootly 门户获取）：

ROOTLY_API_KEY=<value> ROOTLY_API_TOKEN=<value> rootly-cli doctor

运行任何会操作数据的命令前，doctor 都会确认凭据是否有效。即使凭据被拒绝，它也会以 0 退出，因此脚本应添加 --fail-on error。

此技能的功能

MSP 经常提出的问题	命令
现在每项服务和每个排班中，谁在值班？	rootly-cli oncall-now
过去哪些事故与这次事故最相似？	rootly-cli related <incident-id>
上次这项服务发生故障时，究竟是什么修复了问题？	rootly-cli fixed-last-time <service>
本季度各项服务的 MTTA 和 MTTR 是多少？	rootly-cli mttr --by service --since 90d
哪些值班排班存在无人值守的空档？	rootly-cli coverage-gaps --days 14
现在部署这项服务安全吗？	rootly-cli deploy-guard <service>
哪些事故已违反或即将违反 SLA？	rootly-cli sla-breach --within 2h
哪些未完成的操作项已逾期？按负责人分组。	rootly-cli action-items-overdue --group-by owner
为这起事故起草一份可直接粘贴的事后复盘提纲。	rootly-cli postmortem-skeleton <incident-id>

完整命令参考：guide.md。有关 AI Agent 操作约定（--agent、--dry-run，以及何时在执行修改前确认），请参阅 AGENTS.md。

有何不同

大多数 Rootly 集成和 MCP 服务都会将每个问题代理为一次实时 API 调用。这对于单条记录来说没问题；但当你开始询问“本季度各项服务的 MTTR 是多少？”或“过去哪些事故与这次事故最相似？”时，就无法应付了——否则这些问题需要针对每个对象各调用一次，或使用 Rootly 自带的分析界面。

此技能会将 Rootly 同步到带全文搜索的本地 SQLite 镜像中。聚合类问题只需执行一次本地 SQL 联接：即时、离线，而且 AI 看到的是答案，而不是原始数据。related、mttr 和 coverage-gaps 等复合命令会跨事故、服务、排班和值班班次进行联接——这是无状态 API 封装器无法做到的。

它解决的痛点

值班工作正在悄悄消耗优秀团队的精力。r/sysadmin 和 r/sre 上反复出现的值班倦怠和告警疲劳讨论，以及业界年度 Catchpoint SRE Report，都讲述着同一个故事：响应人员被大量告警淹没，其中只有少数重要，而真正的事件则藏在噪声中。随后，在可靠性评审时，领导层想要的数字——MTTA、MTTR、谁承担了值班任务——都得从导出数据中手工拼凑出来。没人会注意到下周排班中的空档，直到某起事件先一步撞上它。

对于跨多个客户服务开展事件响应的 MSP 来说，这意味着同时存在三个未解决的问题：噪声太多，难以分诊；没有低成本的报告方式；值班覆盖出现缺口时，也没有预警。这项技能可通过终端解决这些问题：

• rootly-cli oncall-now - 查看所有排班和服务当前的值班人员，包括升级层级。
• rootly-cli mttr --by service --since 90d - 根据已同步的事件离线计算各服务的 MTTA 和 MTTR。无需在门户中费力查找，即可查看评审所需的数据。
• rootly-cli coverage-gaps --days 14 - 提前发现未来排班中无人值班的时段，避免错过告警。
• rootly-cli related <incident-id> 和 rootly-cli fixed-last-time <service> - 显示之前遇到此类问题时的处理情况，以及实际解决问题的方法。

更详细的说明请参阅 pain-point.md。

常见问题

这能与 ChatGPT 配合使用吗？

当前版本不支持。ChatGPT（Plus、Pro、Team、Business、Enterprise 和 Education 计划；Free 计划目前尚不支持 Developer Mode）只能通过 HTTPS 连接远程 MCP 服务，这意味着需要以 HTTP 模式运行 Rootly MCP 服务。在当前版本中，HTTP 模式无需密码，会监听所有网络接口，任何你打开的网页都可能访问它，因此在连接器重新发布前，请勿运行该模式或将其置于隧道之后；mcp-install.md 中的安全说明解释了原因。在此之前，请使用 Claude Desktop、Claude Code 或 Codex。

这能与 Codex、Cursor、Windsurf、Cline、Copilot 或 Gemini 配合使用吗？

可以——它们都支持 MCP。跨工具安装命令见上方的对照表，详细说明见 docs/which-agent.md。

我需要会编程吗？

不需要。推荐的安装方式是在 Claude Code 或 Codex 中粘贴一句话——你的 Agent 会读取 SKILL.md 并完成安装。备用方式是根据操作系统运行一行安装命令（bash 或 PowerShell）。两种方式都不需要编写代码。你只需输入一次 Rootly 凭据。

我的 Rootly 数据安全吗？

你的数据会保留在自己的设备上。CLI 和 MCP 服务都是本地二进制程序。SQLite 镜像存储在你用户账户下的目录中。AI Agent 只能看到 CLI 返回的内容——通常是查询结果，而不是原始批量数据。凭据从你的环境或 Agent 配置中读取；MSP Skills 绝不会将其打包进此代码库或传输到任何地方。

这会触发 Rootly API 速率限制吗？

很少。读取类问题会通过本地 SQLite 镜像处理，而非调用 API——你只需 sync 一次，之后的分析、搜索和值班视图都可离线完成。只有 sync 和实时写入操作会调用 Rootly。

这与 Rootly 自带的 AI 和分析功能有什么不同？

Rootly 的 AI 和分析功能在 Web 应用中提供。这项技能则将事后分析计算——MTTA/MTTR、事件相似度、解决方案挖掘、值班覆盖情况和升级空档检查——带到你的终端和 AI Agent 中，并根据任何 API 密钥都能读取的数据离线计算。它可与 Rootly 门户互补，但不能取代你的账户。

我需要是 Rootly 客户吗？

需要——你必须使用自己的 Rootly API 密钥登录自己的账户。这项技能是社区开发的非官方连接器，与 Rootly 无关联，也未获其认可。

费用是多少？

免费。采用 Apache-2.0 许可。你只需为使用的 AI Agent（Claude、ChatGPT、Codex 等）付费，费用由你的 AI 提供商收取，而不是由我们收取。

安全模型

层级	示例	建议的 Agent 策略
读取	oncall-now、mttr、related、coverage-gaps、sla-breach、service-health、search，以及任何不含机密信息的 list/get（不包括 secrets/api-keys，它们会返回已存储的凭据——见下文）	允许
写入（常规）	incidents create、incidents update、incidents resolve、schedules update	使用 --dry-run 预览，然后执行经审核的写入
凭据 / 安全	secrets、api-keys rotate	仅限人工参与
破坏性操作 / 配置	incidents delete、schedules delete	仅限人工参与

最有效的控制措施是授予 Rootly 凭据的权限范围——CLI 只能执行凭据获准执行的操作。完整详情（包括如何收紧权限）请参阅 governance.md。

状态

Beta。已针对 Rootly API 的功能范围进行验证，目前正在每周 Build Sessions 中，由实际运行它的 MSP 使用自己的生产租户进行验证。请在 compoundingteams.com/build-sessions RSVP。

---

标准。 符合开放的 Agent Skills 规范（Anthropic，2025 年 12 月；支持 40 多个 Agent）。兼容 MCP——可与任何支持 MCP 的 Agent 配合使用，包括 Hermes。已准备好支持 OpenClaw（frontmatter 已预先配置，等待 OpenClaw 发布）。

由 Servosity 维护。采用 Apache-2.0 许可。使用 CLI Printing Press 构建。最后更新：2026-06-06。