Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

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

Visual Studio Code（VS Code）用の Looker by Google Cloud 拡張機能を使用すると、ローカルデスクトップ環境内で 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 対応エージェント開発ワークフローの一部です。このワークフローを有効にするには、次のツールを構成します。

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

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

始める前に

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

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

管理者の設定

組織で認証に OAuth を使用している場合は、Looker 管理者が Looker 管理 UI で Looker extension for VS Code を 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
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
Kiro（Kiro の OAuth サポートは Looker 26.16 以降で利用可能）	kiro://google.vscode-looker-official/oauth_callback
Looker	looker://google.vscode-looker-official/oauth_callback
VS Code	vscode://google.vscode-looker-official/oauth_callback
Windsurf	windsurf://google.vscode-looker-official/oauth_callback

[Enabled] フィールドが true に設定されていることを確認します。
display_name フィールドと description フィールドに、OAuth クライアントアプリケーションの登録のドキュメントの説明に沿って入力します。

アプリが登録されると、API Explorer は登録の概要を含むレスポンスを返します。リダイレクト URI がリクエストパラメータに入力した内容と一致していることを確認します。client_guid 値で Get OAuth Client App エンドポイントを使用して、登録の詳細を確認できます。

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

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

この拡張機能は、次の主要な拡張機能マーケットプレイスで利用できます。

Visual Studio Marketplace（標準の VS Code 用）
Open VSX Registry（Cursor、Antigravity IDE、VSCodium 用）

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

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

拡張機能の設定

Looker インスタンスの詳細を使用して拡張機能を構成するには、インタラクティブなオンボーディングチュートリアルを実行します。

ワークスペースを開いた状態で、コマンドパレットを開きます（macOS の場合は Command-Shift-P 、Windows/Linux の場合は Ctrl+Shift+P ）。
Looker: Show Onboarding Walkthrough コマンドを実行して、オンボーディングチュートリアルを開きます。
チュートリアルの指示に沿って、Looker インスタンスの URL、プロジェクト ID、認証情報を入力します。ベアリポジトリを使用している場合は、このプロセスでプロジェクトの LookML ファイルを使用してワークスペースを設定するように求められます。

OAuth で認証する（推奨）

OAuth 2.1 が推奨される認証フローです。オンボーディングチュートリアルでプロンプトが表示されたら、OAuth を選択し、次の構成値を指定します。

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

API 認証情報で認証する

Looker API キーを使用する場合は、ドキュメントに沿って API 認証情報を作成します。オンボーディングチュートリアルでプロンプトが表示されたら、[API 認証情報] を選択し、次の構成値を指定します。

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

設定

オンボーディングチュートリアルを使用することをおすすめしますが、VS Code の settings.json ファイルで拡張機能の設定を構成することもできます。このファイルはワークスペースの .vscode フォルダ（.vscode/settings.json）またはグローバルユーザー設定ファイル（settings.json）にあります。また、VS Code のビジュアル設定エディタ（[Preferences: Open Settings (UI)]）を使用して構成することもできます。

拡張機能の MCP 設定 looker.mcpServerUrl を含む、すべての looker.<setting> プロパティは、VS Code の settings.json ファイルで定義する必要があります。AI エージェントの MCP 構成ファイル（.agents/mcp_config.json など）または他の設定ファイルでこれらの設定を定義しても、拡張機能では機能しません。

settings.json で次の拡張機能の設定を構成できます。

設定	説明	デフォルト
`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`	LookML プロジェクト ID。	-
`looker.mcpServerUrl`	拡張機能のローカル MCP プロキシがリクエストを転送するターゲット MCP サーバーの URL。`looker.instanceURL/mcp` と異なる場合にのみ設定します（`http://localhost:5000/mcp` など）。	`looker.instanceURL/mcp`
`looker.acceptSelfSignedCertificates`	SSL 証明書エラーを無視します（自己署名証明書など）。警告: このオプションを有効にすることはおすすめしません。	`false`
`looker.askBeforeOverwritingRemote`	競合が検出された場合は、リモートファイルを上書きする前に必ず確認します。	`false`

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

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

AI エージェントは、独自の MCP 構成ファイル（VS Code の .agents/mcp_config.json、Claude Code の .mcp.json、Cursor の .cursor/mcp.json など）を参照します。この構成をローカルプロキシに向けることで、拡張機能はエージェントの MCP リクエストをキャプチャし、適切な認証ヘッダーで転送できます。

Looker マネージド MCP サーバー（デフォルト、推奨）

拡張機能は、Looker の組み込みマネージド MCP サーバー（LOOKER_INSTANCE_URL/mcp）に接続するローカルリバースプロキシ（デフォルト: http://127.0.0.1:5050/mcp）を実行します。プロキシは、保留中のローカルファイルの同期が完了するまで OAuth ベアラートークンと AI エージェントツールリクエストを自動的に挿入してバッファリングし、検証ツールがサーバー上の古いコードを評価しないようにします。

カスタムまたは自己ホスト型 MCP サーバー（省略可）

組織がカスタム MCP サーバー（データベース向け MCP ツールボックスなど）をホストしている場合:

VS Code の設定で、looker.mcpServerUrl をカスタムサーバー URL（http://localhost:5000/mcp など）に設定します。
IDE の MCP クライアントを構成して、http://127.0.0.1:5050/mcp の拡張機能プロキシを指すようにします。

Visual Studio Code（Copilot）

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

      {
        "mcpServers": {
          "Looker": {
            "serverUrl": "http://127.0.0.1:5050/mcp",
            "disabledTools": [
              "query_url",
              "get_looks",
              "run_look",
              "make_look",
              "get_dashboards",
              "run_dashboard",
              "make_dashboard",
              "add_dashboard_element",
              "add_dashboard_filter",
              "generate_embed_url",
              "health_pulse",
              "health_analyze",
              "health_vacuum",
              "get_project_files",
              "get_project_file",
              "create_project_file",
              "update_project_file",
              "delete_project_file",
              "get_project_directories",
              "create_project_directory",
              "delete_project_directory",
              "project_git_branch"
            ]
          }
        }
      }

Claude Code

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

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

Cursor

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

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

[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/mcp"
          }
        }
      }

Windsurf

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

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

Looker で認証する

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

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

ローカル LookML プロジェクトを設定する

開発を開始するには、リポジトリ構成に適した方法を使用して、ローカル IDE で LookML プロジェクトを開きます。

Git リポジトリ

LookML プロジェクトが Git 用に構成されている場合は、次の手順を行います。

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

ベアリポジトリモード

LookML プロジェクトがベアリポジトリとして構成されている場合は、次の手順を行います。

ワークスペースを開いた状態で、プロジェクトの空のローカルフォルダを作成して開きます。
コマンドパレットを開きます（macOS の場合は Command-Shift-P 、Windows/Linux の場合は Ctrl+Shift+P ）。
Looker: Show Onboarding Walkthrough コマンドを実行して、オンボーディングチュートリアルを開きます。
[Select Project] ステップで、作業する LookML プロジェクトを選択し、[Next] をクリックします。
拡張機能は、ローカルフォルダが空であることを認識し、プロジェクトのファイルを使用してワークスペースを設定するように求めます。[Populate Workspace] をクリックして、ワークスペースを設定します。
オンボーディングチュートリアルを完了します。

ワークスペースが設定されると、拡張機能はローカルフォルダと Looker インスタンスの開発モードのチェックアウトされたブランチの同期を自動的に開始します。

トラブルシューティング

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

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

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