快速接入

先看主来源和安装命令，再打开仓库或文档；下面只保留这个条目的关键接入事实。

命令预览

uv run python -m rootly_mcp_server --list-tools

详细介绍

根MCP服务器

](https://pypi.org/project/rootly-mcp-server/) ](https://pypi.org/project/rootly-mcp-server/) ](https://pypi.org/project/rootly-mcp-server/)

MCP服务器根API 适用于Cursor、Windsurf、Claude和其他MCP客户。

Demo GIF

快速开始

使用托管的MCP服务器。无需本地安装。

托管传输选项

流式HTTP（推荐）： https://mcp.rootly.com/mcp
SSE（稳定替代方案）： https://mcp.rootly.com/sse
代码模式： https://mcp.rootly.com/mcp-codemode

常规远程设置

默认远程配置（HTTP流式传输）：

{
  "mcpServers": {
    "rootly": {
      "url": "https://mcp.rootly.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_ROOTLY_API_TOKEN"
      }
    }
  }
}

SSE（备选方案）：

{
  "mcpServers": {
    "rootly": {
      "url": "https://mcp.rootly.com/sse",
      "headers": {
        "Authorization": "Bearer YOUR_ROOTLY_API_TOKEN"
      }
    }
  }
}

代码模式：

{
  "mcpServers": {
    "rootly": {
      "url": "https://mcp.rootly.com/mcp-codemode",
      "headers": {
        "Authorization": "Bearer YOUR_ROOTLY_API_TOKEN"
      }
    }
  }
}

代理设置

Claude Code

可流式传输的HTTP

claude mcp add --transport http rootly https://mcp.rootly.com/mcp \
  --header "Authorization: Bearer YOUR_ROOTLY_API_TOKEN"

代码模式：

claude mcp add rootly-codemode --transport http https://mcp.rootly.com/mcp-codemode \
  --header "Authorization: Bearer YOUR_ROOTLY_API_TOKEN"

SSE（备选方案）：

claude mcp add --transport sse rootly-sse https://mcp.rootly.com/sse \
  --header "Authorization: Bearer YOUR_ROOTLY_API_TOKEN"

手动配置

创建 .mcp.json 在项目根目录中：

{
  "mcpServers": {
    "rootly": {
      "type": "http",
      "url": "https://mcp.rootly.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_ROOTLY_API_TOKEN"
      }
    }
  }
}

更新配置后重新启动Claude Code。

Gemini CLI

安装扩展：

gemini extensions install https://github.com/Rootly-AI-Labs/Rootly-MCP-server

或在中手动配置 ~/.gemini/settings.json:

{
  "mcpServers": {
    "rootly": {
      "command": "uvx",
      "args": ["--from", "rootly-mcp-server", "rootly-mcp-server"],
      "env": {
        "ROOTLY_API_TOKEN": ""
      }
    }
  }
}

Cursor

添加 .cursor/mcp.json 或 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "rootly": {
      "url": "https://mcp.rootly.com/mcp",
      "headers": {
        "Authorization": "Bearer "
      }
    }
  }
}

Windsurf

添加 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "rootly": {
      "serverUrl": "https://mcp.rootly.com/mcp",
      "headers": {
        "Authorization": "Bearer "
      }
    }
  }
}

Codex

添加 ~/.codex/config.toml:

[mcp_servers.rootly]
url = "https://mcp.rootly.com/mcp"
bearer_token_env_var = "ROOTLY_API_TOKEN"

Claude Desktop

添加 claude_desktop_config.json:

注：这 --transport http 标志确保使用HTTP流式传输，而不是自动回退到SSE。

{
  "mcpServers": {
    "rootly": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.rootly.com/mcp",
        "--transport",
        "http",
        "--header",
        "Authorization: Bearer "
      ]
    }
  }
}

Rootly CLI

用于事件、警报、服务和随叫随到操作的独立CLI。

通过Homebrew安装：

brew install rootlyhq/tap/rootly-cli

或者通过Go：

go install github.com/rootlyhq/rootly-cli/cmd/rootly@latest

有关更多详细信息，请参阅 Rootly CLI存储库.

替代安装（本地）

如果不想使用托管服务，请在本地运行MCP服务器。

先决条件

Python 3.12或更高版本
uv 包管理器

  curl -LsSf https://astral.sh/uv/install.sh | sh

根API令牌

API令牌类型

根据您需要的访问权限选择令牌类型：

全球API密钥：完全访问Rootly实例。最适合整个组织的可见性。
API团队密钥：访问权限仅限于该团队拥有的实体。
个人API密钥：Access与创建它的用户匹配。

