ThreatLocker MCP

ThreatLocker + AI - ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini、および MCP に対応するすべてのエージェント向け

非公式のコミュニティ開発による、ThreatLocker API 用の Claude Code スキルおよび MCP サーバーです。 ThreatLocker, Inc. とは提携しておらず、同社の承認や後援も受けていません。

_{スキルの全ページ - インストール方法、成果、安全性モデル。}

ThreatLocker Portal API のすべての機能に加え、読み取り専用ツールにない書き込み操作と、他の ThreatLocker ツールにはないテナント横断型のオフラインストアを利用できます。すでにお使いの AI で動作します。ChatGPT（Plus/Pro+、ホスト型 HTTPS エンドポイント経由。詳しくは mcp-install.md をご覧ください）、Claude Desktop、Codex、Claude Code、Claude Cowork、GitHub Copilotに加え、リモート方式でMicrosoft 365 Copilot / Copilot StudioおよびGoogle Geminiにも対応しています。無料のオープンソースで、ノート PC 上で動作します。MSP オーナー向けに開発されており、コードは不要です。

お使いのエージェントで利用できます

MSP オーナーが実際に使っている 6 つのエージェントに対応しています（セルフサービスで、現在利用可能です）。

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

ChatGPT にはリモート HTTPS サーバーが必要です。つまり、このコネクターの HTTP モードを使用します。THREATLOCKER_MCP_HTTP_TOKEN が設定されるまで起動せず、すべてのリクエストでベアラーヘッダーにそのトークンを指定する必要があります。また、ループバック以外のアドレスでは --tls-cert と --tls-key も必要です。詳しくは mcp-install.md をご覧ください。

Microsoft および Google のスタックにも対応

導入基盤は大きいものの、正確にお伝えすると、これらはリモート／エンタープライズ向けの方法であり、インストールしたローカルバイナリを使うものではありません。

エージェント	必要なもの
Microsoft 365 Copilot / Copilot Studio	threatlocker-mcp をベアラートークン付きで HTTPS 経由でホストし（ChatGPT と同じ HTTP モード）、Copilot Studio で Model Context Protocol ツールとして追加します。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 で起動します。すべてのツールは、付属の threatlocker-cli をシェルから実行します。2026-09-18 以降に公開されたリリースでは、この CLI がバンドルに含まれています。それ以前のバンドルには MCP サーバーのみが含まれているため、付属の CLI が見つからない場合は、先に以下のパス A またはパス B のインストーラーを実行してください（または、既存のバイナリへのパスを THREATLOCKER_CLI_PATH に設定してください）。詳細は #331 をご覧ください。

ThreatLocker MCP をダウンロード（.mcpb） - ダウンロード後、Claude Desktop > Settings > Extensions を開き、ファイルを選択してください。ワンクリックで完了し、JSON もシェルも不要です。（すべての ThreatLocker リリースはリリースページでご覧いただけます。）

Claude Code プラグインをご希望ですか？マーケットプレイスを一度追加してからインストールしてください。すぐに使え、ディレクトリ一覧の確認も不要です：

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

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

以下を Claude Code、Codex CLI、または Claude Cowork にコピーしてください：

このエージェントのワークスペースに、Servosity/msp-skills から ThreatLocker Skill と MCP サーバーをインストールしてください。このワークスペースが POSIX シェル（macOS、Linux、WSL、または Bash）を使用している場合は、bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/threatlocker/install.sh) を実行してください。Windows PowerShell を使用している場合は、iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/threatlocker/install.ps1 | iex を実行してください。その後、README に従って認証し、threatlocker-cli --help を実行して使い方を確認してください。

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

パス B - インストーラーを自分で実行する

Windows（PowerShell）：

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

macOS / Linux：

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

インストーラーは、threatlocker-cli（CLI）と threatlocker-mcp（MCP サーバー）の両方を、ユーザーの bin パスに配置します。Claude Code、Codex、Cowork は、このディレクトリ内の SKILL.md を通じて Skill を検出します。

確認：

threatlocker-cli --version

最新バージョンにアップグレードする

インストーラーは常に最新リリースを取得します。アップグレードするには、再度実行してください：

macOS / Linux：

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

Windows（PowerShell）：

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

Claude Desktop の .mcpb ユーザー：最新の .mcpb（このセクションの冒頭）をダウンロードし、Settings > Extensions で再度選択してください。Claude Code プラグインのユーザー：/plugin update threatlocker@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 パネルを使う方法です。MCP 設定ブロック（JSON を手動編集する場合）については mcp-install.md に記載されています。

Hermes にインストールする

Hermes CLI から：

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

Hermes のチャットセッション内で：

/skills install servosity/msp-skills/skills/threatlocker --force

Hermes はネイティブに MCP をサポートしているため、threatlocker-mcp サーバーを直接使用することもできます。インストール手順も環境変数も同じです。

OpenClaw にインストールする

OpenClaw エージェントに以下の内容を伝えてください（コピーして使用できます）：

