このページはAIにより自動翻訳されており、不正確な内容が含まれている可能性があります。翻訳の誤りを報告するには、ページ右側の目次の下にあるフィードバックをご利用ください。

Braze MCPサーバーの設定

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

重要

ローカルホスト型のBraze MCPサーバー（ベータ版）は非推奨となっており、今後の更新は行われません。

前提条件

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

前提条件	説明
サポートされているMCPクライアント	OAuthを使用したリモートMCPサーバーをサポートする任意のクライアントが利用可能です。BrazeではClaude、ChatGPT、Cursor、OpenAI Codex、Claude Code、およびVisual Studio Codeでの動作を確認しています。
Brazeダッシュボードアカウント	通常のBraze認証情報（会社でSSOやSAMLを使用している場合はそれらを含む）でサインインします。MCP専用のログインは不要です。
サーバーエンドポイントの選択	`https://mcp.braze.com/mcp`（US）または`https://mcp.braze.eu/mcp`（EU）を選択してください。どちらのエンドポイントからでも任意のBrazeクラスターにアクセスできます。
IPアローリストなし	IPアローリストを使用している顧客は、現時点ではBraze MCPサーバーを使用できません。

注

エージェントのアクセス権はダッシュボードの権限を反映します。ダッシュボードのアクセスがワークスペース全体ではなくチームにスコープされている場合、一部のツールが動作しないことがあります。

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

注

ユーザーが接続する前に、会社の管理者が設定 > 管理者設定 > OAuthでMCP OAuthアクセスを有効にする必要があります。詳細については、OAuth設定の管理を参照してください。

アクセスの付与

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

アクセスの取り消し

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

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

使用状況の監査

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

クライアントを接続する

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

あなたまたは会社の管理者が「Use MCP Server」権限を持っていることを確認する必要があります。
複数のワークスペースにアクセスする必要がある場合は、関連するすべてのワークスペースでこの権限が有効になっていることを確認してください。

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

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

クライアントID、クライアントシークレット、またはAPIキーは不要です。クライアントはBrazeに自動的に登録されます。

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

https://mcp.braze.com/mcp（US）
https://mcp.braze.eu/mcp（EU）

ヒント

EUのお客様はEUエンドポイントを使用してください。EU以外のお客様はどちらのエンドポイントも使用できます。

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

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

SSOが必要な場合を含め、通常どおりBrazeにサインインします。
同じクラスター上の複数の会社にアクセスできるログインの場合は、使用する会社を選択します。
同意画面で、アプリケーションが要求しているアクセス権限を確認します。
Brazeプライバシーポリシーに同意するための確認チェックボックスを選択し、Continueを選択してMCPクライアントに戻ります。

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

セッションでは、自動的にリフレッシュされる短期間のアクセストークンが使用されます。場合によっては再度サインインが必要になることがあります。

ステップ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を使用していますが、サポートされている他のクライアントでも同様のフローになります。

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

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

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

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

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

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

トラブルシューティング

サポートされているクライアントで認証が失敗する

会社の管理者がOAuth設定でMCP OAuthアクセスを有効にしていることを確認してください。
ユーザーが「Use MCP Server」権限を持っていることを確認してください。
サインインと認証を再試行してください。

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

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

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

動作していた接続が認証しなくなる

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

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

エージェントがBrazeツールをリストできない場合は、数分待ってから再試行してください。これらの問題は一時的なものであることが多く、自然に解決します。

エージェントが期待されるツールにアクセスできない

ダッシュボードユーザーが必要な権限を持っていることを確認してください。エージェントは、ご自身のダッシュボードアクセス権と一致するツールのみ使用できます。
プロンプトで期待されるワークスペースを選択していることを確認してください。
エージェントに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クライアントを通じて実装する前に必ず確認してください。

New Stuff!