mttrly - AI-powered incident management and server monitoring via MCP.

mttrly MCP 服务

通过远程 MCP 访问 mttrly，这是一个用于服务器健康检查、诊断、操作手册、审批和审计历史的 AI SRE Agent。

范围

mttrly MCP 是一个远程 Streamable HTTP 连接器。每次工具调用都会先到达 mttrly Central API；随后，Central 会通过现有的安全 Agent 通道与已连接的 Agent 通信。独立 Agent 不会公开本地 MCP 接口。

变体 A 刻意采用远程优先方案：公共目录指向托管端点，OAuth 负责用户授权，常规客户端配置无需 npm 包。

连接

Claude.ai 和 Claude Desktop

使用连接器界面：

1. 打开 Settings -> Connectors。
2. 选择 Add custom connector。
3. 输入 https://api.mttrly.com/mcp。
4. 完成 OAuth 登录流程。

不要将远程 URL 填入 claude_desktop_config.json；该文件用于本地 stdio MCP 服务。

Claude Code

claude mcp add --transport http mttrly https://api.mttrly.com/mcp

OpenAI Codex

将以下内容添加到 ~/.codex/config.toml：

[mcp_servers.mttrly]
url = "https://api.mttrly.com/mcp"

然后完成 OAuth 登录：

codex mcp login mttrly

Cursor

将 https://api.mttrly.com/mcp 添加为远程 MCP 服务 URL。Cursor 应从服务端的质询中发现受保护资源元数据，并启动 OAuth。

身份验证

• 远程传输通过 OAuth 2.1 和 PKCE S256 对 https://app.mttrly.com 进行身份验证。
• 受保护资源的元数据 URL 为 https://api.mttrly.com/.well-known/oauth-protected-resource/mcp。
• 必须通过 MCP_ALLOWED_ORIGINS 明确允许浏览器来源的 MCP 客户端。
• 不带 Origin 标头的请求会收到常规的 401 OAuth 质询。
• 带有不受信任 Origin 标头的请求会按设计以 403 拒绝。

工具

共有 40 个工具可用：21 个读取工具和 19 个执行工具。请始终先调用 mttrly_get_capabilities，以了解当前计划和任何限制。

读取工具（21）

