Looker 拡張機能 for VS Code のスタートガイド

Looker extension for VS Code を使用すると、ローカル デスクトップ環境内で LookML を直接開発できます。高度な構文ハイライト表示、Looker インスタンスとの双方向ファイル同期、「バイブ コーディング」のための AI コーディング エージェントとの統合が提供されます。

この拡張機能は Visual Studio Code（VS Code）フレームワークを使用して構築されており、次の IDE やコーディング ツールなど、VS Code IDE に基づく統合開発環境（IDE）をサポートしています。

• Claude Code
• Codex
• Cursor
• Kiro
• VS Code
• Windsurf
• Zed

IntelliJ や Eclipse など、VS Code のフォークではない IDE は、Looker extension for VS Code ではサポートされていません。

このガイドでは、拡張機能を設定して認証する方法について説明します。

AI 対応ワークフロー

Looker extension for VS Code は、LookML ファイルの編集と作成のための AI 対応エージェント開発ワークフローの一部です。このワークフローを有効にするには、次のツールを構成します。

• Looker extension for VS Code 。
• VS Code に基づくローカル IDE 。IDE には組み込みの AI エージェント （Cursor など）が含まれている必要があります。IDE に組み込みの AI エージェント（基本的な VS Code など）が含まれていない場合は、IDE をスタンドアロンのエージェント ツール （Gemini CLI や Claude Code など）と統合する必要があります。IDE をエージェントに接続する方法については、ローカル IDE のドキュメントをご覧ください。
• Looker が管理する MCP サーバーなどのMCP サーバー。

AI 対応ワークフローの詳細については、Looker を使用した AI 支援開発（バイブ コーディング）のドキュメント ページをご覧ください。

始める前に

拡張機能をインストールする前に、次の要件を満たす必要があります。

• AI ツールに接続する: AI 支援開発を使用する場合は、IDE と AI エージェントを Looker が管理する MCP サーバーに接続します。設定と構成例については、Looker が管理する MCP サーバーのドキュメント ページをご覧ください。詳細については、ツールのドキュメントをご覧ください。
• Looker の権限: 編集するモデルに対する develop Looker 権限が必要です。
• Looker インスタンス: インスタンスが Looker 26.6 以降で実行されている必要があります。
• Git のインストール: LookML リポジトリのクローン作成と管理を行うには、ローカルマシンに Git がインストールされている必要があります。
• プロジェクト構成: LookML プロジェクトが Git 用に構成されている必要があります。
• OAuth クライアント ID: OAuth 認証（推奨）を使用している場合は、Looker 管理者から OAuth クライアント ID を取得する必要があります。

管理者の設定

組織で認証に OAuth を使用している場合は、Looker 管理者が Looker 管理 UI で Looker extension for VS Code を OAuth クライアントとして登録する必要があります。

OAuth 統合を設定するには、Looker API Explorer を使用します。API Explorer には、次のいずれかの方法でアクセスできます。

LOOKER_INSTANCE_URL/extensions/marketplace_extension_api_explorer::api-explorer/

curl -X POST "https://LOOKER_INSTANCE_URL/api/4.0/oauth_client_apps/CLIENT_GUID" \
-H "Authorization: token ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
  "redirect_uri": "REDIRECT_URI",
  "display_name": "CLIENT_NAME",
  "description": "OAuth client to access MCP server using CLIENT_NAME",
  "enabled": true
}'

拡張機能を登録する手順は次のとおりです。

1. OAuth クライアント アプリケーションの登録のドキュメントの手順に沿って、拡張機能を登録します。

2. client_guid フィールドで、次の操作を行います。

   • グローバルに一意の ID を使用します。
   • 拡張機能を使用する LookML デベロッパーに ID を配布できるように準備します。

3. redirect_uri には、次のものを使用します。

   vscode://google.vscode-looker-official/oauth_callback
   

4. display_name と description を OAuth クライアント アプリケーションの登録のドキュメントの説明に沿って入力します。

アプリが登録されると、API Explorer は登録の概要を含むレスポンスを返します。client_guid を使用して OAuth クライアント アプリを取得 エンドポイントを使用すると、登録の詳細を確認できます。

生成された client_guid をデベロッパーに提供します。デベロッパーは、拡張機能を 構成するときにこれを使用します。

拡張機能をインストールする

拡張機能をインストールする手順は次のとおりです。

1. Visual Studio Marketplace から Looker extension for VS Code をインストールします。
2. VS Code や Cursor などの IDE を開きます。
3. アクティビティ バーの [Extensions]（拡張機能）アイコンをクリックします。
4. [Looker extension for VS Code] を見つけて、[Install]（インストール）をクリックします。
5. 拡張機能がインストールされると、アクティビティ バーに [Looker] アイコンが表示されます。

拡張機能の設定

