NinjaOne MCP

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

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

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

涵盖 NinjaOne 的所有报告，另有一个本地存储，可回答单次 API 调用无法回答的全设备群问题：补丁合规性、备份缺失、AV 影响范围、运行状况、配置漂移。可与您已经在使用的 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

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

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

ChatGPT 需要远程 HTTPS 服务，也就是说要使用此连接器的 HTTP 模式：设置 NINJAONE_MCP_HTTP_TOKEN 后才能启动；每个请求都必须在 bearer 标头中发送该令牌；此外，任何非回环地址都需要 --tls-cert 和 --tls-key。参见 mcp-install.md。

也适用于 Microsoft 和 Google 生态

用户基础庞大，但需要坦诚说明：这些属于远程 / 企业方案，而不是刚刚安装的本地二进制程序。

Agent	所需条件
Microsoft 365 Copilot / Copilot Studio	通过 HTTPS 托管 ninjaone-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——请参见下方的安装章节。也可通过 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 二进制程序）。参见 docs/which-agent.md。

60 秒完成安装

适用于 Claude Desktop 的最快方式 - 一键安装 .mcpb

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

下载 NinjaOne MCP（.mcpb） - 然后打开 Claude Desktop > Settings > Extensions 并选择该文件。一键完成，无需 JSON 或 shell。（在发布页面浏览所有 NinjaOne 版本。）

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

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

Path A - 将一条提示词粘贴到你的 AI Agent 中（推荐）

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

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

同一条提示词适用于任何能够运行 shell 的 Agent。

Path B - 自行运行安装程序

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

ninjaone-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

Claude Desktop .mcpb 用户：下载最新的 .mcpb（本节顶部），然后在 Settings > Extensions 中重新选择该文件。Claude Code 插件用户：/plugin update ninjaone@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 配置块（适用于偏好编辑 JSON 的用户）记录在 mcp-install.md 中。

为 Hermes 安装

在 Hermes CLI 中：

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

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/ninjaone --force

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

为 OpenClaw 安装

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

安装来自 https://github.com/servosity/msp-skills/tree/main/skills/ninjaone 的 ninjaone skill。该 skill 说明了如何通过 openclaw: frontmatter 块安装其所需的 CLI（ninjaone-cli）。

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

身份验证

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

NINJAONE_CLIENT_ID=<value> NINJAONE_CLIENT_SECRET=<value> NINJAONE_OAUTH_SCOPE=<value> ninjaone-cli doctor

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

此技能的功能

MSP 经常提出的问题	命令
哪些组织的补丁合规率低于 95%？	ninjaone-cli patch-compliance --min-pct 95
整个设备群中，哪些端点完全没有备份？	ninjaone-cli backup-coverage
给定的威胁出现在整个设备群的哪些设备上？	ninjaone-cli av-sweep --threat "Trojan.Generic"
哪些设备的防病毒定义已超过一周未更新？	ninjaone-cli av-sweep --definition-stale-days 7
每个组织的整体健康评分是多少？原因是什么？	ninjaone-cli fleet-health
哪些设备已两周没有签到？	ninjaone-cli stale-devices --days 14
哪些设备正在运行已到生命周期终止日期的操作系统？	ninjaone-cli os-eol
哪个软件标题分散在过多版本中？	ninjaone-cli software-audit --min-versions 3
自上周以来，补丁合规情况是变好了还是变差了？	ninjaone-cli drift --metric patch
搜索所有已同步设备、组织和警报中的某个字符串？	ninjaone-cli search "disk full"

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

与众不同之处

大多数 NinjaOne 集成和 MCP 服务都会将每个问题转发为一次实时 API 调用。对于单台设备，这样做没问题。但规模扩大后就不行了：比如你想问“我的 40 个客户组织中，哪些补丁安装率低于 95%，其中哪些端点完全没有备份”——API 只会按设备返回数据行，你必须自行获取、缓存并汇总。

此技能会将 NinjaOne 同步到带全文搜索功能的本地 SQLite 镜像中。聚合查询只需执行一次本地 SQL 联接：即时、离线完成，而且 AI 看到的是答案，而不是原始数据。patch-compliance、backup-coverage、fleet-health 和 drift 等复合命令会将设备与组织映射、补丁和备份报告以及上一份快照进行联接，从而完成无状态 API 封装无法实现的跨设备群汇总。

解决的痛点

NinjaOne 是最受欢迎的 RMM 之一，适用于实时的单设备操作。用户反复提到的痛点，是单台设备之外的那一层：报告和跨客户汇总。独立评测指出，NinjaOne 内置的报告“并非总能满足高管汇报的要求”，面向客户的报告通常需要第三方 BI 叠加层——这一缺口在 2026 年依然存在；此外，它也缺少统一的多租户视图（Flamingo，《NinjaOne Review》和《NinjaOne vs Intune》，2026）。

因此，每周都要问的问题，并非点一下就能得到答案——你得对每个组织分别运行报告，再手动重新汇总。此技能将这些操作整合为一条命令：