工具 ID	标题	计划	描述
mttrly_get_capabilities	获取计划功能	watchdog	获取当前计划、可用工具、受限工具和计划限制。使用任何其他工具前，请先调用此工具。
mttrly_list_servers	列出服务	watchdog	列出所有已连接的服务及其在线／离线状态、服务 ID、名称、最后在线时间和 Agent 版本。如需查看每台服务的 CPU、RAM、磁盘和活动警报数量，请使用 mttrly_get_server_status。
mttrly_get_server_status	获取服务状态	watchdog	获取详细的服务运行状况，包括 CPU、RAM、磁盘使用情况和活动警报数量。
mttrly_get_alerts	获取服务警报	watchdog	获取服务警报，并按严重程度和状态筛选。适用基于计划的保留期限限制。
mttrly_quick_triage	快速排查服务问题	watchdog	根据安全的 Watchdog 数据，获取浅层、只读的诊断摘要：状态、活动警报和资源百分比。
mttrly_run_diagnostic	运行服务诊断	deployment_bro	对服务运行非破坏性诊断。描述问题，系统将进行调查。每台服务有 30 秒冷却时间。仅限 Deployment Bro+ 使用——Watchdog 提供只读检查工具（状态、警报、list_playbooks）。
mttrly_list_playbooks	列出操作手册	watchdog	列出可用的修复操作手册。返回 ID、名称、描述、类别、requires_approval 标记和可选参数数组。可按 server_id 或类别筛选。
mttrly_get_service_reality	获取服务实况	deployment_bro	获取服务最新的缓存快照或实时刷新的服务实况快照，包括发现结果、服务、运行时和当前运行状况上下文。
mttrly_refresh_reality	刷新实况	deployment_bro	对服务执行实时服务实况刷新并等待新快照；每台服务均有严格的冷却时间窗口。
mttrly_get_server_timeline	获取服务时间线	deployment_bro	获取服务近期的统一时间线，将事件、部署和审计事件合并为一个有序流。
mttrly_run_deploy_verifier	运行部署验证器	deployment_bro	对服务运行通用部署验证器。返回健康检查结果、活动事件上下文和最新部署状态。
mttrly_read_file	读取文件	deployment_bro	通过统一脱敏机制，从服务读取允许列表中的日志、Docker 日志、Docker 镜像或受管理的环境文件。
mttrly_read_privileged_file	读取特权文件	deployment_bro	通过统一脱敏机制，读取扩展允许列表中的特权文件，例如 sudoers 覆盖文件或 root authorized_keys。
mttrly_search_files	搜索文件	deployment_bro	在服务的允许列表文件中搜索字面查询字符串，可选用 glob 进行筛选，并使用统一脱敏机制。
mttrly_diff_file	比较文件差异	deployment_bro	比较服务上的两个允许列表文件，并返回经过统一脱敏处理的统一差异。
mttrly_compare_source_to_dist	比较源代码与构建输出	deployment_bro	通过标准的只读比较功能，比较服务上的源代码树与 dist 输出。
mttrly_get_install_health	获取安装运行状况	deployment_bro	通过标准恢复后端路径，读取安装程序管理的运行状况、偏差和修复计划。
mttrly_search_knowledge	搜索知识库	deployment_bro	使用全文搜索已保存的事后分析、操作方案和笔记。可选择按服务筛选。
mttrly_get_morning_brief	获取晨间简报	deployment_bro	获取当前面向用户的主动简报，包括新检测到的异常和近期知识库条目。
mttrly_get_investigation_bypass	获取调查绕过状态	deployment_bro	读取调查当前的绕过状态。在 exec 调用之间使用此工具，可验证绕过仍处于活动状态，且不会消耗操作名额。
mttrly_acknowledge_proactive_event	确认主动事件	deployment_bro	代表用户将主动事件标记为已接受或误报。这会影响误报预算，用于静默产生噪声的检测器。

Execute tools (19)

工具 ID	标题	计划	描述
mttrly_run_playbook	运行 Playbook	deployment_bro	在服务器上执行 playbook。只读 playbook 会立即运行；需要审批的 playbook 会返回 pending_approval。
mttrly_execute_command	执行 Shell 命令	deployment_bro	请求在服务器上执行任意 Shell 命令。只读命令和处于活动调查中的绕过操作可以立即执行；否则会返回 pending_approval。
mttrly_get_pending_actions	获取待处理操作	deployment_bro	列出由 mttrly_run_playbook 或 mttrly_execute_command 创建、等待审批的操作。返回 action_id、服务器、类型、描述和过期时间。操作会在 30 分钟后过期。使用 mttrly_approve_action 批准，或使用 mttrly_cancel_action 拒绝。
mttrly_get_action_result	获取操作结果	deployment_bro	获取由 mttrly_run_playbook 或 mttrly_execute_command 创建的操作的当前结果或最终结果。
mttrly_approve_action	批准或拒绝操作	deployment_bro	批准或拒绝待处理操作。仅在用户明确确认后调用；调用后会阻塞，直到执行完成。
mttrly_cancel_action	取消操作	deployment_bro	通过拒绝待处理操作来取消它。仅在用户明确确认后调用。
mttrly_get_audit_log	获取审计日志	deployment_bro	获取服务器的按时间顺序排列的审计记录。包括命令执行、playbook 运行、警报触发和 Agent 修复，并注明来源（mcp/telegram/dashboard/api）和结果。
mttrly_write_file	写入文件	deployment_bro	将经过 base64 编码的内容写入受管理的服务器文件。始终返回待审批操作。
mttrly_cleanup_file	清理文件	deployment_bro	删除允许列表中的受管理服务器文件。始终返回待审批操作。
mttrly_execute_script	执行脚本	deployment_bro	通过规范的脚本功能，在服务器上执行允许列表中的受管理脚本或内联批处理脚本。处于活动调查中的绕过操作可以立即执行；否则会返回 pending_approval。
mttrly_bootstrap_recover	引导恢复	deployment_bro	为服务器和安装令牌生成规范的引导恢复单行命令。
mttrly_repair_install	修复安装	deployment_bro	运行规范的安装恢复策略，例如基于问题的修复、完整安装状态收敛、重新配置包装器或卸载 Agent。始终返回待审批操作。
mttrly_regenerate_install_token	重新生成安装令牌	watchdog	为现有离线服务器生成新的重新安装命令。需要审批；会轮换 Agent 凭据、保留服务器历史记录，且不会清理主机。
mttrly_decommission_server	删除离线服务器	watchdog	仅从 Central 注册表中移除离线/失效服务器。需要审批，且不会清理主机上的文件、用户或 systemd。
mttrly_update_agent	更新 Agent	deployment_bro	通过规范的核心更新功能更新服务器上的 mttrly Agent。始终返回待审批操作。
mttrly_start_investigation	开始调查	deployment_bro	开始或恢复与当前 MCP 会话绑定的服务器调查。需要一个短时有效的 MCP 会话。
mttrly_generate_retrospective	生成复盘	deployment_bro	根据当前服务器时间线、验证器状态和存储的知识生成确定性复盘。保存一条事后分析记录。
mttrly_acquire_investigation_bypass	获取调查绕过权限	deployment_bro	在进行中的调查中获取会话范围的审批绕过权限。需要 2FA。之后，在该调查服务器上执行的 execute_command/execute_script 将跳过逐条命令审批，直至过期、达到最大操作数或权限被撤销。
mttrly_revoke_investigation_bypass	撤销调查绕过权限	deployment_bro	立即撤销有效的调查绕过权限。之后，exec 将恢复逐条命令审批。操作具有幂等性：撤销已撤销的绕过权限时，会返回当前状态而不是报错。

