Avanan MCP

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

非公式です。Avanan API 用の、コミュニティが構築した Claude Code Skill および MCP サーバーです。Check Point との提携、推奨、または後援を受けていません。 Avanan および Harmony Email & Collaboration は、Check Point Software Technologies Ltd. の商標です。

すべての Avanan（Check Point Harmony Email and Collaboration）API 操作に加え、シフト開始時のトリアージ、フィッシングキャンペーンのクラスタリング、単一メッセージのライフサイクルタイムライン、7 つすべてのセキュリティエンジンを横断する例外検索 1 件、さらにステートレスな API ミラーでは 1 回の呼び出しで回答できない、テナント横断の MSP フリート集計に対応しています。すでにお使いの 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 エージェント	Avanan スキルのインストール方法
Claude Desktop	インストーラーを実行し、Settings > Extensions で avanan-mcp を登録します（JSON の編集は不要です）。
ChatGPT（有料プラン）	インストーラーを実行し、avanan-mcp を HTTPS 経由で公開して、Developer Mode コネクターとして登録します。
Codex CLI	下記のインストールプロンプトを貼り付けます。
Claude Code	下記のインストールプロンプトを貼り付けます。
Claude Cowork	下記のインストールプロンプトを貼り付けます。
GitHub Copilot（VS Code）	インストーラーを実行し、mcp.json の servers キーの下に avanan-mcp を追加してから、Agent モードを選択します。

ChatGPT の場合、Avanan MCP サーバーは stdio です。ChatGPT で使用するには、supergateway ブリッジまたは独自のエンドポイントを介して HTTPS 上に公開します。mcp-install.md を参照してください。

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

導入実績の多いサービスですが、先に正直にお伝えします。こちらはリモート／エンタープライズ向けの方法で、インストールしたローカルバイナリを使う方法ではありません。

エージェント	必要なもの
Microsoft 365 Copilot / Copilot Studio	セルフサービスではありません。 avanan-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 を参照してください。

60 秒でインストール

Claude Code プラグインを使いたい場合は、マーケットプレイスを一度追加してからインストールします：

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

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

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

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

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

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

確認：

avanan-cli --version

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

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

macOS / Linux:

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

Windows（PowerShell）:

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

Claude Code プラグインのユーザー：/plugin update avanan@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/avanan --force

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

/skills install servosity/msp-skills/skills/avanan --force

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

OpenClaw 用にインストールする

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

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

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

認証する

CLI に必要なアプリケーション認証情報（Avanan ポータル > Settings > API Keys）を設定し、お使いのリージョンのセッショントークンを発行します。

export AVANAN_APP_ID=<your application id>
export AVANAN_CLIENT_SECRET=<your client secret>
avanan-cli auth login --region us --save
avanan-cli doctor

doctor は認証情報が有効かどうかを確認し、データにアクセスするコマンドを実行する前に、使用される 2 種類の認証方式のどちらかと、解決されたリージョンホストを表示します。認証情報が拒否された場合でも終了コード 0 を返すため、スクリプトでは --fail-on error を追加してください。

Avanan の認証情報について、あらかじめ知っておくべき点が 2 つあります。

• --since はメッセージの日付ではなく、Avanan への取り込み時刻を対象にフィルタリングします。 API の startDate / endDate は entityCreated（Avanan がメッセージをスキャンした時刻）に対応します。 通常は受信ヘッダーの時刻と数秒以内の差ですが、1 時間以上遅れることもあります。そのため、指定した期間内に届いたメールでも、期間後にスキャンされると対象から漏れることがあります。メッセージの経過時間を前提にせず、期間を広げてください。
• アクションには汎用のエンティティタイプではなく、SaaS のエンティティタイプが必要です。 検疫と復元では office365_emails_email または google_mail_email を指定します。remediate はエンティティからこの情報を解決し、--entity-type で上書きできます。
• リージョンは厳密に分離されています。 認証情報はリージョンごとに発行され、設計上、リージョンをまたぐ読み取りは拒否されます。そのため、USA キーで EU テナントのデータが返されなくても、キーが壊れているわけではありません。有効なリージョンは us、eu、ca、ap、uk、uae、in に加え、Infinity Portal ゲートウェイ用の infinity と infinity-us です。それ以外の Infinity Portal ゲートウェイにはリージョンコードがありません。CLI から --base-url または AVANAN_BASE_URL を指定してください。
• 1 つのアプリケーション認証情報で、多数のテナントにアクセスできます。 avanan-cli scopes を実行すると、認証情報が対象とする {farm}:{tenant} スコープを正確に確認できます。これが最適な管理手段でもあります。認証情報が 1 つのテナントだけに紐づいている場合、フリート全体にアクセスできなくなります。governance.md を参照してください。

