适合谁
- 已经使用 PagerDuty 的 SRE / 值班工程师
- 希望在 IDE 中进行 AI 辅助事件分诊的 DevOps 团队
- 需要通过对话方式查询事件指标或管理排班的团队
P
64FMRS · C
PagerDuty 官方维护的 MCP 服务器，工具覆盖事件、服务、排班、升级策略、编排、团队、状态页和 webhook 等 PagerDuty 核心资源，默认只读、写入需显式开启。功能全面但写入权限与账户级 API Key 权限较大，且 HTTP 传输缺乏内置认证，需谨慎部署。
PagerDuty 官方维护的本地 MCP（Model Context Protocol）服务器，为已启用 MCP 的客户端提供工具，用于直接操作 PagerDuty 账户，包括查看和管理事件、服务、值班排班、升级策略、事件编排、状态页和 webhook 等。服务器默认仅暴露只读工具，需显式添加 --enable-write-tools 参数才能启用会修改账户数据的写入工具。它还内置了基于 React 的交互式应用（事件指挥中心、值班管理器、值班薪酬报告、服务依赖图、入门向导），可在 VS Code 中直接展示。支持 stdio、streamable-http 和 sse 三种传输方式，可通过 uvx、本地源码或 Docker 运行。
工具能力
create_alert_grouping_setting
创建新的告警分组设置
delete_alert_grouping_setting
删除一个告警分组设置
get_alert_grouping_setting
获取指定的告警分组设置
list_alert_grouping_settings
列出告警分组设置，支持筛选
update_alert_grouping_setting
更新现有的告警分组设置
get_incident_metrics_all
获取所有服务范围内的聚合事件指标
get_incident_metrics_by_service
按服务分组获取事件指标
get_incident_metrics_by_team
按团队分组获取事件指标
get_responder_load_metrics
获取响应人员的负载指标
get_responder_metrics
获取响应人员的绩效指标
get_business_service_dependencies
获取指定业务服务的依赖关系
get_technical_service_dependencies
获取业务服务对应的技术服务依赖关系
list_business_services
列出业务服务
get_change_event
获取指定的变更事件
list_change_events
列出变更事件，支持可选筛选
list_incident_change_events
列出与指定事件相关的变更事件
list_service_change_events
列出指定服务的变更事件
get_event_orchestration
获取指定的事件编排
get_event_orchestration_global
获取某事件编排的全局编排配置
get_event_orchestration_router
获取某事件编排的路由配置
get_event_orchestration_service
获取指定服务的事件编排配置
list_event_orchestrations
列出事件编排，支持可选筛选
update_event_orchestration_router
更新事件编排的路由配置
append_event_orchestration_router_rule
向事件编排路由添加一条新的路由规则
create_escalation_policy
创建新的升级策略
get_escalation_policy
获取指定的升级策略
list_escalation_policies
列出升级策略
update_escalation_policy
更新现有的升级策略
add_note_to_incident
为事件添加备注
add_responders
为事件添加响应人员
create_incident
创建新的事件
get_alert_from_incident
获取事件中指定的告警
get_incident
获取指定的事件
get_outlier_incident
获取指定事件的异常事件信息
get_past_incidents
获取与指定事件相关的历史事件
get_related_incidents
获取与指定事件相关联的事件
list_alerts_from_incident
分页列出指定事件的所有告警
list_incident_notes
列出指定事件的所有备注
list_incidents
列出事件
manage_incidents
更新事件的状态、紧急程度、分配或升级级别
get_incident_workflow
获取指定的事件工作流
list_incident_workflows
列出事件工作流，支持可选筛选
start_incident_workflow
为事件启动一个工作流实例
get_log_entry
根据 ID 获取指定的日志条目
list_log_entries
按时间筛选列出账户范围内的所有日志条目
add_team_member
将用户添加到团队并指定角色
create_team
创建新团队
delete_team
删除团队
get_team
获取指定的团队
list_team_members
列出团队成员
list_teams
列出团队
remove_team_member
将用户从团队中移除
update_team
更新现有团队
get_user_data
获取当前用户的数据
list_users
列出 PagerDuty 账户中的用户
list_oncalls
列出值班排班信息
list_priorities
列出账户中定义的优先级
create_schedule_override
为排班创建一个临时覆盖
get_schedule
获取指定的排班
list_schedule_users
列出排班中的用户
list_schedules
列出排班
create_schedule
创建新的值班排班
update_schedule
更新现有排班
create_service
创建新服务
get_service
获取指定的服务
list_services
列出服务
update_service
更新现有服务
create_status_page_post
在状态页上创建新帖子（事件或维护通知）
create_status_page_post_update
为现有状态页帖子添加新更新
get_status_page_post
获取指定状态页帖子的详情
list_status_page_impacts
列出状态页可用的影响级别
list_status_page_post_updates
列出指定状态页帖子的所有更新
list_status_page_severities
列出状态页可用的严重程度级别
list_status_page_statuses
列出状态页可用的状态
list_status_pages
列出所有状态页，支持可选筛选
create_webhook_subscription
创建新的 webhook 订阅（返回签名密钥）
delete_webhook_subscription
删除 webhook 订阅
get_webhook_subscription
获取指定的 webhook 订阅
list_webhook_subscriptions
列出 webhook 订阅，支持按类型筛选
update_webhook_subscription
更新现有 webhook 订阅
get_extension_schema
获取指定的扩展模式
list_extension_schemas
列出可用的扩展模式（供应商）
安装接入
- 在 PagerDuty「用户设置 > API Access」中生成一个 User API Token。2. 确保系统已全局安装 uv/uvx（或改用本地源码
uv run/ Docker 镜像）。3. 在 Cursor、VS Code 或 Claude Desktop 的 MCP 配置中添加pagerduty-mcp服务器，命令为uvx pagerduty-mcp，如需写入能力追加--enable-write-tools参数。4. 通过环境变量设置PAGERDUTY_USER_API_KEY（必填）和可选的PAGERDUTY_API_HOST（欧盟账户需设为https://api.eu.pagerduty.com）。5. 重启客户端，并通过提问（如“显示我最新的事件”）验证连接是否成功。
claude_desktop_config.json
{"mcpServers":{"pagerduty-mcp":{"command":"uvx","args":["pagerduty-mcp","--enable-write-tools"],"env":{"PAGERDUTY_USER_API_KEY":"your-pagerduty-api-key-here","PAGERDUTY_API_HOST":"https://api.pagerduty.com"}}}}
选型与风险
不适合谁
- 未使用 PagerDuty 的团队
- 需要严格最小权限、按角色细分令牌权限的组织（该服务器使用用户级 API Token，权限等同于该用户）
- 希望在不受信任网络上直接暴露 HTTP 端点、且没有认证反向代理的部署场景
所需权限
- 需要一个 PagerDuty User API Token（`PAGERDUTY_USER_API_KEY`），拥有该用户在 PagerDuty 账户中的完整权限
- 默认仅暴露只读工具；需显式传入 `--enable-write-tools` 才能创建、更新或删除事件、服务、团队、排班、升级策略、webhook 和状态页内容
- 可选设置 `PAGERDUTY_API_HOST` 以指向标准或欧盟区域的 API 端点
风险与副作用
- streamable-http 和 sse 传输没有内置身份验证，任何能访问该主机端口的客户端都可以使用启动服务器时所用的那个 API Key 调用工具（包括写入工具）；README 明确警告仅在本地回环地址使用，或将 0.0.0.0 部署放在具备身份验证的反向代理/网关之后
- 写入工具权限较大，可创建/删除团队、修改升级策略与排班、创建状态页事件帖子等，误操作可能影响真实的值班和客户可见的状态页
- 创建 webhook 订阅会返回签名密钥，需妥善保存避免泄露
- Claude Desktop 的配置文件要求以明文形式存储 API Key，需注意文件权限
常见排障
- 确认已全局安装 `uv`/`uvx`，并且客户端命令能够找到它（必要时重启终端或 IDE）
- 确认 `PAGERDUTY_USER_API_KEY` 已正确设置；如为欧盟账户，需将 `PAGERDUTY_API_HOST` 设为 `https://api.eu.pagerduty.com`
- 若写入操作（如创建事件、排班覆盖）无效，检查启动参数中是否包含 `--enable-write-tools`
- 在 VS Code 中可通过命令面板搜索 `MCP: List Servers` 检查服务器运行状态，必要时重启
- 使用 HTTP 传输时确认 `MCP_HOST`/`MCP_PORT` 或 `--host`/`--port` 配置正确，且未在不受信任网络上直接暴露 0.0.0.0
使用场景
在 IDE 或聊天客户端中查看、确认和解决 PagerDuty 事件
查询和管理值班排班及临时覆盖
创建/更新升级策略、服务和团队
生成事件指标、响应人员负载和绩效报告
管理状态页帖子和更新
在 VS Code 中使用内置的事件指挥中心、值班管理器等交互式应用
支持客户端
Claude Desktop完整支持
Cursor完整支持
VS Code完整支持