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 Erweiterung Looker by Google Cloud für Visual Studio Code (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:

Eine lokale IDE, die auf VS Code basiert. Die IDE muss entweder einen integrierten KI-Agenten (z. B. Cursor) enthalten oder, falls die IDE keinen integrierten KI-Agenten enthält, in ein eigenständiges agentisches Tool (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.
Die Looker-Erweiterung für VS Code.
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:

Von Looker verwalteter MCP-Server (optional, aber empfohlen): Wenn Sie KI-gestützte Entwicklung verwenden möchten, verbinden Sie Ihre IDE und Ihren KI-Agenten mit dem von Looker verwalteten MCP-Server. Eine Anleitung zum Einrichten des MCP-Servers 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.
Projektkonfiguration: Sie benötigen ein Projekt in Looker, das entweder als Bare-Repository konfiguriert oder für Git konfiguriert ist.
Git-Installation (optional): Wenn Sie Ihr LookML-Repository klonen möchten, muss Git auf Ihrem lokalen Computer installiert 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
Antigravity IDE (verfügbar in Looker 26.12 oder höher)	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 (OAuth-Unterstützung für Kiro ist in Looker 26.16 oder höher verfügbar)	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

Prüfen Sie, ob das Feld Aktiviert auf true festgelegt ist.
Füllen Sie die Felder 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. Achten Sie darauf, dass der Weiterleitungs-URI mit dem übereinstimmt, was Sie im Anfrageparameter eingegeben haben. Mit dem Endpunkt Get OAuth Client App und dem Wert client_guid können Sie Ihre Registrierungsdetails aufrufen.

Geben Sie den generierten client_guid-Wert an Ihre Entwickler weiter. Sie verwenden ihn bei der Konfiguration der Erweiterung.

Erweiterung installieren

Die Erweiterung ist auf beiden großen Erweiterungsmarktplätzen verfügbar:

Visual Studio Marketplace (für Standard-VS Code)
Open VSX Registry (für Cursor, Antigravity IDE und VSCodium)

So installieren Sie die Erweiterung:

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

Erweiterung konfigurieren

So konfigurieren Sie die Erweiterung mit den Details Ihrer Looker-Instanz:

Öffnen Sie bei geöffnetem Arbeitsbereich die Befehlspalette (Befehlstaste + Umschalttaste + P unter macOS oder Strg + Umschalttaste + P unter Windows/Linux).
Führen Sie den Befehl Looker: Show Onboarding Walkthrough aus, um die Onboarding-Anleitung zu öffnen.
Folgen Sie der Anleitung, um die URL der Looker-Instanz, die Projekt-ID und die Authentifizierungsdetails einzugeben. Wenn Sie ein Bare Repository verwenden, werden Sie während dieses Vorgangs auch aufgefordert, Ihren Arbeitsbereich mit den LookML-Dateien des Projekts zu füllen.

Authentifizierung mit OAuth (empfohlen)

OAuth 2.1 ist der empfohlene Authentifizierungsablauf. Wählen Sie bei der Aufforderung während des Onboardings OAuth aus und geben Sie die folgenden Konfigurationswerte an:

Looker-Instanz-URL: Die URL Ihrer Looker-Instanz.
OAuth-Client-ID: Die OAuth-Client-ID (client_guid), die Sie von Ihrem Looker-Administrator erhalten.
Projekt-ID: Der Name des LookML-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. Wählen Sie bei der Aufforderung während des Onboarding-Prozesses API-Anmeldedaten aus und geben Sie die folgenden Konfigurationswerte an:

Looker-Instanz-URL: Die URL Ihrer Looker-Instanz.
Client-ID und Clientschlüssel: Die Client-ID und der Clientschlüssel für die API-Anmeldedaten, die Sie zur Authentifizierung verwenden. Öffnen Sie in Ihrer Looker-Instanz die Seite Konto. Klicken Sie dann im Bereich API-Schlüssel auf die Schaltfläche Verwalten, um Ihre Client-IDs und ‑Secrets aufzurufen.
Projekt-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

Wir empfehlen zwar, die Anleitung für das Onboarding zu verwenden, Sie können die Erweiterungseinstellungen aber auch in Ihrer VS Code-Datei settings.json konfigurieren. Diese Datei befindet sich entweder in Ihrem Arbeitsbereich im Ordner .vscode (.vscode/settings.json) oder in Ihrer globalen Nutzereinstellungsdatei (settings.json). Sie können die Einstellungen auch über den visuellen VS Code-Einstellungseditor konfigurieren (Preferences: Open Settings (UI)).

Alle looker.<setting>-Attribute müssen in VS Code-settings.json-Dateien definiert werden, einschließlich der Erweiterungseinstellung looker.mcpServerUrl für MCP. Wenn Sie diese Einstellungen in der MCP-Konfigurationsdatei eines KI-Agents (z. B. .agents/mcp_config.json) oder in anderen Einstellungsdateien definieren, funktioniert die Erweiterung nicht.

Sie können die folgenden Erweiterungseinstellungen in settings.json 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. Veraltet. Konfigurieren Sie API-Anmeldedaten mithilfe der Anleitung für die Einrichtung.	-
`looker.projectId`	LookML-Projekt-ID.	-
`looker.mcpServerUrl`	URL des Ziel-MCP-Servers, an den der lokale MCP-Proxy der Erweiterung Anfragen weiterleitet. Wird nur festgelegt, wenn sie sich von `looker.instanceURL/mcp` unterscheidet (z. B. `http://localhost:5000/mcp`).	`looker.instanceURL/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 zum lokalen MCP-Proxy der Erweiterung unter http://127.0.0.1:5050/mcp herstellt.

Ihr KI-Agent verweist auf seine eigene MCP-Konfigurationsdatei (z. B. .agents/mcp_config.json in VS Code, .mcp.json in Claude Code oder .cursor/mcp.json in Cursor). Wenn Sie diese Konfiguration auf den lokalen Proxy verweisen, kann die Erweiterung die MCP-Anfragen Ihres Agenten erfassen und mit den entsprechenden Authentifizierungsheadern weiterleiten.

Von Looker verwalteter MCP-Server (Standard und empfohlen)

Die Erweiterung führt einen lokalen Reverse-Proxy aus (Standard: http://127.0.0.1:5050/mcp), der eine Verbindung zum integrierten verwalteten MCP-Server von Looker (LOOKER_INSTANCE_URL/mcp) herstellt. Der Proxy fügt automatisch OAuth-Bearer-Tokens ein und puffert Anfragen für KI-Agenten-Tools, bis ausstehende lokale Dateisynchronisierungen abgeschlossen sind. So wird sichergestellt, dass Validierungstools niemals veralteten Code auf dem Server auswerten.

Benutzerdefinierter oder selbst gehosteter MCP-Server (optional)

Wenn Ihre Organisation einen benutzerdefinierten MCP-Server hostet (z. B. die eigenständige MCP Toolbox for Databases):

Legen Sie in den VS Code-Einstellungen looker.mcpServerUrl auf Ihre benutzerdefinierte Server-URL fest (z. B. http://localhost:5000/mcp).
Konfigurieren Sie den MCP-Client Ihrer IDE so, dass er auf den Erweiterungsproxy unter http://127.0.0.1:5050/mcp verweist.

Visual Studio Code (Copilot)

Öffnen Sie VS Code und erstellen Sie im Stammverzeichnis Ihres Projekts das Verzeichnis .agents, falls es noch nicht vorhanden ist.
Erstellen Sie die Datei .agents/mcp_config.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": {
            "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

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

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

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

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

Ü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.

Lokales LookML-Projekt erstellen

Öffnen Sie Ihr LookML-Projekt in Ihrer lokalen IDE, indem Sie die für Ihre Repository-Konfiguration geeignete Methode verwenden:

Git-Repository

Wenn Ihr LookML-Projekt für Git konfiguriert ist, gehen Sie so vor:

Ö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.

Bare-Repository-Modus

Wenn Ihr LookML-Projekt als Bare Repository konfiguriert ist, gehen Sie so vor:

Erstellen und öffnen Sie bei geöffnetem Arbeitsbereich einen leeren lokalen Ordner für Ihr Projekt.
Öffnen Sie die Befehlspalette (Befehlstaste + Umschalttaste + P unter macOS oder Strg + Umschalttaste + P unter Windows/Linux).
Führen Sie den Befehl Looker: Show Onboarding Walkthrough aus, um die Onboarding-Anleitung zu öffnen.
Wählen Sie im Schritt Projekt auswählen das LookML-Projekt aus, das Sie bearbeiten möchten, und klicken Sie auf Weiter.
Die Erweiterung erkennt, dass Ihr lokaler Ordner leer ist, und fordert Sie auf, den Arbeitsbereich mit den Dateien des Projekts zu füllen. Klicken Sie auf Arbeitsbereich befüllen, um den Arbeitsbereich zu befüllen.
Führen Sie das Onboarding durch.

Sobald der Arbeitsbereich gefüllt ist, beginnt die Erweiterung automatisch mit der Synchronisierung Ihres lokalen Ordners 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.