コンテンツにスキップ

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に直接接続できます。これにより、AIツールはキャンバスやキャンペーンの分析、カスタム属性、セグメントなどの集計データを読み取れるようになります。Braze MCPサーバーは、次のような用途や利用者に最適です。

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

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

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

Braze MCPサーバーを使用すると、AIツールがBrazeと連携できるようになります。BrazeAI OperatorでJiraやNotionなど他の製品のツールを使用できるようにするには、外部MCPサーバーを参照してください。

ベータ版のMCPサーバーは非推奨になりましたか?

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

リモートサーバーは何が違いますか?

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

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

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

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

よくある質問(FAQ)

どのMCPクライアントを使用できますか?

MCPクライアントとは、Claude、ChatGPT、CursorなどのBraze MCPサーバーに接続するAIツールのことです。リモートサーバー向けのMCP標準に準拠したMCPクライアントであれば、Braze MCPサーバーで動作します。クライアントはOAuthで認証し、Dynamic Client RegistrationまたはClient ID Metadata Documentを通じて自身を登録する必要があります。そのため、クライアントIDやクライアントシークレットを入力する必要はありません。サインインする前に、会社の管理者がMCPクライアントで、クライアントをBraze検証済みクライアントとして承認するか、カスタムリダイレクトURIを承認する必要があります。

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がテストしていないクライアントで、BrazeリモートMCPサーバーを使用できますか?

はい、クライアントがDynamic Client RegistrationまたはClient ID Metadata Documentを通じて自身を登録できる場合は使用できます。サインインする前に、会社の管理者がMCPクライアントでクライアントのリダイレクトURIを承認する必要があります。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サーバーは無料トライアルアカウントではご利用いただけません。

指示と応答の処理方法

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!