問い合わせる前に同期する

テナントをまたぐ回答の多くは、ローカルミラーから取得されます。まず一度データを取り込みます。

avanan-cli mirror --since 7d
avanan-cli sync --resources msp

mirror と sync は Avanan API に対して読み取り専用で実行され、ユーザーアカウント内の SQLite ファイルに書き込みます。より新しいデータが必要なときは、再実行してください。オフラインコマンド（triage、campaign、timeline、exceptions find、exceptions audit、msp fleet）はミラーのみを読み取ります。データが取り込まれていないストアに対しては、ライブで一括問い合わせに切り替えることなく、結果が空であることを報告します。

このスキルでできること

MSPからよく聞かれる質問	コマンド
勤務開始から現在までに、Avananはテナント全体で何を検知しましたか？	avanan-cli triage --since 24h
この40件の検知は1つのフィッシングキャンペーンですか？それとも40件の問題ですか？	avanan-cli campaign --since 7d
ユーザーが隔離に異議を申し立てています。このメッセージには実際に何が起きましたか？	avanan-cli timeline <entity-id>
このドメイン、送信者、URL、またはハッシュは、すでにどこかで例外に設定されていますか？	avanan-cli exceptions find example.com
どの例外が互いに矛盾していますか？または、ミラーリング対象期間中にトラフィックと一致しなかった例外はどれですか？	avanan-cli exceptions audit
席数の上限を超えているテナントや、いつもと異なる状況にあるテナントはどれですか？	avanan-cli msp fleet
このバッチを隔離し、メッセージごとの実際の結果を教えてください	avanan-cli remediate quarantine --entity <id> --scope <farm:tenant> --wait
認証と接続は実際に機能していますか？	avanan-cli doctor

コマンドの完全なリファレンスはguide.mdを参照してください。AIエージェントの運用上の取り決め（--agent、--dry-run、変更前に確認すべき状況）については、AGENTS.mdを参照してください。

これが他と異なる点

Avananには、Cortex XSOAR、Microsoft Sentinel、n8n、およびコミュニティ製のMCPサーバーが2つ、すでに連携機能として用意されています。いずれも別の製品内で動作するプラグインであり、すべてステートレスです。質問1つにつきAPI呼び出しが1回行われ、履歴は残りません。ターミナルネイティブなツールはなく、2つのテナントや2日間にまたがる質問に答えるには、HTTP 429を返し、クォータも公開していないAPIに対して、追加のN回の呼び出しが必要になります。

このスキルは、イベント、エンティティ、例外、MSPオブジェクトをローカルのSQLiteミラーに同期するため、こうした質問にもローカルでの結合1回で答えられます。これにより、「検知が400件あります」を「キャンペーンは3件あり、そのうち1件はまだ40%が修復されていません」に変えられます。

また、公開仕様より多くのAPIをカバーしています。SwaggerHubの仕様には、認証エンドポイント、セキュリティツールごとの例外機能一式、SOARおよびダウンロード用ヘルパーが記載されていません。これらは、ベンダーのリファレンスサイトに記載され、実際に提供されているXSOARおよびSentinelのコードでも使用されている約15個の操作です。このスキルは、それらすべてに対応しています。

さらに、リクエスト署名を正しく実装しています。従来のハンドシェイクではreqId + appId + date + requestString + secretに署名します。requestStringは認証以外のすべての呼び出しに必要ですが、公開ドキュメントには記載されていません。そのため、署名に使った文字列と異なる方法でクエリ文字列を構築するクライアントは、認証情報の誤りとまったく同じように見える401エラーを受け取ります。このCLIでは、署名と送信に同じコードパスを使用しています。

このツールで解決できる課題

