ConnectWise Control MCP

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

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

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

通过终端或 AI Agent 管理 ConnectWise Control（ScreenConnect）远程支持和访问会话：跨组列出和检查会话、在访客计算机上运行命令、重命名和标记会话、管理实例用户，以及查询审计日志——通过一个 CLI 管理整个实例。可与您现有的 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 Skill 的安装方式
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 connectwise-control-mcp（无需编辑 JSON）。
ChatGPT（付费方案）	在此连接器重新发布前暂停：ChatGPT 需要 HTTP 模式，而此版本的该模式无需密码，会监听所有网络接口，并且可被您打开的网页访问。参见 mcp-install.md 中的安全提示。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 connectwise-control-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 上启动。每个工具都会调用配套的 connectwise-control-cli。从 2026-09-18 起发布的版本会将该 CLI 一同打包；较早版本仅包含 MCP 服务，因此如果你的安装包中没有配套 CLI，请先运行下方的路径 A 或路径 B 安装程序（或将 CONNECTWISE_CONTROL_CLI_PATH 设置为现有二进制文件的路径）。详情请参阅：#331。

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

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

/plugin marketplace add Servosity/msp-skills
/plugin install connectwise-control@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-control/install.sh)。如果使用 Windows PowerShell，请运行 iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/connectwise-control/install.ps1 | iex。然后按照 README 完成身份验证，并运行 connectwise-control-cli --help 以了解用法。

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

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

connectwise-control-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

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

在 Hermes 聊天会话中：

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

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

为 OpenClaw 安装

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

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

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

身份验证

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

CONNECTWISE_CONTROL_BASE_URL=<value> CONNECTWISE_CONTROL_USERNAME=<value> CONNECTWISE_CONTROL_PASSWORD=<value> connectwise-control-cli doctor

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

此技能的功能

MSP 常问的问题	命令
此组中有哪些访问会话？	connectwise-control-cli sessions list --session-type Access --agent
显示某个会话的完整详细信息	connectwise-control-cli sessions get-detail --session-id <id> --agent
此实例中有哪些会话组？	connectwise-control-cli session-groups --agent
在访客计算机上运行命令（需审批）	connectwise-control-cli sessions run-command --session-id <id> --command "..." --agent
此实例有哪些用户和角色？	connectwise-control-cli security get-configuration --agent
某个会话的审计日志中有哪些内容？	connectwise-control-cli audit query-log --session-name "ACME-WS01" --agent
重命名会话	connectwise-control-cli sessions update-name --session-id <id> --new-name "..." --agent

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

此技能的不同之处

ConnectWise Control（ScreenConnect）是一个没有第一方 CLI 的 Web 控制台——专为技术人员交互式操控单个远程会话而设计。它没有原生终端方式来批量列出、搜索或操作会话，也无法将这些工作交给 AI Agent。

此技能将实例的会话、组、用户和审计功能转化为带 JSON 输出的类型化命令，并提供一个离线 SQLite 镜像，用于快速查找会话。Agent 可以列出和检查会话、读取审计日志，并在获得你的批准后在访客计算机上运行命令；这一切都可以在终端中完成，无需逐个会话点击控制台。它是对实时控制台的补充，并不能取代亲自查看远程控制画面的体验。

解决的痛点

ConnectWise Control（原名 ScreenConnect）是大量 MSP 运行远程支持的地方，但它是一个面向技术人员、一次操作一个会话而构建的 Web 控制台。在 r/msp 和 ScreenConnect 社区中，人们反复提出同一个需求：没有官方 CLI，也没有原生终端方式来批量处理会话。“哪些机器有打开的会话？”，“这个端点上发生了什么？”，或者“在这五台机器上运行同一条命令”，都意味着要在控制台中滚动查找，然后手动在每个命令框中输入。

此技能可直接解决这些问题：

• sessions list --session-type Access - 以 JSON 格式列出某个组中的所有访问会话
• sessions get-detail --session-id <id> - 查看单个会话的连接和近期事件
• audit query-log --session-name <name> - 从审计日志中查看某台机器上发生的情况
• sessions run-command --session-id <id> --command <cmd> - 在访客端点上运行命令（需经过人工参与审批门控，因为命令会在真实机器上执行）
• security get-configuration - 一次读取实例的用户和角色

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

常见问题

这能与 ChatGPT 配合使用吗？

当前版本不能。ChatGPT（Plus、Pro、Team、Business、Enterprise 和 Education 方案；Free 尚未开放 Developer Mode）只能通过 HTTPS 连接远程 MCP 服务，这意味着需要以 HTTP 模式运行 ConnectWise 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 凭据。

我的 ConnectWise 数据安全吗？

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

这是 ConnectWise Control，还是 ConnectWise Manage / Automate？

这是 ConnectWise Control——远程支持和访问工具，原名 ScreenConnect。ConnectWise Manage（PSA）和 ConnectWise Automate（RMM）是独立的技能。此技能与 Control 实例的会话、用户和审计接口交互。

它如何进行身份验证？是否需要 RESTful API Manager 扩展？

使用 ConnectWise Control 实例用户，通过 HTTP Basic 身份验证访问实例基础 URL（CONNECTWISE_CONTROL_BASE_URL），用户名和密码分别为 CONNECTWISE_CONTROL_USERNAME / CONNECTWISE_CONTROL_PASSWORD——与登录 Web 控制台时使用的相同。无需安装扩展；这些是控制台本身使用的内置实例服务。

它真的能在机器上运行命令吗？

可以，通过 sessions run-command 实现，但该操作在 governance.md 中设置了人工参与审批门控——它会在访客端点上运行真实命令。日常使用以读取为主：列出、搜索和检查会话。

它会取代 ConnectWise Control 控制台吗？

不会。它适用于脚本和由 Agent 驱动的会话查询、审计查找，以及通过终端执行需审批的操作。控制台仍用于操作实时远程会话，并全程查看屏幕。

费用是多少？

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

安全模型

关键事实：某些命令会作用于真实的远程计算机。在客户的计算机上运行命令属于远程代码执行。默认安全设置为只读。

层级	示例	建议的 Agent 策略
读取	sessions list/get-detail、session-groups、security get-configuration、audit get-info/query-log、search	允许
写入（会话元数据）	sessions update-name、sessions update-custom-property	使用 --dry-run 预览，然后执行经过审核的写入
会话和主机控制	sessions run-command（在访客机上运行真实命令）、sessions add-event-to（控制唤醒等事件）	人工参与，明确确认
授予访问权限	sessions get-access-token（授予远程访问权限的一次性令牌/URL）	仅限人工参与
管理和身份	security save-user、security delete-user	仅限操作员

最有力的控制措施是你授予 ConnectWise Control 实例登录账户的权限范围——CLI 只能执行该用户获准执行的操作。完整详情（包括如何收紧权限）请参阅 governance.md。

状态

Beta 版。已针对 ConnectWise Control API 接口进行验证，并在每周的 Build Sessions 中与 MSP 一起对其进行验证，他们会在自己的实例上实际运行它。请在 compoundingteams.com/build-sessions 报名参加。

---

标准。 符合开放的 Agent Skills spec（Anthropic，2025 年 12 月；支持 40 多种 Agent）。兼容 MCP——可与任何支持 MCP 的 Agent 配合使用，包括 Hermes。可用于 OpenClaw（frontmatter 已预先配置，等待 OpenClaw 发布）。

由 Servosity 维护。采用 Apache-2.0 许可证。使用 CLI Printing Press 构建。最后更新：2026-06-13。