A. 全球API密钥 建议用于组织范围的查询和修改数据的操作，特别是当工作流可能跨越多个团队、计划或事件时。

带紫外线

{
  "mcpServers": {
    "rootly": {
      "command": "uv",
      "args": [
        "tool",
        "run",
        "--from",
        "rootly-mcp-server",
        "rootly-mcp-server"
      ],
      "env": {
        "ROOTLY_API_TOKEN": "",
        "ROOTLY_MCP_ENABLE_WRITE_TOOLS": "true"
      }
    }
  }
}

自托管传输选项

为每个服务器进程选择一种传输方式：

可流式传输的HTTP 端点路径： /mcp
上海证券交易所 端点路径： /sse
代码模式（实验） 端点路径： /mcp-codemode 在托管双传输模式下

默认情况下，托管和自托管部署都公开了相同的策划工具界面，包括默认的启用写入的工具。要将该表面限制为只读工具，请使用以下命令启动服务器 --no-enable-write-tools 或设置 ROOTLY_MCP_ENABLE_WRITE_TOOLS=false.

要在自托管部署上仅公开MCP工具的特定子集，请设置 ROOTLY_MCP_ENABLED_TOOLS （或通行证 --enabled-tools)例如，使用逗号分隔的精确工具名称列表 list_incidents,getIncident,get_server_version.

要查找当前自托管配置下可用的确切工具名称，请运行：

ROOTLY_API_TOKEN= \
uv run python -m rootly_mcp_server --list-tools

这将在应用当前设置后打印有效的MCP工具名称，包括 ROOTLY_MCP_ENABLE_WRITE_TOOLS 和 ROOTLY_MCP_ENABLED_TOOLS.

吸烟测试一个自我托管的allowlist：

ROOTLY_API_TOKEN= \
ROOTLY_MCP_ENABLED_TOOLS=list_incidents,getIncident,get_server_version \
uv run python -m rootly_mcp_server --transport streamable-http --log-level ERROR

然后将MCP客户端连接到 http://127.0.0.1:8000/mcp 并验证 tools/list 仅返回：

get_server_version
getIncident
list_incidents

要包含用于自托管测试的特定写入工具，请添加写入标志和allowlist：

ROOTLY_API_TOKEN= \
ROOTLY_MCP_ENABLE_WRITE_TOOLS=true \
ROOTLY_MCP_ENABLED_TOOLS=createIncident,createWorkflowTask,listTeams \
uv run python -m rootly_mcp_server --transport streamable-http --log-level ERROR

Docker运行示例（流式HTTP）：

docker run -p 8000:8000 \
  -e ROOTLY_TRANSPORT=streamable-http \
  -e ROOTLY_API_TOKEN= \
  -e ROOTLY_MCP_ENABLE_WRITE_TOOLS=true \
  rootly-mcp-server

Docker运行示例（SSE）：

docker run -p 8000:8000 \
  -e ROOTLY_TRANSPORT=sse \
  -e ROOTLY_API_TOKEN= \
  rootly-mcp-server

Docker运行示例（双传输+代码模式）：

docker run -p 8000:8000 \
  -e ROOTLY_TRANSPORT=both \
  -e ROOTLY_API_TOKEN= \
  rootly-mcp-server

以工作流为中心的工具子集

有150多种工具可供使用，您可能希望配置集中的子集以获得最佳的AI代理性能。使用 ROOTLY_MCP_ENABLED_TOOLS 要激活特定工作流，请执行以下操作：

🚨 事件响应（25个工具）

*应急响应人员和事件指挥官的基本工具*

ROOTLY_MCP_ENABLED_TOOLS="listIncidents,getIncident,createIncident,updateIncident,search_incidents,find_related_incidents,suggest_solutions,createIncidentActionItem,listIncidentActionItems,updateIncidentFormFieldSelection,listTeams,getCurrentUser,listServices,listSeverities,getAlert,listAlerts,updateAlert,listEscalationPolicies,getEscalationPolicy,listOnCallRoles,listSchedules,getScheduleShifts,get_oncall_handoff_summary,get_shift_incidents,list_endpoints"

📅 随叫随到管理（35个工具）

*适用于日程协调员和随叫随到的经理*

