Pangea MCP Server

Pangea MCP サーバー

Pangea API との統合を提供するModel Context Protocol（MCP） サーバーです。

前提条件

• Node.js v24.11.0 以降。
• AI Guard、Domain Intel、Embargo、IP Intel、Redact、Secure Audit Log、URL Intel、Vault のすべてにアクセスできる Pangea API トークン。このトークンは Pangea Vault に保存する必要があります。Pangea API トークンの作成と管理については、Service Tokens を参照してください。
• Vault にアクセスできる Pangea API トークン。これは、実行時に上記のトークンを取得するために使用します。
• 「Standard Audit Log Config」スキーマを使用する Pangea Secure Audit Log 設定。新しい Secure Audit Log 設定の作成方法については、Multiple Service Configurations を参照してください。後で使用するため、設定 ID を控えておいてください。

最初の API トークンは、次のようなものです。

Pangea の初期セットアップ

このセクションでは、この MCP サーバー用に新しい Pangea アカウントを設定する方法を説明します。

1. https://pangea.cloud/signup で Pangea アカウントを作成します。アカウントの作成時に、組織（最上位のグループ）とプロジェクト（個別のアプリ）も作成されます。「Get started with a common service」ダイアログでは、Skip ボタンをクリックして開発者コンソールに移動します。
2. 開発者コンソールの左側のパネルに、サービスの一覧が表示されます。Vault サービスをクリックして有効にします。Vault は、シークレット、暗号鍵、Pangea API トークンを安全に保存します。
3. モーダルに、新しい Pangea API トークンを作成するか、既存のトークンを拡張するかを尋ねるプロンプトが表示されます。Create a new token を選択し、Done をクリックします。このトークンは、後で環境変数 PANGEA_VAULT_TOKEN として使用します。
4. 左側のパネルで Secure Audit Log サービスをクリックして有効にします。Secure Audit Log は、透明性があり、変更不可能で、暗号技術による検証が可能な改ざん防止監査ログを提供します。
5. デフォルトの Standard Audit Log スキーマを使用します。
6. モーダルに、新しい Pangea API トークンを作成するか、既存のトークンを拡張するかを尋ねるプロンプトが表示されます。Create a new token を選択します。Store token in Vault チェックボックスがオンになっていることを確認してから、Done をクリックします。
7. 遷移先のページに表示される Config ID は、後で環境変数 PANGEA_AUDIT_CONFIG_ID として使用します。
8. 次に、作成した2つ目のトークンを、Pangea の残りのサービスに拡張します。以下の各サービスについて、左側のパネルで該当する項目をクリックし、表示されたモーダルで Extend an existing token を選択します。前の手順で作成したトークン（Vault 専用に最初に作成したトークンではありません）を選択し、Done をクリックします。
   1. AI Guard — LLM とのデータややり取りを保護します。
   2. Domain Intel — 提出されたドメインのインテリジェンスデータを取得します。対応プロバイダー：DomainTools、CrowdStrike、WhoisXML API。
   3. Embargo — IP と国コードを、既知の制裁および貿易禁輸リストと照合します。
   4. IP Intel — IP を監視します。対応プロバイダー：Team CYMRU、CrowdStrike、Digital Element。
   5. Redact — 定義されたルールを使用して情報を秘匿し、機密情報を制御します。
   6. URL Intel — 既知の URL に関するインテリジェンスを取得します。対応プロバイダー：CrowdStrike。
   7. Vault — シークレット、暗号鍵、Pangea API トークンを安全に保存します。
9. https://console.pangea.cloud/project/credentials に移動します。上記すべてのサービスに拡張されたトークンには、Vault 列に「Stored」というインジケーターが表示されます。それをクリックすると、そのトークンを含む Vault 項目に直接移動できます。この項目の ID は、後で環境変数 PANGEA_VAULT_ITEM_ID として使用します。

Claude Desktop での使用方法

次の設定ファイルを編集します（存在しない場合は作成してください）。

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

ファイルの内容を次の内容に置き換える（または統合する）:

{
  "mcpServers": {
    "pangea": {
      "command": "npx",
      "args": ["-y", "@pangeacyber/mcp-server"],
      "env": {
        "PANGEA_VAULT_TOKEN": "pts_00000000000000000000000000000000",
        "PANGEA_VAULT_ITEM_ID": "pvi_00000000000000000000000000000000",
        "PANGEA_AUDIT_CONFIG_ID": "pci_00000000000000000000000000000000"
      }
    }
  }
}