• イベントエンドポイントは検出結果を返しますが、分類はしません。そのため、シフト開始時に、1 時間前に実行したクエリをもう一度スクロールすることになります。avanan-cli triage は、脅威の種類、深刻度、状態ごとに、検出数を押し上げている送信者ドメインとあわせて概要を返します。
• 検出結果をグループ化する機能がないため、ある 1 件のフィッシング攻撃と、無関係な 40 件の問題を見分けるには、エクスポートを送信者と件名で並べ替える必要があります。avanan-cli campaign はそれらをクラスタリングし、受信者の広がりと修復の状態を表示します。
• 係争中の隔離案件を調べるには、3 つのエンドポイントにまたがる 5 回の検索が必要で、タスクの記録は期限切れになります。avanan-cli timeline は、ミラーが保持する情報とこの CLI が送信した情報から、1 通のメッセージの履歴を順序どおりに事後再構成します。
• 例外は、パスの形式、ID の方式、削除の動作が異なる 7 つのエンジンと 9 つのテーブルに分散しており、「すでに例外として登録されているか」に答える手段がありません。avanan-cli exceptions find は、それらすべてを一度に検索します。avanan-cli exceptions audit は、矛盾、重複、ミラーの対象期間中にトラフィックと一致していないエントリを見つけます。
• アクションは非同期で、対象範囲は単一です。エンドポイントはタスク ID を返し、複数テナントに紐づく認証情報を指定すると、説明のない HTTP 400 エラーを返します。avanan-cli remediate はタスクの完了を待ち、アイテムごとの実際の結果を報告して、その 400 エラーを、実際に対象にできる範囲を示すエラーに置き換えます。

詳しい説明は pain-point.md を参照してください。

よくある質問

ChatGPT で使えますか？

はい、Plus、Pro、Team、Business、Enterprise、Education プランで利用できます（Free プランでは、現時点で Developer Mode を利用できません）。ChatGPT は、ローカルの stdio バイナリではなく、HTTPS 経由で リモート MCP サーバーに接続します。Avanan MCP サーバーはローカルで動作するため、ChatGPT で使うには、supergateway ブリッジまたは独自の 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）も用意しています。どちらの方法でも、コードを書く必要はありません。Avanan のアプリケーション ID とクライアントシークレットを一度入力するだけです。

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

データはお使いのマシンに保存されます。CLI と MCP サーバーはローカルバイナリで、MCP サーバーは stdio のみを使用するため、ネットワークリスナーを開きません。SQLite ミラーは、ユーザーアカウント配下のディレクトリに保存されます。AI エージェントに表示されるのは CLI が返す内容のみで、通常はクエリ結果であり、生の一括データではありません。メッセージ本文と生の .eml ファイルは、名前を指定したメッセージを明示的に要求した場合にのみ取得されます。認証情報は環境変数またはエージェントの設定から読み込まれます。このリポジトリに含められたり、MSP Skills によってどこかへ送信されたりすることはありません。

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

ほとんどの場合、達しません。このスキルはデータを一度ローカルの SQLite にミラーし、その後はローカルデータから回答するため、オフラインコマンドの実行で API クォータは消費されません。Avanan はクォータ数を公開していませんが、HTTP 429 を返します。そのため、クライアントは自動的にリクエスト間隔を空けます。ミラーの作成後は、6 つのオフラインコマンドの実行に費用はかかりません。

MSP アカウントが必要ですか？ 単一テナントでも使えますか？

どちらでも使えます。msp コマンドとフリートの集計には、複数のテナントに紐づくアプリケーション認証情報が必要です。一方、トリアージ、キャンペーン、タイムライン、例外の検索、検索、修復は、単一テナントの認証情報でも問題なく動作します。

Avanan の認証情報を別のリージョンで使うと失敗するのはなぜですか？

Avanan のリージョンは相互に完全に分離されており、認証情報はリージョンごとに発行されます。そのため、USA のキーで EU のデータを読み取ることは設計上できません。avanan-cli auth login --region <us|eu|ca|ap|uk|uae|in|infinity|infinity-us> --save でリージョンを一度設定してください。それ以外のゲートウェイにある Infinity Portal テナントにはリージョンコードがないため、代わりに avanan-cli auth login --base-url https://<your-infinity-gateway> --save を設定します。avanan-cli doctor は解決されたホストを表示します。