ROOTLY_MCP_ENABLED_TOOLS="listSchedules,getSchedule,updateSchedule,getScheduleShifts,listShifts,list_shifts,createScheduleRotation,updateScheduleRotation,listScheduleRotations,getScheduleRotation,listScheduleRotationUsers,updateScheduleRotationUser,createOnCallShadow,updateOnCallShadow,listOnCallShadows,createOverrideShift,updateOverrideShift,listOverrideShifts,listOnCallRoles,updateOnCallRole,get_oncall_schedule_summary,get_oncall_shift_metrics,check_oncall_health_risk,check_responder_availability,create_override_recommendation,listTeams,getTeam,listUsers,getUser,getCurrentUser,listEscalationPolicies,updateEscalationPolicy,listEscalationPaths,updateEscalationPath,listEscalationLevels"

📊 监控和警报（40个工具）

*为平台团队设置可观察性*

ROOTLY_MCP_ENABLED_TOOLS="listAlerts,getAlert,updateAlert,createAlertGroup,updateAlertGroup,listAlertGroups,createAlertRoutingRule,updateAlertRoutingRule,listAlertRoutingRules,listAlertEvents,getAlertEvent,updateAlertEvent,createHeartbeat,updateHeartbeat,listHeartbeats,getHeartbeat,createPulse,updatePulse,listPulses,getPulse,createDashboard,updateDashboard,listDashboards,getDashboard,createDashboardPanel,updateDashboardPanel,listStatusPages,getStatusPage,updateStatusPage,createStatusPageTemplate,updateStatusPageTemplate,listCommunicationsTemplates,updateCommunicationsTemplate,createLiveCallRouter,updateLiveCallRouter,listServices,listTeams,getCurrentUser,listEnvironments,listSeverities,list_endpoints"

📋 事故后分析（30个工具）

*用于SRE进行回顾和流程改进*

ROOTLY_MCP_ENABLED_TOOLS="getIncident,updateIncident,find_related_incidents,suggest_solutions,listIncidentActionItems,createIncidentActionItem,updateIncidentFormFieldSelection,createPostIncidentReview,updatePostIncidentReview,listPostIncidentReviews,getPostIncidentReview,createRetrospectiveStep,updateRetrospectiveStep,listRetrospectiveSteps,createRetrospectiveProcess,updateRetrospectiveProcess,listRetrospectiveProcesses,createPlaybook,updatePlaybook,listPlaybooks,getPlaybook,createPlaybookTask,updatePlaybookTask,listCauses,getCause,updateCause,listIncidentTypes,getIncidentType,updateIncidentType,getCurrentUser"

📈 分析和报告（15个工具）

*适用于领导力和指标团队（只读重点）*

ROOTLY_MCP_ENABLED_TOOLS="listIncidents,search_incidents,collect_incidents,listTeams,listServices,listSchedules,get_oncall_shift_metrics,get_shift_incidents,listDashboards,getDashboard,listAlerts,listHeartbeats,listPulses,getCurrentUser,list_endpoints"

不同团队的多个MCP实例

您可以使用不同的工具子集运行多个MCP实例：

{
  "mcpServers": {
    "rootly-incident-response": {
      "command": "uvx", "args": ["--from", "rootly-mcp-server", "rootly-mcp-server"],
      "env": {
        "ROOTLY_API_TOKEN": "",
        "ROOTLY_MCP_ENABLED_TOOLS": "listIncidents,getIncident,createIncident,find_related_incidents,suggest_solutions..."
      }
    },
    "rootly-oncall-management": {
      "command": "uvx", "args": ["--from", "rootly-mcp-server", "rootly-mcp-server"],
      "env": {
        "ROOTLY_API_TOKEN": "",
        "ROOTLY_MCP_ENABLED_TOOLS": "listSchedules,updateSchedule,createOverrideShift,get_oncall_shift_metrics..."
      }
    }
  }
}

使用uvx

{
  "mcpServers": {
    "rootly": {
      "command": "uvx",
      "args": [
        "--from",
        "rootly-mcp-server",
        "rootly-mcp-server"
      ],
      "env": {
        "ROOTLY_API_TOKEN": ""
      }
    }
  }
}

特性

动态工具生成：根据Rootly的OpenAPI（Swagger）规范自动创建MCP资源
智能分页：使用有界分页和紧凑的事件响应来防止上下文窗口溢出
API过滤：限制公开的API端点的安全性和性能
智能事件分析：分析历史事件数据的智能工具

- find_related_incidents：使用TF-IDF相似性分析来查找历史上类似的事件 - suggest_solutions：挖掘过去的事件解决方案，以建议可行的解决方案

MCP资源：将事件、团队、随叫随到状态和工作流程指南作为人工智能上下文的结构化资源公开
智能模式识别：自动识别服务、错误类型和解决模式
随叫随到的健康整合：检测预定响应者的工作量健康风险

支持的工具

默认服务器配置公开 150+工具.

自定义代理工具

