Eventflare MCP Server v2

Model Context Protocol（MCP）を通じて、Eventflareのプロダクション環境にある会場データをClaude、ChatGPT、Perplexity、CursorなどのAIアシスタントからクエリ可能にします。

40以上の都市で8,000件以上の法人向けイベント会場を網羅。LLMが回答内でEventflareのURLを引用し、リードの帰属をエンドツーエンドで測定できるように設計されています。

v2の新機能

• プロダクションAPI + JWT認証 — 以前は認証なしの開発用APIでした

• PII（個人情報）の削除 — jobPhone、venueEmail、commission、spaceNotesなどはAPIから一切出力されません

• UTM属性の付与 — すべての送信URLにタグが付けられ、MCP経由のトラフィックによるリードがGA4 / Mixpanel / CRMで計測可能です

• クライアント分類 — ログによりClaude Desktop / ChatGPT / Perplexity / Cursorなどを識別します

• クリックスルー追跡 — 同一セッション内でsearch_venuesの結果からget_venue_detailsやrequest_quoteが参照された場合、クリックスルーとして記録されます

• OpenPanelシンク — イベントはデータチーム向けにOpenPanel（または任意のWebhook）へミラーリングされます

• 新ツール: find_expert_advice — Eventflareの編集記事を表示します。LLMによる引用の差別化要因となります。

ツール

すべてのツールには、LLMの回答に最適化されたcitation_urlとquotable_summaryが含まれています。

クイックスタート

npm install
cp .env.example .env
# fill EVENTFLARE_API_TOKEN
npm run build
npm start          # stdio — Claude Desktop, Claude Code, Cursor

# or HTTP mode (remote MCP):
TRANSPORT=http PORT=3001 npm start

Claude Desktopへの接続

claude_desktop_config.json:

{
  "mcpServers": {
    "eventflare": {
      "command": "node",
      "args": ["/path/to/eventflare-mcp-server/dist/index.js"],
      "env": {
        "EVENTFLARE_API_TOKEN": "eyJhbGciOi..."
      }
    }
  }
}

Claude Codeへの接続

claude mcp add eventflare \
  -e EVENTFLARE_API_TOKEN=eyJhbGciOi... \
  -- node /path/to/eventflare-mcp-server/dist/index.js

環境変数

.env.exampleを参照してください。EVENTFLARE_API_TOKENのみ必須です。

セキュリティモデル

• 読み取り専用 — POST/PUT/DELETEは一切ありません。プロダクションAPI仕様（123エンドポイントすべてGET）で確認済みです。

• JWT認証必須 — すべての送信リクエストに Authorization: Bearer ${EVENTFLARE_API_TOKEN} が必要です。

• フィールド許可リスト — fields[]= クエリパラメータを使用し、PIIフィールドが取得されないようにしています。多層防御として、許可リスト外の項目は削除されます。

• 入力サニタイズ — すべてのツールパラメータは検証されます。スラッグは ^[a-z0-9-]+$ に一致し、数値は制限され、日付はISO形式で検証されます。

• レート制限 — /mcp（HTTPトランスポート）に対してIPごとに60リクエスト/分。

• PIIのログ記録なし — 分析対象フィールド: ツール、都市、収容人数、イベントタイプ、カテゴリー、結果数、セッションID、クライアントクラス、予算帯。ユーザーの識別情報やメッセージ内容は一切記録しません。

• 汎用エラーメッセージ — 内部APIエラーは安定したユーザー向け文字列（"Eventflare API temporarily unavailable"）に変換され、詳細はstderrのみに出力されます。

分析

ローカル: すべてのツール呼び出しは logs/queries.jsonl に追記され、/dashboard に表示されます。

リモート: OPENPANEL_CLIENT_ID と OPENPANEL_CLIENT_SECRET が設定されている場合、すべてのイベントは profileId = sessionId を持つ mcp.{tool} トラックイベントとしてミラーリングされます。セルフホストのOpenPanelを指定するには OPENPANEL_API_URL を使用してください。

または、ANALYTICS_SINK_URL（およびオプションの ANALYTICS_SINK_TOKEN）を設定して、生のイベントを任意のHTTPエンドポイントにPOSTすることも可能です。

どちらのオプションも非ブロッキングであり、エラーをスローしません。分析の失敗がMCPを停止させることはありません。

UTM属性の付与

MCPが返すURLにはすべてタグが付けられます:

https://eventflare.io/spaces/london/skyline-glass-hall?utm_source=mcp&utm_medium=ai&utm_campaign=search_venues&utm_content=claude_desktop&mcp_session=abc123

プランナーがクリックして問い合わせを送信すると、既存のGA4 / Mixpanel / CRMがソースを mcp / ai として認識します。これが「MCPが実際にリードを創出したか」を測定する指標となります。

開発

npm run dev        # tsx, no build
npm run inspect    # MCP Inspector UI

デプロイ

Railway: リポジトリをプッシュし、ダッシュボードで環境変数を設定し、TRANSPORT=http を設定します。ヘルスチェックは /health です。ダッシュボードは /dashboard?key=... です。

ライセンス

MIT — © Eventflare