Braze MCPサーバー関数
Braze MCPサーバーは、特定のBraze REST APIエンドポイントに対応するAPI関数のセットを公開しています。ClaudeやCursorなどのMCPクライアントは、これらの関数を呼び出して非PIIデータの取得や、PIIを含まない書き込みアクションを実行できます。より一般的な情報については、Braze MCPサーバーを参照してください。
Braze MCPサーバーはベータ版です。使用するためにアクセスをリクエストする必要はありません。セットアップ手順に従って開始してください。Braze MCPサーバーを使用することにより、Brazeベータ利用規約に同意したものとみなされます。改善にご協力いただける場合は、mcp-product@braze.com までフィードバックをお送りください。
前提条件
この機能を使用する前に、Braze MCPサーバーのセットアップを完了する必要があります。
利用可能なBraze API関数
MCPクライアントは、Braze MCPサーバーとやり取りするために以下のAPI関数を参照します。
一般関数
これらの関数は、MCPクライアントが利用可能なBraze API関数を検出し、実行するのに役立ちます。
| 関数 | 説明 |
|---|---|
list_functions |
利用可能なすべてのBraze API関数を、説明とパラメーターと共に一覧表示します。 |
call_function |
指定されたパラメーターで特定の読み取り専用Braze API関数を呼び出します。 |
call_write_function |
指定されたパラメーターで特定の書き込み可能なBraze API関数を呼び出します。 |
Campaigns
| 関数 | エンドポイント | 説明 |
|---|---|---|
get_campaign_list |
/campaigns/list |
メタデータ付きのCampaignリストをエクスポートします。 |
get_campaign_details |
/campaigns/details |
特定のCampaignに関する詳細情報を取得します。 |
get_campaign_dataseries |
/campaigns/data_series |
Campaignの時系列分析データを取得します。 |
Canvases
| 関数 | エンドポイント | 説明 |
|---|---|---|
get_canvas_list |
/canvas/list |
メタデータ付きのCanvasリストをエクスポートします。 |
get_canvas_details |
/canvas/details |
特定のCanvasに関する詳細情報を取得します。 |
get_canvas_data_summary |
/canvas/data_summary |
Canvasのパフォーマンスに関するサマリー分析を取得します。 |
get_canvas_data_series |
/canvas/data_series |
Canvasの時系列分析データを取得します。 |
カタログ
| 関数 | エンドポイント | 説明 |
|---|---|---|
get_catalogs |
/catalogs |
ワークスペース内のカタログのリストを返します。 |
get_catalog_items |
/catalogs/{catalog_name}/items |
ページネーションをサポートして、複数のカタログアイテムとその内容を返します。 |
get_catalog_item |
/catalogs/{catalog_name}/items/{item_id} |
特定のカタログアイテムとその内容をIDで返します。 |
クラウドデータ取り込み
| 関数 | エンドポイント | 説明 |
|---|---|---|
list_integrations |
/cdi/integrations |
既存のCDI統合のリストを返します。 |
get_integration_job_sync_status |
/cdi/integrations/{integration_id}/job_sync_status |
指定されたCDI統合の過去の同期ステータスを返します。 |
Content Blocks
| 関数 | エンドポイント | 説明 |
|---|---|---|
get_content_blocks_list |
/content_blocks/list |
利用可能なコンテンツブロックを一覧表示します。 |
get_content_blocks_info |
/content_blocks/info |
コンテンツブロックに関する情報を取得します。 |
カスタム属性
| 関数 | エンドポイント | 説明 |
|---|---|---|
get_custom_attributes |
/custom_attributes |
アプリ用に記録されたカスタム属性をエクスポートします。 |
イベント
| 関数 | エンドポイント | 説明 |
|---|---|---|
get_events_list |
/events/list |
アプリ用に記録されたカスタムイベントのリストをエクスポートします。 |
get_events_data_series |
/events/data_series |
カスタムイベントの時系列データを取得します。 |
get_events |
/events |
ページネーション対応の詳細なイベントデータを取得します。 |
KPI
| 関数 | エンドポイント | 説明 |
|---|---|---|
get_new_users_data_series |
/kpi/new_users/data_series |
新規ユーザー数の日次推移。 |
get_dau_data_series |
/kpi/dau/data_series |
デイリーアクティブユーザーの時系列データ。 |
get_mau_data_series |
/kpi/mau/data_series |
月間アクティブユーザーの時系列データ。 |
get_uninstalls_data_series |
/kpi/uninstalls/data_series |
アプリのアンインストール時系列データ。 |
メディアライブラリ
これはBraze MCPサーバーにおける唯一の書き込み関数です。使用するには、APIキーに media_library.create 権限が必要です。
| 関数 | エンドポイント | 説明 |
|---|---|---|
create_media_library_asset |
/media_library/create |
Brazeメディアライブラリにアセットをアップロードします。公開アクセス可能なURL（asset_url）またはBase64エンコードされたファイル（asset_file_base64）のいずれかを指定できますが、両方を同時に指定することはできません。画像のサイズ上限は5 MBです。 |
メッセージ
| 関数 | エンドポイント | 説明 |
|---|---|---|
get_scheduled_broadcasts |
/messages/scheduled_broadcasts |
今後のスケジュール済みCampaignsとCanvasesを一覧表示します。 |
ユーザー設定センター
| 関数 | エンドポイント | 説明 |
|---|---|---|
get_preference_centers |
/preference_center/v1/list |
利用可能なユーザー設定センターを一覧表示します。 |
get_preference_center_details |
/preference_center/v1/{preferenceCenterExternalID} |
特定のユーザー設定センターの詳細（HTMLコンテンツやオプションを含む）を表示します。 |
購入
| 関数 | エンドポイント | 説明 |
|---|---|---|
get_product_list |
/purchases/product_list |
商品IDのページネーション付きリストをエクスポートします。 |
get_revenue_series |
/purchases/revenue_series |
収益分析の時系列データ。 |
get_quantity_series |
/purchases/quantity_series |
購入数量の時系列データ。 |
Segments
| 関数 | エンドポイント | 説明 |
|---|---|---|
get_segment_list |
/segments/list |
分析トラッキングステータス付きのSegmentリストをエクスポートします。 |
get_segment_data_series |
/segments/data_series |
Segmentの時系列分析データ。 |
get_segment_details |
/segments/details |
特定のSegmentに関する詳細情報。 |
送信
| 関数 | エンドポイント | 説明 |
|---|---|---|
get_send_data_series |
/sends/data_series |
トラッキング対象Campaign送信の日次分析。 |
セッション
| 関数 | エンドポイント | 説明 |
|---|---|---|
get_session_data_series |
/sessions/data_series |
アプリセッション数の時系列データ。 |
SDK認証キー
| 関数 | エンドポイント | 説明 |
|---|---|---|
get_sdk_authentication_keys |
/app_group/sdk_authentication/keys |
アプリのすべてのSDK認証キーを一覧表示します。 |
サブスクリプション
| 関数 | エンドポイント | 説明 |
|---|---|---|
get_user_subscription_groups |
/subscription/user/status |
特定のユーザーの購読グループを一覧表示し、取得します。 |
get_subscription_group_status |
/subscription/status/get |
サブスクリプショングループ内のユーザーのサブスクリプション状態を取得します。 |
テンプレート
| 関数 | エンドポイント | 説明 |
|---|---|---|
get_email_templates_list |
/templates/email/list |
利用可能なメールテンプレートを一覧表示します。 |
get_email_template_info |
/templates/email/info |
メールテンプレートに関する情報を取得します。 |
免責事項
モデルコンテキストプロトコル（MCP）は新たに導入されたオープンソースプロトコルであり、現時点ではセキュリティ上の問題や脆弱性の影響を受けやすい可能性があります。
Braze MCPサーバーの設定コードと手順は、Brazeが「現状のまま」かつ一切の保証なしに提供するものであり、顧客は自己責任で使用するものとします。Brazeは、MCPの不適切な設定、誤用、または発生する可能性のあるセキュリティ上の問題に起因するいかなる結果についても責任を負いません。Brazeは、顧客に対し、設定を慎重に確認し、提示されたガイドラインに従うことで、Braze環境の完全性とセキュリティに関連するリスクを低減することを強く推奨します。
サポートが必要な場合や不明点がある場合は、Brazeサポートまでお問い合わせください。