Nerdio Manager MCP

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

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

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

首个面向 Nerdio Manager for MSP API 的非 PowerShell 客户端 - 支持跨账户 AVD 资源池审计、异步任务处理，以及其他 Nerdio 工具不具备的离线搜索。可与您现有的 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	如何安装 Nerdio Manager Skill
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 nerdio-mcp（无需编辑 JSON）。
ChatGPT（付费计划）	此连接器重新发布前暂停：ChatGPT 需要 HTTP 模式，而此版本的该模式不要求密码、会监听所有网络接口，并且您打开的网页可以访问它。请参阅 mcp-install.md 中的安全提示。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 nerdio-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，然后运行各 Skill 的安装程序来安装 CLI／MCP 二进制文件）。请参阅 docs/which-agent.md。

60 秒内完成安装

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

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

下载 Nerdio Manager MCP (.mcpb)——然后打开 Claude Desktop > Settings > Extensions 并选择该文件。一键完成，无需 JSON，也无需使用 shell。（可在发布页面查看所有 Nerdio Manager 版本。）

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

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

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

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

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

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

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

nerdio-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

Claude Desktop .mcpb 用户：下载最新的 .mcpb（见本节顶部），然后在 Settings > Extensions 中重新选择它。Claude Code 插件用户：/plugin update nerdio@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/nerdio --force

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/nerdio --force

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

为 OpenClaw 安装

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

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

OpenClaw 尚未正式推出；frontmatter 接入配置已预先提供，会在 OpenClaw 发布后立即启用。

身份验证

设置 CLI 所需的凭据（可从 Nerdio Manager 门户获取）：

NERDIO_BASE_URL=<value> NERDIO_TOKEN_URL=<value> NERDIO_CLIENT_ID=<value> NERDIO_CLIENT_SECRET=<value> NERDIO_OAUTH_SCOPE=<value> nerdio-cli doctor

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

此技能的功能

MSP 经常提出的问题	命令
所有客户中，哪些主机池关闭了自动缩放或配置不一致？	nerdio-cli fleet autoscale-audit
目前所有账户中正在运行什么？分别位于哪里？	nerdio-cli fleet host-estate
本期每位客户的账单是多少？哪些客户尚未付款？	nerdio-cli fleet billing-rollup --period 2026-05-01:2026-05-31 --unpaid-only
哪些客户的 Azure 用量环比激增？	nerdio-cli usages drift --from 2026-04-01:2026-04-30 --to 2026-05-01:2026-05-31
列出我管理的所有客户账户	nerdio-cli accounts
显示某个账户的主机池	nerdio-cli host-pools list <account_id>
此账户有哪些 Intune 设备？	nerdio-cli devices list <account_id>
备份或预配作业是否已完成？	nerdio-cli job wait <job_id>
在多个账户上执行同一脚本操作，并等待全部完成	nerdio-cli scripted-actions fan-run <script_id> --accounts 101,102,103 --wait
离线搜索所有已同步内容	nerdio-cli search <query>

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

不同之处

大多数 Nerdio Manager 集成和 MCP 服务都会将每个问题转发为一次实时 API 调用。查询一条记录时，这样做没问题。但规模扩大后就行不通了，比如你要问“本季度我所有 40 个客户中，哪些主机池关闭了自动缩放”——因为 NMM API 每次调用只会返回一个账户或一个账单周期的数据。

此技能会将 Nerdio Manager 同步到本地 SQLite 镜像，并支持全文搜索。聚合查询只需执行一次本地 SQL 联接：响应迅速、可离线使用，而且 AI 看到的是答案，而不是原始数据。fleet autoscale-audit、fleet billing-rollup 和 usages drift 等复合命令可以跨客户账户、主机池、发票和用量周期进行联接——无状态 API 封装无法做到这一点。此外，由于每项 NMM 更改都是异步的，job wait 可将“是否已完成？”转化为可编写脚本的基本操作，并在作业实际失败时返回非零退出码。

