MCP 経由で Netskope を Gemini に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Netskope をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Netskope + Gemini

Netskope Security Service Edge に読み取り専用で接続します。アラートとイベント（アプリケーション、Web、ネットワーク、インシデント、エンドポイント DLP）の検索、管理者の監査ログ、ユーザーのリスクスコア、Cloud Confidence Index の照会、URL リスト、Private Access のパブリッシャーとアプリ、SCIM のユーザーとグループを扱えます。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

NETSKOPE_TENANT, NETSKOPE_API_TOKEN

ステップ 1 — 認証情報を取得

セットアップは約 5 分です。Netskope テナントと、AI に使わせたいエンドポイントに Read 権限を持つ REST API v2 トークンが必要です。

1. Netskope テナントで Settings > Tools > REST API v2 を開き、新しいトークンを作成します。Settings > Administration > Administrators & Roles のサービスアカウントを使うこともできます。
2. AI に使わせるすべてのエンドポイントを Read 権限で追加します: /api/v2/events/datasearch/alert とその他の /api/v2/events/datasearch/... タイプ、/api/v2/events/data/audit、/api/v2/ubadatasvc/user/uci、/api/v2/services/cci/app、/api/v2/policy/urllist、/api/v2/infrastructure/publishers、/api/v2/steering/apps/private、/api/v2/scim/Users、/api/v2/scim/Groups。追加しなかったエンドポイントには AI はアクセスできません。
3. 有効期限を設定し、トークンを NETSKOPE_API_TOKEN にコピーします。トークンは Netskope-Api-Token ヘッダーで送信されます。
4. NETSKOPE_TENANT には、ブラウザのアドレスバーに表示されるテナントのホスト名を設定します。例: example.goskope.com（EU のテナントなら example.eu.goskope.com など）。https:// やパスは付けません。
5. テナントで IP 許可リスト（Settings > Administration > IP Allowlist）を使っている場合は、AnythingMCP サーバーの送信元アドレスを追加します。
6. コネクタをインストールし、netskope_search_alerts を実行してトークンを確認します。

読み取り専用: すべてのツールは読み取りだけを行います。netskope_get_user_risk_score は POST で送信されますが、スコアを読むだけです。コネクタがポリシー、URL リスト、パブリッシャー、アプリ、ユーザーを変更することはありません。

読み取れるデータ: アラート（DLP、マルウェア、ポリシー、異常検知、漏洩した認証情報、UBA など）。イベントは一度に 1 タイプずつ: application（クラウドアプリのアクティビティ）、page（Web 閲覧）、network（ファイアウォールと Private Access のトラフィック）、incident、clientstatus（デバイス上の Netskope クライアントの状態）、epdlp（エンドポイント DLP）。管理者の監査ログ（誰がどの設定やポリシーを変更したか、コンソールへのログイン）。ユーザーの User Confidence Index（UCI、行動分析による 0〜1000 のリスクスコア）とその変化。Dropbox や Slack などクラウドアプリの正確な名前による Cloud Confidence Index（スコア、Cloud Confidence Level、カテゴリ、タグ、承認済みか検出のみか）。ポリシーで使われる URL リスト。Private Access のパブリッシャーとその状態、提供しているプライベートアプリ。SCIM でプロビジョニングされたユーザーとグループ。

アラートとイベントの検索: AI は期間（Unix 秒の starttime と endtime）と、alert_type eq 'DLP' や severity eq 'high' のような Netskope クエリ言語の query を指定し、必要な fields だけを要求します。件数を出すときは fields=count_total:count(_id) と groupbys（例: alert_name や user）を使い、count_total desc で並べ替えます。大規模なテナントには数百万件のイベントがあるため、イベント検索には必ず期間を指定します。UCI の時刻（from_time）はミリ秒です。

制限: datasearch のリストは limit と offset、SCIM のリストは startIndex（1 から）と count でページングします。Netskope はエンドポイントごとに毎秒数回までに制限しており、それを超えると Retry-After 付きの 429 を返します。

よくあるエラー: 401 または 403 は、トークンが間違っているか期限切れ、またはそのエンドポイントが Read 権限でトークンに追加されていないことを意味します。403 はテナントの IP 許可リストが原因の場合もあります。datasearch の呼び出しが失敗すると（例: query に未知のフィールドがある）、status.execution FAILED とメッセージが返り、コネクタはそれをエラーにします。すべての呼び出しで 404 になる場合は、たいてい NETSKOPE_TENANT が間違っています。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Gemini にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう。Gemini CLI が Netskope のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「過去 24 時間の重大度 high の DLP アラートを、ユーザーごとにまとめて表示してください。」
• 「今週いちばん多くアラートを発生させたユーザーは誰ですか。よく出ているアラート名も教えてください。」
• 「[email protected] の User Confidence Index はいくつで、過去 30 日間でどう変わりましたか。」
• 「Dropbox の Cloud Confidence Index を調べて、承認済みかどうか教えてください。」
• 「Private Access のパブリッシャーはすべて接続されていますか。それぞれどのプライベートアプリを提供していますか。」

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Cursor に接続
• Meta Muse に接続
• Microsoft Copilot に接続