Skip to content

Braze MCPサーバー

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

Model Context Protocol（MCP）とは

Model Context Protocol（MCP）は、AIエージェントが別のプラットフォームのデータに接続し、連携できるようにする標準規格です。MCPには主に2つの構成要素があります。

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

Braze MCPサーバーについて

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

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

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

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

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

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

はい。会話ごとまたはリクエストごとにワークスペースを指定できます。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!