Skip to content

Braze MCPサーバー関数

Braze MCPサーバーは、特定のBraze REST APIエンドポイントに対応する読み取りおよび書き込みツールを公開しています。詳細については、Braze MCPサーバーを参照してください。

前提条件

この機能を使用する前に、Braze MCPサーバーのセットアップを完了する必要があります。

利用可能なBraze API関数

MCPクライアントは、Braze MCPサーバーとやり取りするためにこれらのツールを参照します。

ワークスペース

ツール APIエンドポイント アクセス 説明
get_workspaces N/A read 現在のOAuthアクセストークンがアクセスできるBrazeワークスペースを検出します。最初にこれを呼び出してください。返される各ワークスペースのidが、他のすべてのツールで必要なapp_group_idになります。

キャンペーン

ツール APIエンドポイント アクセス 説明
get_campaign_list /campaigns/list read 名前、キャンペーンAPI識別子、APIキャンペーンフラグ、タグを含むキャンペーンのリストをエクスポートします。
get_campaign_details /campaigns/details read campaign_idで指定されたキャンペーンに関する関連情報を取得します。
get_campaign_dataseries /campaigns/data_series read キャンペーン統計の日次推移(チャネル別の送信数、開封数、クリック数、コンバージョン数)を取得します。

キャンバス

ツール APIエンドポイント アクセス 説明
get_canvas_list /canvas/list read 名前、キャンバスAPI識別子、タグを含むキャンバスのリストをエクスポートします。
get_canvas_details /canvas/details read キャンバスのメタデータ(名前、作成日時、現在のステータスなど)をエクスポートします。
get_canvas_data_series /canvas/data_series read キャンバスの時系列データをエクスポートします。
get_canvas_data_summary /canvas/data_summary read キャンバスの時系列データのロールアップをエクスポートし、簡潔な結果サマリーを提供します。

カタログ

ツール APIエンドポイント アクセス 説明
get_catalogs /catalogs read ワークスペース内のカタログを一覧表示します。
get_catalog_items /catalogs/{catalog_name}/items read 複数のカタログアイテムとその内容を返します。
get_catalog_item /catalogs/{catalog_name}/items/{item_id} read 単一のカタログアイテムとその内容を返します。

カスタム属性

ツール APIエンドポイント アクセス 説明
get_custom_attributes /custom_attributes read アプリ用に記録されたカスタム属性を、50件ずつアルファベット順にエクスポートします。

カスタムイベント

ツール APIエンドポイント アクセス 説明
get_events /events read アプリ用に記録されたカスタムイベントを、50件ずつアルファベット順にエクスポートします(カーソルページネーション)。
get_events_list /events/list read カスタムイベント名を、250件ずつアルファベット順にエクスポートします(ページページネーション)。
get_events_data_series /events/data_series read 指定された期間におけるカスタムイベントの発生回数を取得します。

CDI連携

ツール APIエンドポイント アクセス 説明
list_integrations /cdi/integrations read 既存のクラウドデータ取り込み連携を、1回の呼び出しにつき10件ずつ一覧表示します。
get_integration_job_sync_status /cdi/integrations/{integration_id}/job_sync_status read 指定されたCDI連携の過去の同期ステータスを、1回の呼び出しにつき10件ずつ取得します。

KPI

ツール APIエンドポイント アクセス 説明
get_dau_data_series /kpi/dau/data_series read 日付ごとのユニークアクティブユーザーの日次推移です。
get_mau_data_series /kpi/mau/data_series read 30日間のローリングウィンドウにおけるユニークアクティブユーザーの日次推移です。
get_new_users_data_series /kpi/new_users/data_series read 日付ごとの新規ユーザー総数の日次推移です。
get_uninstalls_data_series /kpi/uninstalls/data_series read 日付ごとのアンインストール総数の日次推移です。

メディアライブラリ

ツール APIエンドポイント アクセス 説明
create_media_library_asset /media_library/create create 外部URLまたはBase64ファイルコンテンツを使用して、Brazeメディアライブラリにアセットをアップロードします。アップロードモードはいずれか1つのみ指定する必要があります。

メッセージ

