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

OAuth設定の管理

OAuth設定では、Braze MCPサーバーへの会社全体のアクセスを管理し、Brazeに接続できるMCPクライアントのリダイレクトURIを制御できます。また、会社のすべてのMCP OAuthトークンを取り消すこともできます。

OAuth設定は会社全体に適用されます。各ユーザーに割り当てられた権限によって、MCPサーバーを通じてアクセスできるワークスペースと機能が決まります。

要件

要件	説明
「管理者」権限	OAuth 設定の表示、MCP OAuth アクセスのオン/オフの切り替え、リダイレクト URI の管理、または MCP OAuth トークンの取り消しを行うには、会社レベルの「管理者」権限が必要です。
「MCP サーバーを使用」権限	ユーザーは、MCP サーバー経由でアクセスしたい各ワークスペースについて、この権限を持っている必要があります。この権限は、OAuth 設定の管理に使用される「管理者」権限とは別のものです。

権限の割り当ての詳細については、ユーザー権限を参照してください。

OAuthアクセスの仕組み

OAuth設定とユーザー権限は連携して機能します。

会社全体のOAuth設定によって、ユーザーがMCPクライアントをBrazeに接続できるかどうかが決まります。
「MCPサーバーを使用」権限によって、個々のユーザーがワークスペースでMCPサーバーを使用できるかどうかが決まります。
ユーザーの既存のダッシュボード権限によって、MCPクライアントがアクセスできるBrazeのデータと機能が決まります。
1つのOAuth接続でアクセスできるのは、ユーザーがアクセスを許可されているワークスペースのみです。

MCP OAuthアクセスをオンにしても、ユーザーに新しいワークスペース権限が付与されるわけではありません。同様に、ダッシュボード権限を削除すると、ユーザーが接続しているMCPクライアントからもその機能が削除されます。

会社とワークスペースのコントロール

OAuth ポリシーは会社レベルで保存されます。ワークスペース管理者は、単一のワークスペースに対して MCP OAuth アクセスやリダイレクト URI のステータスを上書きすることはできません。

コントロール	設定場所	範囲
MCP OAuth アクセス	設定 > 管理者設定 > 外部接続	会社全体。これがオフの場合、すべてのワークスペースで MCP OAuth が拒否されます。
承認済みリダイレクト URI	設定 > 管理者設定 > 外部接続	会社全体。承認済みおよびブロック済みの URI は、すべてのワークスペースに適用されます。
MCP OAuth トークンを取り消す	設定 > 管理者設定 > 外部接続	会社全体。取り消しは、すべてのワークスペースのすべての MCP OAuth トークンに適用されます。
「MCP サーバーを使用」権限	設定 > ユーザー管理	ワークスペースごと。ユーザーは、MCP サーバー経由でアクセスする各ワークスペースでこの権限が必要です。

MCP OAuth アクセスの変更、リダイレクト URI のステータスの変更、または MCP OAuth トークンの取り消しを行えるのは、「管理者」権限を持つユーザーのみです。ワークスペースの権限がこれらの会社設定とどのように連携するかについては、OAuth と MCP アクセスを参照してください。

MCP OAuth アクセスのオン/オフを切り替える

会社の MCP OAuth アクセスを更新するには、次の手順に従います。

設定 > 管理者設定 > 外部接続に移動します。
グローバルアクセスコントロールで、MCP OAuth アクセスをオンまたはオフにします。

MCP OAuth アクセスがオンの場合、「MCP サーバーを使用」権限を持つユーザーは、承認済みの MCP クライアントを認可できます。オフの場合、会社内のすべてのユーザーとワークスペースに対して、MCP サーバーへの OAuth アクセスが拒否されます。

MCP OAuth アクセスをオフにしても、設定済みのリダイレクト URI は削除もブロックもされません。Braze が会社の既存の MCP OAuth トークンを取り消すため、接続済みの MCP クライアントはアクセスできなくなります。MCP OAuth アクセスがオフの間、承認済みリダイレクト URI セクションは非表示になります。同じ URI リストを再び管理するには、アクセスをオンに戻してください。

