Looker では、管理者は [OAuth クライアントの管理] ページを使用して、API キーを作成したり API Explorer を使用したりすることなく、外部アプリケーションの ID ベースの OAuth 2.0 アクセスを管理できます。このドキュメントでは、事前構成済みのアプリケーションを有効にする方法、カスタム OAuth クライアントを登録する方法、トークンの取り消しを管理する方法について説明します。
[OAuth クライアントの管理] ページは、Looker の [管理者] パネルの [認証] セクションにあります。Looker CLI、AI エージェントの Model Context Protocol（MCP）クライアント、ビジネス インテリジェンス（BI）コネクタなどのデベロッパー ツールへのアクセス権を付与するための一元化されたインターフェースを提供します。
要件
[OAuth クライアントを管理] ページにアクセスして管理するには、次の要件を満たす必要があります。
- Looker インスタンスは、Looker ホスト型である必要があります。セルフホスト型の Looker インスタンスはサポートされていません。
- Looker インスタンスに対する管理者ロールが必要です。
概要
[OAuth クライアントの管理] ページでは、クライアント アプリケーションが次の 2 つのタブに分類されています。
- アプリケーション ライブラリ: 事前構成済みの Looker 管理の OAuth アプリケーションのカタログ。AI エージェントの Model Context Protocol（MCP）クライアント、ビジネス インテリジェンス（BI）コネクタ、デベロッパー ツールなどが含まれます。
- カスタム クライアント: カスタマイズ可能なコールバック リダイレクト URI とグループ アクセス制御を使用して、独自のカスタム OAuth クライアント アプリケーションを登録して構成するための管理インターフェース。
ページ上部の検索バーを使用すると、両方のタブでアプリケーションをリアルタイムでフィルタできます。
[Application Library] タブ
[アプリケーション ライブラリ] タブには、Looker が管理する事前構成済みの OAuth クライアントが含まれています。カスタム クライアントを作成する前に、まず [アプリケーション ライブラリ] タブを確認することをおすすめします。接続するツールがライブラリにすでに事前構成されている場合は、別のリダイレクト URI またはポートが必要な場合を除き、新しいカスタム クライアントを登録せずに有効にできます。
アプリケーション ライブラリには、次の統合用に事前構成されたクライアントが含まれています。
- AI エージェント MCP クライアント: Cursor、VS Code、Claude Code、Claude Desktop、ChatGPT、Gemini CLI、Cline、Windsurf、Antigravity、Looker Extension for VS Code。
- BI コネクタ: コネクテッド シート、データポータル、Tableau Desktop、Microsoft Power BI、Microsoft Excel。
- デベロッパー ツール: Looker CLI。
ライブラリ アプリケーションの有効化と無効化
アプリケーション ライブラリの事前構成済みのクライアント アプリケーションには、それぞれ [有効にする] スイッチがあります。
- 有効にする: スイッチを有効にすると、ユーザーは OAuth を使用してそのクライアント アプリケーションから Looker に認証できるようになります。
- 無効にする: スイッチを無効にすると、そのクライアント アプリケーションからの認可リクエストがブロックされます。アプリケーションを無効にすると、そのアプリケーションのユーザーに発行されたすべてのアクティブな OAuth トークンが直ちに取り消され、無効になります。
事前構成された各クライアント アプリケーションのクライアント ID が、その行に表示されます。クライアント ID をコピーしてクライアントサイドの設定で使用できますが、ライブラリ アプリケーションのクライアント ID は不変であり、変更できません。
BI コネクタ ページとの同期
BI コネクタ（コネクテッド シート、データポータル、Tableau Desktop、Microsoft Power BI、Microsoft Excel など）の有効化ステータスは、[OAuth クライアントの管理] ページと [BI コネクタ] ページの間で自動的に同期されます。
- [OAuth クライアントの管理] ページで BI コネクタ スイッチの有効化ステータスを変更すると、[BI コネクタ] ページの対応するコネクタ スイッチが自動的に更新されます。
- [BI コネクタ] ページで BI コネクタ スイッチの有効化ステータスを変更すると、[OAuth クライアントの管理] ページのステータスが自動的に更新されます。
リダイレクト URI と動的ポートの構成
Looker では、OAuth リダイレクト URI が登録済みの値と完全に一致する必要があります。ワイルドカード リダイレクト URI はサポートされていません。
- 標準 BI コネクタ: サービスの公式認証エンドポイントと一致する、事前構成済みの不変のリダイレクト URI を使用します。
- AI エージェントと MCP クライアント: 一部の AI ツール（Claude Code や Cline など）は、OAuth リダイレクトを開始するときに、デフォルトで動的または一時的なローカルポートを使用します。これらのツールに対応するため、Looker は各ライブラリ クライアントに固定のデフォルト ポートを事前に登録します（例: Claude Code と Cline の場合はポート
8080、Gemini CLI の場合はポート7777）。
固定ポートを必要とする事前構成済みのライブラリ クライアントを使用するには、次のいずれかのオプションを選択します。
- 事前登録済みの静的ポートを使用するようにクライアントを構成する: クライアント アプリケーションの設定または起動フラグで、事前登録済みのポートを指定します（たとえば、
--callback-port 8080を使用して Claude Code を実行します）。 - カスタム クライアントを登録する: 別のポートまたはカスタム コールバック URL を使用する場合は、[カスタム クライアント] タブで、任意の URI を使用して新しいクライアントを登録します。
[Custom Clients] タブ
[カスタム クライアント] タブでは、アプリケーション ライブラリにない内部ツール、独自の統合、サードパーティ アプリケーション用のカスタム OAuth 2.0 クライアント アプリケーションを登録して管理できます。
カスタム OAuth クライアントの登録
新しいカスタム OAuth クライアントを登録する手順は次のとおりです。
- [管理パネル] で、[認証] セクションに移動し、[OAuth クライアントを管理] を選択します。
- [Custom Clients] タブを選択します。
- [Add New] をクリックします。
- サイドパネルで、次のフィールドに入力します。
- クライアント ID: アプリケーションの一意の文字列識別子を入力します。クライアント ID は
com.looker.で始めることはできません。これは Looker 管理のアプリケーション用に予約されています。 - クライアント名: アプリケーションのわかりやすい表示名を入力します。
- 説明（省略可）: アプリケーションの目的を説明する簡単な説明を入力します。
- リダイレクト URI: 1 つ以上の承認済みコールバック URI（
https://mycompany.com/oauth/callbackやhttp://localhost:8080/callbackなど）を入力します。複数のリダイレクト URI を入力して、異なる環境やポートをサポートできます。 - グループ ID に制限（省略可）: Looker ユーザー グループの数値 ID を入力します。数値 ID が指定されている場合、そのグループに属するユーザーのみが、このアプリケーションを使用して Looker への承認と認証を行うことができます。
- クライアント ID: アプリケーションの一意の文字列識別子を入力します。クライアント ID は
- [Add] をクリックして、カスタム クライアントを作成します。
クライアントの詳細を表示する
カスタム クライアント アプリケーションの詳細情報を表示する手順は次のとおりです。
- [カスタム クライアント] タブで、表のクライアントの行にある シェブロン アイコンをクリックします。
- サイドパネルが開き、クライアント名、クライアント ID、説明、承認済みのリダイレクト URI の完全なリスト、グループ ID の制限（設定されている場合）が表示されます。
カスタム クライアントの編集
既存のカスタム OAuth クライアント アプリケーションを更新する手順は次のとおりです。
- [カスタム クライアント] タブで、クライアント アプリケーションを見つけて、その行の [編集] アイコンをクリックします。
編集サイドパネルで、[クライアント名]、[説明]、[リダイレクト URI]、[グループ ID に制限] の各フィールドを必要に応じて更新します。
[更新] をクリックして、変更を保存します。
カスタム クライアントの削除
カスタム OAuth クライアント アプリケーションを削除する手順は次のとおりです。
- [Custom Clients] タブで、クライアント アプリケーションを見つけて、その行の [Delete]（ゴミ箱）アイコンをクリックします。
- 確認ダイアログで [削除] をクリックします。
トークンの無効化とセキュリティ
接続されたアプリケーション全体のセキュリティを維持するため、Looker はトークンの取り消しを自動的に適用します。管理者がカスタム クライアント アプリケーションを削除するか、[アプリケーション ライブラリ] タブまたは [カスタム クライアント] タブでアプリケーションを無効にすると、Looker は、そのアプリケーションのすべてのユーザーに発行されたすべてのアクティブな OAuth 更新トークンを直ちに取り消します。そのアプリケーションに関連付けられていた認証コードはすべて完全に無効になります。
ユーザーまたはアプリケーションが取り消された認証情報を使用して接続しようとすると、Looker は認可を拒否し、OAuth クライアントが見つからないか、有効になっていないことを示すエラーを返します。