ThreatDown MCP

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

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

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

提供 ThreatDown OneView 的全部 API，以及跨所有站点的整个设备群 stale endpoint、健康状况和席位报告，还有带防护措施的隔离／扫描／恢复任务。可与您已经在使用的 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 工具还可能使用您的凭据进行 更改。如果您为远程 Agent 设置了隧道，请将其关闭。修复即将推出。

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

您的 AI Agent	如何安装 ThreatDown skill
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 threatdown-mcp（无需编辑 JSON）。
ChatGPT（付费方案）	在此连接器重新发布前暂停使用：ChatGPT 需要 HTTP 模式，而此版本的该模式虽会检查令牌，但尚无请求大小或时间限制。请参阅 mcp-install.md 中的安全提示。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 threatdown-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。

原生支持技能的 Agent（也涵盖在内）： Hermes 和 OpenClaw 可直接读取此技能的 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 二进制文件运行各技能的安装程序）。请参阅 docs/which-agent.md。

60 秒内完成安装

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

下载 ThreatDown MCP (.mcpb)，然后打开 Claude Desktop > 设置 > 扩展 并选择该文件。一键完成，无需 JSON，也无需 Shell。（可在发布页面浏览所有 ThreatDown 版本。）

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

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

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

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

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

任何能够运行 Shell 的 Agent 都可以使用相同的提示词。

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

threatdown-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

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

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/threatdown --force

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

为 OpenClaw 安装

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

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

OpenClaw 尚未正式开放使用；frontmatter 配置已预先部署，会在 OpenClaw 启动时立即生效。

身份验证

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

export THREATDOWN_CLIENT_ID=<value>
export THREATDOWN_CLIENT_SECRET=<value>
threatdown-cli doctor

每个运行 CLI 或 MCP 服务的进程都必须设置这两个变量（MCP 安装会将它们放入客户端的环境变量块中）。doctor 会用它们换取令牌，并通过对 OneView 账户端点（其 Credentials 行）进行经过身份验证的调用来验证令牌，因此错误的密钥会显示为凭据错误，并返回 HTTP 401。只有生成的令牌会缓存在 CLI 的 credentials.toml 中，不设置这些变量的进程不会复用该令牌。若要存储这对凭据，请先导出这两个变量，再运行 threatdown-cli auth login --client-id <id>：它会将该客户端 ID 和环境变量中的密钥保存到该文件中，直到运行 threatdown-cli auth logout；密钥绝不会出现在命令行中。

此技能的功能

MSP 常问的问题	命令
所有站点中，哪些端点已 24 小时未签入？	threatdown-cli fleet stale --hours 24 --agent
哪个客户站点最需要优先处理？	threatdown-cli fleet health --agent
哪些站点的席位分配过多或过少？哪些订阅即将到期？	threatdown-cli seats reconcile --agent
哪些扫描或隔离操作从未运行？	threatdown-cli respond pending --since 7d --agent
本月有哪些威胁影响了多个客户？	threatdown-cli threats spread --since 30d --min-sites 2 --agent
下一步应该隔离哪台已感染或可疑的机器？	threatdown-cli threats queue --since 7d --agent
客户通话时查看该客户的所有信息	threatdown-cli customer report "Acme Corp" --agent
隔离一台机器，并先预览操作	threatdown-cli respond isolate --host LAPTOP-042 --agent

threats spread、threats queue 和 customer report 会读取本地副本，因此请先运行 threatdown-cli fleet sync（需要获取最新数据时也要再次运行）。在添加 --confirm 之前，respond 命令不会执行任何操作。

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

有何不同

截至 2026 年 10 月，我们在 GitHub 上没有发现其他用于 ThreatDown OneView 的 MCP 服务。现有集成（例如 Sumo Logic 和 Datadog（Crest Data） 应用）会将 OneView 数据导入 SIEM 或监控工具。像“这个月有哪些威胁影响了我的 40 个客户中的多个客户？”这样的问题，仍然需要逐站点导出并整理到电子表格中。

此技能会为你解析每个站点的账户 ID，并将站点、终端、检测结果和作业同步到本地 SQLite 镜像，支持全文搜索（search --data-source local）。汇总类问题只需在本地执行一次 SQL 联接：即时、离线，而且 AI 看到的是答案，而非原始数据。threats spread、threats queue 和 customer report 等复合命令会联接检测结果、终端、作业和站点——无状态 API 封装器无法做到这一点。ThreatDown 自带的 AI 功能（例如 AI 辅助安全顾问和 AI Detection & Response）运行于 ThreatDown 控制台内；此技能则将所有 OneView 站点引入你现有的 Agent，为其提供补充。

解决的痛点

ThreatDown OneView 一次只能查看一个站点。周一常见的问题——“自周五以来，我所有客户中有哪些机器离线了？”——没有一个页面能给出答案。ThreatDown 官方提供的解决方案是脚本：支持文章 “API Example: Get endpoints not seen for more than 24 hours”（文章 35082574965011）附带 PowerShell 脚本，会列出所有站点、收集每个账户 ID、分页搜索终端，并打印距上次发现的小时数。只有机器沉默一周后，仪表板中的 “Last sync 7+ days ago” 小组件才会捕捉到它。站点运行状况、席位数量和作业结果也都需要逐站点查看。

• threatdown-cli fleet stale --hours 24 - 将厂商的 PowerShell 示例变为一条命令，适用于所有站点。
• threatdown-cli fleet health - 每个客户站点显示一行排名结果，问题最严重的排在最前。
• threatdown-cli seats reconcile - 对照已部署和活跃的机器核对分配情况，并标记即将到期的订阅。
• threatdown-cli respond pending --since 7d - 查找从未运行的扫描、隔离和由 RMM 下发的作业。
• threatdown-cli respond isolate --host LAPTOP-042 - 跨所有站点查找机器，并在发送前预览操作。

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

