Servosity MCP

Servosity + AI - 适用于 Claude、ChatGPT、Codex、Cursor 以及任何支持 MCP 的 Agent

由 Servosity Inc. 面向 MSP 合作伙伴发布。为 Servosity 备份和灾难恢复平台提供的第一方 Claude Code Skill 和 MCP 服务。Servosity 是 Servosity Inc. 的商标。采用 Apache-2.0 许可。

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

为你已在使用的 AI 添加全服务群组备份分诊、过时备份集检测、夜间偏差、按客户端掌握情况以及跨客户端分析 - 支持 Claude Code、Claude Desktop、ChatGPT（Plus/Pro+，通过托管 HTTPS 端点；见 mcp-install.md）、Codex、Cursor、Windsurf、Cline、Continue、Gemini 或 GitHub Copilot。免费、开源，可在笔记本电脑上运行。本地服务群组镜像让你的 AI 能回答合作伙伴门户无法在一个屏幕上展示的跨客户端问题 - 几秒内即可生成可直接用于周五邮件的内容。专为 MSP 合作伙伴打造。无需编写代码。

兼容你的 Agent

MSP 所有者实际使用的五种 Agent：

你的 AI Agent	如何安装 Servosity Skill
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 servosity-mcp（无需编辑 JSON）。
ChatGPT（付费方案）	运行安装程序，通过 HTTPS 托管 servosity-mcp 并使用 bearer token，将其注册为 Developer Mode 连接器。见 mcp-install.md。
Claude Code	粘贴下方的安装提示词。
Codex CLI	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。

ChatGPT 需要远程 HTTPS 服务，也就是此连接器的 HTTP 模式：必须设置 SERVOSITY_MSP_MCP_HTTP_TOKEN，否则服务会拒绝启动；每个请求都必须在 bearer 标头中发送该 token；如果地址不是回环地址，还需要 --tls-cert 和 --tls-key。见 mcp-install.md。

也兼容 Cursor、Windsurf、Cline、Continue.dev、Zed、GitHub Copilot 和 Gemini CLI - 以及 Hermes 和 OpenClaw，两者都通过 MCP 和预先配置的 Skill frontmatter 使用。各工具的完整接入说明：docs/which-agent.md。

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

60 秒内完成安装

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

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

下载 Servosity MCP（.mcpb） - 然后打开 Claude Desktop > Settings > Extensions 并选择该文件。一键完成，无需 JSON，也无需 shell。（在 releases 页面浏览所有 Servosity 版本。）

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

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

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

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

在此 Agent 工作区中安装 Servosity Skill 和来自 Servosity/msp-skills 的 MCP 服务。如果此工作区使用 POSIX shell（macOS、Linux、WSL 或 Bash），请运行 bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/servosity/install.sh)。如果使用 Windows PowerShell，请运行 iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/servosity/install.ps1 | iex。然后使用 SERVOSITY_MSP_TOKEN=<your-partner-token> servosity-cli doctor 进行身份验证，并运行 servosity-cli --help 以了解用法。

同一条提示词也适用于任何可以运行 shell 的 Agent。

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

Windows（PowerShell）：

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

macOS / Linux：

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

安装程序会将 servosity-cli 和 servosity-mcp 都放入你的用户 bin 路径。Claude Code、Codex 和 Cowork 会通过此目录中的 SKILL.md 发现 Skill。

验证：

servosity-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

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

添加到 Claude Desktop、Cursor、Windsurf、Cline、Continue、Gemini 或 Copilot

运行安装程序后，请参阅 mcp-install.md 和 docs/which-agent.md，了解各 Agent 的连接方法。通过 Claude Desktop 的 Settings > Extensions 面板进行配置最为简单。

为 Hermes 安装

从 Hermes CLI 运行：

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

在 Hermes 聊天会话中：

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

Hermes 原生支持 MCP，因此也可以直接使用 servosity-mcp 服务——安装路径和环境变量均相同。

为 OpenClaw 安装

OpenClaw 已正式发布。直接从此仓库安装 Skill：

openclaw skills install git:Servosity/msp-skills/skills/servosity@main

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

从 https://github.com/Servosity/msp-skills/tree/main/skills/servosity 安装 servosity Skill。metadata.openclaw frontmatter 声明了所需的 CLI（servosity-cli）和环境变量；如果缺少任何内容，请运行 openclaw doctor。

openclaw 也原生支持 MCP（参见 OpenClaw MCP 文档中的 openclaw mcp set），因此你可以将 servosity-mcp 配置为与 Skill 并行使用的 MCP 服务。

身份验证

从 Servosity 合作伙伴门户获取合作伙伴 API 令牌，然后：

