Backup Radar MCP

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

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

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

同样来自 Servosity。 备份与灾难恢复是 Servosity 自有领域 - 一方的 Servosity 连接器 将同样的全网、本地镜像方案（全网关注、过期备份、还原、QBR 报告）引入 Servosity Backup and DR。

涵盖所有 Backup Radar v3 和 v2 端点，另附一个本地存储，用于发现无人关注的备份。可与您已在使用的 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 工具也可以使用您的凭据进行 更改。如果您为远程 Agent 设置了隧道，请将其关闭。修复即将推出。

MSP 所有者实际使用的六种 Agent（ChatGPT 在此连接器重新发布前暂停，详见下文）：

您的 AI Agent	如何安装 Backup Radar 技能
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 backup-radar-mcp（无需编辑 JSON）。
ChatGPT（付费套餐）	在此连接器重新发布前暂停：ChatGPT 需要 HTTP 模式，但此版本的该模式虽然会检查令牌，却尚无请求大小或时间限制。请参阅 mcp-install.md 中的安全提示。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 backup-radar-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，之后为 CLI/MCP 二进制文件运行各 Skill 的安装程序）。请参阅 docs/which-agent.md。

60 秒内完成安装

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

下载 Backup Radar MCP (.mcpb)——然后打开 Claude Desktop > 设置 > 扩展 并选择该文件。点击一次即可，无需 JSON 或 shell。（在发布页面浏览所有 Backup Radar 版本。）

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

/plugin marketplace add Servosity/msp-skills
/plugin install backup-radar@msp-skills

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

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

在此 Agent 工作区中安装 Servosity/msp-skills 的 Backup Radar Skill 和 MCP 服务。如果此工作区使用 POSIX shell（macOS、Linux、WSL 或 Bash），请运行 bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/backup-radar/install.sh)。如果使用 Windows PowerShell，请运行 iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/backup-radar/install.ps1 | iex。然后按照 README 进行身份验证，并运行 backup-radar-cli --help 进行探索。

这条提示词也适用于任何能够运行 shell 的 Agent。

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

backup-radar-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

Claude Desktop .mcpb 用户：下载最新的 .mcpb（位于本节顶部），然后在 设置 > 扩展 中重新选择该文件。Claude Code 插件用户：/plugin update backup-radar@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 的“设置 > 扩展”面板是最简单的方式；MCP 配置块（适用于偏好编辑 JSON 的用户）见 mcp-install.md。

为 Hermes 安装

在 Hermes CLI 中：

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

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/backup-radar --force

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

为 OpenClaw 安装

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

从 https://github.com/servosity/msp-skills/tree/main/skills/backup-radar 安装 backup-radar skill。该 skill 定义了如何通过 openclaw: frontmatter 块安装所需的 CLI（backup-radar-cli）。

OpenClaw 尚未普遍开放；frontmatter 配置已预先提供，OpenClaw 一经发布便会启用。

身份验证

设置 CLI 所需的凭据（ScalePad API 标签页中的 v3 密钥，以及 Backup Radar 中的 v2 密钥；单独设置任意一个，就足以运行对应的命令）：

# macOS / Linux
BACKUP_RADAR_API_KEY=<value> BACKUP_RADAR_V2_API_KEY=<value> backup-radar-cli doctor

# Windows PowerShell
$env:BACKUP_RADAR_API_KEY = "<value>"; $env:BACKUP_RADAR_V2_API_KEY = "<value>"; backup-radar-cli doctor

doctor 会检查配置、路径和 API 连通性，然后使用 API 测试每个已配置的密钥（ScalePad v3 密钥使用 GET /clients/health，Backup Radar v2 密钥使用 GET /backups/overview），并为每个密钥（credentials、credentials_v2）报告 valid、rejected 或 not verified。即使某一行显示 ERROR，进程仍会以 0 退出；在脚本中传入 --fail-on error。单独设置任意一个密钥，就足以运行对应的命令。

此 skill 的功能

MSP 经常提出的问题	命令
今天哪些备份失败或无响应（无论是新出现还是持续存在），每个备份有多少个未结工单？	backup-radar-cli check --agent
哪些备份无人监控：处于非活动状态、未映射到 ScalePad、失败但没有工单、没有 PSA 公司，或警告被计为成功？	backup-radar-cli unwatched --agent
某个客户端 90 天内的备份合规率是多少，包括每周趋势和问题最严重的五台设备？	backup-radar-cli scorecard "Acme Dental" --days 90 --agent
按备份合规率对所有客户端排名，最差的排在最前	backup-radar-cli scorecard --days 90 --agent
本月某台设备的备份每天发生了什么，包括工单、标签和备注？	backup-radar-cli timeline "DC01" --days 30 --agent
哪些备份 45 天没有结果且可能已停用？同时为每个可定位的备份生成待停用请求正文的试运行结果	backup-radar-cli stale --days 45 --agent
备份供应商是否保护了 Backup Radar 未监控的设备，或反过来？	backup-radar-cli coverage diff --devices vendor-devices.json --agent
推送 Backup Radar 无法解析的备份工具结果，并在 10,000 条结果的限制内进行验证和分批处理	backup-radar-cli push --from results.csv --dry-run

每个分析命令都会读取本地镜像。backup-radar-cli sync 会根据你设置的密钥填充该镜像；每个命令也会说明哪些集合因从未同步而被跳过。镜像的范围由填充它的凭据决定（v3 密钥，以及设置了 v2 密钥时的 v2 密钥），因此运行分析命令时，请使用与 sync 相同的 BACKUP_RADAR_API_KEY（环境变量或通过 auth set-token 设置）以及相同的 BACKUP_RADAR_V2_API_KEY 设置。

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

有何不同

