PagerDuty MCP

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

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

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

通过 AI Agent 操作 PagerDuty。可搭配你已在使用的 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	PagerDuty Skill 的安装方法
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 pagerduty-mcp（无需编辑 JSON）。
ChatGPT（付费方案）	暂停使用，等待重新发布此连接器：ChatGPT 需要 HTTP 模式，而此版本的该模式无需密码，会监听所有网络接口，且可被你打开的网页访问。请参阅 mcp-install.md 中的安全说明。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 pagerduty-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 app 是远程服务，需要使用与 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 上启动。每个工具都会调用配套的 pagerduty-cli。从 2026-09-18 起发布的版本会将该 CLI 打包在安装包内；较早的安装包只包含 MCP 服务，因此如果你的安装包缺少配套 CLI，请先运行下方的路径 A 或路径 B 安装程序（或者将 PAGERDUTY_CLI_PATH 设置为现有二进制文件的路径）。详情： #331。

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

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

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

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

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

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

任何能够运行 Shell 的 Agent 都可以使用同一条提示词。

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

pagerduty-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

Claude Desktop .mcpb 用户：下载最新的 .mcpb（见本节顶部），然后在 Settings > Extensions 中重新选择该文件。Claude Code 插件用户：/plugin update pagerduty@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/pagerduty --force

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/pagerduty --force

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

为 OpenClaw 安装

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

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

OpenClaw 目前尚未普遍开放使用；frontmatter 配置已预先提供，会在 OpenClaw 发布时立即启用。

进行身份验证

请参阅 mcp-install.md，了解 pagerduty-cli 所需的凭据。

此技能的功能

MSP 经常提出的问题	命令
当前有哪些紧急事件？按 SLA 风险排序。	pagerduty-cli pulse
当前某项服务的值班人员是谁？何时交接？	pagerduty-cli oncall who --service "Payments"
本月各项服务的 MTTA 和 MTTR 是多少？	pagerduty-cli insights mttr --by service --since 30d
哪些服务的升级链路已失效，或存在单点故障？	pagerduty-cli audit coverage --severity high
接下来两周内，哪些排班时段没有值班人员？	pagerduty-cli audit schedule-gaps --days 14
哪些响应人员收到的页面通知最多，非工作时间负担最重？	pagerduty-cli insights responders --since 30d
哪些服务产生的噪声最多？	pagerduty-cli insights noisy --top 10 --since 7d
此事件中断前，刚刚发生了哪些变更？	pagerduty-cli incidents changes <incident-id> --window 4h
哪些未解决事件正在悄然搁置？	pagerduty-cli insights stale --hours 24

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

有何不同

大多数 PagerDuty 集成和 MCP 服务都会针对每个问题代理一次实时 API 调用。查询单条记录时这没问题。但当你要询问“整个季度各项服务的 MTTR 是多少”或“上个月谁承担了最多的非工作时间页面通知”时，规模一大就会变得缓慢且成本高昂——而这类跨事件分析通常被 PagerDuty 限制在付费 Analytics 层级中。

此技能会将 PagerDuty 同步到带有全文搜索的本地 SQLite 镜像中。汇总类问题只需执行一次本地 SQL 联接：即时、离线，且 AI 看到的是答案，而不是原始数据。insights mttr、insights responders 和 audit coverage 等命令会使用任何 REST API 密钥都能读取的事件、日志条目、服务、升级策略和排班数据，在本地完成计算——无需 Analytics 附加组件，也无需针对每个问题进行实时调用。

它解决的痛点

值班是优秀团队悄然消耗殆尽的地方。Catchpoint 的 2025 年 SRE 调查发现，近 70% 的受访者表示值班压力会导致职业倦怠和人员流失；而 Splunk 的 2025 年研究显示，73% 的故障与被忽略的告警有关——因为工程师平均每周要处理约 50 次呼叫，其中只有少数真正重要。与此同时，管理层在季度业务回顾中想看的数据（MTTA、MTTR、谁承担了值班重担），要么藏在 PagerDuty 的付费 Analytics 套餐后面，要么只能靠手工拼接 CSV；下周值班表中的空档，也会一直隐而不见，直到事故找上门来。

这个技能能把这些问题变成一行命令就能得到的答案：

• pagerduty-cli pulse - 当前有哪些未解决事件，按服务分类并按 SLA 风险排序。
• pagerduty-cli insights mttr --by service --since 30d - 按服务计算 MTTA/MTTR，离线完成，无需 Analytics 附加组件。
• pagerduty-cli insights responders --since 30d - 谁承担了呼叫，以及非工作时间的占比——这是职业倦怠的信号。
• pagerduty-cli audit coverage --severity high - 哪些服务的升级链路已失效，或存在单点故障。
• pagerduty-cli audit schedule-gaps --days 14 - 找出未来值班表中无人值班的时段，在事故发现空档之前及时处理。

更完整的说明请参阅 pain-point.md。

常见问题

这适用于 ChatGPT 吗？

当前版本不适用。ChatGPT（Plus、Pro、Team、Business、Enterprise 和 Education 套餐；Free 暂不支持 Developer Mode）只能通过 HTTPS 连接远程 MCP 服务，这意味着必须以 HTTP 模式运行 PagerDuty 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）。这两种方式都不需要编写代码。你只需输入一次 PagerDuty 凭据。

我的 PagerDuty 数据安全吗？

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

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

很少。读取类查询会针对本地 SQLite 镜像执行，而不是调用 API——你只需运行一次 pagerduty-cli sync，之后的分析、审计和搜索都可离线完成。只有 sync 和实时写入会调用 PagerDuty，并且 CLI 支持可配置的 --rate-limit。

生成 MTTR 报告需要购买 PagerDuty 的 Analytics 附加组件吗？

不需要。此技能会根据任何 REST API 密钥都能读取的事件和日志条目，在本地计算 MTTA、MTTR、响应人员工作负载和高噪声服务排名，因此无需购买付费 Analytics 套餐，也能获取事件后的各项数据。

这与 PagerDuty 自带的 AI 功能有何不同？

二者相辅相成。PagerDuty Advance 和 Analytics 位于 Web 应用中，且大多属于付费套餐；此技能则将相同的事件后数据计算功能带到终端和 AI Agent 中，根据已同步的数据离线计算。它不会取代你的 PagerDuty 账户，而是通过你自己的 API 密钥读取数据并执行操作。

费用是多少？

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

安全模型

层级	示例	建议的 Agent 策略
读取	pulse、insights mttr、audit coverage、oncall who、search、incidents timeline	允许
写入（常规）	incidents update（确认 / 解决 / 重新分配）、incidents snooze、incidents notes create-incident、incidents create	先用 --dry-run 预览，再经审核后写入
破坏性操作 / 配置	escalation-policies delete-escalation-policy、automation-actions delete、business-services delete、addons delete	仅限人工参与

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

状态

Beta 版。已针对 PagerDuty 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。