Action1 MCP

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

非官方。由社区构建的 Claude Code Skill 和 Action1 API MCP 服务。与 Action1 Corporation 无关联，未获其认可或赞助。

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

提供所有 Action1 端点，以及跨所有组织查看整个设备群的补丁和漏洞情况。可与您现有的 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	如何安装 Action1 Skill
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 action1-mcp（无需编辑 JSON）。
ChatGPT（付费套餐）	此连接器重新发布前暂停：ChatGPT 需要 HTTP 模式，而此版本的该模式不需要密码、会监听所有网络接口，并且您打开的网页可以访问它。请参阅 mcp-install.md 中的安全提示。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 action1-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 应用在远程运行，需要与 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 上启动。每个工具都会调用配套的 action1-cli。自 2026-09-18 起发布的版本会在软件包中附带该 CLI；更早的版本仅包含 MCP 服务，因此如果你的软件包中没有配套 CLI，请先运行下方的路径 A 或路径 B 安装程序（或将 ACTION1_CLI_PATH 设置为已有二进制文件的路径）。详情请见：#331。

下载 Action1 MCP（.mcpb）——然后打开 Claude Desktop > 设置 > Extensions 并选择该文件。一键完成，无需 JSON，也无需使用 Shell。（前往发布页面查看所有 Action1 版本。）

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

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

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

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

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

此提示词也适用于任何可以运行 Shell 的 Agent。

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

Windows（PowerShell）：

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

macOS / Linux：

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

安装程序会将 action1-cli（CLI）和 action1-mcp（MCP 服务）都安装到你的用户二进制文件目录中。Claude Code、Codex 和 Cowork 会通过此目录中的 SKILL.md 发现 Skill。

验证：

action1-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

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

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/action1 --force

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

为 OpenClaw 安装

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

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

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

进行身份验证

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

ACTION1_CLIENT_ID=<value> ACTION1_CLIENT_SECRET=<value> ACTION1_REGION=<value> action1-cli doctor

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

此技能的功能

MSP 常问的问题	命令
所有客户端中，哪些终端缺少的补丁最多？	action1-cli fleet patch-posture
哪些 CVE 影响的机器最多（按严重性和 KEV 加权）？	action1-cli fleet vuln-triage --kev-only
整个设备群中，哪些 Agent 已停止签到？	action1-cli fleet stale --days 14
每个客户端组织的补丁和漏洞状况如何？	action1-cli fleet org-scorecard
哪些终端正等待重启以完成补丁周期？	action1-cli fleet reboot-pending
按总体风险（更新、CVE、重启、陈旧状态）为所有终端排名	action1-cli fleet health-score
整个设备群安装了哪些软件（按版本去重）？	action1-cli fleet software-rollup
列出某个客户端组织中的受管终端	action1-cli endpoints managed <orgId>

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

与众不同之处

大多数 Action1 集成和 MCP 服务都会将每个问题转发为实时 API 调用，并一次处理一个组织。对于单条记录，这没问题；但规模扩大后就行不通了。比如，当你询问“我所有 40 个客户端中，哪个终端的补丁最落后？本季度哪些机器受同一个 CVE 影响？”时，按组织隔离的 API 无法通过一次调用回答这些问题。

此技能会将每个组织同步到带有全文搜索功能的本地 SQLite 镜像中。汇总类问题只需执行一次本地查询：即时、离线，且 AI 看到的是答案，而不是原始数据。fleet patch-posture、fleet vuln-triage 和 fleet org-scorecard 等跨组织汇总命令会一次性关联所有组织的终端、更新和漏洞；无状态 API 封装器无法做到这一点。

此技能解决的痛点

r/msp 上有关补丁管理的讨论不断提到多租户补丁工具存在同一个缺口：控制台按单个客户组织进行组织，但 MSP 所有者需要回答的问题却涉及整个设备群——“哪些终端落后的补丁最多？”，“哪个 CVE 影响范围最广？”，“这个客户的季度业务回顾（QBR）该填哪个安全态势分数？”在 Action1 中，这意味着逐个切换组织，或者按组织导出数据再合并电子表格。每个客户的数据都有，但无法在一个视图中汇总所有组织的数据。

此技能解决了这个问题：

• action1-cli fleet patch-posture - 所有组织中的每个终端，按缺失更新的数量排序。
• action1-cli fleet vuln-triage --kev-only - 按影响范围（CVSS + CISA KEV）对 CVE 排序。
• action1-cli fleet org-scorecard - 每个客户组织一行安全态势数据，直接列出 QBR 分数。
• action1-cli fleet stale --days 14 - 在所有组织中找出失联的 Agent，避免它们脱离覆盖范围。
• action1-cli fleet reboot-pending - 结束补丁周期的全设备群操作队列。

更多背景说明，请参阅 pain-point.md。

通过 MCP 服务远程桌面

MCP 已经提供 Action1 的远程会话 API。凭据需要在目标终端所属的组织或终端组中拥有 Remote Connect 权限；能够运行脚本并不代表有权限连接桌面。 获得授权的管理员可以将 Remote Connect 添加到凭据现有角色，并设置所需范围。 403 表示访问被拒绝，而不是缺少 MCP 工具。

对于代码编排客户端：

1. 使用 start remote session 调用 action1_search。

2. 使用终端 ID endpoints.managed-id-remote-sessions-post 调用 action1_execute，并传入以下参数：

   {"orgId":"<organization-id>","endpointId":"<endpoint-id>","connection_type":"assistance"}
   

