Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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 は、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 のドキュメントをご覧ください。
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 で VS Code 用 Looker 拡張機能を OAuth クライアントとして登録する必要があります。

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

API Explorer がインストールされている

Looker インスタンスに API Explorer がすでにインストールされている場合は、次の URL 形式でアクセスできます。

LOOKER_INSTANCE_URL/extensions/marketplace_extension_api_explorer::api-explorer/

API Explorer がインストールされていない

Looker インスタンスに API Explorer がない場合は、Looker Marketplace からインストールできます。API Explorer のインストール方法については、API Explorer の使用ページをご覧ください。

PSA プライベートインスタンス

プライベートサービスアクセスを使用する Looker（Google Cloud コア）プライベート接続インスタンスを使用している場合、Looker Marketplace と API Explorer はサポートされていません。AI エージェントを登録するには、oauth_client_apps API エンドポイントを直接呼び出す必要があります。この方法を使用する場合は、この API Explorer 手順の残りのステップをスキップできます。

次の例は、oauth_client_apps エンドポイントで使用してエージェントを登録できる curl コマンドです。

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
}'

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

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

redirect_uri には、IDE のコールバック URL を入力します。IDE またはコーディングツールに応じて、次のいずれかのコールバック URL を使用します。

IDE またはツール	コールバック URL
VS Code	vscode://google.vscode-looker-official/oauth_callback
Antigravity IDE（Looker 26.12 以降で使用可能）	antigravity-ide://google.vscode-looker-official/oauth_callback
Code-OSS	code-oss://google.vscode-looker-official/oauth_callback
Cursor	cursor://google.vscode-looker-official/oauth_callback
HTTPS	https://google.vscode-looker-official/oauth_callback
Looker	looker://google.vscode-looker-official/oauth_callback
Windsurf	windsurf://google.vscode-looker-official/oauth_callback

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

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

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

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

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

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

拡張機能の設定

ワークスペースの settings.json ファイル、VS Code のビジュアル設定エディタ（[Preferences: Open Workspace Settings]）、Looker 拡張機能のインタラクティブなオンボーディング UI で、Looker インスタンスの詳細を使用して拡張機能を構成できます。

次の手順では、settings.json ファイルを編集する方法の例を示します。代わりに VS Code 設定エディタまたは Looker 拡張機能の UI を使用しても、同じ結果が得られます。

ワークスペースを開いた状態で、コマンドパレット（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`

MCP クライアントを構成する

AI エージェントが拡張機能を通じて Looker とやり取りできるようにするには、拡張機能の MCP プロキシ URL に接続するようにエージェントを構成する必要があります。デフォルトでは、プロキシはローカルの http://127.0.0.1:5050 で実行されます。

MCP サーバーが 5000 以外のポートまたはリモートマシンで実行されている場合は、拡張機能のプロキシ構成を更新する必要があります。これを行うには、VS Code ワークスペース設定で looker.mcpServerUrl 設定を更新します。詳細については、設定のセクションをご覧ください。

Visual Studio Code（Copilot）

VS Code を開き、プロジェクトのルートに .vscode ディレクトリが存在しない場合は作成します。
.vscode/mcp.json ファイルが存在しない場合は作成してから、それを開きます。
次の構成を追加して、ファイルを保存します。

      {
        "servers": {
          "looker": {
            "type": "http",
            "url": "http://127.0.0.1:5050"
          }
        }
      }

Claude Code

プロジェクトのルートに .mcp.json ファイルが存在しない場合は作成します。
次の構成を追加して、ファイルを保存します。

      {
        "mcpServers": {
          "looker": {
            "type": "http",
            "url": "http://127.0.0.1:5050"
          }
        }
      }

Cursor

プロジェクトのルートに .cursor ディレクトリが存在しない場合は作成します。
.cursor/mcp.json ファイルが存在しない場合は作成してから、それを開きます。
次の構成を追加して、ファイルを保存します。

      {
        "mcpServers": {
          "looker": {
            "type": "http",
            "url": "http://127.0.0.1:5050"
          }
        }
      }

Cursor を開き、[Settings] > [Cursor Settings] > [MCP] に移動します。サーバーが接続されると、緑色のアクティブステータスが表示されます。

Cline

VS Code で Cline 拡張機能を開き、[MCP Servers] アイコンをクリックします。
[Configure MCP Servers] をクリックして構成ファイルを開きます。
次の構成を追加して、ファイルを保存します。

      {
        "mcpServers": {
          "looker": {
            "type": "http",
            "url": "http://127.0.0.1:5050"
          }
        }
      }

Windsurf

Windsurf を開き、Cascade アシスタントに移動します。
MCP アイコンをクリックし、[Configure] をクリックして構成ファイルを開きます。
次の構成を追加して、ファイルを保存します。

      {
        "mcpServers": {
          "looker": {
            "type": "http",
            "url": "http://127.0.0.1:5050"
          }
        }
      }

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] コマンドを実行すると、問題を解決できることがあります。