check_oncall_health_risk
check_responder_availability
collect_incidents
createIncident -使用代理工作流的一组范围字段创建新事件
create_override_recommendation
find_related_incidents
getIncident -检索单个事件以进行直接验证，包括PIR相关字段
get_alert_by_short_id
get_oncall_handoff_summary
get_oncall_schedule_summary
get_oncall_shift_metrics
get_server_version
get_shift_incidents
list_endpoints
list_incidents
list_shifts
search_incidents
suggest_solutions
updateIncident -范围事件更新工具 summary 和 retrospective_progress_status

OpenAPI生成的工具

ListWorkflowRuns
createIncidentActionItem
createIncidentFormFieldSelection
createWorkflowTask
getAlert
getAlertEvent
getAlertGroup
getAlertRoutingRule
getAlertSource
getAlertUrgency
getCatalog
getCatalogEntity
getCause
getCurrentUser
getCustomForm
getEnvironment
getEscalationLevel
getEscalationPath
getEscalationPolicy
getFormField
getFormFieldOption
getFunctionality
getFunctionalityIncidentsChart
getFunctionalityUptimeChart
getIncidentActionItems
getIncidentFormFieldSelection
getIncidentType
getOnCallRole
getOnCallShadow
getOverrideShift
getSchedule
getScheduleRotation
getScheduleShifts
getService
getServiceIncidentsChart
getServiceUptimeChart
getSeverity
getStatusPage
getStatusPageTemplate
getTeam
getTeamIncidentsChart
getUser
getWorkflow
getWorkflowFormFieldCondition
getWorkflowGroup
getWorkflowTask
listAlertEvents
listAlertGroups
listAlertRoutingRules
listAlertSources
listAlertUrgencies
listAlerts
listAllIncidentActionItems
listCatalogEntities
listCatalogs
listCauses
listCustomForms
listEnvironments
listEscalationLevels
listEscalationLevelsPaths
listEscalationPaths
listEscalationPolicies
listFormFieldOptions
listFormFields
listFunctionalities
listIncidentActionItems
listIncidentAlerts
listIncidentFormFieldSelections
listIncident_Types
listIncidents
listOnCallRoles
listOnCallShadows
listOverrideShifts
listScheduleRotationActiveDays
listScheduleRotationUsers
listScheduleRotations
listSchedules
listServices
listSeverities
listShifts
listStatusPageTemplates
listStatusPages
listTeams
listUsers
listWorkflowFormFieldConditions
listWorkflowGroups
listWorkflows
listWorkflowTasks
updateEnvironment
updateEscalationLevel
updateEscalationPath
updateEscalationPolicy
updateFunctionality
updateIncidentType
updateOnCallRole
updateOnCallShadow
updateOverrideShift
updateSchedule
updateScheduleRotation
updateService
updateSeverity
updateTeam
updateWorkflow
updateIncidentFormFieldSelection
updateWorkflowTask

大规模扩建：此版本包括50多个新端点，涵盖通信、仪表盘、行动手册、事件后审查、监控和高级表单管理，同时小心地排除了对安全敏感的操作，如API密钥管理、用户创建/删除、角色管理和webhook配置。

删除操作在默认工具曲面中保持禁用状态。

随叫随到的健康整合

与集成随叫随到的健康检测预定响应者的工作量健康风险。

设置

设置 ONCALLHEALTH_API_KEY 环境变量：

{
  "mcpServers": {
    "rootly": {
      "command": "uvx",
      "args": ["--from", "rootly-mcp-server", "rootly-mcp-server"],
      "env": {
        "ROOTLY_API_TOKEN": "your_rootly_token",
        "ONCALLHEALTH_API_KEY": "och_live_your_key"
      }
    }
  }
}

用法

check_oncall_health_risk(
    start_date="2026-02-09",
    end_date="2026-02-15"
)

返回已安排的高危用户、推荐的安全替换和行动摘要。

示例技能

预构建Claude代码技能：

🚨 根事件响应者

此技能：

全面分析生产事件
使用基于ML的相似性匹配查找类似的历史事件
根据过去的成功解决方案提出解决方案
跨时区与随叫随到的团队协调
将事件与最近的代码更改和部署相关联
创建行动项和补救计划
提供置信度评分和时间估计

快速入门：

# Copy the skill to your project
mkdir -p .claude/skills
cp examples/skills/rootly-incident-responder.md .claude/skills/

# Then in Claude Code, invoke it:
# @rootly-incident-responder analyze incident #12345

它演示了使用Rootly工具和GitHub上下文的完整事件响应工作流程。

随叫随到轮班指标

