Braze MCPサーバーを使用する
リモートBraze MCPサーバーに接続した後、自然言語を使ってBrazeデータとやり取りする方法を学習しましょう。詳細については、Braze MCPサーバーを参照してください。
リモートのBraze MCPサーバーは早期アクセス段階です。ローカルホスト型のBraze MCPサーバー（ベータ版）は非推奨となっており、現時点では引き続き利用可能ですが、今後の更新は行われません。
前提条件
この機能を使用する前に、Braze MCPサーバーのセットアップを完了する必要があります。
ベストプラクティス
自然言語ツールを通じてBraze MCPサーバーを使用する際は、以下のポイントを念頭に置いてください。
- 特に複数のワークスペースにアクセスできる場合は、プロンプトでワークスペースを確認してください。
- 分析をリクエストする際は、日付範囲と指標を具体的に指定してください。
- 出力を検証する際は、エージェントにどのツールを使用したか確認するよう依頼してください。
- 影響の大きいレコメンデーションは、Brazeダッシュボードのソースデータと照合してください。
使用例
Braze MCPサーバーのセットアップが完了したら、自然言語でBrazeとやり取りできます。以下に開始するための例を紹介します。
どのワークスペースにアクセスできますか？
Show my available Braze workspaces and tell me which one to use for production campaign analytics.
get_workspacesを呼び出し、以下のワークスペースが見つかりました。
Marketing - Production（app_group_id:YOUR-APP-GROUP-ID-1）Marketing - Staging（app_group_id:YOUR-APP-GROUP-ID-2）
本番キャンペーン分析のプロンプトにはMarketing - Productionを使用してください。
詳細については、利用可能なAPI関数を参照してください。
先週のキャンペーンパフォーマンスを表示する
In the Marketing - Production workspace, show campaign performance for the last seven days, including sends, opens, clicks, and top performers.
リクエストされたワークスペースと日付範囲に対してget_campaign_listとget_campaign_dataseriesを使用しました。
概要：
- 総送信数:
YOUR-TEST-SENDS - 総開封数:
YOUR-TEST-OPENS - 総クリック数:
YOUR-TEST-CLICKS - 開封数トップのキャンペーン:
YOUR-TEST-CAMPAIGN-NAME
必要に応じて、キャンペーン別、チャネル別、または日別に分解できます。
詳細については、利用可能なAPI関数を参照してください。
メールテンプレートを作成する
In the Marketing - Production workspace, create an onboarding email template named "YOUR-TEST-TEMPLATE-NAME".
create_email_templateを使用してテンプレートを作成しました。
- テンプレートID:
YOUR-TEST-TEMPLATE-ID-123 - テンプレート名:
YOUR-TEST-TEMPLATE-NAME - ワークスペース:
Marketing - Production
詳細については、利用可能なAPI関数を参照してください。
ワークフローの例
以下の例では、複数のツールを組み合わせてタスクを最初から最後まで完了します。
複数のワークスペースにまたがるレポート
Get me an analytics report for the past week from my US Prod workspace and my EU Prod workspace, and compare total sends and open rates.
get_workspacesを呼び出してアクセスを確認し、過去7日間について各ワークスペースでget_campaign_dataseriesを実行しました。
US Prod:YOUR-TEST-SENDS件の送信、開封率YOUR-TEST-OPEN-RATEEU Prod:YOUR-TEST-SENDS件の送信、開封率YOUR-TEST-OPEN-RATE
今週はUS Prodの方がより多くのメッセージを送信しましたが、EU Prodの方が開封率が高い結果となりました。いずれかのワークスペースをキャンペーン別またはチャネル別に分解できます。
ステージングから本番へテンプレートをコピーする
Copy the email templates from my Staging workspace to my Production workspace.
get_email_templatesとget_email_template_infoを使用してStagingのテンプレートを読み取り、create_email_templateを使用してProductionにそれぞれ再作成しました。
YOUR-TEST-TEMPLATE-NAME-1:Productionに作成済み（YOUR-TEST-TEMPLATE-ID-1）YOUR-TEST-TEMPLATE-NAME-2:Productionに作成済み（YOUR-TEST-TEMPLATE-ID-2）
ドラッグ＆ドロップエディターのテンプレートはget_email_template_infoでサポートされていないためスキップしました。コピーされたテンプレートを確認する必要があればお知らせください。
週次キャンペーンヘルスサマリー
Give me a weekly campaign health summary for the Production workspace.
get_campaign_listとget_campaign_dataseriesを使用して、Productionの過去7日間のアクティビティを取得しました。
- 総送信数:
YOUR-TEST-SENDS - 開封率:
YOUR-TEST-OPEN-RATE - クリック率:
YOUR-TEST-CLICK-RATE - コンバージョン数トップのキャンペーン:
YOUR-TEST-CAMPAIGN-NAME
送信数は前週比で増加しました。チャネル別の内訳を追加したり、エンゲージメントが低下しているキャンペーンをフラグ付けしたりすることもできます。
リモートMCPサーバーの仕組み
リクエストを送信すると、裏側でいくつかのステップが実行されます。
- クライアントにプロンプトを入力します。 先週のキャンペーンパフォーマンスを尋ねるなど、自然言語でリクエストを入力します。
- クライアントのモデルがツールを選択します。 クライアントのAIモデルがリクエストを解釈し、
get_campaign_listやget_campaign_dataseriesなどの1つ以上のBrazeツール呼び出しに変換します。 - Brazeがツール呼び出しを実行します。 リモートMCPサーバーは、認証済みのOAuthセッションを通じて各ツール呼び出しを受信し、指定されたワークスペースを適用して、対応するBraze REST APIエンドポイントに対して実行します。
- Brazeが結果を返します。 サーバーがデータをクライアントに返し、クライアントがフォーマットして表示します。
アクセス権は以下の2つの交差部分で決まります。
- 接続を認可した際に付与されたスコープ（
mcp:toolsなど）。 - ダッシュボードのユーザー権限。 ダッシュボードでキャンペーンを表示できない場合、エージェントも表示できません。メールテンプレートを作成できる場合、エージェントも作成できます。エージェントがユーザー自身のアクセス権を超えることはありません。
ワークスペースのコンテキストはローカルの設定ファイルに保存されるのではなく、各リクエストとともに渡されるため、1つの接続でアクセスが認可されたすべてのワークスペースを操作できます。
免責事項
指示と応答の処理方法
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クライアントを通じて実装する前に必ず確認してください。