Acronis MCP

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

非官方。由社区构建的 Claude Code Skill 和 Acronis API MCP 服务。与 Acronis International GmbH 无关联，也未获其认可或赞助。

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

同样来自 Servosity。 备份与灾难恢复是 Servosity 自有领域——第一方 Servosity connector 将同样的全局、本地镜像方案（全局关注、过期备份、恢复、QBR 报告）带到 Servosity Backup and DR。

首个真正面向 Acronis Cyber Protect Cloud 平台的 CLI——将每个租户、Agent 和使用情况指标镜像到本地，并提供单次 API 调用无法返回的跨租户汇总。可与您现有的 AI 配合使用——ChatGPT（Plus/Pro+，通过托管 HTTPS 端点；参见 mcp-install.md）、Claude Desktop、Codex、Claude Code、Claude Cowork 和 GitHub Copilot——还可通过远程方式使用 Microsoft 365 Copilot / Copilot Studio 和 Google Gemini。免费、开源，可在笔记本电脑上运行。专为 MSP 所有者打造。无需编写代码。

适用于您的 Agent

安全说明。 本地 Agent 使用默认的 stdio 传输，无需网络侦听器。 HTTP 模式（--transport http，供远程 Agent 使用）在设置 ACRONIS_MCP_HTTP_TOKEN 前拒绝启动；任何不带该 bearer token 的请求都会被拒绝； 默认提供 http://127.0.0.1:7777/mcp，使用其他地址时则需要 --tls-cert 和 --tls-key。如果请求正文超过 4 MiB，或接收时间超过 30 秒，也会拒绝请求。 持有该 token 的任何人都能使用您的 Acronis 凭据调用所有工具。用于删除或替换（DELETE、PUT）的端点工具带有 MCP destructiveHint 注释；用于创建或触发（POST）的工具则标记为非只读；服务器不会要求确认，因此是否执行确认由您的 MCP 主机负责。对于只需读取的主机，请设置 ACRONIS_MCP_READ_ONLY=1：这会移除所有未标记为只读的工具。参见 mcp-install.md。

MSP 所有者实际使用的六种 Agent（可自行安装，现已可用）：

您的 AI Agent	如何安装 Acronis skill
Claude Desktop	运行安装程序，然后转到 Settings > Extensions 注册 acronis-mcp（无需编辑 JSON）。
ChatGPT（付费方案）	运行安装程序，通过 HTTPS 托管 acronis-mcp 并设置 bearer token，然后将其注册为 Developer Mode connector。参见 mcp-install.md。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 acronis-mcp，然后选择 Agent 模式。

ChatGPT 需要远程 HTTPS 服务，即使用此 connector 的 HTTP 模式：在设置 ACRONIS_MCP_HTTP_TOKEN 前，服务会拒绝启动；每个请求都必须在 bearer 标头中发送该 token；任何非回环地址还需要 --tls-cert 和 --tls-key。参见 mcp-install.md。

Microsoft 和 Google 技术栈也适用

用户基数庞大，但需要如实提醒：这些属于远程／企业级路径，不是你刚刚安装的本地二进制文件。

Agent	所需条件
Microsoft 365 Copilot / Copilot Studio	通过 HTTPS 托管 acronis-mcp，并使用 bearer token（与 ChatGPT 的 HTTP 模式相同），然后在 Copilot Studio 中将其添加为 Model Context Protocol 工具。需要 Copilot Studio 许可证和租户管理员。请参阅 mcp-install.md。
Google Gemini	Gemini CLI 是本地的，与 Claude Code 相同。Gemini app 是远程的，需要与 ChatGPT 相同的托管 HTTPS 端点。请参阅 mcp-install.md。

原生支持技能的 Agent（同样已涵盖）：Hermes 和 OpenClaw 可直接读取此技能的 SKILL.md，并且支持 MCP——请参阅下方的安装部分。Cursor、Windsurf、Cline、Continue.dev 和 Zed 也可通过 MCP 使用。各工具的完整接入说明：docs/which-agent.md。

**要使用多个 Agent？**通过一条命令即可在全部 51+ 个受支持的 Agent 中安装：npx skills add Servosity/msp-skills@latest（需要 Node.js，然后为 CLI／MCP 二进制文件运行对应技能的安装程序）。请参阅 docs/which-agent.md。

60 秒内完成安装

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

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

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

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

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

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

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

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

任何能够运行 shell 的 Agent 都可以使用相同的提示词。

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

acronis-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

Claude Desktop .mcpb 用户：下载最新的 .mcpb（位于本节顶部），然后在 Settings > Extensions 中重新选择它。Claude Code 插件用户：/plugin update acronis@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 的 Settings > Extensions 面板是最简单的接入方式；面向偏好编辑 JSON 的用户，mcp-install.md 中提供了 MCP 配置块。

