Abnormal Security MCP

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

非官方。由社区构建的 Claude Code Skill 和 Abnormal Security API 的 MCP 服务。 与 Abnormal Security Corporation 无关联，未获其认可，也未接受其赞助。

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

在终端和 Agent 中使用完整的 Abnormal Security REST API——配备本地威胁存储、SOC 分级分类、阻断式修复，以及一键式客户端报告。兼容你已经在使用的 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	如何安装 Abnormal Security skill
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 abnormal-mcp（无需编辑 JSON）。
ChatGPT（付费方案）	此连接器重新发布前暂停使用：ChatGPT 需要 HTTP 模式，而此版本的该模式无需密码，会监听所有网络接口，且你打开的网页可以访问它。请参阅 mcp-install.md 中的安全提示。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，将 abnormal-mcp 添加到 mcp.json 的 servers 键下，然后选择 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 上启动。每个工具都会调用配套的 abnormal-cli。从 2026-09-18 开始发布的版本会在安装包中附带该 CLI；较早的安装包仅包含 MCP 服务，因此如果你的安装包缺少配套 CLI，请先运行下方的路径 A 或路径 B 安装程序（或将 ABNORMAL_CLI_PATH 设置为现有二进制文件的路径）。详情：＃331。

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

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

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

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

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

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

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

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

abnormal-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

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

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/abnormal --force

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

为 OpenClaw 安装

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

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

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

身份验证

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

ABNORMAL_API_TOKEN=<value> abnormal-cli doctor

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

此 skill 的功能

MSP 经常提出的问题	命令
目前有哪些新的、尚未修复的电子邮件威胁需要处理？	abnormal-cli triage --since 24h --top 20
获取一份可直接提供给客户的季度安全报告	abnormal-cli report-snapshot --since 90d --csv
这名员工面临怎样的账户接管风险？	abnormal-cli employee-risk "[email protected]"
这个供应商是否有电子邮件遭入侵的迹象？	abnormal-cli vendor-risk "acme-supplies.com"
修复威胁并阻止操作，直到其真正完成	abnormal-cli remediate-watch <threat|case> <id>
列出最新的 Abnormal 案例	abnormal-cli cases retrieve --all
本周我们阻止了多少次攻击？	abnormal-cli aggregations attack-stopped-retrieve
查找来自伪造发件人的威胁	abnormal-cli threats retrieve --sender "[email protected]"

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

与众不同之处

大多数 Abnormal Security 集成和 MCP 服务都会将每个问题转发为实时 API 调用。查询一条记录时，这种方式没问题。但面对大规模查询时就会失效，例如统计 90 天客户报告中阻止了多少次攻击、上个季度有哪些员工遭到冒充，或查找隔夜数据流中所有尚未修复的威胁。

此 skill 会将 Abnormal Security 同步到支持全文搜索的本地 SQLite 镜像中。聚合查询只需执行一次本地 SQL 联接：即时完成、无需联网，而且 AI 看到的是答案，而非原始数据。triage、employee-risk 和 vendor-risk 等复合命令可通过一次调用联接威胁、案例、员工登录记录和供应商活动——这是无状态 API 封装无法做到的。

解决的痛点

在 r/msp 上，邮件安全相关的帖子总是围绕着同样两个问题：告警疲劳（分析师又得在一个门户里查看威胁日志，在没有优先级队列的情况下不断滚动）以及每季度都得手动把安全仪表板整理成可交付给客户的报告。真正重要的工作——有哪些新情况、哪些问题尚未修复、该告诉客户什么——都被埋在一次次点击中。

此技能通过以下命令解决这些痛点：

• triage --since 24h --top 20 - 按优先级排列最新、严重程度最高且仍未修复的威胁，让值班人员从最重要的事项开始处理。
• report-snapshot --since 90d --csv - 在一张可直接交付给客户的表格中，汇总已发现的攻击、已拦截的攻击、冒充攻击分类以及攻击趋势。
• employee-risk "[email protected]" - 为每位员工呈现账户接管风险全貌：个人资料、Genome 身份、30 天登录记录以及提及他们的未结案件。
• vendor-risk "acme-supplies.com" - 呈现供应商邮件入侵风险全貌：详细信息、近期活动以及未结供应商案件。
• remediate-watch <threat|case> <id> - 执行修复并拦截，直到 Abnormal 报告终止状态，并返回类型化退出代码回执。

详见 pain-point.md 中的完整说明。

常见问题

这适用于 ChatGPT 吗？

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

我的 Abnormal Security 数据安全吗？

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

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

不一定。sync 会先将你的租户数据同步到本地 SQLite 镜像，此后 triage、search 和报告都从磁盘读取，因此重复查询不会触及 API。对于实时调用，你可以通过 --rate-limit 限制吞吐量，并对大型拉取操作进行分页。

我必须是 Abnormal 合作伙伴或客户吗？

你需要能够访问 Abnormal Security 租户的 API，并从门户的集成设置中生成令牌。REST API 不要求单独的合作伙伴级别——只需提供权限范围符合此技能需求的凭据即可。

它真的能执行修复操作，还是只能读取数据？

它可以修复威胁，也可以通过修复命令删除或移动恶意邮件；remediate-watch 会持续等待，直到 Abnormal 报告操作已达到终止状态。这些操作受人工参与策略的约束——请参阅下方的安全模型。

它会取代 Abnormal 门户吗？

不会。检测调优、策略和配置仍在门户中完成。这是一个以读取为先、经批准后再执行操作的终端和 Agent 界面，并非替代性的 UI。

费用是多少？

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

安全模型

层级	示例	建议的 Agent 策略
读取	triage、report-snapshot、threats retrieve、cases retrieve、vendors、employee-risk、vendor-risk、soar（仅 API 令牌元数据）	允许
写入（常规）	cases create（更新案例状态）、detection360 reports-create、api-resources resources-create-create / resources-update-partial-update	使用 --dry-run 预览，然后经审核后写入
修复 / 破坏性操作	threats create（修复 / 取消修复）、email-search search-remediate-create（删除 / 移动邮件）、remediate-watch、import	仅限人工介入

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

状态

Beta 版。已根据 Abnormal Security API 范围完成验证，目前正在每周的 Build Sessions 中与实际运行该工具的 MSP 一起，对其在各自生产租户上的运行情况进行验证。请在 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-07。