Braze がお使いの環境でリモート MCP サーバーをオフにしている場合、MCP OAuth アクセスのトグルは無効になります。その場合は、リモート MCP サーバーが再びオンになるまで会社の設定は反映されないことを説明するメッセージが表示されます。

承認済みリダイレクトURIを管理する

MCP OAuthアクセスをオンにすると、承認済みリダイレクトURIセクションに、MCPクライアントが認証時に使用できるリダイレクトURIが一覧表示されます。形式については、リダイレクトURIの形式を参照してください。

重要

Claude、ChatGPT、Cursor、OpenAI Codex、Claude Code、Visual Studio CodeなどのクライアントのリダイレクトURIも含め、すべてのMCPクライアントのリダイレクトURIを会社の管理者が承認する必要があります。クライアントのリダイレクトURIが承認されていない場合、ユーザーは接続を完了できません。承認する方法については、リダイレクトURIを追加するを参照してください。

承認済みリダイレクトURIテーブルには、次の情報が表示されます。

列	説明
リダイレクトURI	Brazeがクライアントのコールバックと照合する正確なアドレス (パスを含む)。
追加者	URIを追加した、または最後に更新したダッシュボードユーザー。
追加日	URIが追加された、または最後に更新された日時。
ステータス	URIが承認済みかブロック済みか。
アクション	現在のステータスに応じて、ブロックまたはブロック解除。

リダイレクトURIの形式

URIの種類	追加時に使用する形式
ローカル (ループバックアドレス)	`http://localhost` または `http://127.0.0.1` で始まります。任意のローカルポートと一致するように、ポート (ホストの後のコロンと数字) を省略してください。たとえば、クライアントに `http://localhost:33491/oauth/callback` と表示される場合は、`http://localhost/oauth/callback` と入力します。追加するURIにポート (`:33491` など) を含めた場合、Brazeはそのポートのみと照合します。
リモートアドレス	クライアントに表示されているとおりに完全なアドレスを入力します (例: `https://app.example.com/callback`)。
カスタムスキーム	`cursor://` など、カスタムURIスキーム (`http://` や `https://` 以外) で始まります。表示されているとおりに正確に入力してください。一部のデスクトップアプリではこれらのアドレスを使用します。

リダイレクトURIを追加する

リダイレクトURIがまだ一覧にないMCPクライアントを許可するには、次の手順を実行します。

リダイレクトURIを追加を選択します。
クライアントのOAuth設定または統合設定から、コールバックプロトコルを含む完全なリダイレクトURIを入力します。クライアントのコールバックとの照合に迷った場合は、リダイレクトURIの形式の表を参照してください。
保存を選択します。

ローカルクライアントの場合は、追加するリダイレクトURIで 127.0.0.1 を使用し、ポート番号を省略してください。

新しいOAuth認可を完了できるのは、ステータスが承認済みのリダイレクトURIのみです。クライアントのリダイレクトURIが一覧にない場合、またはそのステータスがブロック済みの場合、Brazeは認可リクエストを拒否します。

リダイレクトURIをブロックする

リダイレクトURIからの新しいOAuth認可を防ぐには、その行のブロックを選択してアクションを確定します。BrazeはURIのレコードを保持し、そのステータスをブロック済みに変更します。

リダイレクトURIをブロックしても、そのMCPクライアントにすでに接続しているユーザーのトークンは取り消されません。それらのセッションを終了するには、MCP OAuthトークンを取り消すを選択します。URIのブロックは、そのコールバックによる新しい認可を防ぐための別のアクションです。

または、ユーザーから「MCP Serverを使用」権限を削除すると、そのユーザーのみMCPサーバーを使用できなくなります。他のユーザーのMCP接続は、MCP OAuthトークンを取り消すを選択するまで有効なままです。

リダイレクトURIのブロックを解除する