SERVOSITY_MSP_TOKEN=<token> servosity-cli doctor

运行任何涉及客户端数据的操作前，doctor 会确认令牌有效且本地镜像可访问。即使凭据被拒绝，它也会以 0 退出，因此脚本应添加 --fail-on error。

这项技能能做什么

以结果为先，每个问题都对应一个命令：

MSP 经常提出的问题	命令
今天哪些地方需要我关注，按最严重程度排序？	servosity-cli attention --top 5
与昨天相比，哪些情况恶化了，哪些恢复了？	servosity-cli drift
哪些客户端的备份已过期 7 天以上？	servosity-cli stale-backups --days 7 --refresh
为所有备份过期的客户端起草跟进邮件	servosity-cli email-draft --stale --days 7
将 Acme 的 QBR 备份部分制作成 PDF	servosity-cli qbr "Acme Co" --out acme-q1.pdf
季度末：一次性生成每个客户端的 QBR 报告	servosity-cli qbr-all --quarter 2026-Q1 --out ./qbrs/
DR 事件期间监控每个客户端的还原队列	servosity-cli restore-queue watch
我的 Servosity 账单与向客户端开具的账单是否一致？	servosity-cli bill --reconcile invoices.csv
哪些已安装的 Agent 仍未拉取备份？	servosity-cli unprovisioned
哪些主机的保留期限不足 7 年，或不符合恢复保障？	servosity-cli retention-audit --min 7YEAR
本月备份失败背后的单一根本原因是什么？	servosity-cli failure-clusters --top 10
首次填充本地机群镜像	servosity-cli sync --full

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

与众不同之处

大多数面向备份和 DR 供应商的 AI 集成，都会将每个问题转发为对合作伙伴门户的实时 API 调用。对于单个客户端，这样做没问题。但如果你问的是 “我的 47 个客户端中，哪些客户端有备份集已连续 7 天未成功？”，这种做法就行不通了——合作伙伴门户会将相关信息分散在各个客户端页面、各类型视图（M365、DR Server、DR Desktop）以及充斥着噪声的警报队列中。

这项技能会将 Servosity 同步到一个包含快照历史和 FTS5 搜索的本地机群镜像。跨客户端问题只需执行一次本地查询：响应即时、无需联网，AI 看到的是答案，而不是塞满分页 JSON 的上下文窗口。attention、drift、stale-backups 和 backup-facts 等复合命令会联结公司、备份和问题；这些命令保存的快照历史还能支持 drift、fleet-health 变化量和 storage-trend 预测，而无状态 API 封装器无法提供这些功能。

解决的痛点

备份和 DR 领域的“静默故障”最为棘手。MSP 负责人提到的痛点包括：

• 静默备份故障发现得太晚。 备份悄无声息地停止成功，只有等到客户端需要还原时才会被发现——那是最糟糕的发现时机。
• 缺少全机群视图。 每个客户端的备份状态都在各自的门户视图中；没有一个统一界面能显示“在我的整个客户群中，目前有哪些备份过期、失败或正在处理中。”
• 警报队列中的噪声掩盖了真正的故障。 每个客户端都会堆积大量重复问题和已知安全问题；真正重要的问题被埋在其中。
• 回答单个客户端的问题需要在门户中翻找。 要回答“这个客户端正常吗？”，就得手动逐项查看元数据、每种备份类型、合同和问题。

这项技能将单个客户端的门户视图转化为覆盖整个机群、快速离线可用的情报：attention 可在一个界面查看所有客户端；stale-backups 可找出周五邮件的收件名单，email-draft 则会撰写邮件；drift 让你在周一开始工作时掌握情况，而不是从一张白纸开始；triage 可批量抑制已知安全噪声（忽略／归档／评论），让队列中只显示新问题；qbr 和 qbr-all 则将季度末报告制作简化为一条命令。

常见问题

这能与 ChatGPT 配合使用吗？

可以，适用于 Plus、Pro、Team、Business、Enterprise 和 Education 计划（Free 目前尚未开放 Developer Mode）。ChatGPT 只能通过 HTTPS 连接到远程 MCP 服务，因此你需要以 HTTP 模式托管 servosity-mcp：在设置 SERVOSITY_MSP_MCP_HTTP_TOKEN 之前，它会拒绝启动；每个请求都必须通过 bearer 请求头发送该令牌；此外，除回环地址外，任何地址都需要 --tls-cert 和 --tls-key。只有在连接器的身份验证设置能够发送该 bearer 令牌时，连接才有效，因此请先检查相关设置。分步说明见 mcp-install.md。

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