3. 获取返回的 id，并调用 endpoints.managed-id-remote-sessions-session-id-get，传入 orgId、endpointId 和 sessionId。设置有界等待时间进行轮询，例如 每五秒轮询一次，最多持续一分钟；如遇 API 错误则停止。超时 表示尚未验证连接；请勿自动创建另一个会话。

4. connected 为 yes 后，在浏览器中打开返回的 remote_session URL。 在进行交互之前，请确认显示的是目标终端的桌面。 请对该连接 URL 保密。

等效的启动命令为：

action1-cli endpoints managed-id-remote-sessions-post <orgId> <endpointId> --connection-type assistance --json

API 目前支持将 assistance 作为连接类型。启动会话本身不会自动执行桌面输入；交互操作请使用浏览器或 Agent 获准使用的计算机操作工具。请参阅 Action1 远程会话 API 和 API 凭据角色。

通过 MCP 服务安装软件包

MCP 已支持读取和更新软件仓库中的软件包及其版本。API 密钥授权与浏览器/Entra SSO 相互独立。控制台登录失败并不能证明软件包 API 不可用。

• orgId 是范围选择器。指定组织 ID 会请求该组织的视图；all 会请求 Enterprise 范围。部分 Enterprise 共享软件包可通过组织视图读取，但这并不能证明具有 Enterprise 写入权限。更新 Enterprise 共享软件包时，请使用 all。
• 读取需要在请求的范围内拥有 View Software Repository 权限。更新需要在软件包范围内拥有 Manage Software Repository 权限；该权限隐含包含 View。对于版本 PATCH，approval_status 则需要 Approve Updates 权限，EULA_accepted 则需要 API 的 accept_eula 权限。脚本操作还需要相应范围内的 Use Scripts 权限。内置软件包版本不可修改。获得授权的管理员可以扩展凭证现有角色；HTTP 403 表示权限/范围被拒绝，而不是缺少 MCP 端点。
• versionId 是版本对象的 id，不是显示的 version。例如，id: "21.07.00.0_1640795090369" 和 version: "21.07.00.0" 指的是不同字段。请始终查询当前 ID，不要猜测。

对于代码编排客户端：

1. 使用 installer 调用 action1_search，查找软件包和版本工具。

2. 使用以下端点 ID 调用 action1_execute，并传入这些参数：

   {"orgId":"<organization-id-or-all>","packageId":"<package-id>","fields":"versions"}
   

3. 获取所选对象的 versions[].id。使用 software-repository.versions.packages-all-package-id-id-get，并传入 orgId、packageId 和该 versionId，读取其配置。

4. 保留现有配置，并准备范围内获准的最小更新。软件包元数据使用 software-repository.packages-all-package-id-patch；安装程序部署配置使用 software-repository.versions.packages-all-package-id-id-patch。将相同的标识符以及仅限已编辑且可写的版本属性传给 action1_execute。将这些属性直接放在 params 中，例如：

   {"orgId":"<organization-id-or-all>","packageId":"<package-id>","versionId":"<returned-version-id>","silent_install_switches":"<reviewed silent-install switches>"}
   

   字段名称和类型请参阅供应商 API 参考中的 Windows 或 Mac 版本 PATCH 架构。不要重放整个 GET 响应，也不要将属性嵌套在 body-json 下。该标记属于对应的 CLI 命令；该命令通过 --body-json 或 --stdin 接收更新对象。

5. 更新后重新读取软件包/版本。写入成功并不能证明端点上已安装或部署。

请参阅扩展软件包数据和仓库权限。

常见问题

这能与 ChatGPT 配合使用吗？

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

我的 Action1 数据安全吗？

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

我需要哪个 Action1 区域和哪些凭据？

你需要从 Action1 控制台的 API Credentials 页面获取 API 客户端凭据（Client ID + Client Secret），并将 ACTION1_REGION 设置为 us、eu 或 au，以匹配你的控制台 URL。CLI 会将凭据 POST 到 /oauth2/token，并为你生成和刷新 bearer token。如果你只需要报告，请为客户端设置只读权限模板的范围——请参阅 governance.md。

这会取代 Action1 控制台吗？

不会。控制台仍然是你交互式配置自动化并批准补丁的地方。此技能可以回答控制台一次只显示一个组织的跨组织问题，例如整个设备群的补丁状态、CVE 影响范围、每个客户端的评分卡；还可以让你的 AI Agent 在终端中运行这些查询。

费用是多少？

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

安全模型

层级	示例	推荐的 Agent 策略
读取	fleet patch-posture、fleet vuln-triage、endpoints managed <orgId>、search、export、doctor	允许
写入（常规）	endpoints groups、endpoints managed-id-patch、settings org-id-post、automations policies-schedules-org-id-post、import	使用 --dry-run 预览，再执行经过审核的写入操作
端点／补丁执行	automations policies-instances-org-id-post（运行自动化）、updates approvals updates-org-id、endpoints managed-id-remote-sessions-post、scripts org-id-post	人工参与；绝不无人值守
凭据／安全	oauth2（生成 token）、users post、roles post、roles id-patch	仅限人工参与
破坏性操作／帐户	endpoints managed-id-delete、organizations org-id-delete、users id-delete、enterprise request-closure	仅限人工参与，并需明确确认

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

状态

Beta 版。已针对 Action1 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-06-06。