Sie lesen die Dokumentation für Looker 26.10. Klicken Sie hier, um die aktuelle Dokumentation aufzurufen.

Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Erste Schritte mit der Looker-Erweiterung für VS Code

Mit der Looker-Erweiterung für VS Code können Sie LookML direkt in Ihrer lokalen Desktopumgebung entwickeln. Sie bietet umfassende Syntaxhervorhebung, bidirektionale Dateisynchronisierung mit Ihrer Looker-Instanz und Einbindung von KI-Coding-Agenten für „Vibe Coding“.

Die Erweiterung basiert auf dem Visual Studio Code-Framework (VS Code) und unterstützt integrierte Entwicklungsumgebungen (IDEs), die auf der VS Code-IDE basieren, z. B. die folgenden IDEs und Codierungstools:

Claude Code
Codex
Cursor
Kiro
VS Code
Windsurf
Zed

IDEs, die keine Forks von VS Code sind, z. B. IntelliJ und Eclipse, werden von der Looker-Erweiterung für VS Code nicht unterstützt.

In diesem Leitfaden wird beschrieben, wie Sie die Erweiterung einrichten und authentifizieren.

KI-gestützter Workflow

Die Looker-Erweiterung für VS Code ist Teil eines KI-basierten, agentenbasierten Entwicklungsworkflows zum Bearbeiten und Erstellen von LookML-Dateien. Um diesen Workflow zu aktivieren, müssen Sie die folgenden Tools konfigurieren:

Die Looker-Erweiterung für VS Code.
Eine lokale IDE, die auf VS Code basiert. Die IDE muss entweder einen integrierten KI-Agenten (z. B. Cursor) enthalten oder, wenn die IDE keinen integrierten KI-Agenten enthält (z. B. VS Code), in eine eigenständige Agenten-basierte Lösung (z. B. Gemini CLI oder Claude Code) eingebunden sein. Informationen zum Verbinden Ihrer IDE mit einem Agenten finden Sie in der Dokumentation Ihrer lokalen IDE.
Ein MCP-Server, z. B. der von Looker verwaltete MCP-Server.

Weitere Informationen zum KI-basierten Workflow finden Sie auf der Dokumentationsseite KI-gestützte Entwicklung (Vibe-Codierung) mit Looker.

Hinweis

Bevor Sie die Erweiterung installieren, müssen die folgenden Voraussetzungen erfüllt sein:

KI-Tools verbinden: Wenn Sie die KI-gestützte Entwicklung nutzen möchten, verbinden Sie Ihre IDE und Ihren KI-Agenten mit dem von Looker verwalteten MCP-Server. Die Einrichtung und eine Beispielkonfiguration finden Sie auf der Dokumentationsseite Von Looker verwalteter MCP-Server. Weitere Informationen finden Sie in der Dokumentation Ihrer Tools.
Looker-Berechtigungen: Sie benötigen die Looker-Berechtigung develop für alle Modelle, die Sie bearbeiten möchten.
Looker-Instanz: Auf Ihrer Instanz muss Looker 26.6 oder höher ausgeführt werden.
Git-Installation: Sie müssen Git auf Ihrem lokalen Computer installiert haben, um Ihr LookML-Repository zu klonen und zu verwalten.
Projektkonfiguration: Ihr LookML-Projekt muss für Git konfiguriert sein.
OAuth-Client-ID: Wenn Sie die OAuth-Authentifizierung verwenden (empfohlen), müssen Sie eine OAuth-Client-ID von Ihrem Looker-Administrator erhalten.

Einrichtung durch Administrator

Wenn Ihre Organisation OAuth zur Authentifizierung verwendet, muss ein Looker-Administrator die Looker-Erweiterung für VS Code als OAuth-Client in der Looker-Administratoroberfläche registrieren.

Verwenden Sie den API Explorer von Looker, um die OAuth-Integration einzurichten. Sie haben folgende Möglichkeiten, auf den API Explorer zuzugreifen:

API Explorer installiert

Wenn der API Explorer bereits auf Ihrer Looker-Instanz installiert ist, können Sie über dieses URL-Format darauf zugreifen:

LOOKER_INSTANCE_URL/extensions/marketplace_extension_api_explorer::api-explorer/

API Explorer nicht installiert

