runZero MCP

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

非官方。这是社区构建的 Claude Code Skill 和 runZero API MCP 服务。与 runZero, Inc. 无关联，未获其认可或赞助。

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

查询所有 runZero 数据，还可在本地保存整个攻击面的 SQLite 副本，追踪随时间的差异、离线关联资产与漏洞，并且无需消耗 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	如何安装 runZero 技能
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 runzero-mcp（无需编辑 JSON）。
ChatGPT（付费方案）	此连接器重新发布前暂停：ChatGPT 需要 HTTP 模式，而此版本的该模式无需密码、会监听所有网络接口，并且您打开的网页可以访问它。请参阅 mcp-install.md 中的安全提示。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 runzero-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 上启动。每个工具都会调用配套的 runzero-cli。自 2026-09-18 起发布的版本会在安装包内附带该 CLI；较早的安装包仅包含 MCP 服务，因此如果你的安装包缺少配套程序，请先运行下方的路径 A 或路径 B 安装程序（或将 RUNZERO_CLI_PATH 设为现有二进制文件的路径）。详情： #331。

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

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

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

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

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

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

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

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

runzero-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

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

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/runzero --force

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

为 OpenClaw 安装

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

从 https://github.com/servosity/msp-skills/tree/main/skills/runzero 安装 runzero 技能。该技能通过 openclaw: frontmatter 块定义了其所需 CLI（runzero-cli）的安装方式。

OpenClaw 目前尚未正式推出；frontmatter 接入配置已预先提供，并会在 OpenClaw 发布时立即启用。

身份验证

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

RUNZERO_API_KEY=<value> runzero-cli doctor

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

此技能的功能

MSP 常问的问题	命令
我们当前暴露风险最高的资产有哪些？	runzero-cli triage --agent
只看面向互联网的资产呢？	runzero-cli triage --internet-facing --agent
自上周以来，我们的攻击面发生了哪些变化？	runzero-cli diff --since 7d
自上次同步以来，哪些资产新增了暴露风险或漏洞？	runzero-cli exposure-delta --agent
哪些资产受给定 CVE 影响？	runzero-cli affected "CVE-2024-3094" --agent
某个子网中，风险服务集中在哪些位置？	runzero-cli exposure-map "10.0.0.0/8" --agent
哪些 TLS 证书即将过期或使用了弱加密？	runzero-cli certs-expiring --days 90 --weak
哪些资产已过时、已到生命周期终点或没有所有者？	runzero-cli stale --days 90 --json
按版本统计，运行某个软件产品的资产有多少？	runzero-cli software rollup "openssl" --agent

分隔线上方的所有命令都会读取本地 SQLite 副本——请先运行一次 runzero-cli inventory sync；如果希望 diff 和 exposure-delta 有两个快照可供比较，则运行两次。

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

有何不同

大多数 runZero 集成和 MCP 服务都会将每个问题转发为一次实时 API 调用。查询单条记录时这样做没问题。但当需要大规模查询时，例如“哪些关键资产正在运行存在漏洞的服务”，这种方式就会失效——因为 runZero 的 API 按实体划分范围（/org、/account、/export），所以回答这个问题需要调用三次并手动联接数据。

此技能会将 runZero 同步到支持全文搜索的本地 SQLite 镜像中。聚合查询只需进行一次本地 SQL 联接：即时、离线，AI 看到的是答案，而非原始数据。triage、affected 和 exposure-delta 等复合命令可一次性联接资产、服务和漏洞数据——无状态 API 封装无法做到这一点。此外，每次 inventory sync 都会生成一个快照，因此 diff 和 exposure-delta 可以比较两个时间点的数据，而实时封装完全无法做到这一点。

它解决的痛点

