关于 Veeam VSPC MCP
Veeam VSPC MCP 是面向管理 Veeam Service Provider Console 的 MSP 的 MCP 服务和命令行工具。它将租户数据同步到本地 SQLite 镜像,支持离线的跨公司备份监控与分析。
主要功能
- 01将 VSPC 数据同步到本地 SQLite
- 02生成跨租户机群健康摘要
- 03检测备份过期和 RPO 风险
- 04汇总并去重活动警报
- 05查看许可证用量及变化
适用场景
- 01查找多个客户的失败备份任务
- 02识别超过 RPO 的受保护工作负载
- 03跨租户查看活动警报
- 04比较客户许可证用量
MCP 相关
通过 `veeam-mcp` 向 MCP 客户端提供 Veeam Service Provider Console 操作。它使用配套的 `veeam-cli`;README 建议采用默认的 stdio 传输,并警告当前版本不要使用 HTTP 模式。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
Veeam Service Provider Console + AI - 适用于 ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini 以及任何支持 MCP 的 Agent
非官方。由社区构建的 Claude Code Skill 和 Veeam API MCP 服务。与 Veeam Software 无关联,也未获得其认可或赞助。
▶ 观看 30 秒演示 - 演示数据为模拟数据;展示的每条命令都存在于实际 CLI 中。
同样来自 Servosity。 备份与灾难恢复是 Servosity 自有领域 - 第一方 Servosity connector 将同样的全域、本地镜像方案(全域关注、过期备份、还原、QBR 报告)带到 Servosity Backup and DR。
将每个 Veeam Service Provider Console 端点封装为类型化命令,并提供本地多租户镜像、跨公司汇总和漂移检测;这些都是其他按实例提供的 Veeam 工具所不具备的。可与您已在使用的 AI 搭配使用 - ChatGPT(Plus/Pro+,在此 connector 重新发布前暂停;参见 mcp-install.md)、Claude Desktop、Codex、Claude Code、Claude Cowork 和 GitHub Copilot - 也可通过远程方式使用 Microsoft 365 Copilot / Copilot Studio 和 Google Gemini。免费、开源,可在您的笔记本电脑上运行。专为 MSP 所有者打造。无需编写代码。
适用于您的 Agent
安全说明(在此 connector 重新发布前)。 请勿运行 HTTP 模式 (
--transport http),即使在 localhost 上也不行。此版本没有密码, 会监听所有网络接口,并且早于浏览器重绑定防护,因此您打开的网页可以访问它。 MCP 工具也可以使用您的凭据执行更改。请使用默认的 stdio 传输方式。如果您为 远程 Agent 设置了隧道,请将其关闭。修复即将推出。
MSP 所有者实际使用的六种 Agent(可自行安装,现已可用):
| 您的 AI Agent | 如何安装 Veeam skill |
|---|---|
| Claude Desktop | 运行安装程序,然后前往 Settings > Extensions 注册 veeam-mcp(无需编辑 JSON)。 |
| ChatGPT(付费计划) | 在此 connector 重新发布前暂停:ChatGPT 需要 HTTP 模式,而此版本的该模式不要求输入密码、会监听所有网络接口,并且您打开的网页可以访问它。请参阅 mcp-install.md 中的安全说明。 |
| Codex CLI | 粘贴下方的安装提示词。 |
| Claude Code | 粘贴下方的安装提示词。 |
| Claude Cowork | 粘贴下方的安装提示词。 |
| GitHub Copilot(VS Code) | 运行安装程序,在 servers 键下将 veeam-mcp 添加到 mcp.json,然后选择 Agent 模式。 |
ChatGPT 需要远程 HTTPS 服务,这意味着需要使用此 connector 的 HTTP 模式;在 connector 重新发布前,该模式已暂停:此版本的该模式不要求输入密码、会监听所有网络接口,并且您打开的网页可以访问它。请参阅 mcp-install.md 中的安全说明。
Microsoft 和 Google 生态也适用
用户基数庞大,但先坦诚说明:这些是远程/企业接入方式,而不是你刚安装的本地二进制文件。
| Agent | 所需条件 |
|---|---|
| Microsoft 365 Copilot / Copilot Studio | 暂停使用,直到重新发布此连接器:Copilot Studio 需要使用 HTTP 模式,而此构建中的该模式无需密码,会监听所有网络接口,且可以通过你打开的网页访问。请参阅 mcp-install.md 中的安全说明。 |
| Google Gemini | Gemini CLI 是本地运行的,与 Claude Code 相同。Gemini 应用是远程服务,需要使用与 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
Claude Desktop 安装包:
.mcpb可在 macOS(Intel 和 Apple Silicon)、Windows x64 和 Linux x64 上启动。每个工具都会调用配套的veeam-cli。自 2026-09-18 起发布的版本会将该 CLI 一并打包;较早的安装包只包含 MCP 服务。如果你的安装包缺少配套程序,请先运行下方的路径 A 或路径 B 安装程序(或将VEEAM_CLI_PATH设置为现有二进制文件的路径)。详情请参阅:#331。
下载 Veeam MCP(.mcpb)——然后打开 Claude Desktop > 设置 > 扩展 并选择该文件。点击一次即可完成,无需 JSON 或命令行。(可在发布页面查看所有 Veeam 版本。)
更喜欢 Claude Code 插件?只需添加一次插件市场,然后安装即可立即使用,无需列出目录:
/plugin marketplace add Servosity/msp-skills
/plugin install veeam@msp-skills
路径 A——向 AI Agent 粘贴一条提示词(推荐)
将以下内容复制到 Claude Code、Codex CLI 或 Claude Cowork 中:
在此 Agent 工作区中安装来自 Servosity/msp-skills 的 Veeam Skill 和 MCP 服务。如果此工作区使用 POSIX shell(macOS、Linux、WSL 或 Bash),请运行
bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/veeam/install.sh)。如果使用 Windows PowerShell,请运行iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/veeam/install.ps1 | iex。然后按照 README 完成身份验证,并运行veeam-cli --help以了解用法。
任何能够运行 shell 的 Agent 都可以使用同一条提示词。
路径 B——自行运行安装程序
Windows(PowerShell):
iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/veeam/install.ps1 | iex
macOS / Linux:
bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/veeam/install.sh)
安装程序会将 veeam-cli(CLI)和 veeam-mcp(MCP 服务)都放入用户的 bin 路径。Claude Code、Codex 和 Cowork 会通过此目录中的 SKILL.md 发现该 Skill。
验证:
veeam-cli --version
升级到最新版本
安装程序始终会获取当前版本——重新运行即可升级:
macOS / Linux:
bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/veeam/install.sh)
Windows(PowerShell):
iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/veeam/install.ps1 | iex
Claude Desktop .mcpb 用户:下载最新的 .mcpb(见本节顶部),然后在 设置 > 扩展 中重新选择该文件。Claude Code 插件用户:/plugin update veeam@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-install.md 中记录了 MCP 配置块(适用于偏好编辑 JSON 的用户)。
为 Hermes 安装
在 Hermes 命令行中:
hermes skills install servosity/msp-skills/skills/veeam --force
在 Hermes 聊天会话中:
/skills install servosity/msp-skills/skills/veeam --force
Hermes 原生支持 MCP,因此也可以直接使用 veeam-mcp 服务——安装路径相同,环境变量也相同。
为 OpenClaw 安装
告诉你的 OpenClaw Agent(复制以下内容):
从 https://github.com/servosity/msp-skills/tree/main/skills/veeam 安装 veeam 技能。该技能定义了如何通过
openclaw:frontmatter 块安装其必需的 CLI(veeam-cli)。
OpenClaw 尚未正式开放使用;frontmatter 配置已预先提供,并会在 OpenClaw 发布后立即生效。
身份验证
设置 CLI 所需的凭据(从你的 Veeam 门户获取):
VEEAM_BASE_URL=<value> VEEAM_TOKEN=<value> veeam-cli doctor
运行任何会访问数据的操作前,doctor 会确认凭据有效。即使凭据被拒绝,它也会以状态码 0 退出,因此脚本应添加 --fail-on error。
此技能的功能
| MSP 经常提出的问题 | 命令 |
|---|---|
| 我的所有客户中,哪些备份作业失败了? | veeam-cli fleet-health --agent |
| 哪些作业和 Agent 已超过 3 天未成功运行? | veeam-cli stale-backups --days 3 --agent |
| 哪些受保护工作负载已超过其 RPO? | veeam-cli at-risk --rpo 24h --agent |
| 哪些活动警报需要人工处理(已跨租户去重)? | veeam-cli alarms-triage --severity Error --agent |
| 某个客户的备份、Agent 和警报情况如何? | veeam-cli company-overview --company "Contoso Ltd" --agent |
| 每位客户的许可证使用情况如何,有何变化? | veeam-cli license-usage --agent |
| 过去 24 小时内整个客户群发生了哪些变化? | veeam-cli since 24h --agent |
完整命令参考:guide.md。关于 AI Agent 操作约定(--agent、--dry-run 以及何时在变更前确认),请参阅 AGENTS.md。
此方案的不同之处
大多数 Veeam 集成和 MCP 服务都会将每个问题转发为针对单个控制台的实时 API 调用。这适用于单个作业。但规模扩大后就行不通了,例如你要询问“我的 60 位客户中,现在谁的备份失败了”,或“下一次季度业务回顾前,谁已超过其 RPO”。
此技能会将 Veeam Service Provider Console 同步到带全文搜索的本地 SQLite 镜像中。汇总类问题只需执行一次本地 SQL 联接:响应迅速、可离线使用,而且 AI 看到的是答案,而不是原始数据。fleet-health、stale-backups 和 at-risk 等复合命令会跨公司、备份服务器、作业、Agent、警报和受保护工作负载进行联接——这是无状态 API 封装器无法做到的。
解决的痛点
备份悄无声息地失败,是 r/msp 和 Veeam 社区论坛上反复出现的噩梦:作业不再成功,却没人察觉,直到客户需要恢复时,你才发现问题。VSPC 为 MSP 提供真正的多租户控制台,但它按租户组织——要回答最重要的跨客户问题(“现在有哪些客户的备份失败了?”“谁的恢复点目标(RPO)已超时?”“哪些 Agent 已过期?”),就得逐个点进每家公司。VSPC 中包含所有数据;从中获得全局答案则要花功夫,而偏偏这些答案总是在最糟糕的时刻派上用场:晨会、恢复请求、月度账单。
此技能可直接回答这些问题:
fleet-health- 按租户查看作业的最近状态、Agent 在线/离线情况和活动告警stale-backups --days 3- 跨所有租户,列出 N 天内没有成功运行记录的所有作业和 Agentat-risk --rpo 24h- 列出超出 RPO 或缺少近期还原点的受保护工作负载alarms-triage --severity Error- 按公司和严重程度去重并分组显示活动告警license-usage- 显示各组织的用量及与上次运行相比的变化量,便于计费
更详细的说明请参阅 pain-point.md。
常见问题
这能和 ChatGPT 搭配使用吗?
当前版本不支持。ChatGPT(Plus、Pro、Team、Business、Enterprise 和 Education 方案;Free 尚未开放 Developer Mode)只能通过 HTTPS 连接到远程 MCP 服务,这意味着需要以 HTTP 模式运行 Veeam 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)。这两种方式都不需要编写代码。你只需输入一次 Veeam 凭据。
我的 Veeam 数据安全吗?
你的数据会保留在自己的计算机上。CLI 和 MCP 服务都是本地二进制文件。SQLite 镜像存放在你用户帐户下的目录中。AI Agent 只能看到 CLI 返回的内容——通常是查询结果,而不是原始批量数据。凭据从你的环境或 Agent 配置中读取;MSP Skills 不会将凭据捆绑到此仓库中,也不会在任何地方传输凭据。
这能搭配独立的 Veeam Backup & Replication(VBR)使用吗?
不能。此技能面向多租户 MSP 环境,使用 Veeam Service Provider Console(VSPC)v3 REST API。如果只有一台前面没有 VSPC 的 VBR 服务器,则需要使用另一套 API。
它会给 VSPC 设备带来过多负载或触发速率限制吗?
本地镜像正是为此而设计的。你只需执行一次 sync,之后的汇总、分诊和搜索都会针对本地 SQLite 运行,因此日常问题不会访问设备。只有 sync 和实时 get 命令会调用 VSPC。
我需要特殊的 Veeam 许可证或合作伙伴身份吗?
你需要一台由你管理的 VSPC 设备、REST API bearer token(POST /token)以及它的基础 URL。此技能使用你的身份进行身份验证,不会对你的 Veeam 帐户进行任何更改。
它能更改备份作业或运行还原吗?
此技能开放了完整的 VSPC v3 接口,包括创建/删除作业和部署 Agent,但这些操作在 governance.md 中受人工审批机制限制。日常使用以只读监控为主;破坏性操作和基础设施命令需要明确批准。
需要付费吗?
免费。采用 Apache-2.0 许可。你只需为自己使用的 AI Agent(Claude、ChatGPT、Codex 等)付费,费用由你的 AI 提供商收取,与我们无关。
安全模型
VSPC 提供约 1000 条命令。默认安全策略为只读;所有会写入、安装、删除或接触凭据的操作都受到限制。
| 层级 | 示例 | 建议的 Agent 策略 |
|---|---|---|
| 读取(约 610 条) | fleet-health、stale-backups、at-risk、alarms-triage、company-overview、license-usage、since,以及所有 get/list/search 命令 | 允许 |
| 写入(配置) | configuration create/patch backup-policy、infrastructure create/assign jobs、discovery create/patch rules、alarms acknowledge/resolve | 使用 --dry-run 预览,然后在审核后执行写入操作 |
| 基础设施和 Agent 执行 | discovery install-backup-agent-on-computer / reboot-computer / start-rule、infrastructure activate / force-collect | 人工参与,并明确确认 |
| 破坏性操作 | infrastructure delete-tenant / delete-backup-agent、configuration delete-backup-policy、alarms delete-active | 仅限人工参与 |
| 凭据 / 安全 | authentication generate-* / decrypt-pkcs12-container、infrastructure create/get *-credentials 和 *-encryption-passwords、users tokens revoke-authentication | 仅限人工参与 |
最强有力的控制措施是授予 VSPC 令牌的权限范围——CLI 只能执行令牌获准执行的操作。完整详情(包括如何限制权限)请参阅 governance.md。
状态
Beta 版。已根据 Veeam 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-06-13。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。