SentinelOne MCP

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

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

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

涵盖所有 SentinelOne v2.1 管理端点，另有离线 SQLite 存储和跨实体分析——设备群健康状况、威胁分类、影响范围、配置偏差——这些是控制台视图所不具备的。可搭配你已在使用的 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 使用）只有在设置 SENTINELONE_MCP_HTTP_TOKEN 后才会启动，会拒绝任何未携带该 bearer token 的请求，默认提供 http://127.0.0.1:7777/mcp，其他任何地址都需要 --tls-cert 和 --tls-key。请求正文超过 4 MiB，或接收时间超过 30 秒，都会被拒绝。持有该令牌的人可以使用你的 SentinelOne 凭据调用所有工具，包括会更改租户的工具，因此请像对待密码一样保管它；如果远程主机只需要读取数据，请启用 SENTINELONE_MCP_READ_ONLY=1。参见 mcp-install.md。

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

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

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

Microsoft 和 Google 技术栈也适用

安装基础庞大，但先说明一点：这条路适用于远程 / 企业环境，而不是你刚安装的本地二进制文件。

Agent	所需条件
Microsoft 365 Copilot / Copilot Studio	通过 HTTPS 和持有者令牌托管 sentinelone-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。

原生支持技能的 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

Claude Desktop 捆绑包： .mcpb 可在 macOS（Intel 和 Apple Silicon）、Windows x64 和 Linux x64 上启动。每个工具都会调用配套的 sentinelone-cli。从 2026-09-18 起发布的版本会在捆绑包中附带该 CLI；较早的捆绑包仅包含 MCP 服务，因此如果你的捆绑包缺少配套工具，请先运行下方的路径 A 或路径 B 安装程序（或将 SENTINELONE_CLI_PATH 设置为现有二进制文件的路径）。详情：＃331。

下载 SentinelOne MCP（.mcpb）——然后打开 Claude Desktop > Settings > Extensions 并选择该文件。一键完成，无需 JSON 或 shell。（在 releases 页面浏览所有 SentinelOne 版本。）

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

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

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

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

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

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

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

sentinelone-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

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

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/sentinelone --force

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

为 OpenClaw 安装

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

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

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

身份验证

设置 CLI 所需的凭据（从 SentinelOne 管理控制台获取）：

SENTINELONE_API_TOKEN=<value> sentinelone-cli doctor

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

此技能的功能

MSP 常问的问题	命令
我现在应该优先处理所有客户站点中的哪些问题？	sentinelone-cli threats triage
这个恶意文件传播到了哪里？哪些端点仍处于活动状态？	sentinelone-cli threats blast-radius "<hash>"
哪些端点的状态正在恶化——处于离线、版本过旧、已感染或保护不足？	sentinelone-cli fleet-health stale
哪些客户存在保护缺口（仅检测、Ranger 已关闭、防火墙已关闭）？	sentinelone-cli coverage gaps
从昨天起，整个设备群发生了哪些变化？	sentinelone-cli whatchanged --since 24h
哪些威胁在缓解后仍反复出现？	sentinelone-cli threats recurrence
我们是否达到缓解 SLA？有哪些违规情况？	sentinelone-cli threats mttr --sla 4
为每位客户生成一份安全态势评分卡，用于 QBR 演示文稿？	sentinelone-cli posture
按风险排列客户，方便我确定先联系哪个租户？	sentinelone-cli sites risk
哪些 Agent 仍占用许可证，却没有关联的在线设备？	sentinelone-cli agents reclaim --days 30
按站点和操作系统列出需要升级 Agent 的端点，并指出哪些端点目前可访问？	sentinelone-cli versions plan

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

与众不同之处

大多数 SentinelOne 集成和 MCP 服务都会将每个问题转发为实时 API 调用。处理单条记录时这样做没问题；但在规模较大时就不行了，例如询问“按置信度、严重程度和时间长短，对所有 40 个客户站点中尚未关闭的威胁进行排序”，或“从昨天起，哪些端点离线或降级为仅检测模式”——控制台一次只能查询一个范围，甚至可能完全无法回答。

此技能会将 SentinelOne 数据同步到本地 SQLite 镜像，支持全文搜索，并在每次同步时保存历史快照。聚合类问题只需执行一次本地 SQL 联接：即时、离线，AI 看到的也是答案，而非原始数据。threats triage、threats blast-radius、fleet-health stale 和 whatchanged 等组合命令会联接威胁、Agent、站点和已存储的快照，实现跨站点汇总和基于时间的差异比较，而无状态 API 封装无法做到这一点。

解决的痛点