获取任何时间段的随叫随到轮班指标，按用户、团队或时间表分组。包括主要/次要角色跟踪、轮班计数、小时数和待命天数。

get_oncall_shift_metrics(
    start_date="2025-10-01",
    end_date="2025-10-31",
    group_by="user"
)

随叫随到的交接总结

完成交接：当前/下一个待命+轮班期间的事件。

# All on-call (any timezone)
get_oncall_handoff_summary(
    team_ids="team-1,team-2",
    timezone="America/Los_Angeles"
)

# Regional filter - only show APAC on-call during APAC business hours
get_oncall_handoff_summary(
    timezone="Asia/Tokyo",
    filter_by_region=True
)

区域筛选仅显示指定时区内工作时间（上午9点至下午5点）的通话人员。

退货： schedules 和 current_oncall, next_oncall，以及 shift_incidents

MCP上下文资源

AI代理可以访问这些资源进行态势感知：

incident://{incident_id} -特定事件的详细事件信息
team://{team_id} -团队详细信息，包括名称、颜色和元数据
rootly://incidents -近期事件列表，供快速参考
rootly://oncall-status -所有时间表的当前随叫随到状态（对事件响应至关重要）
rootly://workflow-guide -常见操作的分步工作流程指南

示例用法： *“检查当前的随叫随到状态”* → AI读取 rootly://oncall-status 资源

轮班事故

一段时间内的事件，按严重性/状态/标签进行过滤。

get_shift_incidents(
    start_time="2025-10-20T09:00:00Z",
    end_time="2025-10-20T17:00:00Z",
    severity="critical",  # optional
    status="resolved",    # optional
    tags="database,api"   # optional
)

退货： incidents 列表+ summary （计数、平均分辨率时间、分组）

贡献

看贡献.md 了解开发人员设置和指南。

在Postman上玩它

[](https://god.gw.postman.com/run-collection/45004446-1074ba3c-44fe-40e3-a932-af7c071b96eb?action=collection%2Ffork&source=rip_markdown&collection-url=entityId%3D45004446-1074ba3c-44fe-40e3-a932-af7c071b96eb%26entityType%3Dcollection%26workspaceId%3D4bec6e3c-50a0-4746-85f1-00a703c32f24)

关于Rootly AI实验室

该项目由 Rootly人工智能实验室，我们正在建设系统可靠性和卓越运营的未来。作为一个开源孵化器，我们分享想法、实验和快速原型化解决方案，使整个社区受益。 Rootly AI logo

目录标签

API集成PythonClaudeAPI服务混合部署MCP服务器Rootly集成智能分析多客户端支持

支持客户端

Claude DesktopClaudeCursorWindsurf

接入字段

传输方式（transport，传输协议）

stdio

鉴权方式（authType，认证方式）

token

运行时（runtime，运行环境）

Python

部署方式（deploymentType，部署类型）

remote-capable

工具数量（toolCount，工具数）

124

资源数量（resourceCount，资源数）

0

提示词数量（promptCount，提示词数）

0

权限和风险

stdiotokenremote-capable

接入前请确认传输方式、认证方式和部署位置，并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

来源信息

MCP World

mcpworld.com

/detail/399b2ec149258909a808789c68544835

Rootly MCP服务器是一个为Rootly API服务的MCP服务器，支持Cursor、Windsurf、Claude等多种MCP客户端，提供动态工具生成、智能分页、API过滤等功能。

AIBase MCP

mcp.aibase.com

/zh/server/1916343948723068929

全面解析Rootly MCP ServerMCP Server的核心功能、安装配置和实用案例。作为顶级Model Context Protocol服务器，Rootly MCP Server能让AI助手访问实时数据、执行操作，为您提供更智能的工作体验和自动化解决方案。

AIBase MCP

mcp.aibase.com

/zh/server/1916341310522630145

全面解析RootlyMCP Server的核心功能、安装配置和实用案例。作为顶级Model Context Protocol服务器，Rootly能让AI助手访问实时数据、执行操作，为您提供更智能的工作体验和自动化解决方案。

RO

Glama

glama.ai

/mcp/servers/Rootly-AI-Labs/Rootly-MCP-server

Manage incidents from your IDE. An MCP server allowing to pull out incidents and their associated metadata using Rootly API.

继续浏览同类 MCP

更多开发工具 MCP（20,396）返回 MCP 目录

上一个 MCP

Rootly-AI-Labs Rootly-MCP-server

公开目录未提供摘要。

下一个 MCP

Rootly MCP Server

A remote MCP server that provides AI agents access to the Rootly API for incident management, allowing users to query and manage incidents, alerts, teams, services, and other incident management resources through natural language.