ツール APIエンドポイント アクセス 説明
get_scheduled_broadcasts /messages/scheduled_broadcasts read 現在から指定されたend_timeまでの間にスケジュールされたキャンペーンとエントリキャンバスを一覧表示します。

購入

ツール APIエンドポイント アクセス 説明
get_product_list /purchases/product_list read 商品IDのページネーション付きリストです。
get_quantity_series /purchases/quantity_series read 指定された期間におけるアプリ内の購入総数です。
get_revenue_series /purchases/revenue_series read 指定された期間におけるアプリ内の総支出額です。

SDK認証

ツール APIエンドポイント アクセス 説明
get_sdk_authentication_keys /app_group/sdk_authentication/keys read アプリのすべてのSDK認証キーを取得します。

セグメント

ツール APIエンドポイント アクセス 説明
get_segment_list /segments/list read 名前、セグメントAPI識別子、分析トラッキングフラグを含むセグメントをエクスポートします。
get_segment_details /segments/details read segment_idで指定されたセグメントに関する関連情報を取得します。
get_segment_data_series /segments/data_series read セグメントの推定サイズの日次推移を取得します。

送信

ツール APIエンドポイント アクセス 説明
get_send_data_series /sends/data_series read トラッキング対象のsend_id(APIキャンペーン)の日次統計です。Brazeは送信後14日間、送信分析データを保存します。

セッション

ツール APIエンドポイント アクセス 説明
get_session_data_series /sessions/data_series read 指定された期間におけるアプリのセッション数です。

購読グループ

ツール APIエンドポイント アクセス 説明
get_subscription_group_status /subscription/status/get read 購読グループ内のユーザーの購読状態を取得します。
get_user_subscription_groups /subscription/user/status read ユーザーの購読グループを一覧表示します。

テンプレート

ツール APIエンドポイント アクセス 説明
get_email_templates /templates/email/list read Brazeアカウントで利用可能なメールテンプレートを一覧表示します。
get_email_template_info /templates/email/info read 特定のメールテンプレートの情報を取得します。ドラッグ&ドロップエディターのテンプレートは対象外です。
create_email_template /templates/email/create create Brazeダッシュボードでメールテンプレートを作成します。
update_email_template /templates/email/update update 既存のメールテンプレートを更新します。

コンテンツブロック

ツール APIエンドポイント アクセス 説明
get_content_blocks /content_blocks/list read 既存のコンテンツブロック情報を一覧表示します。
get_content_block_info /content_blocks/info read 既存のコンテンツブロックの情報を取得します。オプションでキャンペーンまたはキャンバスの包含データも取得できます。
create_content_block /content_blocks/create create コンテンツブロックを作成します。
update_content_block /content_blocks/update update コンテンツブロックを更新します。

指示と応答の処理方法

Braze MCPサーバーは、Claude、ChatGPT、Copilot、Gemini CLI、Codex、CursorなどのサードパーティプロバイダーのMCPクライアントから、そのプロバイダーの基盤AIモデルが生成した指示をそのまま受け取ります。自然言語でリクエストを入力すると、AIモデルがリクエストを解釈し、Brazeへの1つ以上の具体的なツール呼び出しに変換します。Brazeは送信されたツール呼び出しをそのまま受信して実行します。Brazeはお客様の元の自然言語プロンプトを参照することはできず、生成されたツール呼び出しがお客様の意図したリクエストを完全かつ正確に反映しているかどうかを検証することもできません。

Brazeがデータや結果を返す際、その応答はサードパーティプロバイダーのMCPクライアントに送信され、クライアント側で解釈、フォーマット、表示が行われます。Brazeは、AIモデルが返された情報をどのように表示、要約、または説明するかを制御しません。

Brazeは、サードパーティプロバイダーのMCPクライアントによって生成された指示、またはそれを通じて伝達された応答について責任を負いません。サードパーティプロバイダーのMCPクライアントがアクションの自動実装のための「自動モード」を提供している場合、Brazeはその使用を推奨しません。AIが生成した要約はBrazeダッシュボードのソースデータと照合して確認し、AIが提案するアクションはサードパーティプロバイダーのMCPクライアントを通じて実装する前に必ず確認してください。

New Stuff!