Proofpoint MCP

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

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

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

涵盖 Proofpoint TAP 的所有 Threat Insight 端点，并提供本地威胁存储，可回答跨端点问题——谁既遭受攻击又点击了链接、哪些内容触及了某个用户——无需再次消耗有限的每日 API 配额。可与您已在使用的 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	如何安装 Proofpoint 技能
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 proofpoint-mcp（无需编辑 JSON）。
ChatGPT（付费方案）	在此连接器重新发布前暂停：ChatGPT 需要 HTTP 模式，而此版本的该模式不需要密码，会监听所有网络接口，并且您打开的网页可以访问它。请参阅 mcp-install.md 中的安全说明。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，将 proofpoint-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，然后为 CLI/MCP 二进制文件运行各 Skill 的安装程序）。请参阅 docs/which-agent.md。

60 秒内完成安装

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

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

下载 Proofpoint MCP（.mcpb）——然后打开 Claude Desktop > Settings > Extensions 并选择该文件。点一下即可完成，无需 JSON 或命令行。（在发布页面浏览所有 Proofpoint 版本。）

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

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

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

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

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

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

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

proofpoint-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

Claude Desktop .mcpb 用户：下载最新的 .mcpb（见本节顶部），然后在 Settings > Extensions 中重新选择该文件。Claude Code 插件用户：运行 /plugin update proofpoint@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 配置块的说明见 mcp-install.md。

为 Hermes 安装

在 Hermes CLI 中：

hermes skills install servosity/msp-skills/skills/proofpoint --force

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/proofpoint --force

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

为 OpenClaw 安装

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

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

OpenClaw 目前尚未普遍开放；frontmatter 接入配置已预先提供，将在 OpenClaw 发布时立即启用。

身份验证

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

PROOFPOINT_API_SECRET=<value> PROOFPOINT_SERVICE_PRINCIPAL=<value> proofpoint-cli doctor

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

此技能的功能

MSP 经常询问的问题	命令
昨夜有哪些恶意点击和消息成功通过？	proofpoint-cli backfill --since 12h
谁既是 Very Attacked 人员，又是点击次数最多的用户之一？	proofpoint-cli risk-overlap --window 30
给我某个 threatId 的完整事件简报	proofpoint-cli incident "threat-abc123"
应屏蔽这个威胁的哪些指标？	proofpoint-cli iocs --threat-id "threat-abc123" --csv
显示涉及某个用户的所有事件	proofpoint-cli user "[email protected]"
本月有哪些 Very Attacked People？	proofpoint-cli people list-vap --window 30
哪些获准点击和已投递威胁仍需响应？	proofpoint-cli siem list-issues
此活动包含哪些威胁？	proofpoint-cli campaign-threats "campaign-xyz789"
解码这个经 urldefense 重写的链接	proofpoint-cli url --urls "https://urldefense.com/v3/..."

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

与众不同之处

大多数 Proofpoint 集成和 MCP 服务都会将每个问题转发为实时 API 调用。对于单次查询，这没问题。但当你要查询“谁既是 Very Attacked 人员，又在点击”，或“涉及此用户的所有事件”时，这种方式就无法应对规模需求——而且每次调用都会消耗 TAP 每日硬性配额：1,800 次 SIEM 请求和 50 次 campaign-id 查询。

此技能会将 Proofpoint TAP 数据回填到本地 SQLite 镜像中，并提供全文搜索。跨端点问题会转化为一次本地联接：即时、离线，AI 看到的是答案，而不是原始数据。risk-overlap、incident 和 user 等复合命令会联接 SIEM 点击、威胁消息、VAP 状态、点击者状态和取证证据——这是无状态 API 封装无法做到的，而且重新查询不会额外消耗 API 调用。

解决的痛点

在 r/msp 和 Proofpoint 社区论坛中，反复出现的 TAP 投诉并非检测质量，而是 API 及其周边的仪表板体验。Threat Insight SIEM 端点在滚动 24 小时内最多允许 1,800 次请求，且单次调用的时间跨度不能超过 1 小时，因此即使要还原一天内的点击和邮件，也得手动循环调用 API；campaign-ids 端点每天更是仅限 50 次请求。仪表板一次只能回答一个界面上的问题，因此你在响应期间真正会问的问题——哪些人既遭到攻击又点击了链接、哪些事件涉及这位用户、这个活动包含什么内容——都需要跨端点查询，而控制台不会帮你关联这些信息。各团队描述的情况如出一辙：导出数据流、反复拉取相同时间段的数据、在电子表格中重新建立关联，每次都消耗配额。

这个技能只需回填一次，之后便可离线回答问题：

• proofpoint-cli backfill --since 12h - 通过一条命令还原夜间的点击和邮件，并自动循环调用 API 的 1 小时时间窗口。
• proofpoint-cli risk-overlap --window 30 - 找出既属于 Very Attacked 人群又是顶级点击者的人员，并列出攻击指数和点击次数。
• proofpoint-cli incident "threat-abc123" - 根据 threatId 生成一份事件简报，包含严重程度、归因、证据，以及所有涉及该事件的本地记录。
• proofpoint-cli iocs --threat-id "threat-abc123" --csv - 将嵌套的取证树展平为可直接粘贴到 EDR 或阻止列表中的指标表格。
• proofpoint-cli user "[email protected]" - 查看某人的所有点击、威胁邮件、VAP 状态和点击者状态，无需再次消耗 SIEM 配额。

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

常见问题

可以与 ChatGPT 配合使用吗？

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

我的 Proofpoint 数据安全吗？

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

这会耗尽 Proofpoint TAP API 配额吗？

不会——避免这种情况正是它的用途。TAP 在滚动 24 小时内最多允许 1,800 次 SIEM 请求和 50 次 campaign-id 查询。此技能会将数据回填一次到本地 SQLite 存储中，之后便可从该镜像回答重复查询和跨端点问题，因此重新查询某个时间段或循环查询多个用户都不会额外调用 API。只有在你要求获取最新数据时，才会进行实时调用。

我需要特殊的 Proofpoint 合作伙伴 API 或 Essentials 管理员权限吗？

不需要。它使用标准的 TAP（Targeted Attack Protection）服务主体和密钥，这些凭据可在 TAP 控制面板的 Settings > Connected Applications 下创建。它会读取你的账户已开放的 Threat Insight 端点；无需 Proofpoint Essentials 管理员权限，也无需加入单独的合作伙伴计划。

它会取代我的 Proofpoint TAP 控制面板吗？

不会——它是对控制面板的补充。控制面板仍用于配置和深入查看单个威胁。此技能可提供门户从未开放的跨端点汇总信息，例如遭受攻击并点击链接的用户重叠情况、按用户排列的时间线，以及一次性事件简报；AI Agent 可调用此技能，并根据你自己的同步数据作答。

费用是多少？

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

安全模型

层级	示例	建议的 Agent 策略
读取	siem list-issues、people list-vap、campaign-threats、threat、incident、iocs、forensics、risk-overlap、user、url、search、export、sync、workflow status	允许
写入（常规）	import（通过 API 创建/更新批量导入数据）	使用 --dry-run 预览，再经审核后写入
凭据 / 安全	auth set-token、auth logout（管理本地存储的 TAP 凭据）	仅限人工介入

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

状态

Beta 版。已根据 Proofpoint 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-06-07。