Huntress MCP

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

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

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

涵盖 Huntress 的每个端点，另有本地 SQLite 镜像，可提供 API 和官方 MCP 无法提供的全服务群事件、覆盖范围和账单汇总。可与您已在使用的 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

安全说明。 本地 Agent 使用默认的 stdio 传输，无需网络侦听器。 HTTP 模式（--transport http，供远程 Agent 使用）在设置 HUNTRESS_MCP_HTTP_TOKEN 前拒绝启动；没有该 bearer 令牌的请求会被拒绝； 默认通过 http://127.0.0.1:7777/mcp 提供服务，使用其他地址则需要 --tls-cert 和 --tls-key。请求正文超过 4 MiB 或接收时间超过 30 秒时，会拒绝该请求。持有令牌的人 可以使用您的 Huntress 凭据调用所有工具，包括会更改您租户的工具，因此请像对待密码一样保管它；如果远程主机只需读取数据，请设置 HUNTRESS_MCP_READ_ONLY=1。参见 mcp-install.md。

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

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

ChatGPT 需要远程 HTTPS 服务，这意味着需要使用此连接器的 HTTP 模式：设置 HUNTRESS_MCP_HTTP_TOKEN 前，服务会拒绝启动；每个请求都必须在 bearer 标头中发送该令牌；除回环地址外，使用任何其他地址还需要 --tls-cert 和 --tls-key。参见 mcp-install.md。

也适用于 Microsoft 和 Google 技术栈

安装量很大，但需要如实提醒：这属于远程 / 企业方案，而不是你刚安装的本地二进制文件。

Agent	所需条件
Microsoft 365 Copilot / Copilot Studio	通过 HTTPS 和 bearer token 托管 huntress-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 上启动。每个工具都会调用配套的 huntress-cli。2026-09-18 及之后发布的版本会在安装包中附带此 CLI；较旧的安装包仅包含 MCP 服务，因此如果你的安装包缺少配套程序，请先运行下方的 Path A 或 Path B 安装程序（或将 HUNTRESS_CLI_PATH 设置为现有二进制文件的路径）。详情：#331。

下载 Huntress MCP（.mcpb）——然后打开 Claude Desktop > Settings > Extensions 并选择该文件。点击一次即可，无需 JSON，也无需运行 shell。（在发布页面浏览所有 Huntress 版本。）

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

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

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

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

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

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

Path B——自行运行安装程序

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

huntress-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

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

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/huntress --force

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

为 OpenClaw 安装

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

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

OpenClaw 尚未普遍开放；frontmatter 配置已预先提供，并会在 OpenClaw 发布后立即启用。

进行身份验证

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

HUNTRESS_API_KEY=<value> HUNTRESS_API_SECRET=<value> huntress-cli doctor

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

此技能的功能

MSP 经常提出的问题	命令
所有客户端组织中，哪些事件发生时间最早？	huntress-cli fleet-incidents --sort age
我的安全态势存在哪些缺口——回调过期、Defender 或防火墙已禁用？	huntress-cli coverage-gaps
这个 IP 或文件哈希是否影响过我的任何客户端？	huntress-cli blast-radius --indicator 203.0.113.10
我的计费席位数是否超过已部署的 Agent 数量？	huntress-cli billing-reconcile
过去一周哪些 Agent 已失联？	huntress-cli stale-agents --days 7
每个客户端的平均解决时间是多少？	huntress-cli mttr --group-by org
自上次轮班以来，整个客户群有哪些变化？	huntress-cli handoff --since 12h
为一个客户端生成 QBR 评分卡。	huntress-cli org-scorecard --org 12345
本周 SOC 报告了哪些检测类型？	huntress-cli signal-digest --since 7d
哪些升级事件仍未解决？按严重程度从高到低排列。	huntress-cli escalation-queue --severity critical

完整命令参考：guide.md。AI Agent 操作规范（--agent、--dry-run，以及何时应在执行变更前进行确认）请参阅 AGENTS.md。

有何不同

大多数 Huntress 集成和 MCP 服务都会将每个问题转发为实时 API 调用。查询单条记录时，这样做没问题。但规模扩大后就行不通了，例如你想问“现在，我所有 40 个客户端组织中发生时间最早的事件是什么？”或“这个攻击者 IP 是否影响过其他租户？”——门户一次只能回答一个组织的问题，而 API 也没有提供可一次性查询多个组织的接口。

