ConnectWise RMM MCP

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

非官方。由社区构建的 Claude Code Skill 和 MCP 服务，适用于 ConnectWise RMM (Asio) 合作伙伴 API。与 ConnectWise, LLC 无关联，也未获得其认可或赞助。

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

66 项 ConnectWise RMM (Asio) 合作伙伴 API 操作，另有本地设备群数据库、补丁合规汇总，以及可通过一条命令预览、安排和监控的脚本运行功能。可与您已有的 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	如何安装 ConnectWise RMM Skill
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 connectwise-rmm-mcp（无需编辑 JSON）。
ChatGPT（付费套餐）	此连接器重新发布前暂停使用：ChatGPT 需要 HTTP 模式，而此版本虽然会检查令牌，但尚无请求大小或时间限制。请参阅 mcp-install.md 中的安全提示。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 connectwise-rmm-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，然后为 CLI / MCP 二进制文件运行各 Skill 的安装程序）。请参阅 docs/which-agent.md。

60 秒内完成安装

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

下载 ConnectWise RMM MCP (.mcpb)，然后打开 Claude Desktop > 设置 > 扩展并选择该文件。只需点击一次，无需 JSON，也无需 shell。（在发布页面浏览所有 ConnectWise RMM 版本。）

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

/plugin marketplace add Servosity/msp-skills
/plugin install connectwise-rmm@msp-skills

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

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

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

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

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

connectwise-rmm-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

Claude Desktop .mcpb 用户：下载最新的 .mcpb（本节顶部），然后在设置 > 扩展中重新选择该文件。Claude Code 插件用户：/plugin update connectwise-rmm@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 的“设置 > 扩展”面板是最简单的方式；MCP 配置块（供偏好编辑 JSON 的用户使用）记录在 mcp-install.md 中。

为 Hermes 安装

在 Hermes CLI 中：

hermes skills install servosity/msp-skills/skills/connectwise-rmm --force

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/connectwise-rmm --force

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

为 OpenClaw 安装

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

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

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

身份验证

在 ConnectWise 门户的 Integrations > API Access 下创建 API 客户端，然后设置其 ID 和密钥：

CONNECTWISE_RMM_CLIENT_ID=<value> CONNECTWISE_RMM_CLIENT_SECRET=<value> connectwise-rmm-cli doctor

以 0e30、0e31 或 0e32 开头的客户端 ID 会自动为你选择北美、欧洲或澳大利亚区域；如果你的 ID 以其他字符开头，请将 CONNECTWISE_RMM_BASE_URL 设置为你所在区域的 API 主机地址。如果你的密钥未获授权使用此连接器所需的所有作用域，请运行 connectwise-rmm-cli scopes --agent，并设置它输出的 CONNECTWISE_RMM_OAUTH_SCOPE 行——如果请求的某个作用域不在密钥授权范围内，ConnectWise 会拒绝整个令牌请求。然后将设备群同步到本地镜像：

connectwise-rmm-cli sync --resources companies,sites,endpoints,tickets

doctor 会根据你的客户端 ID 和密钥生成令牌，并通过 API 验证，因此密钥错误、缺少作用域或主机地址错误都会显示为 Credentials 检查失败。即使检查失败，它也会以状态码 0 退出，因此脚本应添加 --fail-on error。

此技能的功能

MSP 常问的问题	命令
按客户端列出离线或超过一天无响应的终端？	connectwise-rmm-cli fleet stale --older-than 24h --agent
哪些客户端的补丁更新落后了？按最严重的排在前面。	connectwise-rmm-cli fleet patch-posture --min-compliance 90 --agent
本周哪些机器需要重启？当前有哪些用户登录？	connectwise-rmm-cli fleet reboot-due --agent
这个用户登录在哪台机器上？	connectwise-rmm-cli fleet whois "jsmith" --agent
给我一份供评审使用的单个客户端健康概览。	connectwise-rmm-cli fleet scorecard "Acme Corp" --agent
昨晚的脚本为什么失败？哪些机器受到影响？	connectwise-rmm-cli fleet task-failures "<task-id>" --agent
在终端上运行脚本——先预览，再使用 --confirm 安排执行。	connectwise-rmm-cli run --script "Restart Print Spooler" --endpoint "<endpoint-id>"
我的 API 密钥实际获得了哪些 OAuth 作用域？	connectwise-rmm-cli scopes --agent

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

有何不同

大多数 ConnectWise RMM 集成和 MCP 服务——包括开源项目 connectwise-asio-mcp 和 asio-cli——都直接调用实时 API，没有持久化的本地副本。对于单台设备，这没问题；但规模扩大后就不行了。比如你要问“所有 40 个客户端中哪些 Agent 离线了”或“今天早上的客户端评审前，哪些客户端的补丁更新落后了”，因为 Asio 返回的是按 ID 标识的逐终端数据行，从不提供按客户端汇总的数据，而且每次调用最多只能检查 400 个终端的可用性。

