Skip to content

Braze MCPサーバー

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

モデルコンテキストプロトコル（MCP）とは

モデルコンテキストプロトコル（MCP）とは、AIエージェントが別のプラットフォームのデータに接続し、そのデータと連動できるようにする規格です。主に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

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は現在、セキュリティのためにサポート対象ドメインの許可リストを管理しています。お使いのツールがリストに含まれておらず、認証の問題が発生した場合は、[email protected]までお問い合わせください。

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

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

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

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

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

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

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

ディレクトリへの掲載は早期アクセス開始後に順次展開されます。Braze MCPのURLを使用して、いつでも手動で接続できます。

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

現時点ではできません。IP許可リストを使用しているお客様は、早期アクセスプログラムに参加できません。

指示と応答の処理方法

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!