此技能会将 Huntress 数据同步到带有全文搜索的本地 SQLite 镜像中。聚合查询只需执行一次本地 SQL 联接：即时、离线，而且 AI 看到的是答案，而不是原始数据。fleet-incidents、blast-radius 和 billing-reconcile 等复合命令可以一次性联接所有组织的事件报告、Agent、外部端口和发票数据——这是无状态 API 封装无法做到的。

解决的痛点

在 r/msp 上，多租户服务商反复提到 Huntress 的一个问题：仪表板没有原生的跨客户事件队列，没有全网态势汇总，也没有内置的对账功能来核对已开票席位与已部署 Agent。API 确实会列出整个账户中的 Agent 和事件报告，但事件列表对每个事件只返回前 10 条修复记录，而且整个账户每分钟最多只能发起 60 次请求。当有 20、40、80 个客户租户时，“我应该先处理哪个火情？”就变成了不停切换标签页的工作，而账单偏差只能在月底人工发现。

此技能填补了这一空白：

• 面向所有客户的统一事件队列 - huntress-cli fleet-incidents --sort age 会按时间对所有组织中的未处理事件排序，让最早、最紧急的事件排在最前面。
• 按严重程度排序的态势差距 - huntress-cli coverage-gaps 汇总整个服务网络中回调过期、Defender 已禁用和防火墙已禁用的情况。
• 全网影响范围 - huntress-cli blast-radius --indicator 203.0.113.10 会在每个组织的事件、Agent 和外部端口中关联 IP、哈希值或主机名。
• 席位与 Agent 对账 - huntress-cli billing-reconcile 会标出已开票席位与实际部署 Agent 之间的差额。
• 轮班交接与 QBR - huntress-cli handoff --since 12h 和 huntress-cli org-scorecard --org 12345 会将同步的事件、升级记录和 Agent 汇总为轮班交接报告及单个组织的 QBR 摘要（Agent、事件、MTTR）。

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

常见问题

这能与 ChatGPT 配合使用吗？

可以，支持 Plus、Pro、Team、Business、Enterprise 和 Education 计划（Free 计划目前尚未开放 Developer Mode）。ChatGPT 只能通过 HTTPS 连接远程 MCP 服务，因此你需要以 HTTP 模式托管 huntress-mcp：设置 HUNTRESS_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）。这两种方式都不需要编写代码。你只需输入一次 Huntress 凭据。

我的 Huntress 数据安全吗？

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

我需要成为 Huntress 合作伙伴吗？

你需要拥有一个配置了 API 凭据的 Huntress 账户——这些凭据是一组从门户生成的密钥和机密。经销商凭据可启用跨账户的 reseller-rollup；单账户凭据则可用于其他所有功能。

这会触发 Huntress API 速率限制吗？

sync 会将你的账户数据拉取到本地镜像中一次，此后所有汇总和搜索都会基于本地副本运行——因此重复提问不会产生任何 API 调用。CLI 还会遵循可配置的 --rate-limit，限制实际发出的请求。

这会取代 Huntress 门户吗？

不会——它是门户的补充。门户仍然是你进行配置和深入调查的控制台；此技能可回答跨租户和历史相关问题，而门户一次只能显示一个组织的数据。

需要多少费用？

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

安全模型

层级	示例	建议的 Agent 策略
读取	fleet-incidents、coverage-gaps、blast-radius、billing-reconcile、mttr、org-scorecard、stale-agents、search	允许
写入（常规）	organizations update-parameters、accounts memberships update-parameters、unwanted-access-rules update-parameters	使用 --dry-run 预览，然后在审核后使用 --yes 执行写入
事件操作	accounts incident-reports post-v1-accounts-account-id-id-remediations-bulk-approval、incident-reports remediations bulk-rejection-parameters、incident-reports resolution post-v1-incident-reports-id	仅允许人工介入，并明确指定 --yes
破坏性操作／配置	organizations delete-v1-id、accounts delete-v1-id、unwanted-access-rules delete-v1-id	仅允许人工介入，并明确指定 --yes

任何会更改 Huntress 租户的命令（创建、更新、删除、事件解决、修复审批或拒绝、订阅更改及 import）都不会执行，也不会发送任何内容，除非你传入 --yes 以发送请求，或传入 --dry-run 预览请求。能够运行 CLI 的 Agent 也可以传入 --yes，因此请在其策略中保留审批步骤。

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

状态

已在实际环境中验证。@Xenith-B（MSP）已在其生产租户中确认（验证凭证）。更多 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-06-06。