Errors

代码	描述	建议操作
ACTION_EXPIRED	待处理操作已超过 30 分钟的 TTL，并已自动取消。	重新运行原始命令或操作手册，以创建新的待处理操作。
ACTION_NOT_FOUND	未找到待处理操作。	再次列出待处理操作，并使用新的 action_id。
AUTH_FAILED	身份验证失败，或提供的凭据无效。	刷新身份验证信息，然后使用有效的 API 密钥或 OAuth 令牌重试。
CONNECTION_ERROR	MCP 服务无法连接到后端 API。	等待连接恢复后重试请求。
CONTRACT_VERSION_UNSUPPORTED	客户端请求了不受支持的 MCP 合约主版本。	升级 MCP 客户端，或使用当前受支持的合约主版本。
DIAGNOSTIC_COOLDOWN	每台服务的诊断冷却时间尚未结束。	等待冷却时间结束后再重试。
DOCKER_NOT_AVAILABLE	目标服务上未安装 Docker，因此无法使用 Docker 操作手册。	跳过 Docker 操作手册，或先在服务上安装 Docker。
FORBIDDEN	请求的 MCP 资源属于其他用户或套餐上下文。	重新获取当前账户的最新服务、操作手册或操作 ID。
INTERNAL_ERROR	后端发生意外的内部错误。	重试一次。如果仍然失败，请检查后端日志或联系支持人员。
NOT_FOUND	未找到请求的 MCP 资源。	刷新相关列表端点，并使用有效标识符重试。
PLAN_REQUIRED	请求的工具需要更高级别的订阅套餐。	告知用户套餐限制，并显示升级 URL。
POLICY_DENIED	请求在执行前被 Central 端已知的安全策略拒绝。	选择允许的目标路径或操作，然后重试。
PLAYBOOK_NOT_AVAILABLE	所选操作手册当前无法在目标服务上使用。	刷新该服务的操作手册列表，并从列出的操作手册中选择一个。
PLAYBOOK_NOT_FOUND	指定的操作手册 ID 不存在。	调用 mttrly_list_playbooks 并选择有效的 playbook_id。
RATE_LIMITED	请求超出了当前 MCP 限流时间窗口。	等待限流时间窗口重置后重试。
SERVER_NOT_FOUND	指定的服务 ID 不存在，或不属于当前用户。	调用 mttrly_list_servers 查看可用的服务 ID。
SERVER_OFFLINE	目标服务 Agent 当前未连接。	检查服务上是否正在运行 mttrly Agent。
SERVER_ONLINE	目标服务处于在线状态，因此阻止了仅删除注册记录的操作。	使用 Delete 先卸载 Agent，或等待服务离线后再删除注册记录。
TIMEOUT	请求超出了配置的超时时间。	重试请求；如果操作开销较大，请缩小范围。
UNKNOWN_ERROR	MCP 服务发生未知错误。	重试请求；如果问题仍然存在，请检查原始错误详情。
VALIDATION_ERROR	请求未通过架构或参数验证。	根据公布的工具架构检查请求参数。
APPROVAL_NOTIFICATION_FAILED	已创建待处理操作，但无法向用户发送审批提示词；该操作已按失败关闭处理。	检查错误详情中的 action_id，确认该操作不再处于待处理状态，然后重试原始请求以创建新的操作。
INVESTIGATION_CLOSED	调查已关闭，无法获取绕过权限。	在请求绕过权限前，使用 mttrly_start_investigation 开始新的调查。
BYPASS_ALREADY_ACTIVE	此调查已有一个有效且未撤销的绕过权限。	使用当前绕过权限；如果需要不同的限制，请调用 mttrly_revoke_investigation_bypass 撤销后重新获取。
BYPASS_ACQUIRE_FAILED	无法获取调查绕过权限——检查与更新之间调查状态发生了变化。	重新读取调查状态并重试；如果调查已关闭，请开始新的调查。

