Skip to content

Braze MCPサーバーの設定

BrazeリモートMCPサーバーへの接続方法、OAuthによる認証、MCPクライアントからのBrazeツールの使用開始方法について説明します。詳細については、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許可リストを使用しているお客様は、現時点では早期アクセスに参加できません。

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

アクセスの付与

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

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

アクセスの取り消し

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

使用状況の監査

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

クライアントを接続する

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

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

ステップ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）

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

ステップ3：OAuthを通じてBrazeにサインインする

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

  1. SSOが必要な場合も含め、通常どおりBrazeにサインインします。
  2. ログインが同じクラスター上の複数の会社にアクセスできる場合は、使用する会社を選択します。
  3. 同意画面で、アプリケーションが要求しているアクセスを確認します。
  4. 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を使用していますが、他のサポートされているクライアントでもフローは同様です。

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

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

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

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

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

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

トラブルシューティング

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

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

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

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

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

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

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

問題が続く場合は、動画を録画してmcp-product@braze.comに送信し、調査を依頼してください。

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

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