MCPサーバー

MCPサーバーを使用すると、AI アシスタントを主催者アカウントに接続できます。 AI は、売上の確認、トラフィックの分析、出席者の検索、イベントの管理、連絡先のインポートをユーザーに代わって実行できます。

仕組み

MCPサーバーは、アカウントの MCP エンドポイントに常駐します。 AI アシスタントは OAuth2 を使用して接続し、ツールを呼び出してデータを読み取ったり、アクションを実行したりできます。サーバーはチームとアクティブなイベントを自動的に解決するため、ほとんどのクエリは設定を必要としません。

1AI アシスタント

2MCPサーバー

3アカウント

認証

認証では、Laravel Passport 経由で OAuth2 を使用します。 AI クライアントは OAuth アプリケーションとして登録し、アクセスを承認するようにユーザーをリダイレクトし、ベアラートークンを受け取ります。 MCPサーバーへのすべてのリクエストにトークンを含めます。

承認: Bearer {token}

トークンのスコープはチームに限定され、構成可能な期間が経過すると期限切れになります。アカウント設定からいつでもアクセスを取り消すことができます。

コンテキストの検出

常に get_organizer_context から始めてください。このツールは、チーム情報、アクティブなイベント、保留中のアイテムを返します。単一のチームまたは単一のイベントがある場合、他のツールは明示的な ID を必要とせずに自動解決します。

// get_organizer_context からの応答の例
{
  "チーム": { "id": "01HX...", "name": "Acme Events" },
  "アクティブなイベント": [
    { "id": "01HY..."、"name": "DevConf 2026"、"status": "公開済み" }
  ]、
  「保留中」: {
    「スピーカー_アプリケーション」: 3、
    "refund_requests": 1、
    「スポンサーシップ_リクエスト」: 2
  }
}

販売分析ツール

イベントの収益とチケット販売データをクエリします。すべての金額は、生のセント値 (例: revenue_cents) と人間が読める形式の文字列 (例: revenue_formatted) の両方で返されます。

ツール	説明
`get_sales_summary`	総収益、販売チケット数、注文数、平均注文金額
`get_sales_daily`	売上と収益の日別内訳
`get_sales_pacing`	現在の傾向に基づく販売速度と予測

トラフィック分析

get_traffic_channelsは、チャネル (オーガニック、ソーシャル、有料、紹介、直接)、ソース、キャンペーン、デバイスごとに訪問者を分類します。種類と国。これを使用して、マーケティング ROI を測定し、視聴者がどこから来ているかを理解します。

トラフィックチャネル

チャネルソース訪問者

オーガニックgoogle1,842

ソーシャルlinkedin.com967

有料Google 広告534

紹介dev.to312

直接(直接)208

イベント管理ツール

唯一表示されるドラフトイベントを含むイベントの一覧表示と検査

ツール	説明
`list_events`	オプションのステータスフィルター（ドラフト、公開済み、過去）を含むすべてのイベント
`get_event_detail`	チケットの種類、講演者、スポンサー、会場を含む完全なイベント情報

参加者tools

search_attendees を使用すると、名前または電子メールで検索し、チケットの種類またはチェックインステータスでフィルタリングできます。 get_attendee_detail は、注文履歴やスキャン記録を含む完全な出席者レコードを返します。

// 電子メールで出席者を検索します
search_attendees({ クエリ: "[email protected]"、checked_in: false })

// 特定の出席者の詳細を取得します
get_attendee_detail({Attendee_id: "01HZ..." })

保留中のレビューツール

注意が必要な項目をレビューします。すべてのツールは、保留中、承認済み、または拒否された項目のみを表示するステータスフィルタリングをサポートしています。

ツール	説明
`list_speaker_applications`	講演のタイトル、略歴、トピックを含む講演者の提出を確認する
`list_refund_requests`	返金リクエストを金額と理由とともに表示する
`list_sponsorship_requests`	会社の詳細と階層設定を含むスポンサーアプリケーションの確認

イベント作成ワークフロー

MCPサーバーを介したイベントの作成は 3 段階のプロセスです。

呼び出し search_venuesは、一致する会場を見つけるためのクエリ文字列です。
呼び出し resolve_venueは、完全な住所と座標を含む確認された会場を取得する、選択された結果です。
呼び出し create_event解決された会場 ID とイベントの詳細 (名前、日付、説明、チケットの種類) を含めます。

注: 対面イベントの場合は、会場の解決が必要です。 resolve_venueステップでは、イベントが作成される前に会場の存在を確認し、その住所データを正規化します。

連絡先インポートワークフロー

連絡先のインポートは 2 段階の非同期プロセスです。

呼び出し import_contacts連絡先オブジェクトの JSON 配列を使用します。各オブジェクトは、メール、first_name、last_name、会社、および 役職 フィールドを受け入れます。サーバーは 202 ステータスとインポート ID で応答します。

// 連絡先のインポートを開始します。
import_contacts({
  連絡先: [
    { "email": "[email protected]"、"first_name": "Jane"、"last_name": "Doe"、"company": "Acme"、"title": "CTO" },
    { "電子メール": "[email protected]"、"名": "ボブ"、"姓": "スミス" }
  】
})
// 戻り値: { "import_id": "01HZ...", "status": "pending", "count": 2 }

// 完了をポーリングします
check_import_status({ import_id: "01HZ..." })
// 戻り値: { "status": "processed", "imported": 2, "skipped": 0, "errors": 0 }

ステータスが check_import_statusをポーリングします。処理済み または errorになるまで、インポート ID を使用して

注: インポートは非同期で実行されるため、大規模なバッチが完了するまでに数分かかる場合があります。サーバーは作業をキューに入れ、バックグラウンドで連絡先を処理します。

リソースとプロンプト

MCPサーバーは、AI アシスタントにデータと既製の分析ワークフローへの構造化されたアクセスを提供するリソースと事前構築されたプロンプトテンプレートを公開します。

リソース

イベントリスト -- ステータスと日付を含むすべてのイベント
イベント詳細 -- チケットの種類、講演者、スポンサーに関する単一イベントの詳細

プロンプト

DailyBriefing -- 売上、トラフィック、保留中のアイテムの朝の概要
SalesReport -- 傾向と比較を含む詳細な収益分析
トラフィック分析 -- チャネルパフォーマンスROI メトリクスによる内訳
レビュー保留 -- 要約付きの決定を待っている項目

サポートされる AI クライアント

MCP 互換のクライアントは、Kagibag MCPサーバーで動作します。 Claude Desktop には MCP サポートが組み込まれており、推奨されるクライアントです。開始するには、サーバー URL と OAuth 認証情報をクライアントの MCP 設定に追加します。

{
  "mcpサーバー": {
    「鍵袋」: {
      "url": "https://your-account.kagibag.com/mcp",
      "認証": {
        "タイプ": "oauth2",
        "client_id": "あなたのクライアント ID",
        "client_secret": "あなたのクライアント シークレット"
      }
    }
  }
}

クロードデスクトップ — MCP 設定

サーバー名

URL

クライアント ID

クライアントシークレット

接続済み鍵袋