Wenn Ihre Looker-Instanz nicht über den API Explorer verfügt, können Sie ihn über den Looker Marketplace installieren. Informationen zur Installation des API Explorer finden Sie auf der Seite API Explorer verwenden.

Private Instanz für den Zugriff auf private Dienste

Wenn Sie eine Looker (Google Cloud Core)-Instanz mit privaten Verbindungen verwenden, für die Zugriff auf private Dienste verwendet wird, werden der Looker Marketplace und der API Explorer nicht unterstützt. Wenn Sie einen KI-Agent registrieren möchten, müssen Sie den API-Endpunkt oauth_client_apps direkt aufrufen. Wenn Sie diese Methode verwenden, können Sie die verbleibenden Schritte dieses API Explorer-Verfahrens überspringen.

Unten sehen Sie ein Beispiel für einen curl-Befehl, den Sie mit dem oauth_client_apps-Endpunkt verwenden können, um den Agent zu registrieren.

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

Führen Sie die folgenden Schritte aus, um die Erweiterung zu registrieren:

Folgen Sie der Anleitung in der Dokumentation unter OAuth-Clientanwendung registrieren, um die Erweiterung zu registrieren.
Führen Sie für das Feld client_guid die folgenden Schritte aus:
- Verwenden Sie eine beliebige global eindeutige ID.
- Stellen Sie die ID allen LookML-Entwicklern zur Verfügung, die die Erweiterung verwenden möchten.

Geben Sie für redirect_uri die Callback-URL für Ihre IDE ein. Verwenden Sie je nach IDE oder Codierungstool eine der folgenden Callback-URLs:

IDE oder Tool	Callback-URL
VS Code	vscode://google.vscode-looker-official/oauth_callback
Antigravity	antigravity://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

Führen Sie die Schritte unter display_name und description aus, wie in der Dokumentation OAuth-Clientanwendung registrieren beschrieben.

Nach der Registrierung der App gibt der API Explorer eine Antwort mit einer Zusammenfassung der Registrierung zurück. Mit dem Endpunkt Get OAuth Client App und der client_guid können Sie Ihre Registrierungsdetails aufrufen.

Stellen Sie das generierte client_guid Ihren Entwicklern zur Verfügung. Sie verwenden es bei der Konfiguration der Erweiterung.

Erweiterung installieren

So installieren Sie die Erweiterung:

Installieren Sie die Looker-Erweiterung für VS Code über den Visual Studio Marketplace.
Öffnen Sie Ihre IDE, z. B. VS Code oder Cursor.
Klicken Sie in der Aktivitätsleiste auf das Symbol Erweiterungen.
Suchen Sie nach der Looker-Erweiterung für VS Code und klicken Sie auf Installieren.
Nach der Installation der Erweiterung wird das -Symbol für Looker in der Aktivitätsleiste angezeigt.

Erweiterung konfigurieren

Sie können die Erweiterung mit den Details Ihrer Looker-Instanz in der Datei settings.json Ihres Arbeitsbereichs, im visuellen VS Code-Einstellungseditor (Einstellungen: Arbeitsbereichseinstellungen öffnen) oder in der interaktiven Onboarding-UI der Looker-Erweiterung konfigurieren.

Die folgenden Schritte zeigen am Beispiel der Datei settings.json, wie Sie diese bearbeiten. Wenn Sie stattdessen den VS Code-Einstellungseditor oder die Benutzeroberfläche der Looker-Erweiterung verwenden, erzielen Sie dasselbe Ergebnis.

Öffnen Sie bei geöffnetem Arbeitsbereich die Befehlspalette (Befehlstaste + Umschalt + P auf dem Mac oder Strg + Umschalt + P unter Windows/Linux).
Suchen Sie nach Einstellungen: Arbeitsbereichseinstellungen öffnen (JSON) und wählen Sie die Option aus.
Fügen Sie Ihrer Konfiguration die Konfigurationsvariablen hinzu. Die Konfigurationsvariablen variieren je nachdem, ob Ihre Authentifizierungsmethode OAuth oder API-Anmeldedaten sind, wie in den folgenden Abschnitten beschrieben.

Authentifizierung mit OAuth (empfohlen)

OAuth 2.1 ist der empfohlene Authentifizierungsablauf. Fügen Sie diese Einstellungen in die Datei settings.json Ihres Arbeitsbereichs ein.

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

Ersetzen Sie Folgendes:

