コンテンツにスキップ

Braze MCPサーバー

Braze MCPサーバーについて学びましょう。これはClaudeやCursorのようなAIツールが非PIIのBrazeデータにアクセスして質問に答え、傾向を分析し、インサイトを提供し、コンテンツを作成できるようにする安全なリモート接続です。

Model Context Protocol(MCP)とは

Model Context Protocol(MCP)は、AIエージェントが別のプラットフォームに接続し、そのデータを扱えるようにするための標準規格です。MCPは主に次の2つの要素で構成されています。

  • MCPクライアント:AIエージェントが実行されるアプリケーションです(CursorやClaudeなど)。
  • MCPサーバー:Brazeなどの別のプラットフォームが提供するサービスです。AIが使用できるツールと、アクセスできるデータを定義します。

Braze MCPサーバーについて

Braze MCPサーバーを設定すると、エージェント、アシスタント、チャットボットなどのAIツールをBrazeに直接接続できます。これらのツールは、キャンバスやキャンペーンの分析、カスタム属性、セグメントなどの集計データを読み取れるようになります。Braze MCPサーバーは、次のような用途に最適です。

  • Brazeのコンテキストを必要とするAI搭載ツールの構築
  • CRMエンジニアによるマルチステップのエージェントワークフローの作成
  • テクニカルマーケターによる自然言語クエリの試行

Braze MCPサーバーには、読み取りツールと書き込みツールの両方が含まれています。これらのツールは、Brazeのユーザープロファイルのデータを返しません。エージェントには、Brazeダッシュボードのユーザー権限がそのまま引き継がれます。利用可能なツールの一覧については、利用可能なAPI関数を参照してください。

MCPサーバーを使用すると、自然言語でキャンペーンやキャンバスのパフォーマンスについて質問したり、セグメントやカスタム属性を調べたり、レポートを生成したり、メールテンプレート、コンテンツブロック、メディアライブラリーのアセットなどのコンテンツを作成したりできます。

ベータ版のMCPサーバーは非推奨ですか?

はい。2025年8月にリリースされたローカルホスト型のMCPサーバーは非推奨となり、今後アップデートは提供されません。引き続きご利用いただくことは可能ですが、Brazeではリモートホスト型バージョンへの移行をお勧めしています。

リモートサーバーはどう違いますか?

以前のBraze MCPサーバーは、お使いのマシン上でローカルに実行されていました。パッケージのインストール、設定ファイルの管理、適切な権限を持つBraze API キーの作成が必要でした。リモートMCPサーバーでは、こうしたローカルでの設定が不要になります。

対応するMCPクライアントから1分以内に接続できます。認証にはOAuthを使用します。アクセス権は共有のAPI キーではなく、Brazeダッシュボードのユーザーアカウントに紐づいているため、エージェントが閲覧・実行できる内容はダッシュボードの権限と同じになります。ダッシュボードユーザーがBrazeでアクセス権を失うと、クライアントもアクセス権を失います。

主な違いは次のとおりです。

  • 設定:パッケージのインストールや設定ファイルの編集の代わりに、BrazeのURLを貼り付けます。
  • 認証:API キーを作成する代わりに、Brazeアカウントでサインインします。
  • 権限:アクセス権はAPI キーの権限ではなく、ダッシュボードのユーザーアカウントに基づきます。
  • ワークスペースの指定:ワークスペースのコンテキストは、ローカル設定で固定されるのではなく、リクエストごとに渡されます。

よくある質問(FAQ)

どのMCPクライアントがサポートされていますか?

OAuthを使用したリモートMCPサーバーをサポートするMCPクライアントであれば動作します。Brazeが検証済みのクライアントは以下のとおりです。

  • カスタムコネクター経由のClaude
  • カスタムコネクター経由のChatGPT
  • Cursor
  • OpenAI Codex
  • Claude Code
  • Visual Studio Code

MCPクライアントはBrazeのどのデータにアクセスできますか?

MCPクライアントは、ユーザーレベルのPIIを返さないツールにアクセスできます。

MCPクライアントはBrazeデータを変更できますか?

はい、ダッシュボードユーザーにその権限がある場合は変更できます。

Braze API キーは引き続き必要ですか?

MCPには不要です。API キーはREST APIで引き続き使用でき、非推奨にはなりません。

どのリージョンがサポートされていますか?

両方のBrazeクラスターがサポートされています。現在、2つのエンドポイントが利用可能です。

  • https://mcp.braze.com/mcp(US)
  • https://mcp.braze.eu/mcp(EU)

どちらのエンドポイントからでも、すべてのBrazeクラスターにアクセスできます。

検証済みリスト以外のツールでBrazeリモートMCPサーバーを使用できますか?

試すことはできますが、認証がブロックされる場合があります。Brazeは現在、セキュリティのためにサポート対象ドメインの許可リストを管理しています。support for your MCP clientをご希望ですか?製品フィードバックの送信をご検討ください。

リモートサーバーは複数のワークスペースをサポートしていますか?

はい。会話ごとまたはリクエストごとにワークスペースを指定できます。1つの接続で、アクセスが許可されているすべてのワークスペースをカバーできます。

エージェントはユーザーレベルのPIIにアクセスできますか?

いいえ。現時点では、PIIを公開するツールは利用できません。

MCPサーバー経由で行ったキャンペーンの編集は編集履歴に表示されますか?

はい。MCPツール経由で行ったキャンペーンの編集は、サインインしているダッシュボードユーザーによるものとして記録され、キャンペーンの編集履歴に表示されます。

キャンバス固有のMCPツールは現在、読み取り専用です(get_canvas_list、get_canvas_details、get_canvas_data_series、get_canvas_data_summary)。

権限が変更された場合はどうなりますか?

エージェントのアクセスはダッシュボードユーザーに連動して変更されます。権限の変更は次のリクエスト時に適用されます。無効化されたダッシュボードユーザーはMCPアクセスを失います。

クライアントのディレクトリにBrazeコネクターが表示されないのはなぜですか?

すべてのMCPクライアントでディレクトリへの掲載が利用できるとは限りません。Braze MCPのURLを使用して、いつでも手動で接続できます。

無料トライアル中にBraze MCPサーバーを使用できますか?

いいえ。Braze MCPサーバーは無料トライアルアカウントではご利用いただけません。

当社ではIP許可リストを使用しています。リモートMCPサーバーを使用できますか?

現時点ではできません。IP許可リストを使用している場合、リモートMCPサーバーは使用できません。

指示と応答の処理方法

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!