このページはAIにより自動翻訳されており、不正確な内容が含まれている可能性があります。翻訳の誤りを報告するには、ページ右側の目次の下にあるフィードバックをご利用ください。
Braze MCPサーバー関数
Braze MCPサーバーは、特定のBraze REST APIエンドポイントに対応する読み取りおよび書き込みツールを公開しています。詳細については、Braze MCPサーバーを参照してください。
重要
ローカルホスト型のBraze MCPサーバー（ベータ版）は非推奨となっており、今後の更新は行われません。
注
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 | 既存のクラウドデータ取り込み連携を、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 | コンテンツブロックを更新します。 |
オペレーター
| ツール | APIエンドポイント | アクセス | 説明 |
|---|---|---|---|
send_operator_prompt |
N/A | update | 自然言語のプロンプトをBrazeAI Operatorに送信します。バックグラウンドジョブを送信し、job_idを返します。 |
get_operator_result |
N/A | read | job_idを使用して、送信済みのオペレータージョブの結果をポーリングします。 |
cancel_operator_job |
N/A | 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!