Huntress MCP

Huntress + AI - ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini、およびMCPを話すあらゆるエージェント向け

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

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

Huntressのすべてのエンドポイントに加え、APIや公式MCPでは提供できない、フリート全体のインシデント、カバレッジ、請求の集計を可能にするローカル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エージェント	Huntressスキルのインストール方法
Claude Desktop	インストーラーを実行し、Settings > Extensionsでhuntress-mcpを登録します（JSONの編集は不要です）。
ChatGPT（有料プラン）	インストーラーを実行し、huntress-mcpをHTTPS経由で公開して、Developer Modeコネクターとして登録します。
Codex CLI	以下のインストールプロンプトを貼り付けます。
Claude Code	以下のインストールプロンプトを貼り付けます。
Claude Cowork	以下のインストールプロンプトを貼り付けます。
GitHub Copilot（VS Code）	インストーラーを実行し、serversキーの下にあるmcp.jsonにhuntress-mcpを追加してから、Agentモードを選択します。

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

MicrosoftおよびGoogleの環境にも対応

導入先は多いものの、正直にお伝えします。これらは、インストールしたローカルバイナリを使う方法ではなく、リモート／エンタープライズ向けの方法です。

エージェント	必要なもの
Microsoft 365 Copilot / Copilot Studio	セルフサービスではありません。huntress-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にも対応しています。以下のインストール方法をご覧ください。MCP経由でCursor、Windsurf、Cline、Continue.dev、Zedでも動作します。ツールごとの詳しい接続方法は**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 で起動します。各ツールは、付属の huntress-cli を呼び出します。2026-09-18 以降にリリースされたバンドルには、この CLI が同梱されています。それ以前のバンドルには MCP サーバーのみが含まれているため、バンドルに付属の CLI がない場合は、先に以下のパス A またはパス B のインストーラーを実行するか、HUNTRESS_CLI_PATH に既存のバイナリを指定してください。詳細： #331。

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

Claude Code プラグインを使う場合は、マーケットプレイスを一度追加してからインストールしてください。ディレクトリ一覧を取得する必要はなく、すぐに使えます。

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

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

これを Claude Code、Codex CLI、または Claude Cowork にコピーしてください。

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

シェルを実行できるエージェントなら、同じプロンプトを使えます。

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

確認：

huntress-cli --version

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

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

macOS / Linux：

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

Windows（PowerShell）：

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

Claude Desktop の .mcpb ユーザー：最新の .mcpb（このセクションの冒頭）をダウンロードし、Settings > Extensions で再度選択してください。Claude Code プラグインのユーザー：/plugin update huntress@msp-skills。

Claude Desktop、GitHub Copilot、Gemini CLI、Microsoft 365 Copilot、またはその他の MCP クライアントに追加する

インストーラーの実行後、エージェントごとの接続方法（エージェントごとのセクションを用意しています。GitHub Copilot の servers キーや、リモートの Microsoft 365 Copilot / Copilot Studio の手順を含みます）については、mcp-install.md と docs/which-agent.md を参照してください。最も簡単なのは Claude Desktop の Settings > Extensions パネルを使う方法です（JSON の編集を希望するユーザー向けに、MCP 設定ブロックを mcp-install.md に記載しています）。

Hermes にインストールする

Hermes CLI から：

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

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

/skills install servosity/msp-skills/skills/huntress --force

Hermes はネイティブで MCP に対応しているため、huntress-mcp サーバーを直接利用することもできます。インストール方法と環境変数は同じです。

OpenClaw にインストールする

OpenClaw エージェントに次の内容を伝えてください（コピーして使えます）。

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

OpenClaw はまだ一般公開されていませんが、フロントマターの接続設定はあらかじめ同梱されており、OpenClaw のリリースと同時に有効になります。

認証する

CLI に必要な認証情報を設定してください（Huntress ポータルから取得します）。

HUNTRESS_API_KEY=<value> HUNTRESS_API_SECRET=<value> huntress-cli doctor

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

このスキルでできること

MSPからよく寄せられる質問	コマンド
すべてのクライアント組織で最も古いインシデントはどれですか？	huntress-cli fleet-incidents --sort age
セキュリティ体制のどこにギャップがありますか？ 古いコールバック、無効化された Defender やファイアウォールはありますか？	huntress-cli coverage-gaps
この IP やファイルハッシュは、いずれかのクライアントに接触しましたか？	huntress-cli blast-radius --indicator 203.0.113.10
実際に導入しているエージェント数より多いライセンス数で請求されていますか？	huntress-cli billing-reconcile
過去 1 週間に応答しなくなったエージェントはどれですか？	huntress-cli stale-agents --days 7
クライアントごとの平均解決時間はどれくらいですか？	huntress-cli mttr --group-by org
前回のシフト以降、フリート全体で何が変わりましたか？	huntress-cli handoff --since 12h
あるクライアントの QBR スコアカードを作成してください。	huntress-cli org-scorecard --org 12345

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

このスキルの特徴

