ThreatLocker MCP

ThreatLocker + AI——适用于 ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini 及所有支持 MCP 的 Agent

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

_{完整 Skill 页面 - 安装、效果、安全模型。}

涵盖 ThreatLocker Portal API 的所有功能，还包括只读工具所没有的写入操作，以及其他 ThreatLocker 工具都不具备的跨租户离线存储。可与您已在使用的 AI 配合使用——ChatGPT（Plus/Pro+，通过托管的 HTTPS 端点；参见 mcp-install.md）、Claude Desktop、Codex、Claude Code、Claude Cowork 和 GitHub Copilot，还可通过远程方式使用 Microsoft 365 Copilot / Copilot Studio 和 Google Gemini。免费、开源，可在笔记本电脑上运行。专为 MSP 所有者打造。无需编写代码。

适用于您的 Agent

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

您的 AI Agent	ThreatLocker Skill 安装方法
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 threatlocker-mcp（无需编辑 JSON）。
ChatGPT（付费套餐）	运行安装程序，通过 HTTPS 使用 bearer token 托管 threatlocker-mcp，并将其注册为 Developer Mode 连接器。参见 mcp-install.md。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 threatlocker-mcp，然后选择 Agent 模式。

ChatGPT 需要远程 HTTPS 服务，也就是使用此连接器的 HTTP 模式：在设置 THREATLOCKER_MCP_HTTP_TOKEN 之前，服务不会启动；每个请求都必须在 bearer 标头中发送该令牌；此外，任何非 loopback 地址都需要 --tls-cert 和 --tls-key。参见 mcp-install.md。

也适用于 Microsoft 和 Google 技术栈

用户群庞大，但需要坦诚说明：这些属于远程 / 企业接入方式，而不是您刚安装的本地二进制文件。

Agent	所需条件
Microsoft 365 Copilot / Copilot Studio	通过 HTTPS 使用 bearer token 托管 threatlocker-mcp（与 ChatGPT 使用相同的 HTTP 模式），然后在 Copilot Studio 中将其添加为 Model Context Protocol 工具。需要 Copilot Studio 许可证和租户管理员。参见 mcp-install.md。
Google Gemini	Gemini CLI 在本地运行——与 Claude Code 相同。Gemini app 需要远程接入，使用与 ChatGPT 相同的托管 HTTPS 端点。参见 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 上启动。每个工具都会调用配套的 threatlocker-cli。从 2026-09-18 开始发布的版本会将该 CLI 打包在安装包内；较早的安装包只包含 MCP 服务，因此如果你的安装包缺少配套 CLI，请先运行下方的路径 A 或路径 B 安装程序（或将 THREATLOCKER_CLI_PATH 设置为现有二进制文件的路径）。详情请见：#331。

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

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

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

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

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

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

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

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

threatlocker-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

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

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/threatlocker --force

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

为 OpenClaw 安装

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

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

OpenClaw 目前尚未普遍开放；frontmatter 配置已预先打包，OpenClaw 一经发布便会立即启用。

身份验证

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

THREATLOCKER_API_KEY=<value> threatlocker-cli doctor

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

此技能的功能

MSP 经常提出的问题	命令
目前我所有客户有哪些待处理的应用审批？	threatlocker-cli approvals triage --all-tenants
先制定计划，再批准所有待处理项中的这个文件哈希？	threatlocker-cli approvals approve-batch --hash <sha256> --all-tenants --dry-run
哪些客户的审计证据即将因 31 天保留期限而丢失？	threatlocker-cli audit retention-check
在客户的被阻止文件（deny）审计事件过期前，将其全部保存到本地？	threatlocker-cli audit pull --since 30d
导出已保存的审计日志，供 SIEM 或审计人员使用？	threatlocker-cli audit export --all-tenants --since 30d
本周所有租户有哪些变化：保护已关闭、策略已编辑、维护？	threatlocker-cli audit drift --since 7d --all-tenants
所有客户中有哪些 ThreatLocker Agent 离线或状态过时？	threatlocker-cli devices health --all-tenants
哪些租户和端点请求运行此文件，哪些应用已信任它？	threatlocker-cli applications hunt --hash <sha256>
哪些端点仍处于维护模式？	threatlocker-cli maintenance open --older-than 24h
应该先查看哪个租户？	threatlocker-cli organizations posture

审计行读取 audit pull 保存的数据，其他行读取 sync 保存的数据：请先运行 threatlocker-cli sync 和 threatlocker-cli audit pull --since 30d，并按短于 31 天的间隔定期运行 audit pull。

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

有何不同

大多数 ThreatLocker 集成和 MCP 服务会将每个问题转发为实时 API 调用。对于单条记录，这样做没问题；但规模扩大后就行不通了，因为 Portal API 一次只能处理一个租户。因此，询问“显示所有 40 个客户的待处理审批，并按文件哈希去重”或“哪些客户本月即将丢失审计证据”，就会变成不断更换请求头、重复查询的繁琐过程，AI 还得逐个租户消耗上下文来处理。

此技能会将 ThreatLocker 同步到带有全文搜索功能的本地 SQLite 镜像。汇总类问题只需执行一次本地 SQL 联接：响应即时、无需联网，AI 看到的是答案，而不是原始数据。approvals triage、applications hunt 和 devices health 等复合命令可以一次性联接所有租户的审批请求、应用、计算机和审计事件——这是无状态 API 包装器做不到的。

