コンテンツにスキップ

Braze MCPサーバーの設定

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

前提条件

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

前提条件 説明
サポートされている MCP クライアント OAuth によるリモート MCP サーバーをサポートしているクライアントであれば利用できます。Braze では、Claude、ChatGPT、Cursor、OpenAI Codex、Claude Code、Visual Studio Code などのクライアントを検証済みです。
承認済みの MCP クライアントまたはリダイレクト URI 会社の管理者が、設定 > 管理者設定 > 外部接続 > MCP クライアントでクライアントを承認する必要があります。管理者は検証済みの MCP クライアントを参照し、名前で承認できます。その他のクライアントについては、管理者がクライアントのリダイレクト URI を承認する必要があります。詳細については、MCP クライアントを管理するを参照してください。
Braze ダッシュボードのアカウント 通常の Braze 認証情報でサインインします。会社で SSO や SAML を使用している場合は、それらも利用できます。MCP 専用のログインはありません。
サーバーエンドポイントの選択 https://mcp.braze.com/mcp (US) または https://mcp.braze.eu/mcp (EU) を選択します。どちらのエンドポイントからでも、すべての Braze クラスターにアクセスできます。
有料の Braze アカウント Braze MCP サーバーは無料トライアルアカウントではご利用いただけません。

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

アクセスを付与する

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

アクセスを取り消す

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

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

使用状況を監査する

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

クライアントを接続する

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

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

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

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

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

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

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

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

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

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

  1. 必要に応じて SSO を含め、通常どおり Braze にサインインします。
  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で説明しているとおり、会社の管理者がMCPクライアントでClaudeを承認していることを確認してください。

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

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

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

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

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

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

トラブルシューティング

MCPへの認証に失敗する

  1. 会社の管理者がOAuth設定でMCP OAuthアクセスをオンにしていることを確認します。
  2. ユーザーに「Use MCP Server」権限があることを確認します。
  3. MCPクライアントが承認されていることを確認します。同意ステップで「This app needs approval」や「An unexpected error occurred」などの一般的なエラーが表示される場合は、会社の管理者に依頼して、MCPクライアントで検証済みクライアントまたはそのリダイレクト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!