N-able N-central MCP

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

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

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

涵盖每个 N-central REST 端点，还提供整个组织树的离线 SQLite 镜像、跨租户搜索、问题分诊汇总，以及其他 N-central 工具所没有的 JWT 过期守护功能。可与您已在使用的 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

安全提示（在此连接器重新发布之前）。 请勿将此连接器接入 supergateway 桥接服务或任何其他 stdio-to-HTTP 桥接服务， 即使是在 localhost 上也不行。桥接服务没有添加密码，因此任何能访问 其端口的人都能使用带有您凭据的 MCP 工具。请使用默认的 stdio 传输方式。如果您为远程 Agent 设置了桥接服务或隧道，请将其 关闭。修复方案正在开发中。

MSP 所有者实际使用的六种 Agent（自助安装，即刻可用）：

您的 AI Agent	如何安装 N-able N-central Skill
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 n-central-mcp（无需编辑 JSON）。
ChatGPT（付费方案）	在此连接器重新发布前暂停：ChatGPT 需要 HTTPS 服务，而此构建版本仅支持 stdio，因此需要一个不添加密码的 stdio-to-HTTP 桥接服务。请参阅 mcp-install.md 中的安全提示。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 n-central-mcp，然后选择 Agent 模式。

ChatGPT 需要远程 HTTPS 服务。此连接器仅支持 stdio，因此需要一个不添加密码的 stdio-to-HTTP 桥接服务；在连接器重新发布前，此方式暂停使用。请参阅 mcp-install.md 中的安全提示。

Microsoft 和 Google 技术栈的接入方式

用户基数很大，但需要如实提醒：这些是远程 / 企业级接入方式，不是你刚安装的本地二进制文件。

Agent	所需条件
Microsoft 365 Copilot / Copilot Studio	暂停接入，等待此连接器重新发布：Copilot Studio 需要 HTTPS 服务，而此版本仅支持 stdio，因此需要添加 stdio 到 HTTP 的桥接层，但这不会增加密码保护。请参阅 mcp-install.md 中的安全说明。
Google Gemini	Gemini CLI 在本地运行，和 Claude Code 一样。Gemini app 需要远程接入，与 ChatGPT 一样，远程接入方式目前已暂停。请参阅 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 上启动。每个工具都会调用配套的 n-central-cli。自 2026-09-18 起发布的版本会在安装包中附带此 CLI；较早的安装包仅包含 MCP 服务，因此如果你的安装包缺少配套 CLI，请先运行下方的路径 A 或路径 B 安装程序（或将 N_CENTRAL_CLI_PATH 设置为现有二进制文件的路径）。详情请见：#331。

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

更喜欢使用 Claude Code 插件？添加一次市场来源，然后安装即可——马上就能使用，无需列出目录：

/plugin marketplace add Servosity/msp-skills
/plugin install n-central@msp-skills

路径 A——将一条提示词粘贴到你的 AI Agent 中（推荐）

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

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

此提示词也适用于任何能够运行 shell 命令的 Agent。

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

n-central-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

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

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/n-central --force

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

为 OpenClaw 安装

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

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

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

身份验证

设置 CLI 所需的凭据（从你的 N-able N-central 门户获取）：

NCENTRAL_JWT=<value> n-central-cli doctor

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

此技能的功能

MSP 经常提出的问题	命令
当前有哪些告警？按客户分组并按严重程度排序。	n-central-cli triage --by customer
EXCHANGE01 在哪里——服务器、服务组织、客户、站点分别是什么？	n-central-cli whereis EXCHANGE01
在我们运行的所有服务器中查找名称包含 acme 的内容	n-central-cli fanout "acme"
哪些设备缺少 Backup Plan 自定义属性？	n-central-cli props audit --required "Backup Plan"
补丁部署前，哪些设备没有维护时段？	n-central-cli maint coverage --before 2026-06-15
JWT 是否正常？API 用户的密码何时会导致它失效？	n-central-cli guardian --password-set 2026-03-01
单台设备的硬件和软件清单	n-central-cli devices assets 987654321
导出所有设备，供 QBR 或文档工具使用	n-central-cli export "devices" --format jsonl

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

与众不同之处

大多数 N-able N-central 集成和 MCP 服务会将每个问题转发为一次实时 API 调用。这对单条记录来说没问题，但规模扩大后就会失效：例如，你需要查询“这台设备在我们的三个 N-central 服务器中分别位于何处”或“所有客户当前有哪些告警”时，就会遇到组织树分页、各端点的并发数上限（N-able 文档说明，并发调用超过 3-50 次时会出现 429 错误），以及密码轮换时 JWT 悄然失效的问题。

