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

OAuth設定の管理

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

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

要件

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

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

OAuth アクセスの仕組み

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

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

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

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

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

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

「Admin」権限を持つユーザーのみが、MCP OAuthアクセスの変更、リダイレクトURIステータスの変更、またはMCP OAuthトークンの取り消しを行えます。ワークスペース権限とこれらの会社設定の相互作用については、OAuthとMCPアクセスを参照してください。

MCP OAuth アクセスのオンとオフの切り替え

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

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

MCP OAuth アクセスがオンの場合、「Use MCP Server」権限を持つユーザーは、承認済みの 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のフォーマットを参照してください。

承認済みリダイレクト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`）。
カスタムスキーム	カスタムURIスキーム（`http://` や `https://` ではないもの）で始まります（`cursor://` など）。表示されたとおりに入力してください。一部のデスクトップアプリがこのようなアドレスを使用します。

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

まだリストに表示されていないカスタムMCPクライアントを許可するには、以下の手順を実行します。

リダイレクトURIを追加を選択します。
クライアントのOAuthまたはインテグレーション設定から、コールバックプロトコルを含む完全なリダイレクトURIを入力します。クライアントのコールバックとの照合に関するヘルプが必要な場合は、リダイレクトURIのフォーマットテーブルを参照してください。
保存を選択します。

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

承認済みステータスのリダイレクトURIのみが、新しいOAuth認証を完了できます。URIがリストになく、Braze認証済みクライアントでもない場合、Brazeは認証リクエストを拒否します。

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

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

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

または、ユーザーの「MCPサーバーを使用する」権限を削除して、そのユーザーのみがMCPサーバーを使用できないようにすることもできます。他のユーザーのMCP接続は、MCP OAuthトークンを取り消すを選択するまでアクティブなままです。

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

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

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

MCP OAuthトークンの取り消し

トークンを取り消すと、会社全体のすべてのMCP OAuthトークンが一度に無効化されます。トークンが漏洩したり、不正使用された可能性がある場合に使用してください。

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

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

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

警告

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

取り消しによる変更内容

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

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

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

OAuthアクティビティの監査

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

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

New Stuff!