Afi MCP

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

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

_{完整 Skill 页面 - 安装、使用效果、安全模型。}

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

首个适用于 Afi SaaS 备份的 CLI——全面覆盖公开 API，并提供全机群覆盖、过期情况和离职处理方面的答案，这些内容无法通过受限速的 API 实时获取。可与您现有的 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	如何安装 Afi skill
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 afi-mcp（无需编辑 JSON）。
ChatGPT（付费套餐）	在此 connector 重新发布前暂停：ChatGPT 需要 HTTP 模式，而此版本的该模式不要求密码、会监听所有网络接口，并且您打开的网页可以访问它。请参阅 mcp-install.md 中的安全提示。
Codex CLI	粘贴下面的安装提示词。
Claude Code	粘贴下面的安装提示词。
Claude Cowork	粘贴下面的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 afi-mcp，然后选择 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 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

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

下载 Afi MCP (.mcpb)——然后打开 Claude Desktop > Settings > Extensions 并选择该文件。只需点击一次，无需 JSON，也无需使用 Shell。（在 releases 页面浏览所有 Afi 版本。）

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

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

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

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

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

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

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

afi-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

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

为 Hermes 安装

在 Hermes CLI 中：

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

在 Hermes 聊天会话中：

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

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

为 OpenClaw 安装

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

从 https://github.com/servosity/msp-skills/tree/main/skills/afi 安装 afi 技能。该技能通过 openclaw: frontmatter 块定义了如何安装其必需的 CLI（afi-cli）。

OpenClaw 目前尚未普遍开放；frontmatter 接入配置已预先提供，会在 OpenClaw 发布时立即启用。

进行身份验证

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

AFI_API_KEY=<value> afi-cli doctor

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

此技能的功能

MSP 常问的问题	命令
哪些资源完全没有备份保护？	afi-cli coverage-gaps --agent
哪些受保护资源的备份已过期（静默失败）？	afi-cli backup-stale --max-age 48h --agent
今天早上整个资源群是否一切正常？如果不是，哪些资源失败了？	afi-cli fleet-health --failed-only --agent
如何查看某个租户的完整备份状况，以用于 QBR 或工单？	afi-cli tenant-scorecard <tenant-id> --agent
Afi 席位的许可数量是过多还是不足？	afi-cli reconcile-licenses --agent
[email protected] 在 Afi 中是谁？（包括跨 Multi-Geo 租户）	afi-cli resolve <email-or-id> --agent
如何安全地备份离职员工的邮箱，然后释放它？	afi-cli offboard <resource-id> --tenant <tenant-id> --reason "employee departure"

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

有何不同

大多数 Afi 集成和 MCP 服务都会把每个问题转发为实时 API 调用。查询单条记录时这样做没问题。但规模扩大后就行不通了，例如要问“所有 47 个客户租户中，哪些邮箱没有关联备份策略？”——而 Afi 的公共 API 会因轮询而限制请求。

此技能会将 Afi 同步到带有全文搜索的本地 SQLite 镜像中。聚合查询只需执行一次本地 SQL 联接：即时完成，无需联网，而且 AI 看到的是答案，而不是原始数据。coverage-gaps、backup-stale 和 reconcile-licenses 等复合命令会一次性将所有租户的资源与保护、归档和已购订阅进行联接——这是无状态 API 封装层无法实现的。

解决的痛点

SaaS 备份有一种不易察觉的故障模式，MSP 所有者在 r/msp 上反复提起：你以为正在运行的备份，其实并没有运行。有人在 Microsoft 365 或 Google Workspace 中创建了邮箱或站点，入职工单也随之关闭，却没人确认是否已为其分配备份策略；或者确实分配了策略，但夜间归档悄然停止，门户仍显示其处于“受保护”状态。这个漏洞一直不会被发现，直到客户要求恢复，而数据压根就不存在。大家反复提到的问题是：“如何真正确认每位客户的 M365 备份都在运行？” Afi 有这些数据，但一次只能查看一个租户，而且必须通过迫使你逐个客户查看的门户操作；Afi 还要求你不要轮询其 API。

此技能通过本地镜像弥补了这个漏洞：

• afi-cli coverage-gaps --agent ——列出整个客户群中所有未受备份保护的资源。明确指出盲区。
• afi-cli backup-stale --max-age 48h --agent ——列出虽受保护、但最新归档已过期的资源：这类故障悄无声息。
• afi-cli fleet-health --failed-only --agent ——用一张表完成周一的“客户群状态是否正常”巡检。
• afi-cli reconcile-licenses --agent ——核对已购买席位与实际受保护的席位。
• afi-cli offboard <resource-id> --tenant <tenant-id> --reason "employee departure" ——先归档再释放，并在确认最新备份前拒绝移除保护。

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

常见问题

这能与 ChatGPT 配合使用吗？

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

我的 Afi 数据安全吗？

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

这会触发 Afi 的 API 速率限制吗？

按设计方式使用就不会。Afi 会限制持续轮询的应用，甚至可能暂停这些应用；因此，此技能会通过一次谨慎且受速率限制的操作将整个客户群同步到本地存储（afi-cli fleet-sync），之后所有问题都会基于该存储离线回答。你应按计划进行同步，而不是每提一个问题就同步一次。

我需要是 Afi 客户吗？API 密钥需要哪些权限？

需要——你必须拥有 Afi 帐户和 Application API 密钥。可在 Afi 门户中创建密钥（组织级别：Configuration > Apps；租户级别：Service > Settings > Apps）。密钥会继承 Application 的安装范围，因此 CLI 只能看到安装了该 Application 的组织和租户。每个 Application 支持两个密钥，可用于轮换。

这会取代 Afi 门户吗？

不会。恢复、导出和策略编辑仍需在 Afi 门户中进行，因为公共 API 不提供这些功能。此技能负责读取、报告和受控退役：它可以回答整个机群的问题，并执行经验证的“先归档、再释放”流程，然后将你带回门户，完成只有门户才能执行的操作。

费用是多少？

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

安全模型

等级	示例	建议的 Agent 策略
读取	coverage-gaps、backup-stale、fleet-health、tenant-scorecard、reconcile-licenses、resolve、fleet-sync，以及所有 list/get	允许
写入（常规）	orgs create、import、tenants resources protections-protect、tenants jobs tasks-trigger	使用 --dry-run 预览，然后在审核后写入
凭据 / 安全	auth set-token、auth logout	仅限人工参与
破坏性操作 / 配置	offboard（释放保护）、tenants resources protections-unprotect、tenants archives delete	仅限人工参与

最有力的控制措施是你授予 Afi 凭据的权限范围——CLI 只能执行这些凭据获准执行的操作。完整详情（包括如何收紧权限）请参阅 governance.md。

状态

Beta 版。已根据 Afi API 接口进行验证，目前正与 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-07。