KnowBe4 MCP

KnowBe4 + AI - ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini、および MCP に対応したあらゆるエージェント向け

非公式です。KnowBe4 API 向けにコミュニティが構築した Claude Code スキルおよび MCP サーバーです。KnowBe4, Inc. との提携、承認、または後援を受けていません。

_{▶ 30 秒のデモを見る - デモデータはシミュレーションですが、表示されているコマンドはすべて実際の CLI に存在します。}

KnowBe4 KMSAT のすべてのレポート機能に、ローカルの SQLite ストアを組み合わせました。コンソールでは答えられないクライアント横断の質問、つまり繰り返しクリックするユーザーの特定や、トレーニング受講状況の未対応者の抽出に対応します。すでにお使いの AI - ChatGPT（Plus/Pro+）、Claude Desktop、Codex、Claude Code、Claude Cowork、GitHub Copilot - で動作します。さらに、リモート方式で Microsoft 365 Copilot / Copilot Studio と Google Gemini にも対応しています。無料のオープンソースで、ノート PC 上で動作します。MSP オーナー向けに構築されており、コードは不要です。

お使いのエージェントに対応

MSP オーナーが実際に使用している 6 つのエージェントでセルフサービスによるセットアップが可能で、すぐに利用できます。

AI エージェント	KnowBe4 スキルのインストール方法
Claude Desktop	インストーラーを実行し、Settings > Extensions から knowbe4-mcp を登録します（JSON の編集は不要です）。
ChatGPT（有料プラン）	インストーラーを実行し、knowbe4-mcp を HTTPS 経由で公開して、Developer Mode コネクターとして登録します。
Codex CLI	以下のインストール用プロンプトを貼り付けます。
Claude Code	以下のインストール用プロンプトを貼り付けます。
Claude Cowork	以下のインストール用プロンプトを貼り付けます。
GitHub Copilot（VS Code）	インストーラーを実行し、mcp.json の servers キーの下に knowbe4-mcp を追加してから、Agent モードを選択します。

ChatGPT では、knowbe4-mcp --transport http を実行し、HTTPS の背後で公開します。ブリッジパッケージは不要です。mcp-install.md を参照してください。

Microsoft と Google の各環境にも対応

広くインストールされていますが、率直にお伝えします。これらは、インストールしたばかりのローカルバイナリではなく、リモート／エンタープライズ方式です。

エージェント	必要なもの
Microsoft 365 Copilot / Copilot Studio	セルフサービスではありません。 knowbe4-mcp を HTTPS 経由でホストし、Copilot Studio（Tools > Add a tool > Model Context Protocol > Server URL）または宣言型エージェントに接続します。Copilot Studio ライセンスとテナント管理者権限が必要です。mcp-install.md を参照してください。
Google Gemini	Gemini CLI はローカルで動作し、Claude Code と同様です。Gemini アプリはリモートで動作し、ChatGPT と同じ HTTPS 方式です。mcp-install.md を参照してください。

スキルネイティブのエージェント（こちらも対応）： Hermes と OpenClaw は、このスキルの SKILL.md を直接読み込み、MCP にも対応しています。以下の各インストール手順を参照してください。Cursor、Windsurf、Cline、Continue.dev、Zed でも MCP 経由で動作します。ツールごとの完全な接続手順はこちらをご覧ください：docs/which-agent.md。

複数のエージェントを使用していますか？ 1 つのコマンドで、対応する 51 以上のエージェントすべてにインストールできます：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 で起動します。すべてのツールは、同梱の knowbe4-cli を呼び出します。2026-09-18 以降に公開されたリリースでは、この CLI がバンドル内に含まれています。それ以前のバンドルには MCP サーバーのみが含まれているため、同梱の CLI がない場合は、まず以下の Path A または Path B のインストーラーを実行してください（または、既存のバイナリを KNOWBE4_CLI_PATH に設定してください）。詳細： #331。

KnowBe4 MCP（.mcpb）をダウンロード - 次に Claude Desktop > Settings > Extensions を開き、ファイルを選択します。ワンクリックで完了し、JSON もシェルも不要です。（リリースページで KnowBe4 のすべてのリリースを確認できます。）