为 Hermes 安装

在 Hermes CLI 中：

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

在 Hermes 聊天会话中：

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

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

为 OpenClaw 安装

向你的 OpenClaw Agent 发送以下内容（复制即可）：

从 https://github.com/servosity/msp-skills/tree/main/skills/acronis 安装 acronis 技能。该技能说明如何通过 openclaw: frontmatter 块安装所需的 CLI（acronis-cli）。

OpenClaw 目前尚未普遍开放；frontmatter 接入配置已预先准备好，OpenClaw 一经发布就会启用。

进行身份验证

设置 CLI 所需的凭据（从你的 Acronis 门户获取）：

ACRONIS_BEARER_AUTH=<value> ACRONIS_DATACENTER=<value> acronis-cli doctor

在运行任何会触及数据的操作前，doctor 会确认凭据是否有效。即使凭据被拒绝，它也会以状态码 0 退出，因此脚本应添加 --fail-on error。

此技能的功能

MSP 常问的问题	命令
昨晚所有客户中，哪些客户的备份失败、成功或已过期？	acronis-cli health
显示过去 24 小时内每个失败或遗漏的备份	acronis-cli failures --since 24h
哪些客户长时间没有成功备份（违反 SLA）？	acronis-cli freshness --sla 48h --breached
所有租户中，哪些备份 Agent 已悄然离线？	acronis-cli agents stale --older-than 7d
部署后，每位客户的 Agent 都已更新吗？	acronis-cli agents compliance
我在哪些地方为实际上未运行的保护服务付费？	acronis-cli coverage --unprotected
哪些用量没有匹配的 SKU，哪些付费 SKU 的用量为零？	acronis-cli reconcile usages
通话前，如何查看某个客户的所有信息？	acronis-cli customer "<TENANT_ID>"

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

与众不同之处

大多数 Acronis 集成和 MCP 服务都会将每个问题代理为一次实时 API 调用。对于单条记录，这种方式没问题；但规模扩大后就会失效：例如，你要查询 40 多个客户租户中，昨晚哪些租户备份失败、哪些 Agent 已悄然离线——每个租户都要进行一次分页 API 调用，还要处理令牌交换和数据中心主机探测。

此技能会将 Acronis 数据同步到带有全文搜索的本地 SQLite 镜像中——这正是 Acronis 自己的开发者监控指南建议 MSP 构建的本地存储方案。聚合查询只需一次本地 SQL 联接：响应即时、可离线运行，AI 看到的是答案，而不是原始数据。health、coverage --unprotected 和 customer 等复合命令会跨租户、Agent、备份任务、用量及服务项目进行联接——无状态 API 包装器无法做到这一点。

解决的痛点

备份验证是 MSP 绝不能掉以轻心的工作，而 Acronis Cyber Protect Cloud 却让它变成了每个租户都要单独处理的琐事。Acronis 自己的《Management Portal Administrator Guide》明确指出，合作伙伴级仪表板和报告只能在单个合作伙伴租户内使用——因此，对于“昨晚哪些客户的备份失败了”，没有统一的跨客户视图。你只能逐个深入查看租户，或者导出数据后在 Excel 中拼凑。最令人头疼的故障往往悄无声息：备份 Agent 默默停止上报，是保护措施失效而无人察觉的最常见原因，只有在客户要求恢复却发现备份并不存在时才会暴露出来。这正是 MSP 在 r/msp 上谈到备份监控时常常描述的日常苦差事。

执行一次 sync 后，跨租户问题就能通过一次离线查询解决：

• acronis-cli health - 在一个表格中查看所有客户的备份成功、失败或过期情况。
• acronis-cli agents stale --older-than 7d - 列出所有租户中已悄然离线的 Agent，并按客户排序。
• acronis-cli freshness --sla 48h --breached - 找出太久没有成功备份的客户。
• acronis-cli coverage --unprotected - 找出已付费购买保护服务、但实际并未运行保护的租户。
• acronis-cli reconcile usages - 找出没有 SKU 的用量以及用量为零的付费 SKU，让发票与实际情况相符。

更多背景说明请参阅 pain-point.md。

常见问题

能与 ChatGPT 搭配使用吗？

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

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

可以——它们都支持 MCP。跨工具安装命令见上方的对照表，详细说明见 docs/which-agent.md。

我需要懂编程吗？

不需要。推荐的安装方式是向 Claude Code 或 Codex 粘贴一句话——你的 Agent 会读取 SKILL.md 并完成安装。备用方式是为每种操作系统提供一条安装命令（bash 或 PowerShell）。这两种方式都不需要编写代码。你只需输入一次 Acronis 凭据。

我的 Acronis 数据安全吗？

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

这会触及 Acronis API 的速率限制吗？

