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 キャンペーンの統計情報の日次系列データを取得します(送信数、開封数、クリック数、チャネル別コンバージョン)。
duplicate_campaign /campaigns/duplicate create 既存のキャンペーンを複製します。
create_campaign* N/A create 新しいキャンペーンを作成します。
edit_campaign* N/A update 既存のキャンペーンを編集します。
launch_campaign* N/A update キャンペーンを開始します。
stop_campaign* N/A update 実行中のキャンペーンを停止します。
archive_campaign* N/A update キャンペーンをアーカイブします。
unarchive_campaign* N/A update キャンペーンのアーカイブを解除します。
get_campaign_draft* N/A read 下書きのキャンペーン詳細を取得します。
get_campaign_live_details* N/A read ライブキャンペーンの詳細を取得します。
create_campaign_message* N/A create キャンペーン内にメッセージを作成します。
update_campaign_message* N/A update キャンペーンメッセージを更新します。
delete_campaign_message* N/A delete キャンペーンメッセージを削除します。
create_campaign_message_variation* N/A create キャンペーン内にメッセージバリエーションを作成します。
update_campaign_message_variation* N/A update キャンペーンメッセージバリエーションを更新します。
delete_campaign_message_variation* N/A delete キャンペーンメッセージバリエーションを削除します。
update_campaign_distribution* N/A update キャンペーンの配信設定を更新します。

* このツールは、キャンペーンAPIベータプログラムに参加しているお客様のみ利用できます。アカウントでこの機能が有効になっていない場合、使用時にエラーが発生することがあります。ベータプログラムへの参加については、アカウントマネージャーにお問い合わせください。

キャンバス

ツール 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 単一のカタログアイテムとそのコンテンツを返します。
create_catalog /catalogs create カタログを作成します。
delete_catalog /catalogs/{catalog_name} delete カタログを削除します。
create_catalog_fields /catalogs/{catalog_name}/fields create カタログに複数のフィールドを作成します。
delete_catalog_field /catalogs/{catalog_name}/fields/{field_name} delete カタログフィールドを削除します。
create_catalog_items /catalogs/{catalog_name}/items create カタログに複数のアイテムを作成します。1リクエストあたり最大50アイテムです。
edit_catalog_items /catalogs/{catalog_name}/items update カタログ内の既存のアイテムを複数編集します。1リクエストあたり最大50アイテムです。
replace_catalog_items /catalogs/{catalog_name}/items update カタログ内の複数のアイテムを置換します。アイテムが存在しない場合は作成されます。1リクエストあたり最大50アイテムです。
delete_catalog_items /catalogs/{catalog_name}/items delete カタログ内の複数のアイテムを削除します。1リクエストあたり最大50アイテムです。
create_catalog_selection /catalogs/{catalog_name}/selections create カタログにセレクションを作成します。
delete_catalog_selection /catalogs/{catalog_name}/selections/{selection_name} delete カタログセレクションを削除します。

カスタム属性

ツール 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 既存のCloud Data Ingestion連携を1回の呼び出しにつき10件ずつ一覧表示します。
get_integration_job_sync_status /cdi/integrations/{integration_id}/job_sync_status read 指定したCDI連携の過去の同期ステータスを、1回の呼び出しにつき10件ずつ取得します。
trigger_integration_sync /cdi/integrations/{integration_id}/sync write 指定したCDI連携の同期をトリガーします。

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_product_list /purchases/product_list read プロダクトIDのページネーション付き一覧です。
get_quantity_series /purchases/quantity_series read 指定した期間におけるアプリの購入総数です。
get_revenue_series /purchases/revenue_series read 指定した期間におけるアプリの売上総額です。

セグメント

ツール APIエンドポイント アクセス 説明
get_segment_list /segments/list read セグメントを、名前、セグメントAPI識別子、分析トラッキングフラグとともにエクスポートします。
get_segment_details /segments/details read segment_idで指定したセグメントの関連情報を取得します。
get_segment_data_series /segments/data_series read セグメントの推定サイズの日次系列データを取得します。
get_segment_filters* N/A read セグメントフィルターの定義を取得します。
create_segment* N/A create 新しいセグメントを作成します。
edit_segment* N/A update 既存のセグメントを編集します。

* このツールは、セグメントAPIベータプログラムに参加しているお客様のみ利用できます。アカウントでこの機能が有効になっていない場合、使用時にエラーが発生することがあります。ベータプログラムへの参加については、アカウントマネージャーにお問い合わせください。

送信

ツール 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_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!