SentinelOne 管理控制台一次只能选择一个 Account 或 Site。要跨多个客户站点运行管理工作时，每个跨客户问题——哪些客户有最多未处理威胁、哪些客户的 Agent 已离线、哪些客户仍在使用旧版本、哪些客户悄悄降级到了仅检测模式——都意味着切换范围选择器，再逐个租户重新查看相同页面。MSP 在 r/msp 上反复提出这个单窗格视图的缺失问题：没有一个视图能并排排列所有客户的威胁或设备群组健康状况，而在没人有时间检查的逐站点筛选器之间，防护能力就会悄然减弱。

此技能通过在本地镜像每个站点来弥补这一缺口，然后通过一次调用回答跨站点问题：

痛点	命令
没有按优先级排列、涵盖所有客户的分诊工作清单	sentinelone-cli threats triage
无法查看某个威胁的完整影响范围	sentinelone-cli threats blast-radius "<hash>"
离线／陈旧／防护不足的 Agent 被逐站点隐藏	sentinelone-cli fleet-health stale
防护缺口（仅检测、Ranger／防火墙关闭）未被发现	sentinelone-cli coverage gaps
无法查看整个设备群组“一夜之间发生了什么变化”	sentinelone-cli whatchanged --since 24h
手动整理 QBR 防护状况评分卡	sentinelone-cli posture

更详细的说明见 pain-point.md。

常见问题

能与 ChatGPT 配合使用吗？

可以，适用于 Plus、Pro、Team、Business、Enterprise 和 Education 套餐（Free 目前尚未提供 Developer Mode）。ChatGPT 只能通过 HTTPS 连接远程 MCP 服务，因此你需要以 HTTP 模式托管 sentinelone-mcp：必须设置 SENTINELONE_MCP_HTTP_TOKEN，否则服务将拒绝启动；每个请求都必须在 bearer 标头中发送此令牌；如果地址不是环回地址，还需要提供 --tls-cert 和 --tls-key。默认情况下，它会在 http://127.0.0.1:7777/mcp 上提供服务，并拒绝请求正文超过 4 MiB，或接收耗时超过 30 秒的请求。只有当连接器的身份验证设置能够发送 bearer 令牌时，连接器才能正常工作。分步说明见 mcp-install.md。

能与 Codex、Cursor、Windsurf、Cline、Copilot 或 Gemini 配合使用吗？

可以——它们都支持 MCP。跨工具安装命令见上方的矩阵，深入说明见 docs/which-agent.md。

我需要懂编程吗？

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

我的 SentinelOne 数据安全吗？

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

这会触及 SentinelOne API 的速率限制吗？

设置本地镜像的目的就是避免读取操作继续调用 API。第一次 sync 后，跨站点视图（threats triage、blast-radius、fleet-health、coverage gaps、posture、sites risk、whatchanged）会基于本地 SQLite 运行，不会调用 API；实时调用则遵守 --rate-limit 限制。具备历史分析能力的功能（whatchanged、threats mttr、versions rollout、threats verdicts --changed）至少需要同步两次才有数据可供比较。

我需要哪种 API 令牌？如何限定其权限范围？

从管理控制台获取 SentinelOne API 令牌（服务用户令牌更适合长期使用；个人用户令牌也可以，但会过期）。令牌继承创建它的用户角色，因此该角色才是真正的权限边界——为报告工作流创建只读令牌，只有在确实需要时才使用写入或管理员权限。

这与 Purple AI 有何不同？

两者相辅相成。Purple AI 和控制台最适合在单个范围内进行深入威胁狩猎、编写策略和执行响应工作流。此技能将整个控制台的跨站点汇总功能——统一的分类处置工作清单、统一的资产群健康状况与安全态势视图，以及跨所有客户端的统一影响范围追踪——带到你已在使用的 AI Agent，并通过本地镜像离线运行。

它能取代 SentinelOne 控制台吗？

不能。控制台仍最适合威胁狩猎、编写策略和交互式响应工作流。此技能为 AI Agent 添加了跨站点查询和可脚本化操作，让你无需逐个进入站点，就能回答全组织范围的问题。

费用是多少？

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

安全模型

等级	示例	建议的 Agent 策略
读取	threats triage、threats blast-radius、fleet-health stale、coverage gaps、posture、sites risk、whatchanged、exclusions audit、agents reclaim、versions plan、search	允许
写入（常规）	agents initiate-scan、threats mitigate、agents disconnect-from-network、agents update-software、exclusions create——除非传入 --yes（发送）或 --dry-run（预览），否则每项操作都会拒绝执行且不会发送任何内容	先用 --dry-run 预览，再经审核后用 --yes 执行写入
破坏性操作／配置	agents uninstall、agents decommission、exclusions delete、sites delete、config-override delete、users delete	仅限人工参与操作

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

状态

已在实际环境中验证。一家 MSP 通过 GitHub 报告确认，该工具已在其生产租户中运行。更多 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-06。