https://YOUR_INSTANCE_URL: Die URL Ihrer Looker-Instanz.
YOUR_OAUTH_CLIENT_ID: Die OAuth-Client-ID (client_guid), die Sie von Ihrem Looker-Administrator erhalten.
YOUR_PROJECT_ID: Der Name des Projekts, das Sie bearbeiten möchten. Öffnen Sie in Ihrer Looker-Instanz die Seite LookML-Projekte. Die Projekt-ID finden Sie in der Spalte Projekt.

Mit API-Anmeldedaten authentifizieren

Wenn Sie lieber Looker API-Schlüssel verwenden möchten, folgen Sie der Dokumentation zum Erstellen von API-Anmeldedaten. Sie müssen auch Ihre Projekt-ID angeben.

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

Ersetzen Sie Folgendes:

https://YOUR_INSTANCE_URL: Die URL Ihrer Looker-Instanz.
YOUR_CLIENT_ID und YOUR_CLIENT_SECRET: Die Client-ID und der Clientschlüssel für die API-Anmeldedaten, die Sie zur Authentifizierung verwenden. Um diese Anmeldedaten zu finden, öffnen Sie in Ihrer Looker-Instanz die Seite Konto und klicken Sie dann im Bereich API-Schlüssel auf die Schaltfläche Verwalten. Dadurch wird die Seite API-Schlüssel geöffnet, auf der Sie Ihre Client-IDs und Secrets sehen können.
YOUR_PROJECT_ID: Der Name des Projekts, das Sie bearbeiten möchten. Um den Projektnamen zu finden, öffnen Sie in Ihrer Looker-Instanz die Seite LookML-Projekte. Die Projekt-ID finden Sie in der Spalte Projekt.

Einstellungen

Sie können die folgenden MCP-Einstellungen in Ihrem IDE-Arbeitsbereich konfigurieren.

Einstellung	Beschreibung	Standard
`looker.instanceURL`	Die Basis-URL der Looker-Instanz, z. B. `https://mycompany.looker.com`.	-
`looker.authURL`	URL für die OAuth-Authentifizierung. Wird nur festgelegt, wenn sie sich von der Instanz-URL unterscheidet.	`looker.instanceURL`
`looker.sdkURL`	URL für API-Anfragen. Wird nur festgelegt, wenn sie sich von der URL Ihrer Instanz unterscheidet.	`looker.instanceURL`
`looker.oauthClientId`	Looker-OAuth-Client-ID. Für OAuth erforderlich.	-
`looker.clientId`	Looker API-Client-ID. Erforderlich für die API-Schlüssel-Authentifizierung.	-
`looker.clientSecret`	Looker API-Clientschlüssel. Erforderlich für die API-Schlüssel-Authentifizierung.	-
`looker.projectId`	Looker-Projekt-ID.	-
`looker.mcpServerUrl`	URL des externen MCP-Servers, der als Proxy verwendet werden soll (z. B. `http://localhost:5000/mcp`).	-
`looker.acceptSelfSignedCertificates`	SSL-Zertifikatfehler ignorieren (z. B. bei selbstsignierten Zertifikaten). Achtung: Das Aktivieren dieser Option wird nicht empfohlen.	`false`
`looker.askBeforeOverwritingRemote`	Immer nachfragen, bevor Remote-Dateien überschrieben werden, wenn ein Konflikt erkannt wird.	`false`

MCP-Client konfigurieren

Damit Ihr KI-Agent über die Erweiterung mit Looker interagieren kann, müssen Sie ihn so konfigurieren, dass er eine Verbindung zur MCP-Proxy-URL der Erweiterung herstellt. Standardmäßig wird der Proxy lokal unter http://127.0.0.1:5050 ausgeführt.

Wenn Ihr MCP-Server auf einem anderen Port als 5000 oder auf einem Remotecomputer ausgeführt wird, müssen Sie die Proxykonfiguration der Erweiterung aktualisieren. Aktualisieren Sie dazu die Einstellung looker.mcpServerUrl in den Einstellungen Ihres VS Code-Arbeitsbereichs. Weitere Informationen finden Sie im Abschnitt Einstellungen.

Visual Studio Code (Copilot)

Öffnen Sie VS Code und erstellen Sie im Stammverzeichnis Ihres Projekts das Verzeichnis .vscode, falls es noch nicht vorhanden ist.
Erstellen Sie die Datei .vscode/mcp.json, falls sie noch nicht vorhanden ist, und öffnen Sie sie.
Fügen Sie die folgende Konfiguration hinzu und speichern Sie die Datei:

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

