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-RATE開封率EU 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クライアントを通じて実装する前に必ず確認してください。