可以——它们都支持 MCP。上方矩阵中提供了跨工具安装命令，详细说明见 docs/which-agent.md。其中记录了各工具的注意事项（Copilot 使用 servers 而非 mcpServers、Cline 在 Windows 上的 npx 问题、ChatGPT 的计划要求及桥接）。

我需要成为 Servosity MSP 合作伙伴吗？

需要。此技能封装的 Servosity API 接口仅向通过身份验证的 MSP 合作伙伴开放。你需要从 Servosity 合作伙伴门户获取合作伙伴 API 令牌。此技能本身免费；令牌是 Servosity 合作伙伴协议的一部分。还不是 Servosity 合作伙伴？请通过 servosity.com 联系他们。

这会取代 Servosity 合作伙伴门户吗？

不会。你仍需通过门户处理管理工作、配置备份并接入客户端。此技能让 AI 能够查询门户中的数据，这样日常排查、每周五的备份过期报告、偏差检查以及临时的跨客户端问题都无需再费力翻查门户。门户保持不变；你只是新增了一种查询数据的方式。

我需要会编程吗？

不需要。推荐的安装方式是在 Claude Code 或 Codex 中粘贴一句话——你的 Agent 会读取 SKILL.md 并完成安装。备用方式是每种操作系统各有一条安装命令（bash 或 PowerShell）。这两种方式都不需要编写代码。你只需输入一次 Servosity 合作伙伴令牌。

我的 Servosity / 客户端数据安全吗？

你的数据保留在自己的计算机上。CLI 和 MCP 服务都是本地二进制文件。设备群镜像存放在你用户帐户下的一个目录中。AI Agent 只能看到 CLI 返回的内容——通常是查询结果，而非原始批量数据。合作伙伴令牌从你的环境或 Agent 配置中读取；MSP Skills 绝不会将其打包进此代码库或传输到任何地方。令牌仅适用于你的经销商帐户（无法跨经销商访问）。

我能在 Windows 上运行吗？

可以。上方的 PowerShell 安装程序适用于 Windows。CLI 和 MCP 二进制文件均为原生 Windows 版本。

费用是多少？

免费。采用 Apache-2.0 许可证。Servosity 不会对运行此技能所需的 API 访问收费——合作伙伴门户 API 已包含在你现有的合作伙伴协议中。你只需为所使用的 AI Agent（Claude、ChatGPT、Codex 等）付费，费用由相应的 AI 提供商收取。

安全模型

该技能使用一个合作伙伴令牌进行身份验证，其权限仅限于你的经销商账户（无法跨经销商访问）。请了解写入操作的控制方式——二进制程序不会替你进行控制：--dry-run 是可选启用的预览；如果命令会交互式提示，只有明确指定 --yes 才会跳过提示——--agent 不代表 --yes。控制机制由你的 Agent 策略负责：使用 --dry-run 预览，展示确切命令，获取批准，然后执行。

层级	示例	建议的 Agent 策略
读取	attention、drift、stale-backups、backup-facts、qbr、fleet-health、unprovisioned、retention-audit、failure-clusters、bill、email-draft（仅草拟，不会发送任何内容）、restore-queue watch、search	允许
写入（常规）	triage（--ignore/--archive/--reactivate/--comment）、import、资源组下的原始创建/更新子命令	使用 --dry-run 预览，然后在审核后写入——绝不一概使用 --yes
凭据 / 安全	credentials rotate/delete、current-user api-token-list --reveal-token、current-user *-mfa-*、resellers agent-install-token、*-backups encryption-key update、auth set-token/logout	仅限人工参与；API 令牌读取不包含在 MCP 和同步功能中
破坏性操作	companies delete（会删除所有备份账户和数据）、backups delete、users delete	仅限人工参与

自主 Agent 的操作范围应限制为读取加预览后的写入；低于这一范围的所有操作都应由人工把关。完整矩阵和锁定指南请参阅 governance.md。

状态

已用于 Servosity 自身的备份 / DR 运维；现已向 MSP 合作伙伴发布。公共功能目前处于 Beta 阶段，并正在与 MSP 一起通过线上 Build Sessions 进行验证。请在 compoundingteams.com/build-sessions RSVP。

---

标准。 符合开放的 Agent Skills 规范（Anthropic，2025 年 12 月；40 多个 Agent）。兼容 MCP——可与任何支持 MCP 的 Agent 配合使用，包括 Hermes 和 OpenClaw；已预先配置 metadata.openclaw frontmatter，因此可直接运行 openclaw skills install。

由 Servosity 维护。采用 Apache-2.0 许可。使用 CLI Printing Press 构建。上次更新：2026-10-23。