解决的痛点

ThreatLocker 默认拒绝，因此每个新应用或更新后的应用都会生成一条待管理员处理的审批请求。ThreatLocker 自己的 MSP 指南也承认请求量很大：“在为前几个客户进行接入时，设备正在学习，因此可能会产生相当多的请求”（Allowlisting for MSPs）。管理多个租户时，队列永远不会清空，而 Portal 只能让你逐个租户处理。还有证据留存问题：ThreatLocker 帮助中心明确指出，“默认情况下，Unified Audit 会保留 31 天的数据。31 天后，信息将被永久删除，且无法恢复”（Log Retention）——这比大多数合规和网络保险要求的期限都短。

此技能解决了这两个问题：

• approvals triage --all-tenants — 将所有租户的待审批项汇总成一个按优先级排序的队列，并按文件哈希去重。
• approvals approve-batch --hash <sha256> --all-tenants --dry-run — 允许所有待审批租户中的已知可信文件，先生成计划；实际执行时需要 --yes。
• audit pull --since 30d + audit retention-check — 在证据过期前，将每个租户的拒绝事件保存到本地（添加 --action permit 可包含已允许的事件），并标记即将触及 31 天期限的租户；audit export 可将已保存的日志交给 SIEM 或审计人员。
• devices health --all-tenants — 无需逐个租户排查，即可发现所有租户中的离线和过期 Agent。

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

常见问题

这适用于 ChatGPT 吗？

适用于 Plus、Pro、Team、Business、Enterprise 和 Education 计划（Free 目前尚未开放 Developer Mode）。ChatGPT 只能通过 HTTPS 连接远程 MCP 服务，因此你需要以 HTTP 模式托管 threatlocker-mcp：在设置 THREATLOCKER_MCP_HTTP_TOKEN 之前，它不会启动；每个请求都必须在 bearer 标头中发送该令牌；此外，任何非 loopback 地址还需要 --tls-cert 和 --tls-key。只有当连接器的身份验证设置能够发送该 bearer 令牌时，才能正常使用，因此请先检查你的设置。分步说明请参阅 mcp-install.md。

这适用于 Codex、Cursor、Windsurf、Cline、Copilot 或 Gemini 吗？

适用——它们都支持 MCP。跨工具安装命令见上方的对照表，详细说明请参阅 docs/which-agent.md。

我需要懂编程吗？

不需要。推荐的安装方式是在 Claude Code 或 Codex 中粘贴一句话——你的 Agent 会读取 SKILL.md 并完成安装。备用方式是运行适用于各操作系统的一行安装命令（bash 或 PowerShell）。这两种方式都不需要编写代码。你只需输入一次 ThreatLocker 凭据。

我的 ThreatLocker 数据安全吗？

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

这会触及 ThreatLocker API 速率限制吗？

设置本地镜像就是为了避免读取操作访问 API。首次运行 sync 后，跨租户视图（approvals triage、audit drift、devices health、applications hunt）会基于本地 SQLite 运行，不会调用 API。实时调用会遵循 --rate-limit 限流设置，而同步采用增量方式，只获取自上次检查点以来发生变化的数据。

它如何处理 ThreatLocker 的 31 天审计保留期？

ThreatLocker 的 Unified Audit 日志默认保留约 31 天。audit pull 会将每个租户的拒绝事件（或使用 --action permit 时的允许事件）保存到本地存储，以便证据在此期限过后仍然留存；audit export 会将其导出为 JSONL 或 CSV；audit retention-check 则会按租户报告你的存档距离过期还有多久，以及上次同步已过多久，避免任何数据在不知情的情况下过期。

我需要成为 ThreatLocker MSP 或拥有子租户吗？

你需要在自己的 ThreatLocker Portal 中拥有 API 访问权限。跨租户功能面向拥有子租户的托管（父级）组织，也就是 MSP 设置；不过，单个组织也可以使用，只是只能查看单个租户。你创建的凭据才是真正的权限边界。

它会取代 ThreatLocker Portal 吗？

不会。Portal 仍然最适合编写策略以及进行交互式批准／拒绝操作。此技能为你的 AI Agent 添加跨租户查询和可脚本化写入功能，让你无需登录每个租户就能回答全组织范围的问题。

费用是多少？

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

安全模型

等级	示例	推荐的 Agent 策略
读取	approvals triage、audit drift、audit retention-check、audit export、devices health、applications hunt、maintenance open、organizations posture、search；sync 和 audit pull 只写入本地存储	允许
写入（常规）	approvals approve / approve-batch（实时运行需要 --yes）、applications create / update、policies create / copy / deploy、computers maintenance / enable-protection / restart-service	先用 --dry-run 预览，再经审核后写入
凭据	organizations auth-key、computers install-info（每个命令都会返回一个租户的 Agent 安装密钥；仅限 CLI，不通过 MCP 提供，也不会缓存或存储）	仅限人工介入
破坏性操作／配置	computers delete、policies delete	仅限人工介入

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

状态

已进行实时验证。@geekbrownbear（MSP）已使用其生产租户确认（凭证）。更多 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-05。