Plans

Limits

Plan	Servers	Log lines	Log retention (days)	Scheduled checks
watchdog	1	50	7	0
deployment_bro	3	500	30	5
deployment_crew	9	500	30	Unlimited

Access matrix

Tool	Watchdog	Deployment Bro	Deployment Crew
mttrly_get_capabilities	✓	✓	✓
mttrly_list_servers	✓	✓	✓
mttrly_get_server_status	✓	✓	✓
mttrly_get_alerts	✓	✓	✓
mttrly_quick_triage	✓	✓	✓
mttrly_run_diagnostic	—	✓	✓
mttrly_list_playbooks	✓	✓	✓
mttrly_run_playbook	—	✓	✓
mttrly_execute_command	—	✓	✓
mttrly_get_pending_actions	—	✓	✓
mttrly_get_action_result	—	✓	✓
mttrly_approve_action	—	✓	✓
mttrly_cancel_action	—	✓	✓
mttrly_get_audit_log	—	✓	✓
mttrly_get_service_reality	—	✓	✓
mttrly_refresh_reality	—	✓	✓
mttrly_get_server_timeline	—	✓	✓
mttrly_run_deploy_verifier	—	✓	✓
mttrly_read_file	—	✓	✓
mttrly_read_privileged_file	—	✓	✓
mttrly_search_files	—	✓	✓
mttrly_diff_file	—	✓	✓
mttrly_compare_source_to_dist	—	✓	✓
mttrly_get_install_health	—	✓	✓
mttrly_write_file	—	✓	✓
mttrly_cleanup_file	—	✓	✓
mttrly_execute_script	—	✓	✓
mttrly_bootstrap_recover	—	✓	✓
mttrly_repair_install	—	✓	✓
mttrly_regenerate_install_token	✓	✓	✓
mttrly_decommission_server	✓	✓	✓
mttrly_update_agent	—	✓	✓
mttrly_start_investigation	—	✓	✓
mttrly_generate_retrospective	—	✓	✓
mttrly_search_knowledge	—	✓	✓
mttrly_get_morning_brief	—	✓	✓
mttrly_get_investigation_bypass	—	✓	✓
mttrly_acquire_investigation_bypass	—	✓	✓
mttrly_revoke_investigation_bypass	—	✓	✓
mttrly_acknowledge_proactive_event	—	✓	✓

Support

• Support email: [email protected]
• Issues: github.com/mttrly-hq/mttrly-mcp/issues
• Marketing page: mttrly.com/mcp
• Docs: mttrly.com/docs#mcp