https://github.com/servosity/msp-skills/tree/main/skills/threatlocker から threatlocker スキルをインストールしてください。このスキルには、必須 CLI（threatlocker-cli）を openclaw: frontmatter ブロック経由でインストールする方法が記載されています。

OpenClaw はまだ一般公開されていません。frontmatter の接続設定はあらかじめ含まれており、OpenClaw のリリースと同時に有効になります。

認証する

CLI に必要な認証情報を ThreatLocker ポータルから設定してください：

THREATLOCKER_API_KEY=<value> threatlocker-cli doctor

doctor は、データにアクセスする操作を実行する前に、認証情報が機能することを確認します。認証情報が拒否された場合でも終了コード 0 を返すため、スクリプトでは --fail-on error を追加してください。

このスキルでできること

MSP からよく尋ねられる質問	コマンド
現在、すべてのクライアントで保留中のアプリケーション承認は何ですか？	threatlocker-cli approvals triage --all-tenants
このファイルハッシュを、保留中のすべての場所で承認しますか？まず計画を確認しますか？	threatlocker-cli approvals approve-batch --hash <sha256> --all-tenants --dry-run
31 日間の保持期限を迎え、監査証跡が失われそうなクライアントはどれですか？	threatlocker-cli audit retention-check
各クライアントのブロックされたファイル（拒否）の監査イベントが期限切れになる前に、すべてローカルに保存しますか？	threatlocker-cli audit pull --since 30d
保存した監査ログを SIEM または監査担当者向けにエクスポートしますか？	threatlocker-cli audit export --all-tenants --since 30d
今週、すべてのテナントで何が変わりましたか？保護の無効化、ポリシーの編集、メンテナンスなど。	threatlocker-cli audit drift --since 7d --all-tenants
すべてのクライアントで、オフラインまたは古い状態の ThreatLocker エージェントはどれですか？	threatlocker-cli devices health --all-tenants
このファイルの実行を要求したテナントとエンドポイント、およびすでに信頼しているアプリケーションはどれですか？	threatlocker-cli applications hunt --hash <sha256>
メンテナンスモードのままになっているエンドポイントはどれですか？	threatlocker-cli maintenance open --older-than 24h
最初に確認が必要なテナントはどれですか？	threatlocker-cli organizations posture

監査行は audit pull で保存したデータを読み込み、その他の行は sync で保存したデータを読み込みます。最初に threatlocker-cli sync と threatlocker-cli audit pull --since 30d を実行し、audit pull は 31 日未満の間隔で定期実行してください。

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

このスキルの特長

ThreatLocker との連携機能や MCP サーバーの多くは、質問ごとに API をリアルタイムで呼び出す仕組みです。1 件のレコードを取得するには問題ありません。しかし、大規模な利用には対応できません。Portal API の対象は一度に 1 つのテナントに限られるため、「40 のクライアントすべてで保留中の承認を、ファイルハッシュで重複を除いて表示して」や「今月、監査証跡を失いそうなクライアントはどれか」と尋ねると、テナントごとにヘッダーを切り替えて再クエリする作業が発生し、AI のコンテキストを消費してしまいます。

このスキルは、ThreatLocker をフルテキスト検索に対応したローカル SQLite ミラーに同期します。集計が必要な質問も、ローカルの SQL 結合 1 回で、即座にオフラインで処理できます。AI に見えるのは生データではなく、答えです。approvals triage、applications hunt、devices health などの複合コマンドは、すべてのテナントにまたがる承認リクエスト、アプリケーション、コンピューター、監査イベントを一度に結合します。これは、ステートレスな API ラッパーではできない処理です。

解決する課題

ThreatLocker はデフォルト拒否方式のため、新規または更新されたアプリケーションはすべて、管理者が承認する必要があります。ThreatLocker 自身の MSP ガイドでも、その件数の多さが認められています。「最初の数社のクライアントをオンボーディングする間、デバイスは学習中のため、かなり多くのイベントが発生する場合があります」（MSP 向け許可リストの設定）。複数のテナントを管理していると、承認待ちのキューが途切れることはなく、ポータルではテナントごとに処理しなければなりません。さらに、証跡の問題もあります。ThreatLocker のヘルプセンターには、_「Unified Audit はデフォルトでデータを 31 日間保持します。31 日を過ぎると情報は完全に削除され、復元できません」_と明記されています（ログの保持期間）。これは、ほとんどのコンプライアンス要件やサイバー保険の要件より短い期間です。

このスキルは、次の両方の課題を解決します。

• approvals triage --all-tenants - すべてのテナントの承認待ちをファイルハッシュで重複排除し、優先順位を付けた単一のキューにまとめます。
• approvals approve-batch --hash <sha256> --all-tenants --dry-run - 安全性が確認されたファイルを、承認待ちのすべてのテナントで許可します。まず実行計画を確認し、実際の処理には --yes が必要です。
• audit pull --since 30d ＋ audit retention-check - 証跡が保持期限切れになる前に、各テナントの拒否イベントをローカルに保存し（--action permit を指定すると許可イベントも追加）、31 日の期限が迫っているテナントにフラグを立てます。audit export を使うと、保存したログを SIEM や監査担当者に渡せます。
• devices health --all-tenants - テナントを一つずつ確認せずに、管理対象全体でオフラインや古いエージェントを見つけます。

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