大多数 Backup Radar 集成和 MCP 服务都会将每个问题转发为实时 API 调用。查询一条记录时，这样做没问题。但在规模扩大后就行不通了，比如你要问：“我们 400 个备份中，哪些已经一周没有上报且没有工单？上个季度哪些客户的合规率下降了？”

此技能会将 Backup Radar 同步到带全文搜索的本地 SQLite 镜像中。聚合查询只需执行一次本地 SQL 联接：即时、离线，而且 AI 看到的是答案，而不是原始数据。check、unwatched 和 scorecard 等复合命令会联接 ScalePad v3 的客户健康状况和设备历史，以及 Backup Radar v2 的备份状态、非活动列表、策略标记和工单数量。无状态 API 封装无法完成这项工作，因为这两个 API 版本不会在一次调用中共同返回结果。

解决的痛点

备份如果从不报告状态，就不会发送故障邮件。ScalePad 的 Gflex 合作伙伴案例介绍了那些数周甚至数月都未被发现的备份，直到无结果监控发现问题才引起注意；一名技术人员每天还要花约 4 小时整理备份邮件。MicroAge Swift Current估算，其人工检查每天需要 2 小时。Backup Radar 弥补了数据收集方面的缺口，但晨间检查仍需要有人登录门户逐项查看：哪些故障是新出现的，哪些已持续一周，哪些已有工单，哪些备份从未启用，以及哪些已停用的设备仍在产生无结果噪声。River Run只会处理持续超过一天的故障，因为单次失败通常会自行恢复。这正是门户留给技术人员判断的“新问题还是持续问题”。

此技能的应对方式：

• backup-radar-cli check --include-at-risk --agent - 按优先级排列今天失败、静默和有风险的备份，并为每项标记是新问题还是持续问题、当前状态持续天数以及未结工单数量（不带 --include-at-risk 时，仅显示失败和无结果的备份）。
• backup-radar-cli unwatched --agent - 列出所有无人处理的备份，并附上原因代码：inactive、unmapped、ticketless、no-psa、masked。
• backup-radar-cli stale --days 45 --agent - 按客户分组列出静默备份，每项都附带 dry_run: true 的退役请求体（映射设备按 ScalePad 设备 ID 固定标识；未映射设备按确切的公司、设备和作业名称固定标识；仅存在于 v2 的记录则附带 retire_note），可直接通过 backups retire --stdin 预览。
• backup-radar-cli scorecard --days 90 --agent - 按合规率为所有客户排名，或查看某个客户的每周趋势和表现最差的设备，用于 QBR。
• backup-radar-cli coverage diff --devices vendor-devices.json --agent - 找出备份供应商保护但 Backup Radar 未检测到的设备，以及相反的情况。

更详细的说明请参阅 pain-point.md。

常见问题

这能用于 ChatGPT 吗？

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

我的 Backup Radar 数据安全吗？

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

我需要同时具备 ScalePad API 密钥和 Backup Radar API v2 密钥吗？

不需要。ScalePad API 密钥（BACKUP_RADAR_API_KEY，v3）用于 health、devices、backups ingest、backups retire 和 push。Backup Radar API v2 密钥（BACKUP_RADAR_V2_API_KEY）用于 backups list、get、results、filters、inactive、retired 和 overview。每个密钥都能单独运行各自对应的命令；check、unwatched、stale 和 timeline 会使用你已同步的数据，并列出跳过了哪些数据。

这会触及 Backup Radar 或 ScalePad API 的速率限制吗？

分析命令读取本地镜像，因此每日 API 调用成本仅为一次 sync：包含一年的历史记录的 v3 客户端运行状况、包含 90 天数据的 v3 设备，以及包含 31 天数据的 v2 备份列表。客户端默认每秒最多发送 2 个请求（--rate-limit）。

AI Agent 会不会误操作停用备份？

backups retire 是唯一会从监控中移除备份的命令，它执行 v3 写入操作，并支持 API 自带的 --dry-run 预览。stale 会生成 dry_run: true 的停用请求体：已映射的设备通过 ScalePad 设备 ID 锁定目标，未映射的设备则通过公司、设备和作业名称的精确组合锁定；无法锁定目标的备份会获得 retire_note，而不会生成请求体。通过 MCP 使用时，BACKUP_RADAR_MCP_READ_ONLY=1 会彻底移除 backups_retire 和 backups_ingest 工具；此外，backups_retire 会被标注为具有破坏性，因此宿主会先征求确认。

它适用于欧盟的 ScalePad 租户吗？

适用。将 BACKUP_RADAR_BASE_URL 设为 https://eu.api.scalepad.com/backup-radar/v3（默认使用美国主机）。Backup Radar API v2 只有一个主机：https://api.backupradar.com。

费用是多少？

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

安全模型

层级	示例	建议的 Agent 策略
读取	check、unwatched、scorecard、timeline、stale、coverage diff、health list、devices、backups list、backups overview、sync、search、analytics	允许
写入（常规）	backups ingest、push、import（将备份结果提交到 Backup Radar）	使用 --dry-run 预览，然后经审核后写入
破坏性操作 / 凭据	backups retire（从监控中移除备份；--close-psa-tickets 会关闭对应工单）、auth set-token、auth logout	仅限人工参与

通过 MCP 使用时，BACKUP_RADAR_MCP_READ_ONLY=1 会移除 backups_ingest、backups_retire、sync、export、workflow_archive 和学习存储写入工具（learnings_forget、learnings_reject）；push 和 import 命令不会通过 MCP 暴露，而读取或写入本地文件的标志（--devices、--playbook-file、--notes-file、--output、--db）会被拒绝用于 MCP 调用。

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

状态

测试版。已针对 Backup Radar 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-10-19。