このページは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経由で正常に接続すると、イベントがセキュリティイベントレポートに記録されます。

クライアントを接続する

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

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

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

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（会社で使用している場合）を含む通常の認証情報で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のように、カスタムスキームなしでローカルマシン上で動作するクライアントも使用できます。

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

エージェントが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!