Braze MCPサーバーの設定

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

前提条件

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

前提条件	説明
サポートされているMCPクライアント	OAuthによるリモートMCPサーバーをサポートするクライアントであれば利用できます。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: リモート MCP コネクターとして Braze を追加する

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

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

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

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

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

• Claude
• Claude Code
• ChatGPT
• Cursor
• OpenAI Codex
• Visual Studio Code

ステップ 3: OAuth で Braze にサインインする

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

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

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

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

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

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

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

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

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

トラブルシューティング

サポート対象のクライアントで認証が失敗する

1. 会社の管理者が OAuth 設定で MCP OAuth アクセスをオンにしていることを確認します。
2. 自分のユーザーに「MCP サーバーを使用」権限があることを確認します。
3. クライアントのリダイレクト URI が承認されていることを確認します。同意ステップで「このアプリには承認が必要です」や「予期しないエラーが発生しました」などの一般的なエラーが表示される場合は、OAuth 設定でリダイレクト URI のステータスが「承認済み」になっていることを確認するよう、会社の管理者に依頼してください。
4. サインインと認可を再試行します。

未検証のクライアントで認証がブロックされる

Braze はセキュリティのため、サポート対象のクライアントドメインの許可リストを管理しています。許可リストに含まれていないクライアントから接続すると、認証がブロックされる場合があります。support for your MCP clientをご希望ですか？製品フィードバックの送信をご検討ください。

Claude Code や OpenAI Codex など、カスタムスキームを使用せずにローカルマシン上で実行されるクライアントも動作するはずです。

正常に動作していた接続で認証ができなくなる

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

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

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