ほとんどの Huntress 連携や MCP サーバーは、質問のたびにライブ API へ転送します。1 件のレコードを扱うなら問題ありません。しかし、「今、クライアント組織 40 件すべてのうち、最も古いインシデントはどれか」や「この攻撃者の IP はほかのテナントにも接触したか」と尋ねるような規模になると、対応できません。ポータルでは組織ごとにしか回答できず、API にも一括で問い合わせる方法がありません。

このスキルは、Huntress のデータを全文検索機能付きの ローカル SQLite ミラーに同期します。集計が必要な質問も、ローカルでの SQL 結合 1 回で解決できるため、即座に、オフラインでも結果を得られます。AI が目にするのは生データではなく、答えです。fleet-incidents、blast-radius、billing-reconcile のような複合コマンドは、すべての組織のインシデントレポート、エージェント、外部ポート、請求書を一度に結合します。これは、ステートレスな API ラッパーではできない処理です。

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

r/msp では、マルチテナント環境の事業者から、Huntress の可視性が組織ごとに限定されるという不満が繰り返し寄せられています。クライアントを横断するネイティブなインシデントキューも、フリート全体のセキュリティ体制を集計する機能も、請求対象のライセンス数と導入済みエージェント数を照合する標準機能もありません。クライアントテナントが 20、40、80 件にもなると、「まずどの火事を消すべきか」を探すためにタブを切り替えることになり、請求数のずれは月末に手作業で発見することになります。

このスキルは、そのギャップを解消します。

• すべてのクライアントを対象にした 1 つのインシデントキュー - huntress-cli fleet-incidents --sort age は、すべての組織の未解決インシデントを古い順に並べ、最も古く緊急度の高いものを先頭に表示します。
• 深刻なものから確認できるセキュリティ体制のギャップ - huntress-cli coverage-gaps は、フリート全体の古いコールバック、無効化された Defender、無効化されたファイアウォールを集計します。
• フリート全体を対象にした影響範囲の調査 - huntress-cli blast-radius --indicator 203.0.113.10 は、すべての組織のインシデント、エージェント、外部ポートにわたり、IP、ハッシュ、ホスト名を関連付けます。
• ライセンス数とエージェント数の照合 - huntress-cli billing-reconcile は、請求対象のライセンス数と実際に導入済みのエージェント数の差を検出します。
• シフトの引き継ぎと QBR - huntress-cli handoff --since 12h と huntress-cli org-scorecard --org 12345 を使うと、繰り返し同期することで、ライブ API では失われる履歴を残せます。

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

よくある質問

ChatGPT で使えますか？

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

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

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

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

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

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

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

Huntress パートナーである必要はありますか？

Huntress アカウントと、ポータルで生成するキーおよびシークレットの API 認証情報が必要です。再販業者の認証情報を使うと、複数アカウントを横断する reseller-rollup を利用できます。単一アカウントの認証情報があれば、その他の機能をすべて利用できます。

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

sync でアカウントのデータを一度ローカルミラーに取り込めば、その後のロールアップや検索はすべてローカルコピーに対して実行されるため、繰り返し質問しても API 呼び出しは発生しません。また CLI は、実行するリクエストに対して設定可能な --rate-limit も遵守します。

Huntress ポータルの代わりになりますか？

いいえ。ポータルを補完するものです。設定や詳細な調査には引き続きポータルをご利用ください。このスキルは、ポータルでは一度に1組織しか表示できない、テナント横断や過去の状況に関する質問に答えます。

費用はいくらですか？

無料です。Apache-2.0 ライセンスです。費用が発生するのは、利用する AI エージェント（Claude、ChatGPT、Codex など）の料金のみで、その請求元は当社ではなく AI プロバイダーです。

安全性モデル

ティア	例	推奨されるエージェントのポリシー
読み取り	fleet-incidents、coverage-gaps、blast-radius、billing-reconcile、mttr、org-scorecard、stale-agents、search	許可
書き込み（通常）	organizations update-parameters、accounts memberships update-parameters、unwanted-access-rules update-parameters	--dry-run でプレビューしてから、レビュー済みの書き込みを実行
破壊的操作／設定	organizations delete-v1-id、accounts delete-v1-id、unwanted-access-rules delete-v1-id	必ず人間が介在

最も強力な制御手段は、Huntress の認証情報に付与するスコープです。CLI で実行できるのは、その認証情報に許可された操作だけです。制限を設定する方法を含む詳細は、governance.md をご覧ください。

ステータス

ベータ版です。Huntress API の各機能に対する検証を完了し、毎週の Build Sessions では、MSP が本番テナントで実際に利用する環境で検証を進めています。compoundingteams.com/build-sessions から参加登録できます。

---

標準規格。 オープンな Agent Skills 仕様（Anthropic、2025年12月、40以上のエージェント）に準拠しています。MCP と互換性があり、Hermes を含む MCP 対応エージェントで利用できます。OpenClaw に対応済みです（フロントマターの設定済み。OpenClaw の公開待ちです）。

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