コンテンツにスキップ

Braze MCPサーバーの設定

BrazeリモートMCPサーバーへの接続方法、OAuthによる認証、MCPクライアントからのBrazeツールの使用開始方法について説明します。詳細については、Braze MCPサーバーを参照してください。

前提条件

始める前に、以下の準備が整っていることを確認してください。

前提条件 説明
互換性のあるMCPクライアント リモートサーバー向けのMCP標準に準拠し、OAuthで認証を行い、Dynamic Client RegistrationまたはClient ID Metadata Documentを通じて自身を登録するクライアントであれば利用できます。静的なクライアントIDとクライアントシークレットのみを受け付けるクライアントは接続できません。Brazeでは、Claude、ChatGPT、Cursor、OpenAI Codex、Claude Code、Visual Studio Codeで動作をテストしています。
承認済みのリダイレクトURI 会社の管理者が、設定 > 管理者設定 > 外部接続で、クライアントのリダイレクトURIを承認する必要があります。管理者は、クライアントのOAuth設定またはコネクター設定からリダイレクトURIをコピーできます。詳細については、OAuth設定を管理するを参照してください。
Brazeダッシュボードのアカウント 通常のBrazeの認証情報でサインインします。会社でSSOまたはSAMLを使用している場合は、それらも利用できます。MCP専用のログインはありません。
サーバーエンドポイントの選択 https://mcp.braze.com/mcp (US) または https://mcp.braze.eu/mcp (EU) を選択します。どちらのエンドポイントからでも、すべてのBrazeクラスターにアクセスできます。
有料のBrazeアカウント Braze MCPサーバーは、無料トライアルアカウントではご利用いただけません。
IP許可リストを使用していないこと IP許可リストを使用している顧客は、現時点ではBraze MCPサーバーを使用できません。

アクセスの管理 (管理者向け)

アクセスを付与する

管理者は、「MCPサーバーを使用」権限によってMCPサーバーへのアクセスを制御します。デフォルトでは、ユーザーはこの権限を持っていないため、明示的に付与する必要があります。

アクセスを取り消す

アクセスを取り消すには、ユーザーから「MCPサーバーを使用」権限を削除します。ユーザーからダッシュボードの権限を削除すると、次のリクエスト時に、接続されているすべてのエージェントからもそれらの機能が削除されます。

トークンが漏洩した、または不正に使用されたと思われる場合、会社の管理者は設定 > 管理者設定 > 外部接続で、会社のすべてのMCP OAuthトークンを一括で取り消すことができます。接続されているすべてのクライアントがアクセスを失い、すべてのユーザーが再接続する必要があります。詳細については、MCP OAuthトークンを取り消すを参照してください。

使用状況を監査する

ユーザーがOAuthを通じて正常に接続すると、セキュリティイベントレポートにイベントが記録されます。

クライアントを接続する

ステップ 1: 権限とワークスペースへのアクセスを確認する

  1. 「Use MCP Server」権限があることを確認するか、会社の管理者に確認を依頼してください。
  2. 複数のワークスペースへのアクセスが必要な場合は、関連するすべてのワークスペースでこの権限が有効になっていることを確認してください。
  3. クライアントのリダイレクトURIがOAuth設定で承認されていることを、会社の管理者に確認してもらってください。承認されていない場合、ステップ 3でBrazeへのサインインを完了できません。

ステップ 2: Brazeをリモート MCP コネクターとして追加する

MCPクライアントで新しいリモートサーバーまたはカスタムコネクターを追加し、Braze MCP URLを入力します。たとえばClaudeでは、設定 > コネクタ > カスタムコネクタを追加に移動して、URLを貼り付けます。

クライアントID、クライアントシークレット、API キーは必要ありません。クライアントは自動的にBrazeに登録されます。ただし、登録によってクライアントのリダイレクトURIが会社に対して承認されるわけではないため、ステップ 1で説明したとおり、引き続き管理者による承認が必要です。

Braze MCP エンドポイントのオプション:

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

クライアントの設定ガイド:

ステップ 3: OAuthを使用してBrazeにサインインする

エージェントが初めてBrazeツールを呼び出すと、クライアントがブラウザーウィンドウを開き、サインインのためにBrazeへ移動します。

  1. 通常どおりBrazeにサインインします (必要に応じてSSOも使用します)。
  2. 同じクラスター上の複数の会社にアクセスできるログインの場合は、使用する会社を選択します。
  3. 同意画面で、アプリケーションが要求しているアクセス内容を確認します。
  4. 確認のチェックボックスを選択してBrazeのプライバシーポリシーに同意し、続行を選択してMCPクライアントに戻ります。

Claude DesktopがBrazeアカウント情報へのアクセスとBrazeデータへの広範なアクセスを要求していることを示すBrazeの同意画面。プライバシーポリシーへの同意チェックボックスと、キャンセルボタンおよび続行ボタンが表示されている。

セッションでは、自動的に更新される有効期間の短いアクセストークンが使用されます。ときどき再度サインインが必要になる場合があります。

ステップ 4: 使用するワークスペースをエージェントに伝える

