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

Braze MCPサーバーの設定

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

重要

リモートのBraze MCPサーバーは早期アクセス段階です。ローカルホスト型のBraze MCPサーバー（ベータ版）は非推奨となっており、現時点では引き続き利用可能ですが、今後の更新は行われません。

前提条件

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

前提条件	説明
早期アクセスへの登録	アカウントマネージャーが早期アクセスプログラムに貴社を登録できます。
サポートされているMCPクライアント	OAuthを使用したリモートMCPサーバーをサポートする任意のクライアントが使用できます。BrazeではClaude、ChatGPT、Cursor、OpenAI Codex、Claude Codeでの動作を確認しています。
Brazeダッシュボードアカウント	通常のBraze認証情報（貴社がSSOまたはSAMLを使用している場合はそれを含む）でサインインします。MCP専用のログインはありません。
サーバーエンドポイントの選択	`https://mcp.braze.com/mcp`（US）または`https://mcp.braze.eu/mcp`（EU）を選択してください。どちらのエンドポイントでも任意のBrazeクラスターにアクセスできます。
IPアローリスティング不可	現時点では、IPアローリスティングを使用しているお客様は早期アクセスに参加できません。

注

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

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

アクセスの付与

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

管理者にこの権限が表示されない場合は、Brazeアカウントマネージャーに連絡して早期アクセスへの登録をリクエストしてください。

アクセスの取り消し

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

使用状況の監査

ユーザーが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のサインインページに移動します。

通常どおりBrazeにサインインします（必要に応じてSSOを含む）。
ログインが同じクラスター上の複数の会社にアクセスできる場合は、使用する会社を選択します。
同意画面で、アプリケーションがリクエストしているアクセスを確認します。
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のサインインページに移動します。
通常の認証情報でBrazeにサインインします（貴社がSSOを使用している場合はそれを含む）。ログインが同じクラスター上の複数の会社にアクセスできる場合は、使用する会社を選択します。
同意画面で、リクエストされたアクセスを確認し、確認チェックボックスを選択してからContinueを選択します。Claudeがチャットに戻り、エージェントがBrazeツールを使用できるようになります。

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

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

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

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

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

トラブルシューティング

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

貴社が早期アクセスに登録されていることを確認します。
ユーザーにUse MCP Server権限があることを確認します。
サインインと認可を再試行します。

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

早期アクセス中、Brazeはセキュリティのためにサポートされているクライアントドメインのアローリストを管理しています。アローリストにないクライアントから接続すると、認証がブロックされる場合があります。クライアントがサポートされるべきだと思われる場合は、[email protected]にお問い合わせください。

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

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

ダッシュボードユーザーに必要な権限があることを確認します。エージェントは、自分のダッシュボードアクセスに一致するツールのみを使用できます。
プロンプトで期待されるワークスペースを選択したことを確認します。
エージェントに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!