隔離と復元でスコープの指定を求められるのはなぜですか？

Avanan のアクションエンドポイントはスコープを正確に1つだけ受け付けます。複数テナントに対応する認証情報を指定してスコープを省略すると、キーが無効であるかのようなHTTP 400を返します。これは、このAPIで最もよくある連携上の落とし穴です。remediate はこのエラーを、認証情報が実際にカバーするスコープを示すメッセージに変換します。そのため、メールボックスに影響する書き込みが、指定していないテナントに実行されることはありません。

Check Point のファイアウォール製品やエンドポイント製品にも対応していますか？

いいえ。対象は Avanan / Harmony Email and Collaboration のみです。メールとSaaSコラボレーションのセキュリティを扱います。Check Point のシステムログと監査ログは、別の Infinity Portal API にあり、このツールの対象外です。

Avanan ポータルに取って代わるものですか？

いいえ。ポータルを補完するものです。セキュリティポリシーのルールとエンジン設定はポータルでのみ行えます。API が公開しているのは例外であり、ポリシーではありません。このスキルは質問に答え、ポータルでは時間がかかる一括処理を実行します。

費用はかかりますか？

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

安全性モデル

ティア	例	推奨されるエージェントポリシー
読み取り	triage、campaign、timeline、exceptions find、exceptions audit、msp fleet、event query、scopes、search、mirror、sync、export、および以下のティアに記載されていない list / get コマンド	許可
メッセージ内容の外部送信	download、download-large-email、avanan-search get-saas-entity（soar get-entity は、テストしたすべてのテナントで現在404を返します）	調査中の特定のメッセージに限る。全件を対象にしない
書き込み（定型）	exceptions create、exceptions update、sectool-exceptions create、sectools create-ctp-item、report	--dry-run でプレビューしてから、レビュー済みの書き込みを実行
一括書き込み（import）	import（JSONLからの一括POST。import action は実メールに作用し、import soar はエンドユーザーに通知し、import msp はテナントを変更します）	人による承認が必須です。対象リソースのティアを引き継ぎます。また、受け付けるリソースは、以下のメールボックスに影響するエンドポイントや人間の関与を必要とするエンドポイントに到達します。まず --dry-run でプレビューしてください。
メールボックスに影響	remediate quarantine、remediate restore、action post-entity、action post-event	人による承認が必須です。必ず明示的に --scope を指定してください
エンドユーザーへの連絡	soar post-notify	人間の関与が必須
テナントと課金のライフサイクル	msp create-tenants、msp create-users、msp update-or-create-tenant-license	人間の関与が必須
破壊的操作	msp delete-tenants、msp delete-users、exceptions delete、sectool-exceptions delete、sectools delete-ctp-lists	人間の関与と明示的な確認が必須

ダッシュボードの外部に作用するのは2つの行です。remediate と action コマンドは、顧客の Microsoft 365 または Google Workspace 上の実メールを隔離・復元します。また、soar post-notify は実際の人に代わってメールを送信します。どちらも、ユーザーのメールボックスに触れる際にすでに求めている承認を適用してください。msp delete-tenants は顧客テナント全体を削除するため、ここに並ぶほかの操作とは影響範囲が大きく異なります。

最も強力な制御は、アプリケーション認証情報のスコープです。認証情報は1つのリージョンと特定のテナント群に紐付けられており、CLI がアクセスできるのはその範囲内のみです。制限方法を含む詳細は、governance.md をご覧ください。

ステータス

ベータ版です。オフラインでビルドと検証を実施済みです。コマンドツリー全体がビルドされ、テストスイートに合格し、doctor は設定、リージョン、接続を解決します。MCP の stdio ハンドシェイクではすべてのツールが一覧表示され、変更を伴うすべてのコマンドは --dry-run のみで実行して検証しました。まだ本番環境の Avanan テナントに対して実行していません。MSP が自社テナントで確認するまで、live_verified バッジは awaiting のままです。毎週開催している Build Sessions で、MSP とともに検証を進めています。compoundingteams.com/build-sessions から RSVP してください。

---

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

Servosity がメンテナンスしています。Apache-2.0 ライセンスです。CLI Printing Press でビルドされています。最終更新日：2026-08-15。