Proofpoint

Proofpoint MCP サーバー

Proofpoint TAP および Essentials API 用の Model Context Protocol（MCP）サーバーです。AI アシスタントが脅威を調査し、メールを追跡し、隔離を管理し、脅威インテリジェンスにアクセスして、URL 防御の操作を実行できるようにします。

これは、Claude（または MCP 互換の AI）を Proofpoint 環境に接続する Model Context Protocol（MCP） サーバーです。

MSP Claude Plugins エコシステムの一部です — MSP スタック向けの AI 統合機能を拡充するスイートです。MSP によって、MSP のために構築されています。

インストール

npm install @wyre-ai/proofpoint-mcp

設定

.env.example をコピーし、以下の変数を設定してください。stdio トランスポートは PROOFPOINT_* を読み取り、HTTP のサービス間認証は使用しません。

変数	必須	説明
PROOFPOINT_SERVICE_PRINCIPAL	stdio および AUTH_MODE=env の場合	Proofpoint TAP のサービスプリンシパル
PROOFPOINT_SERVICE_SECRET	stdio および AUTH_MODE=env の場合	Proofpoint TAP のサービスシークレット
PROOFPOINT_BASE_URL	いいえ	API ホスト。デフォルトは https://tap-api-v2.proofpoint.com です。認証情報ではありません。
MCP_TRANSPORT	いいえ	stdio（デフォルト）または http
AUTH_MODE	いいえ	gateway（Docker イメージおよび Compose）または env。ゲートウェイモードでは、各 /mcp リクエストに X-Proofpoint-Service-Principal と X-Proofpoint-Service-Secret が必要で、PROOFPOINT_* へのフォールバックは行われません。env は S2S 認証の成功後にのみこれらの変数を使用します。未設定の場合は env です（stdio およびシングルテナント HTTP）。
CONDUIT_S2S_SECRET	HTTP では必須	サービス間シークレット。この値が空、または既知のプレースホルダー（changeme、secret、replace-me、your-s2s-secret およびその他のサンプル値）の場合、HTTP サーバーはエラーを記録してゼロ以外の終了コードで終了します。openssl rand -hex 32 で生成してください。これがないと Compose は起動しません。この値がログに記録されることはありません。
MCP_ALLOW_INSECURE_DEV	いいえ	HTTP を CONDUIT_S2S_SECRET なしで起動する場合に限り、ローカル開発用として 1 を設定してください。プロセスは警告を記録し、X-Gateway-S2S を強制せず、127.0.0.1 のみにバインドします。より広い範囲の MCP_HTTP_HOST（0.0.0.0 を含む）は無視され、その上書きがログに記録されます。既知のプレースホルダーシークレットを指定した場合も起動は拒否されます。
MCP_HTTP_HOST	いいえ	有効な CONDUIT_S2S_SECRET が設定されている場合のバインドアドレス。未設定時のデフォルトは 127.0.0.1 です。コンテナーイメージおよび Compose では、コンテナー内で 0.0.0.0 が設定されます。
MCP_HTTP_PORT	いいえ	HTTP ポート。デフォルトは 8080 です。

/health と /healthz は認証なしで利用でき、認証情報を読み取りません。

HTTP 認証

MCP_TRANSPORT=http で CONDUIT_S2S_SECRET が設定されている場合、すべての /mcp リクエストに X-Gateway-S2S が必要です。検証は src/s2s-verify.ts の verifyS2sHeader で行います。ヘッダー値は t=<unix seconds>,v1=<hex> です。<hex> は、CONDUIT_S2S_SECRET をキーとして、文字列 t=<unix seconds> のリテラル値から生成した HMAC-SHA256 です（小文字の 16 進数 64 文字）。タイムスタンプはサーバー時刻から 300 秒以内でなければなりません。ヘッダーがないか無効な場合、ベンダーの認証情報を読み取る前に HTTP 401 が返されます。

AUTH_MODE=gateway では、/mcp に X-Proofpoint-Service-Principal と X-Proofpoint-Service-Secret も必要です（X-Proofpoint-Cluster-Url は任意です）。これらのヘッダーのみがそのリクエストの認証情報として使用されます。必須ヘッダーのいずれかがないリクエストには 401 が返され、PROOFPOINT_SERVICE_PRINCIPAL / PROOFPOINT_SERVICE_SECRET へのフォールバックは行われません。

使用方法

Claude Desktop で実行する

Claude Desktop の claude_desktop_config.json に追加してください。