よくある質問

ChatGPT で使えますか？

はい。Plus、Pro、Team、Business、Enterprise、Education の各プランで利用できます（Free ではまだ Developer Mode を利用できません）。ChatGPT が接続できるのは HTTPS 経由のリモート MCP サーバーのみなので、threatlocker-mcp を HTTP モードでホストしてください。THREATLOCKER_MCP_HTTP_TOKEN が設定されていないと起動せず、すべてのリクエストでそのトークンをベアラーヘッダーとして送信する必要があります。また、ループバック以外のアドレスを使用する場合は、--tls-cert と --tls-key も必要です。認証設定でベアラートークンを送信できるコネクターでのみ動作するため、まずご利用のコネクターの設定をご確認ください。手順は mcp-install.md をご覧ください。

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

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

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

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

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

データはご利用のマシン上に保存されます。CLI と MCP サーバーはローカルバイナリです。SQLite のミラーは、ユーザーアカウント配下のディレクトリに置かれます。AI エージェントから見えるのは CLI が返すデータだけで、通常は一括取得した生データではなく、クエリ結果です。認証情報は環境変数またはエージェントの設定から読み込まれます。このリポジトリに含めたり、MSP Skills がどこかへ送信したりすることはありません。

ThreatLocker API のレート制限に達しますか？

読み取り時に API を呼び出さなくて済むよう、ローカルミラーを用意しています。最初の sync の後は、テナント横断ビュー（approvals triage、audit drift、devices health、applications hunt）はローカルの SQLite に対して実行され、API 呼び出しはゼロです。API を直接呼び出す場合は --rate-limit によるスロットリングを守ります。また、同期は差分方式で、前回のチェックポイント以降に変更されたデータだけを取得します。

ThreatLocker の 31 日間の監査保持期間にはどのように対応していますか？

ThreatLocker の Unified Audit ログでは、デフォルトで約 31 日間分が保持されます。audit pull は、各テナントの拒否イベント（または --action permit を指定した場合は許可イベント）をローカルストアに保存するため、証跡をその保持期間より長く残せます。audit export はデータを JSONL または CSV として書き出し、audit retention-check はテナントごとに、アーカイブが保持期限にどれほど近づいているか、最後の同期がどれほど古いかを報告するため、気付かないうちにデータが期限切れになることはありません。

ThreatLocker の MSP である必要や、子テナントを持つ必要はありますか？

ご自身の ThreatLocker Portal で API アクセスが必要です。テナント横断機能は、子テナントを持つマネージド（親）組織、つまり MSP 環境を前提としていますが、単一の組織でも利用できます。その場合は、1 テナントのビューになります。発行する認証情報が、実際の権限境界となります。

ThreatLocker Portal の代わりになりますか？

いいえ。ポリシーの作成や、対話形式の承認／拒否ワークフローには、引き続き Portal が最適です。このスキルを使うと、AI エージェントでテナント横断のクエリやスクリプト化された書き込みを実行できるため、組織全体に関する質問に答えるために各テナントへログインする必要がなくなります。

費用はいくらですか？

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

安全性モデル

ティア	例	推奨されるエージェントポリシー
読み取り	approvals triage、audit drift、audit retention-check、audit export、devices health、applications hunt、maintenance open、organizations posture、search。sync と audit pull はローカルストアへの書き込みのみ	許可
書き込み（通常）	approvals approve／approve-batch（ライブ実行には --yes が必要）、applications create／update、policies create／copy／deploy、computers maintenance／enable-protection／restart-service	--dry-run でプレビューしてから、レビュー済みの書き込みを実行
認証情報	organizations auth-key、computers install-info（どちらもテナントのエージェントインストールキーを返します。CLI 専用で、MCP 経由では提供されず、キャッシュや保存もされません）	必ず人間が介在
破壊的操作／設定	computers delete、policies delete	必ず人間が介在

最も強力な制御策は、ThreatLocker の認証情報に付与するスコープです。CLI で実行できるのは、その認証情報に許可された操作のみです。ロックダウンの方法を含む詳細は、governance.md をご覧ください。

ステータス

ライブ環境で検証済みです。@geekbrownbear（MSP）が自身の本番テナントで確認済みです（検証記録）。毎週開催している Build Sessions では、ほかの MSP も実運用しています。compoundingteams.com/build-sessions から参加登録してください。

---

標準規格。 オープンな Agent Skills spec（Anthropic、2025 年 12 月。40 以上のエージェント）に準拠しています。MCP 互換で、Hermes を含む MCP 対応エージェントで利用できます。OpenClaw に対応済みです（frontmatter の事前設定済み。OpenClaw のリリース待ち）。

Servosity がメンテナンスしています。Apache-2.0 ライセンスで提供しています。CLI Printing Press で構築しました。最終更新日：2026-06-05。