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サーバーを使用して、キャンペーンやキャンバスのパフォーマンスに関する質問、セグメントやカスタム属性の調査、レポートの生成、さらにメールテンプレート、コンテンツブロック、メディアライブラリアセットなどのコンテンツ作成を、自然言語で行うことができます。

ベータ版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アクセスを失います。

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

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

当社では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!