Claude Code プラグインを使う場合は、マーケットプレイスを一度追加してからインストールしてください。ディレクトリの一覧表示は不要で、すぐに動作します。

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

Path A - AI エージェントにプロンプトを 1 つ貼り付ける（推奨）

これを Claude Code、Codex CLI、または Claude Cowork にコピーします。

このエージェントのワークスペースに、Servosity/msp-skills から KnowBe4 Skill と MCP サーバーをインストールしてください。このワークスペースが POSIX シェル（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 を実行して確認してください。

シェルを実行できるエージェントであれば、同じプロンプトを使用できます。

Path 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 を参照してください。GitHub Copilot の servers キーや、リモートの Microsoft 365 Copilot / Copilot Studio の手順を含め、エージェントごとにセクションがあります。最も簡単なのは Claude Desktop の Settings > Extensions パネルを使う方法です。JSON の編集を希望するユーザー向けの MCP 設定ブロックは、mcp-install.md に記載されています。

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 エージェントに次の内容を伝えてください（コピーして使用します）。

https://github.com/servosity/msp-skills/tree/main/skills/knowbe4 から knowbe4 スキルをインストールしてください。このスキルでは、必須 CLI（knowbe4-cli）を openclaw: フロントマターブロックからインストールする方法を定義しています。

OpenClaw はまだ一般公開されていません。フロントマターの接続設定はあらかじめ組み込まれており、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
クライアントの四半期レビュー全体を、1つのコマンドでまとめる	knowbe4-cli qbr --since 90d
シミュレーションによるフィッシングメールを一度も報告しないのは誰ですか？	knowbe4-cli report-rate --bottom 25

コマンドの全リファレンスはguide.mdをご覧ください。AI エージェントの操作契約（--agent、--dry-run、変更を加える前に確認すべきタイミング）については、AGENTS.mdをご覧ください。

このスキルの特徴

KnowBe4 の一般的なインテグレーションや MCP サーバーでは、各質問をライブ API 呼び出しに中継します。1件のレコードを調べるなら問題ありません。しかし、「今四半期、40のクライアントテナント全体で何度もクリックした人は誰か」のような質問をすると、規模が大きくなるにつれて対応できなくなります。この質問に答えられる KnowBe4 のエンドポイントは1つもありません。

このスキルは、KnowBe4 のデータを全文検索機能付きのローカル SQLite ミラーに同期します。集計が必要な質問は、ローカルの SQL 結合1回で処理できます。即座にオフラインで結果を得られ、AI には生データではなく回答が表示されます。repeat-clickers、untrained-clickers、qbr などの複合コマンドは、フィッシングテスト、トレーニングの受講登録、リスクスコアのスナップショットを横断して結合します。KnowBe4 ではこれらのレコードが別々のレポートに分かれているため、ステートレスな API ラッパーでは実現できない処理です。

このスキルで解消できる課題

r/msp で繰り返し話題になる KnowBe4 の不満は、製品そのものではなくレポート機能です。KMSAT コンソールでは、一度に確認できるのは1つのテナント、1つのフィッシングテスト、1つのリスクチャートだけです。そのため、クライアント間やテスト間の比較が必要になると、CSV をエクスポートしてピボットテーブルを作ることになります。最も大きな課題は相関分析です。フィッシングテストの結果とトレーニングの修了状況が別々のレポートにあるため、vCISO が管理する最も有用なリスト（フィッシングメールをクリックしたのに、トレーニングを修了していない人のリスト）がポータルに存在しません。このスキルは、untrained-clickers（アンチ結合）、repeat-clickers（すべてのテストを通じて最もリスクの高い人）、risk-drift（悪化している人）、coverage-gaps（プログラムの対象から漏れている人）、qbr（四半期レビュー全体を1つのコマンドで実行）で、この課題を解消します。

詳しい説明は pain-point.mdをご覧ください。

よくある質問

ChatGPT で使えますか？