1. PANGEA_VAULT_TOKEN の値を Pangea Vault API トークンに更新します。
2. PANGEA_VAULT_ITEM_ID の値を、他のすべての Pangea サービスの呼び出しに使用する API トークンを含む Vault アイテム ID に更新します。
3. PANGEA_AUDIT_CONFIG_ID の値を Secure Audit Log の設定 ID に更新します。
4. Claude Desktop を再起動します。

HTTP サーバーとして実行する

npx @pangeacyber/mcp-server --transport httpStream --port 8080

Pangea AuthN の追加

ストリーム可能な HTTP トランスポートを使用してサーバーを実行する場合、Pangea AuthN を介してサーバーに認証を任意で追加できます。この機能を有効にするには、--authn フラグを設定し、次の環境変数を設定します。

• PANGEA_AUTHN_ISSUER — Pangea AuthN の発行者 URL。
• PANGEA_AUTHN_CLIENT_ID — Pangea AuthN のクライアント ID。
• PANGEA_AUTHN_CLIENT_SECRET — Pangea AuthN のクライアントシークレット。

クライアントの設定

1. Pangea AuthN ダッシュボードに移動します。
2. 左側のパネルで、OAuth Server をクリックします。
3. 右側の + OAuth Client ボタンをクリックして、新しい OAuth クライアントの作成を開始します。
   • Name: OAuth Server の設定にあるクライアント一覧に表示される、識別しやすい名前をクライアントに付けます。この名前はいつでも変更できます。
   • Grant Type: Authorization Code である必要があります。
   • Response Types: Code のみが必要です。
   • Allowed Redirect URIs: http://localhost:8000/pangea/callback を入力します。本番環境の MCP サーバーでは、localhost アドレスではなく、サーバーのリモートアドレス（例：https://mcp.example.org/pangea/callback）を使用してください。
   • Allowed Scopes & Default Scopes: openid。
4. Client ID と Client Secret は、それぞれ PANGEA_AUTHN_CLIENT_ID と PANGEA_AUTHN_CLIENT_SECRET の環境変数に設定します。AuthN 概要ページに表示される Hosted Login URL は、PANGEA_AUTHN_ISSUER 環境変数に設定します。

ツール

AI Guard

• prompt_guard — テキストを分析および編集して、モデルへの操作、悪意のあるコンテンツの追加、その他の望ましくないデータ転送を防ぎます。

Domain Intel

• lookup_domain_reputation — 1 つ以上のドメインのレピュテーションスコアを取得します。
• whois — ドメインの WHOIS（インターネットリソースの登録ユーザーまたは割り当て先）情報を取得します。

Embargo

• check_ip_embargo — 1 つ以上の IP アドレスを、既知の制裁および貿易禁輸リストと照合します。
• check_iso_code_embargo — 国コードを、既知の制裁および貿易禁輸リストと照合します。

File Intel

• lookup_file_reputation — 一連のファイルハッシュのレピュテーションスコアを取得します。

IP Intel

• lookup_ip_address_reputation — 1 つ以上の IP アドレスのレピュテーションスコアを取得します。
• lookup_domain_from_ip_address — 1 つ以上の IP アドレスに関連付けられたドメイン名を取得します。
• is_proxy — 1 つ以上の IP アドレスがプロキシ経由のものかどうかを判定します。
• is_vpn — 1 つ以上の IP アドレスが VPN 経由のものかどうかを判定します。
• geolocate — 1 つ以上の IP アドレスの位置情報を取得します。

Redact

• redact — 提供されたテキストから機密情報を編集して取り除きます。

Secure Audit Log

• log_entry — Secure Audit Log にログエントリを作成します。
• search_log — Secure Audit Log を検索します。

URL Intel

• lookup_url_reputation — 1 つ以上の URL のレピュテーションスコアを取得します。

Vault

• get_vault_item — Vault のキー、シークレット、トークン、またはフォルダーの詳細を取得します。
• list_vault_items — 指定したフィルターに一致する Vault アイテムの配列を、シークレット、キー、トークン、フォルダーなどの一般的な詳細とともに取得します。
• delete_vault_item — Vault のキー、シークレット、トークン、またはフォルダーを削除します。
• generate_key — 対称鍵または非対称鍵を生成します。