此技能会将 ConnectWise RMM 同步到带全文搜索功能的本地 SQLite 镜像中，批量检查实时可用性，并缓存补丁摘要。汇总类问题只需进行一次本地联接，AI 看到的是答案，而不是原始数据。fleet patch-posture、fleet scorecard 和 fleet task-failures 等复合命令会联接公司、站点、终端、补丁摘要、工单和任务结果——这是无状态 API 封装工具无法做到的。

解决的痛点

ConnectWise RMM（基于 ConnectWise Asio 平台的云端 RMM，前身为 Command 和 Continuum）围绕按客户端、按设备的视图构建，其合作伙伴 API 也是如此：ConnectWise 自己的文档规定，每次调用最多检查 400 个终端的可用性，每 5 分钟最多调用 40 次；补丁合规情况则以按 ID 标记的逐终端数据行返回，没有按客户端汇总的结果。在 r/msp 上，大家反复提到的 RMM 问题在不同供应商之间都一样——无法轻松跨客户端汇总——因此，负责人会在客户评审前将设备列表导出到电子表格，并在客户来电时才发现 Agent 已失效。推送脚本则有相反的问题：每个终端的结果都带有各自的原始错误文本，手动归类相同故障很费力。

此技能可直接回答这些问题：

• fleet stale --older-than 24h - 列出所有客户端中的离线或失联 Agent，并按公司分组
• fleet patch-posture --min-compliance 90 - 按补丁风险对客户端排序，为评审做好准备
• fleet reboot-due - 补丁周重启队列：立即重启、与已登录用户协调、离线
• fleet whois "jsmith" - 查询来电者登录的是哪台机器
• fleet task-failures "<task-id>" - 按相同错误对失败终端分组，并提供可用于重新运行的 ID

更完整的说明请参阅 pain-point.md。

常见问题

这能与 ChatGPT 配合使用吗？

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

我的 ConnectWise RMM 数据安全吗？

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

这是用于 ConnectWise RMM、ConnectWise Automate 还是 ConnectWise PSA？

ConnectWise RMM——基于 ConnectWise Asio 平台的云端 RMM（前身为 Command 和 Continuum）。ConnectWise Automate（LabTech）、ConnectWise PSA（Manage）和 ConnectWise ScreenConnect（Control）各自都有对应的技能。此技能使用 Asio 合作伙伴 API，处理公司、站点、终端、补丁、脚本和任务，以及 Asio 自有的服务工单。

这会触及 ConnectWise RMM API 的速率限制吗？

本地镜像正是为此而设。你可以 sync 公司、站点、终端和工单，并基于该副本执行汇总。每次调用最多检查 400 个终端的可用性；补丁摘要默认缓存 12 小时；当 Asio 返回 HTTP 429 时，CLI 会自动降低请求速度。

我的 AI 能在客户端机器上运行脚本吗？

只能运行你允许的命令。在 CLI 中，run 默认会预览：它会解析脚本和目标机器，打印完整请求；只有添加 --confirm 后才会安排执行。还有三种路径会立即安排执行：tasks schedule、导入任务记录，以及 MCP 服务的通用 connectwise-rmm_execute 工具。如果你不希望 Agent 运行脚本，请设置 CONNECTWISE_RMM_MCP_READ_ONLY=1（此时 MCP 服务会移除写入工具，并拒绝所有非只读 API 调用），且不要向密钥授予 platform.automation.create 范围。缓存的 API 客户端优先于环境变量，因此切换到权限更窄的密钥后，请先运行 connectwise-rmm-cli auth logout。

这会取代 ConnectWise RMM 门户吗？

不会。门户仍用于配置策略、监控和远程访问。此技能可让你的 AI Agent 或终端回答跨客户端的报告和分诊问题，并与 ConnectWise 内置的 AI——ConnectWise Sidekick——互为补充，而非取而代之。

费用是多少？

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

安全模型

层级	示例	建议的 Agent 策略
只读	fleet stale、fleet patch-posture、fleet reboot-due、fleet whois、fleet brief、fleet scorecard、fleet task-failures、scopes、sync、search、不带 --confirm 的 run（预览）、所有 list/get	允许
终端操作	run --confirm、tasks schedule（别名 tasks create）、导入任务记录，以及调用 tasks.schedule 的 MCP connectwise-rmm_execute 工具——每项操作都会在真实终端上运行脚本	人工介入并明确确认
破坏性操作	endpoints uninstall（别名 endpoints delete；会移除 Agent，之后该终端将不再受管理）	仅限人工介入并明确确认
写入（记录）	tickets create / update、ticket-notes create、sites create / update、custom-fields set-company / set-site / set-endpoint、导入工单记录	先使用 --dry-run 预览，再经审核后写入
凭据	endpoints create-agent-install-token（别名 endpoints create）、导入终端记录（会生成安装令牌）、auth login、auth set-token	仅限人工介入

如需将 MCP 服务设为只读，请设置 CONNECTWISE_RMM_MCP_READ_ONLY=1：该服务会移除写入工具，并拒绝所有非只读 API 调用。

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

状态

Beta 版。基于 ConnectWise RMM 合作伙伴 API 构建（已在无凭据的情况下通过实时网关确认每条路由；行为已通过模拟网关测试），目前正等待每周 Build Sessions 中使用自有生产租户进行实时验证的 MSP。请在 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-10-13。