はい、Plus、Pro、Team、Business、Enterprise、Education の各プランで使用できます（Free プランでは、現時点で Developer Mode を利用できません）。ChatGPT は、ローカルの stdio バイナリではなく、HTTPS 経由でリモート MCP サーバーに接続します。KnowBe4 MCP サーバーはローカルで動作しますが、HTTP にネイティブ対応しています。knowbe4-mcp --transport http --addr :7777 で起動し、HTTPS トンネルまたは独自のリバースプロキシの背後に配置してください。ブリッジパッケージは必要ありません。手順についてはmcp-install.mdをご覧ください。

Codex、Cursor、Windsurf、Cline、Copilot、Gemini で使えますか？

はい。どれも MCP に対応しています。各ツールのインストールコマンドは上記の一覧と、docs/which-agent.mdの詳しい説明をご覧ください。

コーディングの知識は必要ですか？

いいえ。推奨するインストール方法は、Claude Code または Codex に1文を貼り付けることです。エージェントが SKILL.md を読み取り、インストールを行います。別の方法として、OS ごとに1行のインストーラー（bash または PowerShell）も用意されています。どちらの方法でも、コードを書く必要はありません。KnowBe4 の認証情報を一度入力するだけです。

KnowBe4 のデータは安全ですか？

データはお使いのマシンに保存されます。CLI と MCP サーバーはローカルバイナリです。SQLite ミラーは、ユーザーアカウント内のディレクトリに保存されます。AI エージェントが参照できるのは CLI が返す内容のみで、通常はクエリ結果であり、生の一括データではありません。認証情報は環境変数またはエージェントの設定から読み込まれます。MSP Skills によってこのリポジトリに含められたり、どこかに送信されたりすることはありません。

KnowBe4 コンソールの代わりになりますか？ 特別なパートナー API が必要ですか？

どちらでもありません。標準の KMSAT Reporting API キー（Account Settings - API - enable Reporting API）と、お使いのリージョン（us、eu、ca、uk、de）を使用します。アカウントですでに公開されているデータを読み取り、コンソールでは利用できないクライアント横断の集計を追加します。ポータルを補完するものであり、置き換えるものではありません。

KnowBe4 独自のダッシュボードや Virtual Risk Officer とはどう違いますか？

コンソールと VRO では、テナントごとのダッシュボードを利用できます。このスキルは、クライアント横断・テスト横断の集計と、ポータルでは確認できないアンチジョインを追加します。たとえば、すべてのフィッシングテストを通じた再クリックユーザー、全ユーザーを対象にリスクの変動を順位付けした結果、クリックしたもののトレーニングを受けていないユーザーへの対処リストなどを、同期済みの独自データから AI エージェントが作成します。

AI は KnowBe4 アカウントの情報を変更できますか？

同梱の MCP サーバーは読み取り専用で、レポート用のツールのみを公開します。書き込み処理は CLI のみで実行でき、--dry-run でプレビューできます。events create／events delete はカスタムリスクイベントを追加または削除します（これらには、別途オプトインが必要な User Event API キーを使用します）。import は標準の Reporting API キーを通じてレコードを一括アップサートします。governance.md を参照してください。

費用はいくらですか？

無料です。Apache-2.0 ライセンスです。お使いの AI エージェント（Claude、ChatGPT、Codex など）の利用料金のみがかかり、その料金は当社ではなく AI プロバイダーから請求されます。

安全性モデル

ティア	例	推奨されるエージェントポリシー
読み取り	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 を参照してください。

ステータス

ベータ版です。KnowBe4 API の仕様に対する検証を完了し、週次の Build Sessions で実際に本番テナントに接続して運用する MSP を対象に検証中です。compoundingteams.com/build-sessions から参加登録してください。

---

標準規格。 オープンな Agent Skills 仕様（Anthropic、2025 年 12 月、40 以上のエージェント）に準拠しています。MCP に対応しており、Hermes を含む MCP 対応エージェントで動作します。OpenClaw に対応済み（frontmatter は設定済み、OpenClaw のリリース待ち）。

Servosity がメンテナンスしています。Apache-2.0 ライセンスです。CLI Printing Press を使用して構築されています。最終更新日：2026-06-06。