“看不见的东西就无法保护”是 r/msp 上常被提起的一句话，这自有其原因：资产清单会过时，影子 IT 会悄然出现，而真正重要的问题从来不只是关于某个资产。它们涉及多个实体——哪些关键机器运行了这个有漏洞的服务，什么东西从上周以来新开放了端口，哪些主机实际受到了新 CVE 的影响。runZero 能发现这一切，但它的 API 每次只提供一个实体，因此答案只能留在电子表格里，还得手动合并三份导出数据。

此技能通过在本地同步整个攻击面，并直接回答涉及多个实体的问题，填补了这一空白：

• 按暴露风险排序 - runzero-cli triage --agent 一次性关联关键性、服务和漏洞。
• 查看变更 - runzero-cli diff --since 7d 和 runzero-cli exposure-delta --agent 显示两次同步之间的变化和新暴露的服务。
• 追踪 CVE 的影响范围 - runzero-cli affected "CVE-2024-3094" --agent 列出所有受影响资产及其服务和关键性。
• 清理资产卫生问题 - runzero-cli stale --days 90 --json 将未发现、已结束生命周期（EOL）和无负责人的资产分类，并输出可直接传给批量命令的 ID。

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

常见问题

这适用于 ChatGPT 吗？

当前版本不适用。ChatGPT（Plus、Pro、Team、Business、Enterprise 和 Education 方案；Free 方案目前尚未提供开发者模式）只能通过 HTTPS 连接到远程 MCP 服务，这意味着必须以 HTTP 模式运行 runZero 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）。两种方式都不需要编写代码。你只需输入一次 runZero 凭据。

我的 runZero 数据安全吗？

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

这会消耗我的 runZero API 配额吗？

只有 inventory sync 和实时查询会调用 API。跨实体分析——triage、diff、affected、exposure-map、exposure-delta、certs-expiring、software rollup——完全基于本地 SQLite 副本运行，因此以一百种方式重新分析攻击面也不会额外消耗 API 调用次数。

这适用于自托管的 runZero 吗？

适用。默认使用托管控制台 console.runzero.com；通过 RUNZERO_BASE_URL 指定你自己的控制台即可。API 令牌的权限范围要求相同。

我需要什么令牌权限范围？

读取/导出令牌（Export ET、Organization OT 或 Account CT 密钥）适用于 inventory sync 和所有分析命令。使用 scan-watch 或 org create-scan 启动扫描，则需要具有扫描权限的令牌。请将凭据权限限制在工作流实际需要的范围内。

这会取代 runZero 控制台吗？

不会。控制台和 API 仍是发现数据的事实来源。此技能添加了 API 无法通过一次调用返回的离线跨实体分析层，包括特定时间点差异、CVE 到资产的影响范围，以及暴露风险排序，让 AI 一步即可回答安全问题。

费用是多少？

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

安全模型

等级	示例	建议的 Agent 策略
读取	triage、diff、affected、exposure-delta、exposure-map、stale、certs-expiring、software rollup、search、inventory list / status，以及非敏感信息的 account / org get-* 报告（资产、站点、服务、任务、组织、用户）——不包括下方列出的凭据读取	允许
写入（常规）	inventory sync（写入本地副本）、org create-site、org create-scan 和 scan-watch（这些操作会针对你的目标启动真实网络扫描）、import / runzero-import，以及资产标签/所有者更新	使用 --dry-run 预览，然后在审核后写入
凭据 / 破坏性操作 / 配置	会返回机密信息的读取操作（account get-apitoken 会生成令牌，get-credential / get-credentials、get-key / get-keys、get-organization-export-token / -tokens）、所有凭据和密钥写入操作（create-credential、create-key、rotate-key、reset-user-password / reset-user-mfa），以及所有 delete-* / remove-* 操作和 org 批量清除操作	仅限人工介入

最有力的控制措施是授予 runZero 凭据的权限范围——CLI 只能执行这些凭据获准执行的操作。完整详情（包括如何限制权限）请参阅 governance.md。

状态

Beta 版。已根据 runZero 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。