常见问题

这能与 ChatGPT 配合使用吗？

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

我的 ThreatDown 数据安全吗？

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

这是用于 ThreatDown OneView 还是 ThreatDown Nebula？

这是用于 OneView 的。ThreatDown（Malwarebytes）为 MSP 提供多站点控制台。它连接 OneView API api.threatdown.com/oneview，可管理你负责的所有站点。单家公司使用的 Nebula 控制台不属于 OneView 帐户；它使用不同的 API，本技能不支持该 API。

我需要什么凭据？

你需要 OneView 的 OAuth 客户端 ID 和密钥：在左侧菜单中打开 Integrate，点击 Add，为应用命名并勾选所需范围。ThreatDown 表示，必须由全局管理员或站点管理员创建该应用，而且密钥只会显示一次。read 范围适用于所有报告；respond 命令（隔离、恢复、扫描、重启、更新）还需要 execute，其他变更则需要 write。设置 THREATDOWN_CLIENT_ID 和 THREATDOWN_CLIENT_SECRET，然后运行 threatdown-cli doctor。若想请求少于默认的 execute read write 范围，可设置 THREATDOWN_OAUTH_SCOPE（例如 read）；CLI 会在下次调用时使用这些范围请求令牌。

我的 AI 能隔离或扫描客户端计算机吗？

只能执行你允许的命令。respond 命令默认会先预览：它们会列出将收到任务的计算机，并且在你添加 --confirm（或全局选项 --yes）之前不会发送任何内容；除非你提高 --max-targets 的值，否则目标端点超过 25 个时会拒绝执行。其他路径会立即发送：endpoint-jobs issue、endpoint-jobs bulk-issue、grid jobs-bulk、import endpoint_jobs，以及 MCP 服务的通用 threatdown_execute 工具。对于报告型 Agent，请将 OAuth 客户端设为仅有 read 权限，或者设置 THREATDOWN_MCP_READ_ONLY=1，这样 MCP 服务就会移除写入工具，并拒绝所有非 GET 调用，以及通过 threatdown_execute 执行的 endpoints diag-log。

是否已在真实 OneView 租户上测试？

尚未。所有命令均根据 ThreatDown 发布的 OneView API 规范构建，并针对该 API 的本地模拟环境进行了测试，而非真实租户。如果你在自己的 OneView 帐户上运行，请通过 问题跟踪器或 Build Session 告诉我们哪些功能正常、哪些出现问题；只有经过真实 MSP 环境的运行验证，才能获得实时验证徽章。

这会取代 OneView 控制台吗？

不会。OneView 仍然用于设置策略、管理订阅和部署 Agent。本技能可让你的 AI Agent 或终端回答跨站点报告和分类问题，并发送响应任务：respond 命令会先预览，而原始任务命令会立即发送。

费用是多少？

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

安全模型

层级	示例	建议的 Agent 策略
读取	fleet stale、fleet health、seats reconcile、respond pending、threats spread、threats queue、customer report、fleet sync、search、tail（会剔除机密字段）、不带 --confirm 的 respond 命令、除最后一行中的凭据读取命令和 endpoints diag-log 外的所有 list / get / search / export 命令	允许
端点操作	带 --confirm 的 respond isolate / restore / scan / reboot / update、endpoint-jobs issue、endpoint-jobs bulk-issue、endpoint-jobs quarantine-bulk、endpoint-jobs parent-reissue、endpoint-jobs parent-children-reissue、endpoint-jobs 取消命令、grid jobs-bulk、endpoints sa-remediate、suspicious-activity remediate、endpoints diag-log、import endpoint_jobs、作业端点上的 MCP threatdown_execute 工具	人类参与审核，需明确确认
安全配置	exclusions create / update、policies create / update / promote 及其他策略写入操作、groups assign-endpoints、防火墙、内容过滤、设备控制、应用屏蔽和 AIDR 规则、schedules、webhooks 和 notifications 的 create / update、syslog 和 email-protection 设置，以及前后各行未列出的所有其他写入操作	先使用 --dry-run 预览，再由人类批准写入
破坏性操作	endpoints delete / delete-bulk、grid endpoints-delete、sites delete、policies delete、exclusions delete、users delete、webhooks delete、notifications delete，以及所有其他 delete 命令	仅限人类参与审核，需明确确认
凭据和管理	所有 policies 读取操作（包括 secret-get / secret-get-v2）、sites secret、installation-tokens search、installers、webhooks list / get、notifications list / get，以及 policies 或 notifications 的 export（其输出可能包含防篡改密码、注册凭据或 Webhook 签名密钥；本地镜像不会存储这些字段）、installation-tokens create / send / revoke、policies secret-set、users create / update、sites create / update、对用户或站点执行 import、subscriptions create / update、email-protection 的注册、迁移和授权命令	仅限人类参与审核

最强的控制措施是你在 OneView OAuth 客户端上勾选的权限范围（read、write、execute）——CLI 只能执行该客户端获准的操作。设置 THREATDOWN_MCP_READ_ONLY=1 可让 MCP 服务以只读模式运行。完整详情（包括如何加强限制）请参见 governance.md。

状态

Beta 版。基于 ThreatDown 发布的 OneView API 规范构建，并通过该 API 的本地模拟版本进行测试；目前正与在自有生产租户上实际运行该工具的 MSP 一起，在每周的 Build Sessions 中进行验证。请在 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-14。