{
  "mcpServers": {
    "proofpoint-mcp": {
      "command": "npx",
      "args": ["@wyre-ai/proofpoint-mcp"],
      "env": {
        "PROOFPOINT_SERVICE_PRINCIPAL": "your-proofpoint-service-principal"
        "PROOFPOINT_SERVICE_SECRET": "your-proofpoint-service-secret"
      }
    }
  }
}

Claude Code（CLI）で実行する

claude mcp add proofpoint-mcp \
  -e PROOFPOINT_SERVICE_PRINCIPAL=your-value \
  -e PROOFPOINT_SERVICE_SECRET=your-value \
  -- npx -y @wyre-ai/proofpoint-mcp

Docker

イメージはコンテナ内で 0.0.0.0（MCP_HTTP_HOST）をリッスンし、デフォルトは AUTH_MODE=gateway です。ポートをループバックに公開し、有効な S2S シークレットを渡してください。ゲートウェイモードでは、Proofpoint の認証情報は各リクエストのヘッダーとして送信され、環境変数から読み込まれることはありません。

docker build -t proofpoint-mcp .
docker run \
  -e CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" \
  -p 127.0.0.1:8080:8080 \
  proofpoint-mcp

CONDUIT_S2S_SECRET が未設定の場合、Compose は起動を拒否します。ゲートウェイサービスは PROOFPOINT_SERVICE_PRINCIPAL や PROOFPOINT_SERVICE_SECRET を設定せず、env_file も使用しないため、プロジェクトの .env から静的なベンダー認証情報を注入することはできません。Compose は引き続き、そのファイルから CONDUIT_S2S_SECRET を補間します。公開先は 127.0.0.1:8080:8080 です。

CONDUIT_S2S_SECRET="$(openssl rand -hex 32)" docker compose up

シングルテナントの HTTP（AUTH_MODE=env）でも S2S シークレットが必要です。そのうえで、PROOFPOINT_SERVICE_PRINCIPAL と PROOFPOINT_SERVICE_SECRET を使用します。これは、上記のゲートウェイ Compose サービスとは別の構成です。

docker run \
  -e CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" \
  -e AUTH_MODE=env \
  -e PROOFPOINT_SERVICE_PRINCIPAL=your-value \
  -e PROOFPOINT_SERVICE_SECRET=your-value \
  -p 127.0.0.1:8080:8080 \
  proofpoint-mcp

シークレットなしのローカル HTTP は、開発専用です。MCP_HTTP_HOST が 0.0.0.0 の場合でも、127.0.0.1 にバインドし、警告をログに記録します。

MCP_TRANSPORT=http MCP_ALLOW_INSECURE_DEV=1 npm start

機能

インタラクティブ脅威カード（MCP Apps）

proofpoint_threat_get_by_id は、MCP Apps ホスト（Claude Desktop/web）で読み取り専用のインタラクティブカードとして表示されます。このカードには、脅威名、ステータス、カテゴリ、重大度、解決済みのアクター名／マルウェアファミリー名／キャンペーン名が表示されます。他のホストでのプレーンな JSON の動作は変わりません。カードはデフォルトで中立的なデザインで、window.__BRAND__ の注入または MCP_BRAND_* 環境変数（MCP_BRAND_NAME、MCP_BRAND_LOGO_URL、MCP_BRAND_PRIMARY_COLOR、MCP_BRAND_ACCENT_COLOR、MCP_BRAND_BG、MCP_BRAND_TEXT）でブランド設定できます。再ビルドは不要です。

利用可能なドメイン

Dlp

データ損失防止ポリシー

Events

セキュリティイベントストリームと SIEM エクスポート

Forensics

脅威のフォレンジック分析

People

Very Attacked People（VAP）レポート

Policy

メールポリシー管理

Quarantine

メールの隔離管理

Reports

セキュリティレポートと概要

Smart Search

高度なメール検索

Tap

標的型攻撃対策イベントとキャンペーン

Threat Intel

脅威インテリジェンスと侵害の痕跡

Url Defense

URL の書き換えとクリック防御

開発

# Clone the repository
git clone https://github.com/WYRE-AI/proofpoint-mcp.git
cd proofpoint-mcp

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# HTTP refuses to start until CONDUIT_S2S_SECRET is a real secret
CONDUIT_S2S_SECRET="$(openssl rand -hex 32)" MCP_TRANSPORT=http npm start

# Local HTTP only, without a service-to-service secret (always binds 127.0.0.1)
MCP_TRANSPORT=http MCP_ALLOW_INSECURE_DEV=1 npm start

貢献

貢献を歓迎します！CONTRIBUTING.md がある場合はご確認ください。または、変更について議論するために issue を作成してください。

ライセンス

Apache License, Version 2.0 の下でライセンスされています。詳細は LICENSE をご覧ください。