ワークスペースの settings.json ファイルで、Looker インスタンスの詳細を使用して拡張機能を構成する必要があります。

1. ワークスペースを開いた状態で、コマンド パレットを開きます（Mac の場合は Command-Shift-P 、Windows/Linux の場合は Ctrl+Shift+P ）。
2. [Preferences: Open Workspace Settings (JSON)] を検索して選択します。
3. 構成変数を設定に追加します。構成変数は、認証方法が OAuth か API 認証情報かによって異なります。

OAuth で認証する（推奨）

OAuth 2.1 が推奨される認証フローです。これらの設定をワークスペースの settings.json ファイルに貼り付けます。

{
  "looker.instanceUrl": "https://YOUR_INSTANCE_URL",
  "looker.oauthClientId": "YOUR_OAUTH_CLIENT_ID",
  "looker.projectId": "YOUR_PROJECT_ID"
}

次のように置き換えます。

• https://YOUR_INSTANCE_URL: Looker インスタンスの URL。
• YOUR_OAUTH_CLIENT_ID: Looker 管理者から受け取った OAuth クライアント ID（client_guid）。
• YOUR_PROJECT_ID: 編集するプロジェクトの名前。これを確認するには、Looker インスタンス内で [LookML プロジェクト] ページを開きます。プロジェクト ID は [プロジェクト] 列にあります。

API 認証情報で認証する

Looker API キーを使用する場合は、ドキュメントに沿って API 認証情報を作成します。プロジェクト ID も指定する必要があります。

{
  "looker.instanceUrl": "https://YOUR_INSTANCE_URL",
  "looker.clientId": "YOUR_CLIENT_ID",
  "looker.clientSecret": "YOUR_CLIENT_SECRET",
  "looker.projectId": "YOUR_PROJECT_ID"
}

次のように置き換えます。

• https://YOUR_INSTANCE_URL: Looker インスタンスの URL。
• YOUR_CLIENT_ID と YOUR_CLIENT_SECRET: 認証に使用する API 認証情報のクライアント ID とクライアント シークレット。これらの認証情報を見つけるには、Looker インスタンス内で [アカウント] ページを開き、[API キー] セクションで [管理] ボタンをクリックします。[API キー] ページが開き、クライアント ID とシークレットを表示できます。
• YOUR_PROJECT_ID: 編集するプロジェクトの名前。プロジェクト名を確認するには、Looker インスタンス内で [LookML プロジェクト] ページを開きます。プロジェクト ID は [プロジェクト] 列にあります。

設定

IDE ワークスペースで次の MCP 設定を構成できます。

Looker で認証する

OAuth 認証を使用している場合は、ローカル IDE を Looker アカウントにリンクするためにログインする必要があります。

1. コマンド パレットを開きます。
2. コマンド Looker: Sign In (OAuth) を実行します。
3. プロンプトが表示されたら、ブラウザを開きます。
4. ブラウザで、拡張機能が Looker アカウントにアクセスすることを承認します。
5. 承認すると、ブラウザは IDE にリダイレクトされます。[Successfully signed in to Looker!] という通知が表示されます。

LookML プロジェクトのクローンを作成する

開発を開始するには、LookML リポジトリをローカルマシンにクローンする必要があります。

1. VS Code で新しいウィンドウを開きます。
2. コマンド パレットを開き、[Git: Clone] を選択します。
3. リモート Git リポジトリの URL（GitHub や GitLab など）を入力し、ローカル フォルダを選択します。
4. IDE でクローンされたフォルダを開きます。

拡張機能は LookML ファイルを自動的に検出し、Looker インスタンスの開発モードでチェックアウトされたブランチとの同期を開始します。

トラブルシューティング

拡張機能のログは、IDE の [出力] パネルで確認できます。[Looker] チャネルを選択してログを表示します。詳細なログを表示するには、コマンド パレットを開き、Developer: Set Log Level コマンドを実行して、[Debug] または [Trace] を選択します。

• 認証エラー: looker.instanceUrl と looker.oauthClientId が正しいことを確認します。Looker のリダイレクト URI が完全に一致していることを確認します。
• 同期の問題: 拡張機能のログを確認して、同期の問題に対処します。ログを表示するには、[出力] パネルを開き、プルダウン メニューから [Looker] を選択します。
• OAuth 中に Bad Request レスポンスが返される: Looker インスタンスにローカル ネットワークからアクセスできることと、有効なインターネット接続があることを確認します。

拡張機能で問題が発生した場合は、コマンド パレットから Developer: Reload Window コマンドを実行すると、問題を解決できることがあります。

次のステップ

• Looker VS Code 拡張機能を使用して LookML ファイルと Git を管理する
• Looker が管理する MCP サーバー
• データベース向け MCP ツールボックスを使用する
• Looker を使用した AI 支援開発（バイブ コーディング）