Skip to content

Braze MCPサーバー関数

Braze MCPサーバーは、特定のBraze REST APIエンドポイントに対応するAPI関数のセットを公開しています。ClaudeやCursorなどのMCPクライアントは、これらの関数を呼び出して非PIIデータを取得し、適切な権限があればPIIを含まない書き込みアクションを実行できます。より一般的な情報については、Braze MCPサーバーを参照してください。

前提条件

この機能を使用する前に、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

create_content_block関数とupdate_content_block関数は書き込み関数です。MCPクライアントはcall_write_functionでこれらを呼び出す必要があり、APIキーには対応するcontent_blocks.createまたはcontent_blocks.update権限が必要です。

関数 エンドポイント 説明
get_content_blocks_list /content_blocks/list 利用可能なコンテンツブロックを一覧表示します。
get_content_blocks_info /content_blocks/info コンテンツブロックに関する情報を取得します。
create_content_block /content_blocks/create コンテンツブロックを作成します。namecontentが必須です。オプションフィールドはdescriptionstateactiveまたはdraftである必要があります)、およびtagsです。
update_content_block /content_blocks/update 既存のコンテンツブロックを更新します。content_block_idと、少なくとも1つの更新可能なフィールド(namecontentdescriptionstateactiveまたはdraftである必要があります)、またはtags)が必須です。

カスタム属性

関数 エンドポイント 説明
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 アプリのアンインストール時系列データです。

メディアライブラリ

create_media_library_asset関数は書き込み関数です。MCPクライアントはcall_write_functionでこれを呼び出す必要があり、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 サブスクリプショングループ内のユーザーのサブスクリプション状態を取得します。

テンプレート

create_email_template関数とupdate_email_template関数は書き込み関数です。MCPクライアントはcall_write_functionでこれらを呼び出す必要があり、APIキーには対応するtemplates.email.createまたはtemplates.email.update権限が必要です。

関数 エンドポイント 説明
get_email_templates_list /templates/email/list 利用可能なメールテンプレートを一覧表示します。
get_email_template_info /templates/email/info メールテンプレートに関する情報を取得します。
create_email_template /templates/email/create メールテンプレートを作成します。template_namesubject、およびbodyが必須です。オプションフィールドはplaintext_bodypreheadertags、およびshould_inline_cssです。
update_email_template /templates/email/update 既存のメールテンプレートを更新します。email_template_idと、少なくとも1つの更新可能なフィールド(template_namesubjectbodyplaintext_bodypreheadertags、またはshould_inline_css)が必須です。

免責事項

モデルコンテキストプロトコル(MCP)は新たに導入されたオープンソースプロトコルであり、現時点ではセキュリティ上の問題や脆弱性の影響を受けやすい可能性があります。

Braze MCPサーバーの設定コードと手順は、Brazeが「現状のまま」かつ一切の保証なしに提供するものであり、顧客は自己責任で使用するものとします。Brazeは、MCPの不適切な設定、誤用、または発生する可能性のあるセキュリティ上の問題に起因するいかなる結果についても責任を負いません。Brazeは、顧客に対し、設定を慎重に確認し、提示されたガイドラインに従うことで、Braze環境の完全性とセキュリティに関連するリスクを低減することを強く推奨します。

サポートが必要な場合や不明点がある場合は、Brazeサポートまでお問い合わせください。

New Stuff!