此技能会将组织树同步到带有全文搜索的本地 SQLite 镜像中。whereis（从设备名称片段查到完整的服务器 > 服务组织 > 客户 > 站点路径）、fanout（对每台服务器的镜像执行查询并合并结果）和 triage（按客户、设备或监控器分组并按严重程度排序的活跃问题）等复合命令可以跨组织树联接数据——这是无状态 API 封装器无法做到的。此外，guardian 会将 JWT 悄然失效的问题转变为可接入 CI 的警告。

解决的痛点

N-able 自己的 REST API 文档承认了每位 N-central 集成开发者都会遇到的两个陷阱：每个端点都有并发数上限（根据官方已知问题页面，并发调用超过 3-50 次就会返回 429），以及错误消息会出现在 200 OK 响应中。GitHub 上由社区维护的 NC-API-Documentation 项目还记录了第三个问题：API 用户的密码默认每 90 天过期一次，会悄无声息地使 JWT 失效，导致集成直接停止运行。

与此同时，每日巡检仍然需要手动完成：早晨的 NOC 巡检需要逐个客户进入控制台；想知道“这台机器在哪里”，就得预先知道它所属的客户和站点；服务多个服务器的 MSP 则要在每个控制台里重复这一切。

• n-central-cli triage --by customer - 用一条命令按严重程度排序，完成 NOC 巡检。
• n-central-cli whereis EXCHANGE01 - 从本地镜像获取完整组织路径，离线可用。
• n-central-cli fanout "acme" - 跨所有服务器的镜像执行一次查询，每条匹配结果都会标注所属服务器。
• n-central-cli guardian --password-set 2026-03-01 - 验证令牌，在密码到期导致 JWT 失效前 14 天发出警告，并捕获“200 OK 响应中包含错误正文”的情况。返回非零退出码，供 CI 设置门禁。
• n-central-cli maint coverage --before 2026-06-15 - 找出补丁部署前没有维护窗口的设备，避免它们在工作时间重启。

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

常见问题

这能与 ChatGPT 配合使用吗？

当前版本不支持。ChatGPT（Plus、Pro、Team、Business、Enterprise 和 Education 计划；Free 计划目前尚未开放 Developer Mode）只能通过 HTTPS 连接远程 MCP 服务。N-able N-central MCP 服务仅支持 stdio，因此需要在其前面放置 stdio-to-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）。这两种方式都不需要编写代码。你只需输入一次 N-able N-central 凭据。

我的 N-able N-central 数据安全吗？

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

我需要什么凭据？

需要 API 专用用户的 JSON Web Token：在 N-central 中，依次前往 Administration > User Management > Users > 选择 API 用户 > API Access > Generate JSON Web Token。该用户必须关闭 MFA；用户密码默认每 90 天过期一次，会悄无声息地使 JWT 失效 - guardian 会跟踪这一倒计时。设置 NCENTRAL_JWT 和 N_CENTRAL_BASE_URL（例如 https://yourmsp.ncod.n-able.com/api）。

这能更改 N-central 中的内容吗？

几乎所有操作都是只读的。只有两条命令可以更改内容：scheduled-tasks run 会在设备上执行支持 API 的 Automation Policy 或 Script；import 会从 JSONL 文件 POST 记录。--dry-run 是可选的预览模式，并非默认启用 - 推荐的 Agent 策略是先预览，由人工批准后再运行。对于 scheduled-tasks run，请确保有人工参与审批流程。

我们运行多个 N-central 服务，这能处理吗？

可以。每台服务器都会同步到自己的本地镜像，fanout 会合并这些镜像：一次查询即可返回所有服务器镜像中的匹配项，每一行都会标记其来源服务器。

这会触及 N-central API 速率限制吗？

N-able 文档说明了每个端点的并发上限——根据端点不同，并发调用超过大约 3 到 50 次时会收到 429 响应。CLI 内置了 --rate-limit 限流功能，而负载最高的查询（whereis、fanout、search）会针对本地镜像运行，不会调用 API。

这适用于 N-able N-sight 吗？

不适用。此技能专门针对 N-central REST API。N-sight 是 N-able 的另一款产品，使用独立的 API。

费用是多少？

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

安全模型

级别	示例	建议的 Agent 策略
读取	n-central-cli triage、whereis、fanout、devices list、props audit、maint coverage、guardian、export	允许
写入（常规）	n-central-cli import <resource> --input data.jsonl - 对每条记录执行 POST；--dry-run 是选择启用的预览选项，并非默认行为	先使用 --dry-run 预览，再经审核后写入
远程执行	n-central-cli scheduled-tasks run --task-type Script --device-id <id> --item-id <id> - 在运行中的端点上执行	仅允许人在环路中，并需明确确认
凭据 / 安全	n-central-cli customers registration-token、org-units registration-token（设备注册令牌）、auth set-token、auth logout	仅允许人在环路中

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

状态

Beta 版。已针对 N-able N-central API 接口进行验证，目前正在每周 Build Sessions 中，与将其用于自有生产租户的 MSP 一起验证。请在 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-05。