ConnectWise Automate MCP

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

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

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

将整个 ConnectWise Automate 设备群同步到本地 SQLite，并回答按服务器划分的 Web UI 无法解答的跨客户端问题：全设备群健康状况汇总、过期 Agent 扫查、按客户端统计补丁合规情况，以及夜间漂移。可与您现有的 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 到 HTTP 的桥接程序之后，即使是在 localhost 上也不行。桥接程序不会添加密码，因此任何能够访问其端口的人都可以使用您的凭据调用 MCP 工具。请使用默认的 stdio 传输方式。如果您为远程 Agent 设置了桥接程序或隧道，请将其关闭。修复方案即将推出。

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

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

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

Microsoft 和 Google 技术栈也适用

安装量很大，但先说明一点：这些走的是远程／企业路径，而不是你刚安装的本地二进制文件。

Agent	所需条件
Microsoft 365 Copilot / Copilot Studio	暂停使用，直到重新发布此连接器：Copilot Studio 需要 HTTPS 服务，而此仅支持 stdio 的构建版本需要一个不会增加密码的 stdio-to-HTTP 桥接。请参阅 mcp-install.md 中的安全说明。
Google Gemini	Gemini CLI 是本地运行的，与 Claude Code 相同。Gemini 应用是远程应用，需要采用与 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，然后为 CLI/MCP 二进制文件运行各 Skill 的安装程序）。请参阅 docs/which-agent.md。

60 秒内完成安装

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

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

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

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

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

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

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

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

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

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

connectwise-automate-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

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

在 Hermes 聊天会话中：

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

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

为 OpenClaw 安装

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

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

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

验证身份

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

CONNECTWISE_AUTOMATE_SERVER=<value> CONNECTWISE_AUTOMATE_CLIENT_ID=<value> CONNECTWISE_AUTOMATE_TOKEN=<value> connectwise-automate-cli doctor

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

此技能的功能

MSP 经常提出的问题	命令
按客户端列出超过 30 天未签到的 Agent？	connectwise-automate-cli stale-agents --days 30 --agent
哪些客户端的补丁更新滞后？按严重程度从高到低排列。	connectwise-automate-cli patch-compliance --agent
所有客户端中有哪些未解决警报需要人工处理？	connectwise-automate-cli alert-triage --min-priority 3 --agent
目前整个设备群的运行状况如何？	connectwise-automate-cli fleet-health --agent
为评审提供每个客户端的一行概览。	connectwise-automate-cli client-rollup --agent
设备群中有哪些操作系统已停止支持？	connectwise-automate-cli os-inventory --eol-only --agent
昨晚发生了哪些变化——警报、签到、补丁？	connectwise-automate-cli since --hours 24 --agent

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

有何不同

大多数 ConnectWise Automate 集成和 MCP 服务都会针对每个问题代理一次实时 API 调用。对于一台计算机来说这没问题。但当你要询问“所有 40 个客户端中有多少 Agent 处于离线状态”或“今天早上的 QBR 之前哪些客户端的补丁更新滞后”时，这种方式就无法满足规模化需求。

此技能会将 ConnectWise Automate 同步到带有全文搜索的本地 SQLite 镜像中。聚合查询只需执行一次本地 SQL 联接：快速、离线运行，AI 看到的是答案，而非原始数据。fleet-health、patch-compliance 和 alert-triage 等复合命令会联接计算机、客户端、位置、警报和补丁历史记录——这些操作是无状态 API 封装器无法完成的。

解决的痛点

Automate（原名 LabTech）采用按服务器划分的控制台，擅长深入查看单个端点，却无法应对“跨所有客户查看这些信息”的需求。在长期运营的 ConnectWise Automate 社区论坛 MSPGeek 和 r/msp 上，反复出现的抱怨都一样：无法快速汇总所有客户的数据，离线和过期的 Agent 悄悄推高许可证数量，而为季度业务回顾（QBR）检查补丁合规情况，则意味着要手动为每个客户整理报告。数据都在 Automate 中；真正费工夫的是从中获取整个设备群的答案——而且偏偏总是在最不合时宜的时候需要，比如许可证数量核对前，或评审当天早上。

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

• stale-agents --days 30 - 按客户分组的离线 Agent，可用于许可证数量核对
• patch-compliance - 按客户查看补丁状态，最差的排在前面，可用于 QBR
• alert-triage --min-priority 3 - 今天早上所有客户中需要人工处理的事项
• fleet-health - 一次汇总显示在线／离线状态、距上次联系的时间，以及未解决的警报
• os-inventory --eol-only - 标记出生命周期已结束的操作系统，便于讨论设备更新

较长的说明请参阅 pain-point.md。

常见问题

这适用于 ChatGPT 吗？

此版本不适用。ChatGPT（Plus、Pro、Team、Business、Enterprise 和 Education 方案；Free 目前尚未开放 Developer Mode）只能连接通过 HTTPS 提供服务的远程 MCP 服务。ConnectWise 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）。这两种方式都不需要编写代码。你只需输入一次 ConnectWise 凭据。

我的 ConnectWise 数据安全吗？

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

这是针对 ConnectWise Automate 还是 ConnectWise Manage（PSA）的？

ConnectWise Automate——也就是 RMM，原名 LabTech。ConnectWise Manage（PSA）是另一项独立技能。此技能通过 Automate 服务器的 API 访问计算机、客户、警报、补丁、脚本和监视器。

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

本地镜像正是为此设计的。你只需 sync 一次，之后所有汇总、分类和搜索都会使用本地 SQLite，因此日常查询不会访问 API。只有 sync 和实时 list／get 命令会调用 Automate。

我需要是 ConnectWise 合作伙伴吗？

你需要有一台自己管理的 Automate 服务器和一个 API 令牌，以及一个已注册的集成 clientId GUID（v2020.11 及更高版本需要）。此技能以你的身份进行身份验证，不会对你的 ConnectWise 帐户做任何更改。

这会取代 Automate 控制台吗？

不会。它用于通过终端或 AI Agent 跨客户生成报告和进行分类处理。配置监视器、脚本和策略仍需使用控制台。

费用是多少？

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

安全模型

层级	示例	建议的 Agent 策略
读取	fleet-health、stale-agents、patch-compliance、alert-triage、client-rollup、os-inventory、since，所有 list/get/search	允许
端点和机群操作	computers command-execute（在 Agent 上运行实际命令）、patching deploy-approved / deploy-security / reattempt-failed（机群范围的补丁部署）	人工参与，明确确认
写入（数据）	import <resource>（通过 API 创建或更新记录）	使用 --dry-run 预览，然后经审核后写入
凭据	apitoken mint / refresh、auth set-token	仅限人工参与

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

状态

Beta 版。已根据 ConnectWise API 功能进行验证，目前正与运行该工具、连接其自有生产租户的 MSP 在每周 Build Sessions 中进行验证。请在 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-12。