アカウントで複数のワークスペースにアクセスできる場合は、プロンプトでワークスペースを指定してください。例:

  • I'd like to look at campaign analytics for the past week in the Production workspace.
  • Can you compare this week's analytics between my prod-1 workspace and my prod-2 workspace?

ワークスペースを指定しない場合、エージェントから確認を求められることがあります。

ステップ 5: テストプロンプトを送信する

設定後、次のような簡単な検証用プロンプトを送信します。

  • List the Braze tools available in this workspace.
  • Show my recent キャンバス from the Production workspace.

その他の例については、Braze MCPサーバーの使用を参照してください。

例: Claudeと接続する

クライアントの接続は、数ステップで完了します。以下の手順ではClaudeを使用していますが、他の互換クライアントでも流れはほぼ同じです。

開始する前に、ステップ 1で説明されているとおり、会社の管理者がクライアントのリダイレクトURIを承認していることを確認してください。

  1. Claudeで、設定 > コネクタ > カスタムコネクタを追加に移動します。
  2. Brazeなどの名前を入力し、Braze MCP URLを貼り付けます。US の場合はhttps://mcp.braze.com/mcp、EU の場合はhttps://mcp.braze.eu/mcpです。クライアントID、クライアントシークレット、API キーは必要ありません。
  3. 追加を選択してコネクタを保存します。ClaudeはBrazeに自動的に登録されますが、これによって会社でのリダイレクトURIが承認されるわけではありません。
  4. 接続を選択して認証を開始します。Claudeがブラウザーウィンドウを開き、Brazeのサインイン画面に移動します。
  5. 通常の認証情報でBrazeにサインインします。会社でSSOを使用している場合はSSOでサインインします。ログインで同じクラスター上の複数の会社にアクセスできる場合は、使用する会社を選択します。
  6. 同意画面で要求されたアクセス内容を確認し、確認のチェックボックスを選択してから、続行を選択します。Claudeがチャットに戻り、エージェントがBrazeのツールを使用できるようになります。

接続を確認するには、Show my recent キャンバス from the Production workspaceのようなテストプロンプトを送信します。

ローカルベータサーバーからの移行

移行中は、ローカルベータサーバーとリモートホスト型サーバーを並行して実行できます。どちらを使用するかをエージェントに明示的に指示する必要がある場合があります。

リモートホスト型サーバーには、ローカルベータサーバーにはない新しいツールが含まれています。ローカルサーバー向けにスキルを構築している場合は、新しいツール名と動作を参照するようにスキルを更新する必要がある場合があります。

ワークフローとスキルがリモートサーバーで動作することを確認したら、ローカルホスト型サーバーを無効にしてください。

トラブルシューティング

MCPへの認証が失敗する

  1. 会社の管理者がOAuth設定でMCP OAuthアクセスをオンにしていることを確認してください。
  2. ユーザーに「Use MCP Server」権限があることを確認してください。
  3. クライアントのリダイレクトURIが承認されていることを確認してください。同意ステップで「This app needs approval」や「An unexpected error occurred」などの一般的なエラーが表示される場合は、OAuth設定でリダイレクトURIのステータスが「承認済み」になっていることを確認するよう、会社の管理者に依頼してください。
  4. サインインと認可をもう一度試してください。

正常だった接続で認証できなくなった

クライアントが接続済みだったのに認証に失敗するようになった場合は、会社の管理者が自社のMCP OAuthトークンを取り消した可能性があります。クライアントからBrazeにもう一度サインインして、新しい接続を作成してください。それでもサインインに失敗する場合は、MCP OAuthアクセスがオンになっていること、および引き続き「Use MCP Server」権限があることを確認してください。

クライアントにツールが表示されない

エージェントがBrazeツールを一覧表示できない場合は、数分待ってからもう一度お試しください。こうした問題は一時的なものであることが多く、自然に解消されます。

エージェントが想定したツールにアクセスできない

  1. ダッシュボードユーザーに必要な権限があることを確認してください。エージェントは、ご自身のダッシュボードアクセス権に一致するツールしか使用できません。
  2. プロンプトで想定したワークスペースを選択していることを確認してください。
  3. エージェントにget_workspacesを呼び出すよう依頼し、利用可能なワークスペースIDを確認してください。

エージェントが誤ったワークスペースを使用する

アカウントが複数のワークスペースにアクセスできる場合は、Brazeダッシュボードに表示されている正確な名前を使って、プロンプトでワークスペースを指定してください。ワークスペースを指定しないと、エージェントが確認を求めてきたり、想定外のワークスペースを使用したりする場合があります。

別の会社に切り替える

会社は最初に認可したときに設定されます。同じクラスター上の別の会社で作業するには、クライアントでBrazeコネクターの接続を解除してから再認可し、サインイン時に別の会社を選択してください。

指示と応答の処理方法

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クライアントを通じて実装する前に必ず確認してください。

Brazeカスタマーエンゲージメントプラットフォームのドキュメント。

リソース
法的情報
会社情報
© 2026 Braze, Inc. All rights reserved.
Braze ステータスの確認
New Stuff!