每周要问的问题	一条命令
谁的补丁安装落后了？	ninjaone-cli patch-compliance --min-pct 95
谁没有备份？	ninjaone-cli backup-coverage
该威胁扩散了多远？	ninjaone-cli av-sweep --threat "Trojan.Generic"
每个客户的健康状况如何？	ninjaone-cli fleet-health
比上周变好了还是变差了？	ninjaone-cli drift --metric patch

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

常见问题

如何将 Claude 连接到 NinjaOne？

安装这个免费的 NinjaOne MCP 服务，提供 NinjaOne API 应用的客户端 ID 和密钥（在 Administration > Apps > API 下创建），Claude 就能用通俗易懂的语言回答有关你的 NinjaOne 租户的问题。在 Claude Desktop 中，前往 Settings > Extensions，选择一键安装的 .mcpb；在 Claude Code 中，运行 /plugin install ninjaone@msp-skills；使用其他 Agent 时，运行安装程序并按照Agent 设置指南操作。所有安装方式都列在60 秒内完成安装中。如果你登录 NinjaOne 时使用的地址不是 app.ninjarmm.com，还需要设置 NINJAONE_BASE_URL 和 NINJAONE_TOKEN_URL（见下方关于区域的问题）。首次询问整个设备群的问题前，先运行一次 ninjaone-cli sync（或让 Claude 同步 NinjaOne）。

连接两者的其他方式包括社区 MCP 服务，例如 WYRE 的 ninjaone-mcp 和 Lungshot 的 NinjaOneMCP，以及托管连接器服务，例如 Truto 和 MCPBundles。本服务会在本地保存整个设备环境的 SQLite 副本，因此有关整个设备群的问题可直接通过本地副本回答，无需再次调用 API；它还以预编译二进制文件形式发布（包括 MCP 服务及其配套 CLI），因此在 Claude Desktop 之外运行时无需 Node.js 或 Docker。一家 MSP 也已通过生产环境中的 NinjaOne 租户验证了该服务（验证记录）。

这能与 ChatGPT 配合使用吗？

可以，适用于 Plus、Pro、Team、Business、Enterprise 和 Education 方案（Free 方案目前尚未开放 Developer Mode）。ChatGPT 只能通过 HTTPS 连接远程 MCP 服务，因此你需要以 HTTP 模式托管 ninjaone-mcp：必须设置 NINJAONE_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）。这两种方式都不需要编写代码。你只需输入一次 NinjaOne 凭据。

我的 NinjaOne 数据安全吗？

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

它支持美国、欧盟和其他 NinjaOne 区域吗？

支持。美国主机（https://app.ninjarmm.com）是默认设置。要使用其他区域，请设置 NINJAONE_BASE_URL（例如 https://eu.ninjarmm.com）和 NINJAONE_TOKEN_URL（例如 https://eu.ninjarmm.com/ws/oauth/token），然后运行 ninjaone-cli doctor，确认凭据可以连接到你的实例。

这会触发 NinjaOne API 速率限制吗？

本地镜像的作用是让读取操作不再调用 API。首次运行 sync 后，机群视图（patch-compliance、backup-coverage、av-sweep、fleet-health、stale-devices、os-eol、software-audit、drift）会基于本地 SQLite 运行，不会调用 API。实时调用会遵守 --rate-limit 限流设置，而 sync 是增量且可恢复的——它只会获取发生变化的内容，并将令牌无权访问的资源视为警告，而非失败。

我需要成为 NinjaOne 合作伙伴或购买报告附加组件吗？

不需要。你可以在 Administration > Apps > API 下自行创建 API 应用，并获取 OAuth2 client_id 和 client_secret。机群汇总会根据你的令牌已能读取的内容在本地计算——无需报告附加组件、数据仓库或合作伙伴等级。

它能更改 NinjaOne 中的内容吗？还是只能读取？

主要机群视图为只读。CLI 也封装了 NinjaOne 的写入操作（例如更新组织、创建工单、运行脚本、重启设备），以及更少见的破坏性操作（删除）。使用 --dry-run 预览任何写入操作，让人工参与审核，并将 API 令牌的权限范围限制在工作流所需的范围内。请参阅 governance.md。

费用是多少？

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

安全模型

层级	示例	建议的 Agent 策略
读取	patch-compliance、backup-coverage、av-sweep、fleet-health、stale-devices、os-eol、software-audit、drift、search——报告、汇总、搜索；不做任何更改	允许
写入（常规）	organization update、ticketing create、contact update、device reboot、device script run-on-device、tag set-for-asset（共 84 个写入命令）	使用 --dry-run 预览，然后执行经审核的写入操作
破坏性操作／配置	contact delete、organization delete-client-document、knowledgebase delete-knowledge-base-articles、itam delete-unmanaged-device-public-api（共 18 个破坏性命令）	仅限人工参与审核

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

状态

已在线验证。@Xenith-B（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-06-05。