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

VS Code 用 Looker 拡張機能を使用すると、ローカルデスクトップ環境内で 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 は、VS Code 用 Looker 拡張機能でサポートされていません。

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

AI 対応のワークフロー

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

VS Code 用 Looker 拡張機能。
VS Code ベースのローカル IDE。IDE には、組み込みの AI エージェント（Cursor など）が含まれているか、IDE に組み込みの AI エージェントが含まれていない場合（基本的な VS Code など）、IDE は スタンドアロンのエージェントツール（Gemini CLI や Claude Code など）と統合されている必要があります。IDE をエージェントに接続する方法については、ローカル IDE のドキュメントをご覧ください。
データベース向け MCP ツールボックスなどの MCP サーバー。

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

始める前に

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

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

管理者の設定

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

Looker API Explorer を使用して OAuth インテグレーションを設定します。API Explorer には、次のいずれかの方法でアクセスできます。

Looker インスタンスに API Explorer がすでにインストールされている場合は、次の URL 形式でアクセスできます。
```
https://LOOKER_INSTANCE_URL/extensions/marketplace_extension_api_explorer::api-explorer/
```
Looker インスタンスに API Explorer がない場合は、Looker Marketplace からインストールできます。詳細については、API Explorer の使用ページをご覧ください。

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

OAuth クライアントアプリケーションの登録のドキュメントの手順に沿って、拡張機能を登録します。
[client_guid] フィールドで、次の操作を行います。
- グローバルに一意の ID を使用します。
- 拡張機能を使用する LookML デベロッパーに ID を配布できるように準備します。

redirect_uri には、次を使用します。

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

OAuth クライアントアプリケーションの登録に関するドキュメントの説明に従って、display_name と description を完了します。

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

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

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

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

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

拡張機能の設定

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

ワークスペースを開いた状態で、コマンドパレット（Mac の場合は Command+Shift+P、Windows/Linux の場合は Ctrl+Shift+P）を開きます。
[設定: ワークスペース設定を開く（JSON）] を検索して選択します。
構成変数を設定に追加します。構成変数は、認証方法が 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.instanceURL`	Looker インスタンスのベース URL（例: `https://mycompany.looker.com`）。	-
`looker.authURL`	OAuth 認証に使用する URL。インスタンス URL と異なる場合にのみ設定します。	`looker.instanceURL`
`looker.sdkURL`	API リクエストに使用する URL。インスタンス URL と異なる場合にのみ設定します。	`looker.instanceURL`
`looker.oauthClientId`	Looker OAuth クライアント ID。OAuth に必要です。	-
`looker.clientId`	Looker API クライアント ID。API キー認証に必要です。	-
`looker.clientSecret`	Looker API クライアントシークレット。API キー認証に必要です。	-
`looker.projectId`	Looker プロジェクト ID。	-
`looker.mcpServerUrl`	プロキシする外部 MCP サーバーの URL（例: `http://localhost:5000/mcp`）。	-
`looker.acceptSelfSignedCertificates`	SSL 証明書エラーを無視します（自己署名証明書など）。警告: このオプションを有効にすることはおすすめしません。	`false`
`looker.askBeforeOverwritingRemote`	競合が検出されたときに、リモートファイルを上書きする前に必ず確認します。	`false`

Looker を介して認証する

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

コマンドパレットを開きます。
コマンド Looker: Sign In (OAuth) を実行します。
ブラウザを開くためのプロンプトが表示されたら、確認します。
ブラウザで、拡張機能が Looker アカウントにアクセスすることを承認します。
承認後、ブラウザは IDE にリダイレクトされます。「Looker にログインしました。」という通知が表示されます。

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

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

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

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

トラブルシューティング

拡張機能のログは、IDE の [出力] パネルで確認できます。[Looker] チャネルを選択してログを表示します。詳細なログを取得するには、コマンドパレットを開き、[デベロッパー: ログレベルを設定] コマンドを実行して、[デバッグ] または [トレース] を選択します。

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

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