Claude Code

Erstellen Sie im Stammverzeichnis Ihres Projekts die Datei .mcp.json, falls sie noch nicht vorhanden ist.
Fügen Sie die folgende Konfiguration hinzu und speichern Sie die Datei:

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

Cursor

Erstellen Sie das Verzeichnis .cursor im Stammverzeichnis Ihres Projekts, falls es noch nicht vorhanden ist.
Erstellen Sie die Datei .cursor/mcp.json, falls sie noch nicht vorhanden ist, und öffnen Sie sie.
Fügen Sie die folgende Konfiguration hinzu und speichern Sie die Datei:

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

Öffnen Sie Cursor und rufen Sie Einstellungen > Cursoreinstellungen > MCP auf. Wenn der Server verbunden ist, wird ein grüner aktiver Status angezeigt.

Cline

Öffnen Sie die Cline-Erweiterung in VS Code und klicken Sie auf das Symbol MCP-Server.
Klicken Sie auf MCP-Server konfigurieren, um die Konfigurationsdatei zu öffnen.
Fügen Sie die folgende Konfiguration hinzu und speichern Sie die Datei:

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

Windsurf

Öffnen Sie Windsurf und rufen Sie den Cascade-Assistenten auf.
Klicken Sie auf das MCP-Symbol und dann auf Konfigurieren, um die Konfigurationsdatei zu öffnen.
Fügen Sie die folgende Konfiguration hinzu und speichern Sie die Datei:

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

Über Looker authentifizieren

Wenn Sie die OAuth-Authentifizierung verwenden, müssen Sie sich anmelden, um Ihre lokale IDE mit Ihrem Looker-Konto zu verknüpfen.

Öffnen Sie die Befehlspalette.
Führen Sie den Befehl Looker: Sign In (OAuth) aus.
Bestätigen Sie die Aufforderung, um den Browser zu öffnen.
Autorisieren Sie im Browser die Erweiterung für den Zugriff auf Ihr Looker-Konto.
Nach der Autorisierung wird der Browser zurück zu Ihrer IDE weitergeleitet. Sie sollten eine Benachrichtigung mit dem Text Successfully signed in to Looker! (Erfolgreich in Looker angemeldet) sehen.

LookML-Projekt klonen

Bevor Sie mit der Entwicklung beginnen können, müssen Sie Ihr LookML-Repository auf Ihren lokalen Computer klonen.

Öffnen Sie in VS Code ein neues Fenster.
Öffnen Sie die Befehlspalette und wählen Sie Git: Clone aus.
Geben Sie die URL Ihres Remote-Git-Repositorys ein (z. B. von GitHub oder GitLab) und wählen Sie einen lokalen Ordner aus.
Öffnen Sie den geklonten Ordner in Ihrer IDE.

Die Erweiterung erkennt die LookML-Dateien automatisch und beginnt mit der Synchronisierung mit dem ausgecheckten Branch im Entwicklermodus Ihrer Looker-Instanz.

Fehlerbehebung

Sie können die Erweiterungslogs im Bereich Output Ihrer IDE aufrufen. Wählen Sie den Looker-Channel aus, um Logs aufzurufen. Wenn Sie detailliertere Logs benötigen, öffnen Sie die Befehlspalette, führen Sie den Befehl Entwickler: Log-Ebene festlegen aus und wählen Sie Debuggen oder Trace aus.

Authentifizierungsfehler: Prüfen Sie, ob looker.instanceUrl und looker.oauthClientId korrekt sind. Die Weiterleitungs-URI in Looker muss genau übereinstimmen.
Synchronisierungsprobleme: Prüfen Sie die Erweiterungslogs, um Synchronisierungsprobleme zu beheben. Wenn Sie Logs aufrufen möchten, öffnen Sie den Bereich Output (Ausgabe) und wählen Sie im Drop-down-Menü Looker aus.
„Bad Request“-Antwort während OAuth: Prüfen Sie, ob Ihre Looker-Instanz über Ihr lokales Netzwerk erreichbar ist und ob Sie eine gültige Internetverbindung haben.

Wenn Probleme mit der Erweiterung auftreten, kann es helfen, den Befehl Developer: Reload Window über die Befehlspalette auszuführen.