ImmyBot MCP

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

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

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

为每个 ImmyBot 端点提供类型定义，另有本地 SQLite 镜像，可解答 Web UI 无法回答的跨租户问题。适用于你已经在使用的 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 工具也可以使用你的凭据进行更改。 请使用默认的 stdio 传输。如果你为远程 Agent 设置了隧道，请将其关闭。 修复即将推出。

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

你的 AI Agent	如何安装 ImmyBot Skill
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 immybot-mcp（无需编辑 JSON）。
ChatGPT（付费方案）	在此连接器重新发布前暂停：ChatGPT 需要使用其 HTTP 模式，而此版本不会要求输入密码。参见 mcp-install.md 中的安全提示。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，将 immybot-mcp 添加到 mcp.json 的 servers 键下，然后选择 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，然后运行每个 Skill 的安装程序以安装 CLI/MCP 二进制程序）。参见 docs/which-agent.md。

60 秒完成安装

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

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

下载 ImmyBot MCP（.mcpb）——然后打开 Claude Desktop > Settings > Extensions 并选择该文件。只需点击一次，无需 JSON，也无需使用 shell。（在发布页面查看所有 ImmyBot 发布版本。）

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

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

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

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

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

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

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

immybot-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

Claude Desktop .mcpb 用户：下载最新的 .mcpb（位于本节顶部），并在 Settings > Extensions 中重新选择该文件。Claude Code 插件用户：/plugin update immybot@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 面板接入最简单；mcp-install.md 中也记录了 MCP 配置块（适合偏好编辑 JSON 的用户）。

为 Hermes 安装

在 Hermes CLI 中：

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

在 Hermes 聊天会话中：

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

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

为 OpenClaw 安装

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

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

OpenClaw 尚未正式推出；frontmatter 接线已预先提供，将在 OpenClaw 发布时立即启用。

身份验证

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

export IMMYBOT_SUBDOMAIN=acme          # the "acme" in acme.immy.bot
export IMMYBOT_TENANT_ID=<entra-tenant-guid>
export IMMYBOT_CLIENT_ID=<entra-app-client-id>
export IMMYBOT_CLIENT_SECRET=<entra-app-client-secret>
immybot-cli doctor

ImmyBot 本身不提供 API 密钥。你需要在 Microsoft Entra ID 中注册一个应用，创建客户端密钥，然后将该企业应用程序的对象 ID 添加为 ImmyBot 中的管理员人员（Show More > People > New > AD External ID）。IMMYBOT_SUBDOMAIN 为必填项：它用于推导 OAuth 范围；如果未设置，令牌请求会回退到以你自己的应用注册命名的范围，而 Entra 会拒绝该请求。

doctor 会检查配置、路径和 API 可达性，然后通过对 /auth/me 执行一次经过身份验证的读取来验证凭据本身：它会报告 valid、invalid (HTTP 401) 或 scope-limited (HTTP 403)。即使凭据被拒绝，它也会以 0 退出，因此脚本应添加 --fail-on error。

此技能的作用

MSP 经常提出的问题	命令
昨晚维护窗口中哪些任务失败了，原因是什么？	immybot-cli session-triage --since 24h
哪些租户的 Chrome 版本仍然落后？	immybot-cli version-spread "Google Chrome" --min-version 140
为什么这台计算机一直没有收到部署？	immybot-cli assignment-explain 4821
自昨晚以来，整个设备群实际上发生了哪些变化？	先运行一次 immybot-cli fleet-diff --snapshot，然后运行 immybot-cli fleet-diff --since 24h
哪些计算机的入职流程卡在中途？	immybot-cli onboarding-stalled --older-than 3d
编辑这个共享脚本之前，它会影响哪些对象？	immybot-cli script-blast-radius "Install Chrome"
哪些部署从未成功过？	immybot-cli deployment-health --only-failing
ImmyBot 中有哪些计算机在我的 PSA 中缺失？	immybot-cli psa-reconcile
如何在一个视图中查看这台计算机的完整历史记录？	immybot-cli computer-dossier WS-01

完整的命令参考：guide.md。AI Agent 操作约定（--agent、--dry-run、何时在进行修改前确认）请参阅 AGENTS.md。

有何不同

大多数 ImmyBot 集成和 MCP 服务都会针对每个问题代理一次实时 API 调用。查询单条记录时，这没问题。但当你想知道 40 个客户端中有多少仍在运行低于 140 版的 Chrome 时，这种方式就难以应对了，因为每个租户的每个标题都需要调用一次 API，而且 ImmyBot 不会保留历史记录供你比较。

