KnowBe4 MCP

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

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

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

KnowBe4 KMSAT 的全部报告功能，加上一个本地 SQLite 存储，用于回答控制台无法回答的跨客户端问题——反复点击者排查和培训覆盖率反连接查询。可与您已经在使用的 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	如何安装 KnowBe4 技能
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 knowbe4-mcp（无需编辑 JSON）。
ChatGPT（付费套餐）	此连接器重新发布前暂停使用：ChatGPT 需要 HTTP 模式，而此版本的该模式不需要密码、会监听所有网络接口，且您打开的网页可以访问它。请参阅 mcp-install.md 中的安全提示。
Codex CLI	粘贴下面的安装提示词。
Claude Code	粘贴下面的安装提示词。
Claude Cowork	粘贴下面的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 knowbe4-mcp，然后选择 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 app 是远程版本，需要使用与 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 上运行。每个工具都会调用配套的 knowbe4-cli。自 2026-09-18 起发布的版本会将该 CLI 一同打包；较早的安装包仅包含 MCP 服务。因此，如果你的安装包缺少配套 CLI，请先运行下方的路径 A 或路径 B 安装程序（或将 KNOWBE4_CLI_PATH 设为现有二进制文件的路径）。详情请参阅 #331。

下载 KnowBe4 MCP（.mcpb）——然后打开 Claude Desktop > Settings > Extensions 并选择该文件。一键完成，无需 JSON，也无需使用 Shell。（前往 发布页面查看所有 KnowBe4 版本。）

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

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

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

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

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

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

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

knowbe4-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

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

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/knowbe4 --force

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

为 OpenClaw 安装

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

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

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

身份验证

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

KNOWBE4_API_KEY=<value> KNOWBE4_REGION=<value> knowbe4-cli doctor

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

此技能的功能

MSP 经常提出的问题	命令
谁在不止一次的钓鱼测试中点击了诱饵？	knowbe4-cli repeat-clickers --min-clicks 2 --since 90d
谁点击了钓鱼邮件却从未通过培训？	knowbe4-cli untrained-clickers --since 180d
本季度谁的风险评分在上升？	knowbe4-cli risk-drift --window 90d --worsened --top 20
哪些活跃用户完全没有培训或钓鱼防护？	knowbe4-cli coverage-gaps
Finance 组的培训是否真的有效？	knowbe4-cli phish-prone-trend --group "Finance" --since 12mo
哪些用户的风险最高，评分依据是什么？	knowbe4-cli risk-leaderboard --top 25
哪些部门正在推高我们的风险？	knowbe4-cli group-risk-contribution --window 90d --top 10
用一条命令汇总完整的客户端季度审查	knowbe4-cli qbr --since 90d
谁从不报告模拟钓鱼邮件？	knowbe4-cli report-rate --bottom 25

完整命令参考：guide.md。关于 AI Agent 操作约定（--agent、--dry-run，以及在更改数据前何时需要确认），请参阅 AGENTS.md。

与众不同之处

大多数 KnowBe4 集成和 MCP 服务都会将每个问题转发为实时 API 调用。这适合查询单条记录。但当你要问“本季度 40 个客户租户中，哪些人反复点击了钓鱼邮件？”时，这种方式就无法胜任，因为 KnowBe4 没有任何单一端点能回答这个问题。

此技能会将 KnowBe4 数据同步到带有全文搜索功能的本地 SQLite 镜像中。汇总类问题只需执行一次本地 SQL 联接：响应即时、可离线使用，AI 看到的是答案，而非原始数据。repeat-clickers、untrained-clickers 和 qbr 等复合命令会联接钓鱼测试、培训报名和风险评分快照的数据；无状态 API 封装器无法做到这一点，因为 KnowBe4 将这些记录分别保存在不同的报告中。

解决的痛点

在 r/msp 上，反复出现的 KnowBe4 投诉针对的是报告功能，而不是产品本身：KMSAT 控制台一次只能回答一个租户、一次钓鱼测试或一张风险图表的问题，因此任何跨客户端或跨测试的问题都会变成导出 CSV 和制作数据透视表。最难解决的缺口在于关联分析——钓鱼测试结果和培训完成情况分属不同报告，因此 vCISO 最需要的名单（点击了钓鱼链接却从未完成培训的人）在门户中并不存在。此技能通过 untrained-clickers（反连接）、repeat-clickers（所有测试中风险最高的人）、risk-drift（风险正在恶化的人）、coverage-gaps（你的计划未能覆盖到的人）以及 qbr（一条命令生成完整的季度审查）填补了这一缺口。

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

常见问题

这适用于 ChatGPT 吗？

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

我的 KnowBe4 数据安全吗？

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

这会取代 KnowBe4 控制台吗？是否需要特殊的合作伙伴 API？

两者都不是。它使用标准的 KMSAT Reporting API 密钥（Account Settings - API - enable Reporting API）和你的区域（us、eu、ca、uk 或 de）。它读取你的账户已经开放的数据，并补充控制台不提供的跨客户端汇总数据。它与门户配合使用，而不是取代门户。

这与 KnowBe4 自带的仪表板和 Virtual Risk Officer 有什么不同？

控制台和 VRO 提供单租户仪表板。此技能增加了跨客户端、跨测试的汇总分析，以及门户从未提供的反连接查询——涵盖所有钓鱼测试中的重复点击者、按风险对所有用户排名的风险变化趋势，以及点击钓鱼链接但未完成培训的补救名单；所有分析都基于你自己的同步数据，并由你的 AI Agent 驱动。

AI 能修改我的 KnowBe4 账户中的任何内容吗？

捆绑的 MCP 服务是只读的——它只提供报告工具。写入操作仅限 CLI，并支持通过 --dry-run 预览：events create / events delete 可添加或移除自定义风险事件（这两项操作使用单独的、需主动启用的 User Event API 密钥），import 则通过标准 Reporting API 密钥批量新增或更新记录。请参阅 governance.md。

费用是多少？

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

安全模型

层级	示例	建议的 Agent 策略
读取	account info、users list、groups list、phishing-tests list、training-enrollments list、risk-leaderboard、repeat-clickers、sync、search、qbr	允许
写入（常规）	events create（推送自定义风险事件）、import（从 JSONL 批量创建/更新）	使用 --dry-run 预览，然后在审核后写入
破坏性操作 / 配置	events delete（从用户时间线中移除自定义风险事件）	仅限人在环路中操作

MCP 服务仅开放读取层级。写入和破坏性操作层级仅限 CLI；events 命令使用单独的、需主动启用的 KNOWBE4_USER_EVENT_API_KEY，而 import 则使用你的标准 KNOWBE4_API_KEY 写入。

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

状态

Beta 版。已针对 KnowBe4 API 功能进行了验证，并正在每周的 Build Sessions 中与使用自有生产租户运行该工具的 MSP 一起验证。请通过 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。