ブロックされたリダイレクトURIへのアクセスを復元するには、その行のブロック解除を選択してアクションを確定します。Brazeは重複を作成せずに、既存のレコードを承認済みに更新します。

以前そのMCPクライアントに接続していたユーザーは、再度認証する必要があります。

MCP OAuth トークンを取り消す

トークンを取り消すと、会社全体のすべての MCP OAuth トークンが一度に無効になります。トークンが漏洩した、または不正使用されたと思われる場合に使用します。

会社の MCP OAuth トークンを取り消すには、次の手順に従います。

設定 > 管理者設定 > 外部接続に移動します。
MCP OAuth トークンを取り消すで、MCP OAuth トークンを取り消すを選択します。
確認ダイアログの内容を確認し、トークンを取り消すを選択します。

Braze はバックグラウンドでトークンを取り消し、取り消しが完了すると確認メッセージを表示します。接続数が多い会社では、数分かかることがあります。確認メッセージが表示されるまで、外部接続ページを開いたままにしてください。

警告

トークンの取り消しは元に戻せません。接続されているすべての MCP クライアントが Braze にアクセスできなくなり、各ユーザーはサインインして MCP クライアントを再度接続する必要があります。

取り消しによって変わること

項目	結果
アクセストークン	取り消されます。ユーザーが再接続するまで、接続されている MCP クライアントは機能しなくなります。
リフレッシュトークン	取り消されます。MCP クライアントはバックグラウンドで自動的に再接続できません。ユーザー自身が再接続する必要があります。
MCP OAuth アクセス	変更されません。オンになっていた場合、ユーザーはすぐに再接続できます。
承認済みのリダイレクト URI	変更されません。承認済みの URI とブロックされた URI はそのまま維持されます。
「MCP サーバーを使用」権限	変更されません。ユーザーは権限を保持し、再接続できます。
新しい接続	影響を受けません。取り消しの開始後に行われた接続は引き続き機能します。

取り消し時にすでに処理中だったリクエストは取り消されません。現在のセッションを終了するだけでなく、すべての MCP アクセスを停止するには、MCP OAuth アクセスをオフにします (これにより MCP OAuth トークンも取り消されます)。特定のユーザーの MCP アクセスを削除するには、そのユーザーから「MCP サーバーを使用」権限を削除します。

取り消しが完了しない場合、Braze はエラーメッセージを表示します。一部のトークンがすでに取り消されている可能性があるため、再試行する前にサポートに連絡してください。

ブロックされた接続のトラブルシューティング

ユーザーがMCPクライアントをBrazeに接続する際に「This app needs approval」や「An unexpected error occurred」などの一般的なエラーが表示される場合、そのクライアントのリダイレクトURIが会社で承認されていない可能性があります。

設定 > 管理者設定 > 外部接続に移動し、承認済みリダイレクトURIテーブルでクライアントのリダイレクトURIを探します。ステータス列で、URIが承認済みかブロックされているかを確認します。
URIがリストにない場合はURIを追加し、ステータスがブロック済みの場合はブロック解除を選択します。
ユーザーにMCPクライアントを再度接続するよう依頼します。

リダイレクトURIが承認されているにもかかわらず接続が失敗する場合は、MCP OAuthアクセスがオンになっていること、およびユーザーに「MCPサーバーを使用」権限があることを確認してください。その他のトラブルシューティングについては、Braze MCPサーバーの設定を参照してください。

OAuth アクティビティの監査

Braze は、MCP サーバーへの OAuth 接続をセキュリティイベントレポートに記録します。このレポートを使用して、ユーザーが OAuth 経由で接続した日時を監査できます。

特定のユーザーの MCP アクセスを取り消すには、そのユーザーから「Use MCP Server」権限を削除します。会社内のすべての MCP OAuth トークンを取り消すには、MCP OAuth トークンの取り消しを参照してください。設定とトラブルシューティングのガイダンスについては、Braze MCP サーバーの設定を参照してください。

New Stuff!