本地镜像的作用就是避免读取操作继续调用 API。首次执行 sync 后，跨租户视图（health、coverage、freshness、agents stale、reconcile usages）都通过本地 SQLite 运行，不会调用 API。实时调用会遵守 --rate-limit 限流设置。每次 sync 都会重新读取镜像中的所有资源，因此请安排定期同步，而不是在每次查询前都运行它。

我需要是 Acronis 合作伙伴吗？

需要。你需要使用在自己的 Acronis Management Portal 中创建的 API 客户端（OAuth2 客户端或 bearer 令牌）进行身份验证，因此你必须拥有要访问的租户的合作伙伴或管理员权限。CLI 只能查看该 API 客户端获准访问的内容。

它指向哪个数据中心？

由托管你的 Acronis 账户的数据中心决定。设置 ACRONIS_DATACENTER（例如 us-cloud 或 eu2-cloud），或在 acronis-cli auth login 中传入 --datacenter。CLI 会据此构建正确的区域 API 主机地址，因此你无需手动拼接数据中心 URL。

它会取代 Acronis 控制台吗？

不会。配置保护计划和运行恢复时，控制台仍然是最佳选择。此技能增加了跨租户报告层，弥补了合作伙伴仪表板的不足——让你可以在同一处查询哪些客户的备份失败、哪些代理处于离线状态，以及账单与保护情况在哪些方面不一致。

费用是多少？

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

安全模型

级别	示例	建议的 Agent 策略
读取	acronis-cli health、acronis-cli coverage --unprotected、acronis-cli agents stale、acronis-cli reconcile usages、acronis-cli customer "<TENANT_ID>"	允许
写入（日常操作）	acronis-cli tenants create、acronis-cli tenants update、acronis-cli tenants offering-items update、acronis-cli reports、acronis-cli agent-manager force-agent-update	使用 --dry-run 预览，然后经审核后再写入
凭据 / 安全	acronis-cli clients create（会返回新客户端的密钥）、acronis-cli idp request-token、acronis-cli idp revoke-token	仅限人工介入
破坏性操作	acronis-cli tenants delete、acronis-cli clients delete、acronis-cli agent-manager delete-agent、acronis-cli agent-manager delete-agents	仅限人工介入

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

状态

已在实际环境中验证。@asterisk79（MSP）已使用其多租户合作伙伴账户确认此功能（#325）。更多 MSP 正在我们的每周 Build Sessions 中实际运行此工具。请在 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-06。

合作伙伴同步与完整性

在依赖整个客户群的汇总数据前，请先运行 acronis-cli sync --full。同步会解析 API 客户端的根租户，并获取其租户层级、代理、任务、活动，以及所有版本中每个租户的用户、用量和产品项目。

任何资源获取失败、被拒绝、格式错误或内容被截断，都会导致同步以非零状态码退出。health、freshness、coverage、tree 和其他本地汇总功能都会拒绝使用不完整的镜像。旧数据库必须使用此版本成功执行完整同步。范围同步、--since 和 --latest-only 会使镜像保持为部分状态；请使用原始 search 或 sql 检查这些记录。每次运行都会从第一页开始枚举；旧检查点无法证明镜像完整。未筛选的同步会替换之前的镜像，并移除供应商处已删除的记录。 如果刷新失败，镜像会一直保持不完整，直到重试成功。

任务列表中现有的 --tenant-id 标志会在获取所有页面后，在本地按完全匹配的租户 UUID 筛选。它不会按租户子树筛选，且不能与 --after 或 --data-source local 组合使用；若要精确筛选租户，请使用实时枚举。任务筛选器使用供应商的 camelCase 线格式名称。请使用 --order 'desc(startedAt)'；较早的 startedAt desc 写法也会转换处理。直接 MCP 任务工具采用相同的处理方式，并会在应用租户筛选器前完成分页。

默认情况下，remote-search --query Customer 会使用经过身份验证的根租户；--tenant-id 可指定另一个可访问的子树。搜索词至少需要三个字符，限制为 1 到 300。此 API 不支持分页：--all 不会将搜索结果扩展到该限制之外。

现在，auth login --datacenter eu8-cloud 会在配置包含随附占位符或标准 Acronis 区域主机时，保存所选 API URL。明确指定的自定义基础 URL 或 ACRONIS_BASE_URL 覆盖值会予以保留。 HTTP 400 验证错误不再建议替换可用的凭据。

部分 Agent API 版本会返回数字租户 ID，而 Account Management 使用 UUID。如果无法关联这些身份信息，汇总报告会列出无法匹配的代理，而不会声称代理数量为零。仍需由合作伙伴进行实时重新测试。

API 合约：任务分页， 任务筛选器， 账户 API， 代理 API。

共享同一数据库的同步任务会依次运行。进程崩溃后，可能会残留过期的 <database>.sync.lock。删除该锁并重试完整同步前，请确认没有同步任务正在运行。