このページはAIにより自動翻訳されており、不正確な内容が含まれている可能性があります。翻訳の誤りを報告するには、ページ右側の目次の下にあるフィードバックをご利用ください。
Braze MCPサーバー関数
Braze MCPサーバーは、読み取りおよび書き込みツールを公開しています。そのほとんどはBraze REST APIエンドポイントに対応していますが、MCPサーバー経由でのみ利用できるツールもあります。詳細については、Braze MCPサーバーを参照してください。
重要
ローカルホスト型のBraze MCPサーバー（ベータ版）は非推奨となっており、今後の更新は行われません。
注
Braze MCPサーバーには、ベータプログラムに参加している顧客のみが利用できるツールが含まれています。ベータプログラムの一部であるツールにアクセスしようとした際に、アカウントでその機能が有効になっていない場合、エラーレスポンスが返されることがあります。ベータプログラムに参加するには、アカウントマネージャーにお問い合わせください。
前提条件
この機能を使用する前に、Braze MCPサーバーを設定する必要があります。
利用可能なBraze API関数
MCPクライアントは、これらのツールを参照してBraze MCPサーバーとやり取りします。APIエンドポイント列に「MCPのみ」と表示されているツールは、Braze MCPサーバー経由でのみ利用できます。これらのツールには、対応する公開REST APIエンドポイントはありません。
ワークスペース
| ツール | APIエンドポイント | アクセス | 権限 | 説明 |
|---|---|---|---|---|
get_workspaces |
MCPのみ | 読み取り | なし | 現在のOAuthアクセストークンでアクセスできるBrazeワークスペースを確認します。最初にこのツールを呼び出してください。返される各ワークスペースのidは、他のすべてのツールで必要となるapp_group_idです。 |
キャンペーン
| ツール | APIエンドポイント | アクセス | 権限 | 説明 |
|---|---|---|---|---|
get_campaign_list |
/campaigns/list |
読み取り | キャンペーン分析を表示 | 名前、キャンペーンAPI識別子、APIキャンペーンフラグ、タグを含むキャンペーンのリストをエクスポートします。 |
get_campaign_details |
/campaigns/details |
読み取り | キャンペーン分析を表示 | campaign_idで指定したキャンペーンの関連情報を取得します。 |
get_campaign_dataseries |
/campaigns/data_series |
読み取り | キャンペーン分析を表示 | キャンペーン統計の経時的な日次系列 (チャネル別の送信数、開封数、クリック数、コンバージョン数) を取得します。 |
duplicate_campaign |
/campaigns/duplicate |
作成 | キャンペーンを作成 | 既存のキャンペーンを複製します。 |
create_campaign |
MCPのみ | 作成 | キャンペーンを作成 | 新しいキャンペーンを作成します。 |
edit_campaign |
MCPのみ | 更新 | キャンペーンを編集 | 既存のキャンペーンを編集します。 |
launch_campaign* |
MCPのみ | 更新 | キャンペーンを開始 | キャンペーンを開始します。 |
stop_campaign |
MCPのみ | 更新 | キャンペーンを停止 | 実行中のキャンペーンを停止します。 |
archive_campaign* |
MCPのみ | 更新 | キャンペーンをアーカイブ | キャンペーンをアーカイブします。 |
unarchive_campaign* |
MCPのみ | 更新 | キャンペーンをアーカイブ | キャンペーンのアーカイブを解除します。 |
get_campaign_draft |
MCPのみ | 読み取り | キャンペーン分析を表示 | 下書きキャンペーンの詳細を取得します。 |
get_campaign_live_details |
MCPのみ | 読み取り | キャンペーン分析を表示 | 実行中のキャンペーンの詳細を取得します。 |
create_campaign_message |
MCPのみ | 作成 | キャンペーンを編集 | キャンペーン内にメッセージを作成します。 |
update_campaign_message |
MCPのみ | 更新 | キャンペーンを編集 | キャンペーンメッセージを更新します。 |
delete_campaign_message |
MCPのみ | 削除 | キャンペーンを編集 | キャンペーンメッセージを削除します。 |
create_campaign_message_variation |
MCPのみ | 作成 | キャンペーンを編集 | キャンペーン内にメッセージバリエーションを作成します。 |
update_campaign_message_variation |
MCPのみ | 更新 | キャンペーンを編集 | キャンペーンのメッセージバリエーションを更新します。 |
delete_campaign_message_variation |
MCPのみ | 削除 | キャンペーンを編集 | キャンペーンのメッセージバリエーションを削除します。 |
update_campaign_distribution |
MCPのみ | 更新 | キャンペーンを編集 | キャンペーンの配信設定を更新します。 |
キャンペーンツールは一般提供されており、アスタリスク (*) が付いているツールを除き、ベータプログラムへの参加は不要です。
* このツールは、キャンペーンAPIベータプログラムに参加している顧客のみが利用できます。アカウントでこの機能が有効になっていない場合、使用しようとするとエラーが発生することがあります。ベータプログラムに参加するには、アカウントマネージャーにお問い合わせください。
キャンバス
| ツール | APIエンドポイント | アクセス | 権限 | 説明 |
|---|---|---|---|---|
get_canvas_list |
/canvas/list |
読み取り | キャンバス分析を表示 | 名前、キャンバスAPI識別子、タグを含むキャンバスのリストをエクスポートします。 |
get_canvas_details |
/canvas/details |
読み取り | キャンバス分析を表示 | 名前、作成日時、現在のステータスなどのキャンバスメタデータをエクスポートします。 |
get_canvas_data_series |
/canvas/data_series |
読み取り | キャンバス分析を表示 | キャンバスの時系列データをエクスポートします。 |
get_canvas_data_summary |
/canvas/data_summary |
読み取り | キャンバス分析を表示 | キャンバスの時系列データを集計し、簡潔な結果サマリーとしてエクスポートします。 |
カタログ
| ツール | APIエンドポイント | アクセス | 権限 | 説明 |
|---|---|---|---|---|
get_catalogs |
/catalogs |
読み取り | カタログを表示 | ワークスペース内のカタログを一覧表示します。 |
get_catalog_items |
/catalogs/{catalog_name}/items |
読み取り | カタログアイテムを表示 | 複数のカタログアイテムとその内容を返します。 |
get_catalog_item |
/catalogs/{catalog_name}/items/{item_id} |
読み取り | カタログアイテムを表示 | 単一のカタログアイテムとその内容を返します。 |
create_catalog |
/catalogs |
作成 | カタログを管理 | カタログを作成します。 |
delete_catalog |
/catalogs/{catalog_name} |
削除 | カタログを管理 | カタログを削除します。 |
create_catalog_fields |
/catalogs/{catalog_name}/fields |
作成 | カタログフィールドを管理 | カタログに複数のフィールドを作成します。 |
delete_catalog_field |
/catalogs/{catalog_name}/fields/{field_name} |
削除 | カタログフィールドを管理 | カタログフィールドを削除します。 |
create_catalog_items |
/catalogs/{catalog_name}/items |
作成 | カタログアイテムを管理 | カタログに複数のアイテムを作成します。1リクエストあたり最大50アイテムです。 |
edit_catalog_items |
/catalogs/{catalog_name}/items |
更新 | カタログアイテムを管理 | カタログ内の既存の複数アイテムを編集します。1リクエストあたり最大50アイテムです。 |
replace_catalog_items |
/catalogs/{catalog_name}/items |
更新 | カタログアイテムを管理 | カタログ内の複数のアイテムを置き換えます。アイテムが存在しない場合は作成します。1リクエストあたり最大50アイテムです。 |
delete_catalog_items |
/catalogs/{catalog_name}/items |
削除 | カタログアイテムを管理 | カタログ内の複数のアイテムを削除します。1リクエストあたり最大50アイテムです。 |
create_catalog_selection |
/catalogs/{catalog_name}/selections |
作成 | カタログ選択を管理 | カタログに選択を作成します。 |
delete_catalog_selection |
/catalogs/{catalog_name}/selections/{selection_name} |
削除 | カタログ選択を管理 | カタログ選択を削除します。 |
カスタム属性
| ツール | APIエンドポイント | アクセス | 権限 | 説明 |
|---|---|---|---|---|
get_custom_attributes |
/custom_attributes |
読み取り | カスタムイベント、属性、購入を表示 | アプリで記録されたカスタム属性を、50件ずつアルファベット順にエクスポートします。 |
カスタムイベント
| ツール | APIエンドポイント | アクセス | 権限 | 説明 |
|---|---|---|---|---|
get_events |
/events |
読み取り | カスタムイベント、属性、購入を表示 | アプリで記録されたカスタムイベントを、50件ずつアルファベット順にエクスポートします (カーソルページネーション)。 |
get_events_list |
/events/list |
読み取り | カスタムイベント、属性、購入を表示 | カスタムイベント名を、250件ずつアルファベット順にエクスポートします (ページネーション)。 |
get_events_data_series |
/events/data_series |
読み取り | カスタムイベント、属性、購入を表示 | 指定した期間におけるカスタムイベントの発生回数を取得します。 |
CDI連携
| ツール | APIエンドポイント | アクセス | 権限 | 説明 |
|---|---|---|---|---|
list_integrations |
/cdi/integrations |
読み取り | クラウドデータ取り込みのジョブステータスを表示 | 既存のクラウドデータ取り込み連携を、1回の呼び出しにつき10件ずつ一覧表示します。 |
get_integration_job_sync_status |
/cdi/integrations/{integration_id}/job_sync_status |
読み取り | クラウドデータ取り込みのジョブステータスを表示 | 指定したCDI連携の過去の同期ステータスを、1回の呼び出しにつき10件ずつ取得します。 |
trigger_integration_sync |
/cdi/integrations/{integration_id}/sync |
書き込み | クラウドデータ取り込み連携を同期 | 指定したCDI連携の同期をトリガーします。 |
KPI
| ツール | APIエンドポイント | アクセス | 権限 | 説明 |
|---|---|---|---|---|
get_dau_data_series |
/kpi/dau/data_series |
読み取り | KPIデータを表示 | 日付ごとのユニークアクティブユーザー数の日次系列を取得します。 |
get_mau_data_series |
/kpi/mau/data_series |
読み取り | KPIデータを表示 | 30日間のローリングウィンドウにおけるユニークアクティブユーザー数の日次系列を取得します。 |
get_new_users_data_series |
/kpi/new_users/data_series |
読み取り | KPIデータを表示 | 日付ごとの新規ユーザー総数の日次系列を取得します。 |
get_uninstalls_data_series |
/kpi/uninstalls/data_series |
読み取り | KPIデータを表示 | 日付ごとのアンインストール総数の日次系列を取得します。 |
メディアライブラリー
| ツール | APIエンドポイント | アクセス | 権限 | 説明 |
|---|---|---|---|---|
create_media_library_asset |
/media_library/create |
作成 | メディアライブラリーのアセットを管理 | 外部URLまたはbase64ファイルコンテンツを使用して、Brazeメディアライブラリーにアセットをアップロードします。アップロードモードは必ず1つだけ指定する必要があります。 |
購入
| ツール | APIエンドポイント | アクセス | 権限 | 説明 |
|---|---|---|---|---|
get_product_list |
/purchases/product_list |
読み取り | カスタムイベント、属性、購入を表示 | 製品IDのページ分割されたリストを取得します。 |
get_quantity_series |
/purchases/quantity_series |
読み取り | カスタムイベント、属性、購入を表示 | 指定した期間におけるアプリ内の購入総数を取得します。 |
get_revenue_series |
/purchases/revenue_series |
読み取り | カスタムイベント、属性、購入を表示 | 指定した期間におけるアプリ内の支出総額を取得します。 |
セグメント
| ツール | APIエンドポイント | アクセス | 権限 | 説明 |
|---|---|---|---|---|
get_segment_list |
/segments/list |
読み取り | セグメントを表示 | 名前、セグメントAPI識別子、分析トラッキングフラグを含むセグメントをエクスポートします。 |
get_segment_details |
/segments/details |
読み取り | セグメントを表示 | segment_idで指定したセグメントの関連情報を取得します。 |
get_segment_data_series |
/segments/data_series |
読み取り | セグメントを表示 | セグメントの推定サイズの経時的な日次系列を取得します。 |
get_segment_filters |
MCPのみ | 読み取り | セグメントを表示 | セグメントフィルターの定義を取得します。 |
create_segment |
MCPのみ | 作成 | セグメントを作成 | 新しいセグメントを作成します。 |
edit_segment |
MCPのみ | 更新 | セグメントを編集 | 既存のセグメントを編集します。 |
セグメントツールは一般提供されており、ベータプログラムへの参加は不要です。
注
キャンペーンとセグメントをプログラムで管理するためにサポートされている方法は、MCPツールです。これらのツールを支える基盤のAPIは公開APIドキュメントに掲載されておらず、直接使用することはサポートされていません。貴社がAPIベータに登録していない限り、これらのAPIを直接使用したことによる問題について、Brazeサポートはお手伝いできません。本番環境のワークフローには、MCPツールを使用してください。
送信
| ツール | APIエンドポイント | アクセス | 権限 | 説明 |
|---|---|---|---|---|
get_send_data_series |
/sends/data_series |
読み取り | 送信データを表示 | トラッキング対象のsend_id (APIキャンペーン) の日次統計を取得します。Brazeは送信後14日間、送信分析を保存します。 |
セッション
| ツール | APIエンドポイント | アクセス | 権限 | 説明 |
|---|---|---|---|---|
get_session_data_series |
/sessions/data_series |
読み取り | セッションデータを表示 | 指定した期間におけるアプリのセッション数を取得します。 |
テンプレート
| ツール | APIエンドポイント | アクセス | 権限 | 説明 |
|---|---|---|---|---|
get_email_templates |
/templates/email/list |
読み取り | メールテンプレートを表示 | Brazeアカウントで利用可能なメールテンプレートを一覧表示します。 |
get_email_template_info |
/templates/email/info |
読み取り | メールテンプレートを表示 | 特定のメールテンプレートの情報を取得します。ドラッグ＆ドロップエディターのテンプレートには対応していません。 |
create_email_template |
/templates/email/create |
作成 | メールテンプレートを管理 | Brazeダッシュボードでメールテンプレートを作成します。 |
update_email_template |
/templates/email/update |
更新 | メールテンプレートを管理 | 既存のメールテンプレートを更新します。 |
コンテンツブロック
| ツール | APIエンドポイント | アクセス | 権限 | 説明 |
|---|---|---|---|---|
get_content_blocks |
/content_blocks/list |
読み取り | コンテンツブロックを表示 | 既存のコンテンツブロック情報を一覧表示します。 |
get_content_block_info |
/content_blocks/info |
読み取り | コンテンツブロックを表示 | 既存のコンテンツブロックの情報を取得します。必要に応じて、キャンペーンやキャンバスでの使用状況データも含められます。 |
create_content_block |
/content_blocks/create |
作成 | コンテンツブロックを管理 | コンテンツブロックを作成します。 |
update_content_block |
/content_blocks/update |
更新 | コンテンツブロックを管理 | コンテンツブロックを更新します。 |
Operator
| ツール | APIエンドポイント | アクセス | 権限 | 説明 |
|---|---|---|---|---|
send_operator_prompt |
MCPのみ | 更新 | BrazeAI Operatorを使用 | BrazeAI Operatorに自然言語のプロンプトを送信します。バックグラウンドジョブを送信し、job_idを返します。 |
get_operator_result |
MCPのみ | 読み取り | BrazeAI Operatorを使用 | 送信したOperatorジョブの結果を、そのjob_idを使用してポーリングします。 |
cancel_operator_job |
MCPのみ | 更新 | BrazeAI Operatorを使用 | 実行中のOperatorジョブをキャンセルします。 |
重要
これらのツールは、Operatorベータプログラムに参加している顧客のみが利用できます。アカウントでこの機能が有効になっていない場合、使用しようとするとエラーが発生することがあります。ベータプログラムに参加するには、アカウントマネージャーにお問い合わせください。
スキル
| ツール | APIエンドポイント | アクセス | 権限 | 説明 |
|---|---|---|---|---|
get_operator_skills |
MCPのみ | 読み取り | スキルを表示 | ワークスペースのスキルを、各スキルの名前と説明とともに一覧表示します。 |
get_operator_skill |
MCPのみ | 読み取り | スキルを表示 | 指示を含むスキルを読み取ります。 |
create_operator_skill |
MCPのみ | 作成 | スキルを表示、スキルを編集 | スキルを作成します。名前がすでに使用されている場合、Brazeはサフィックスを追加します。 |
update_operator_skill |
MCPのみ | 更新 | スキルを表示、スキルを編集 | スキルを編集します。指定しなかったフィールドは現在の値が維持されます。 |
詳しくは、スキルを参照してください。
免責事項
指示と応答の処理方法
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!