mcpField
A
authenticating-looker-cli

authenticating-looker-cli

github.com/looker-open-sourceデータ・データベース43102 回インストール2 週間前に更新
リポジトリ

authenticating-looker-cli について

OAuth を使って Looker CLI を Looker インスタンスに接続し、認証情報を名前付きプロファイルに保存するスキルです。ブラウザー認証の手順と、Looker ユーザーの権限確認を案内します。

主な機能

  1. 01名前付きプロファイルの作成と選択
  2. 02OAuth によるログイン
  3. 03ローカル・ヘッドレス環境の認証
  4. 04CLI のユーザーと権限の確認

活用シーン

  1. 01Looker CLI とインスタンスの初回接続
  2. 02ヘッドレス環境での OAuth 認証
  3. 03プロジェクト・接続管理権限の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/looker-open-source/looker-skills --skill authenticating-looker-cli

インストール後、Claude Code で/authenticating-looker-cliを入力して読み込まれたか確認します。

詳細

Looker CLI の認証

OAuth を使用して Looker CLI を Looker インスタンスに認証し、セッション設定を名前付きプロファイルに保存します。

前提条件

  • Looker CLI がインストールされている必要があります（installing-looker-cli スキルを参照してください）。
  • Looker インスタンスの URL（ホストと API ポート）を把握している必要があります。Looker Core／Google Cloud Core の API ポートは通常 443 です。

手順

1. 名前付きプロファイルを設定する

接続情報を保存するために、default という名前の新しいプロファイルを作成します。

looker-cli profile add default --host {instance_host} --port {instance_port}

この新しいプロファイルをデフォルト設定にします。

looker-cli profile use default
2. OAuth ログインを開始する

対話型のブラウザー認証が必要なため、ログインコマンドをバックグラウンドで実行します。

looker-cli session login --oauth
3. 認証 URL を取得する

バックグラウンドのログインタスクのログまたは標準出力を監視し、生成されたログイン URL を取得します。Looker CLI は次の内容を出力します。

Opening browser to URL: に続いて、長い URL が表示されます。

4. ユーザーに案内する（対話型の手順）

ログイン URL をユーザーに提示し、次のように案内します。

「次の URL をブラウザーで開き、Looker にログインして、CLI を承認してください。

URL: {auth_url}

ローカルのデスクトップマシンで実行している場合は、承認後にログインが自動的に完了します。リモートサーバー／ヘッドレスのワークスペースで実行している場合は、ブラウザーにページ読み込みエラーが表示されるか、http://127.0.0.1:7777/?code=... へのリダイレクトが試行されます。ブラウザーのアドレスバーに表示されているリダイレクト先の URL 全体をコピーし、ターミナルのプロンプトに貼り付けてください。」

5. OAuth の応答を処理する
  • シナリオ A（自動）：ユーザーが認証を完了し、CLI がローカルのポート 7777 で待ち受けている場合、ログインコマンドのタスクは正常に終了します。
  • シナリオ B（ヘッドレス環境でのフォールバック）：バックグラウンドプロセスに Paste redirected URL here: と表示されます。ユーザーがリダイレクト先の URL を貼り付けたら、send_input を指定した manage_task を使用して、貼り付けられた URL をバックグラウンドのログインタスクに直接渡します。

完了すると、looker-cli はアクセス トークンとリフレッシュ トークンを ~/.config/looker-cli/config.yaml の default プロファイルに自動的に保存します。

6. 認証を確認する

接続フラグを指定せずに Looker API と正常に通信できることを確認します。

looker-cli user me

認証されたユーザーの詳細を含む JSON オブジェクトが返されます。

7. 事前確認：Looker ユーザーの権限

認証されたユーザーアカウントに、必要な開発者権限と接続管理権限があることを確認します。

  1. looker-cli user me の出力でロールと権限を確認します。
  2. アカウントに develop と manage_project_connections の権限を含むロールがあることを確認します（または代替として Admin ロールがあることを確認します）。
  3. 権限が不十分な場合：ユーザーに警告し、更新を待ちます。次のように伝えてください。> 「認証は正常に完了しましたが、お使いの Looker ユーザーアカウントには必要な develop と manage_project_connections の権限（または Admin ロール）がないようです。> > これらの開発者権限がないと、データベース接続やプロジェクトの作成、LookML の記述ができません。Looker コンソールで私のユーザーアカウントにこれらの権限を付与し、完了したらお知らせください。続きの作業を進めます。」

コメント

Markdown 対応