解决的痛点

在 r/msp 上，Nerdio 用户反复提到，自动缩放是购买它的全部理由，也是整个资源群中最难管理妥当的事项。没有统一视图能显示哪些主机池、哪些客户租户启用了缩放，因此闲置的会话主机悄悄消耗 Azure 费用，直到账单寄到才被发现。每个 NMM 安装都按租户独立部署，所以哪怕只是想知道“所有客户当前一共运行着多少台主机”，也得逐个登录各个门户。由于每项更改都是异步的，你还得盯着门户的 Jobs 页面，才能知道操作是否已完成。

这项技能从整个资源群的角度解决这些问题：

• nerdio-cli fleet autoscale-audit - 找出所有账户中自动缩放已关闭或偏离基准的主机池。
• nerdio-cli fleet host-estate - 用一张表列出每台会话主机及其主机池、账户和电源状态。
• nerdio-cli fleet billing-rollup --period <start>:<end> - 按客户汇总已计费、未付款和使用量，方便与 PSA 对账。
• nerdio-cli usages drift --from <start>:<end> --to <start>:<end> - 找出用量环比激增的客户。
• nerdio-cli job wait <job_id> - 轮询任意 NMM 作业，直到进入终止状态；若失败则以非零状态码退出。

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

常见问题

这能与 ChatGPT 配合使用吗？

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

我的 Nerdio Manager 数据安全吗？

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

我需要成为 Nerdio 合作伙伴，或运行 Nerdio Manager for MSP（NMM）吗？

需要——此工具面向 NMM Partner REST API，即 MSP 版本（而非 Nerdio Manager for Enterprise）。你需要在自己的 NMM 门户中前往 Settings > Integrations > REST API 创建 API 客户端。没有厂商全局端点；CLI 会连接到你自己的实例 URL，你可通过 NERDIO_BASE_URL 设置该 URL。

这会取代 Nerdio Manager 门户吗？

不会。它是一个以读取为主、可跨账户使用的辅助工具。日常操作仍在 NMM 中进行；它用于处理门户难以完成的全资源群视角问题和脚本自动化任务。

为什么更改操作只返回作业 ID？

每项 NMM 修改操作（配置、脚本化操作、备份、主机电源）都是异步的，并会返回作业 ID。运行 nerdio-cli job wait <job_id> 进行轮询，直到作业进入终止状态；若失败则以非零状态码退出——这样你的 Agent 就不会把实际出错的作业报告为“已完成”。

费用是多少？

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

安全模型

级别	示例	建议的 Agent 策略
读取	accounts、fleet autoscale-audit、fleet host-estate、fleet billing-rollup、usages drift、host-pools list、devices list、job wait、search、sync 以及其他 list/get 命令	允许
写入（常规）	host-pools create、host-pools set-autoscale、reservations create/update、recovery-vaults create/link/unlink、resource-groups link/set-default、networks link、provisioning link-network/link-tenant、workspaces create、backup enable/disable、job retry、import	先用 --dry-run 预览，再执行经审核的写入操作
终端节点 / 基础设施控制	hosts start/stop/restart、desktop-images start/stop、devices sync、scripted-actions run/run-account/fan-run、backup run/restore	人工参与——这些操作会启动、重启实时 VM 和设备，或在其上执行代码
凭据 / 安全	secure-variables list/create/update/delete（以及 account-* 变体）、devices bitlocker-keys、devices laps	仅限人工参与——这些操作会读取或写入已存储的机密、BitLocker 密钥和 LAPS 密码
破坏性操作	host-pools delete、reservations delete、recovery-vaults delete-policy、resource-groups unlink/account-unlink、scripted-actions unschedule	仅限人工参与，并需明确确认

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

状态

Beta 版。已针对 Nerdio Manager API 范围进行验证，目前正与 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-06-07。