此技能会将 ImmyBot 同步到带有全文搜索功能的本地 SQLite 镜像中。聚合查询会变成一次本地 SQL 联接：即时、离线，而且 AI 看到的是答案，而不是原始数据。session-triage、version-spread 和 assignment-explain 等复合命令可以跨维护会话、操作、计算机、租户、软件清单和目标分配进行联接——这是无状态 API 封装器无法做到的。

解决的痛点

ImmyBot 自身的社区帖子和 r/msp 上关于部署的讨论，都反复提到同一种情况：这个平台非常擅长将软件部署到设备上，但部署后的第二天早上就不那么好用了。维护窗口覆盖数百个终端，其中一部分失败了，而控制台会为每台设备显示相同的错误文本，既不做归类，也不提供根因，更无法回答“这是一个损坏的软件包，还是四十个损坏的 Agent？”更棘手的是那些跨租户问题：哪些客户端仍低于版本下限，为什么一台设备没有匹配部署而旁边那台却匹配了，以及昨晚发生了什么变化。ImmyBot 不保留可供对比的历史记录，因此目前只能如实地说：用电子表格。

• session-triage --since 24h - 将一整晚的失败操作归纳为不同的根因，让你只需查看一次失败，而不用看四十次。
• version-spread "Google Chrome" --min-version 140 - 将一个软件标题按真实的 semver 规则进行比较，并在所有租户中排名，而不是按字符串排序。
• assignment-explain 4821 - 列出最终分配给一台计算机的所有目标分配、匹配的范围以及被覆盖的规则：解答“为什么这台设备没有匹配？”。
• fleet-diff --since 24h - 展示两次同步之间实际发生的变化，数据来自 API 未保留的历史记录。ImmyBot 不提供 updated-since 游标，因此此命令会与本地快照进行比较：同步后运行 immybot-cli fleet-diff --snapshot 记录首个基线，从下一次同步开始即可进行比较。
• deployment-health --only-failing - 列出从未成功过的部署；这是最容易被忽略的故障，因为它从未触发警报。

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

常见问题

这能与 ChatGPT 配合使用吗？

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

我的 ImmyBot 数据安全吗？

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

我需要是 ImmyBot 合作伙伴或 MSP 客户吗？

你需要拥有一个 ImmyBot 实例，并能够在该实例信任的 Microsoft Entra 租户中注册应用。此技能执行的所有操作，都以你在自己的实例中创建的管理员身份进行。

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

sync 是唯一会批量调用 API 的命令，也是你需要安排定期运行的命令。上面提到的所有跨租户视图都读取本地 SQLite 镜像，因此同一个问题询问十次也不会产生任何 API 调用。

这会取代 ImmyBot 控制台吗？

不会。部署、审批和期望状态配置仍在控制台中完成。这是控制台缺少的读取层：跨租户关联、根因分组，以及可用于对比的历史记录。

费用是多少？

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

安全模型

层级	示例	推荐的 Agent 策略
读取	session-triage、drift、version-spread、fleet-diff、assignment-explain，以及其他所有 list / get，但以下凭据读取操作除外	允许
终端与设备群执行	scripts create-run-adhoc-metascript（在指定计算机上运行你提供的脚本正文）、run-immy-service、maintenance-actions create-latest-action-for-tenants、schedules create-bulk-run-now、computers registry create-keys、target-assignments create、software create-global-upload	人工参与并明确确认
写入（数据）	tenants create、persons create、tags create、preferences update-application、import	使用 --dry-run 预览，然后经审核后写入
凭据 / 安全	auth login、oauth get-access-tokens、access get-get-azure-tenant-auth-details-by-azure-tenant-principal-id（此读取操作会返回机密）、roles create	仅限人工参与
破坏性操作	computers create-bulk-delete、scripts delete-global-by-id、software delete-global-by-identifier、brandings delete-by-id	仅限人工参与并明确确认
本地配置	profile save、auth logout、sync、export、feedback	允许（不会影响服务端）

ImmyBot 会向真实客户端计算机部署软件并运行维护任务，因此这里最需要关注的是 终端与设备群执行 层级：一次 create-latest-action-for-tenants 就会触达某个租户中的每台计算机。

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

状态

已在线验证。@geekbrownbear（MSP）已在其生产租户中确认（验证记录）。更多 MSP 已在我们的每周 Build Sessions 中在线运行此工具。请在 compoundingteams.com/build-sessions 报名。

---

标准。 符合开放的 Agent Skills 规范（Anthropic，2025 年 12 月；40 多个 Agent）。兼容 MCP——可与任何支持 MCP 的 Agent 配合使用，包括 Hermes。已为 OpenClaw 做好准备（frontmatter 已预先配置，等待 OpenClaw 发布）。

由 Servosity 维护。采用 Apache-2.0 许可证。使用 CLI Printing Press 构建。最后更新：2026-08-22。