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

MCP Toolbox for Databases verwenden

Auf dieser Seite wird beschrieben, wie Sie die MCP Toolbox for Databases verwenden, um Ihre Looker-Instanz mit integrierten Entwicklungsumgebungen (IDEs) und Entwicklertools zu verbinden, die das Model Context Protocol (MCP) unterstützen. Die MCP Toolbox ist eine gute Option, wenn Sie eine vom Kunden gehostete Instanz verwenden oder Ihre eigene Infrastruktur verwalten möchten. Andernfalls empfehlen wir, stattdessen den von Looker verwalteten MCP-Server zu verwenden.

Wir empfehlen, die spezielle Looker-Erweiterung für die Gemini CLI mit der MCP-Toolbox zu verwenden. Mit der semantischen Schicht von Looker können Sie der Gemini CLI sicheren, kontrollierten und On-Demand-Zugriff auf vertrauenswürdige Daten gewähren und Workflows beschleunigen, indem Sie die Erstellung von Berichten, Visualisierungen und Dashboards aus Prompts in natürlicher Sprache automatisieren. Als Google Clouds Gemini CLI der nächsten Generation ist sie das empfohlene Tool für die Interaktion mit Ihren Looker-Instanzen über die Befehlszeile.

Sie können auch andere integrierte Entwicklungsumgebungen (IDEs) und Entwicklertools, die das Model Context Protocol (MCP) unterstützen, über die MCP Toolbox for Databases für allgemeine Zwecke verbinden. Die MCP Toolbox ist ein Open-Source-MCP-Server, der die Verbindung von KI-Agenten mit Ihren Daten vereinfacht, indem er komplexe Aufgaben wie Authentifizierung und Verbindungspooling übernimmt. So können Sie direkt über Ihre IDE in natürlicher Sprache mit Ihren Daten interagieren. Für diese Tools bietet diese Methode grundlegende Funktionen für die Datenbankinteraktion.

Gemini CLI und Erweiterungen

Die Gemini CLI ist ein Open-Source-KI-Agent, der Entwicklungs-Workflows beschleunigen soll, indem er beim Programmieren, Debuggen, bei der Datenexploration und bei der Erstellung von Inhalten hilft. Ziel ist es, eine elegante agentische Umgebung für die Interaktion mit Cloud-Datendiensten und gängigen Open-Source-Datenbanken bereitzustellen.

Funktionsweise von Erweiterungen

Die Gemini CLI ist hochgradig erweiterbar, sodass neue Tools und Funktionen über Erweiterungen hinzugefügt werden können. Diese Erweiterungen sind einfach zu installieren. Sie können sie über eine GitHub-URL, ein lokales Verzeichnis oder eine konfigurierbare Registry laden. Diese Erweiterungen bieten eine Vielzahl von Funktionen, darunter neue Tools, Slash-Befehle und Prompts, mit denen Sie Ihren Workflow optimieren können.

Looker-Authentifizierung vorbereiten

Sie haben zwei Möglichkeiten, Ihren MCP-Client bei Looker zu authentifizieren: Sie können entweder Standard-API-Anmeldedaten verwenden oder den Client über eine OAuth-Anwendungsregistrierung authentifizieren.

Option 1: API-Anmeldedaten

Rufen Sie eine Looker-Client-ID und einen Clientschlüssel ab. Folgen Sie der Anleitung auf der Dokumentationsseite Looker API-Authentifizierung.
Halten Sie die Basis-URL Ihrer Looker-Instanz bereit. Sie sieht wahrscheinlich so aus: https://looker.example.com. In einigen Fällen überwacht die API einen anderen Port und Sie müssen stattdessen https://looker.example.com:19999 verwenden.

Option 2: OAuth-Anwendungsregistrierung

Öffnen Sie den Looker API Explorer.
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-Explorers finden Sie auf der Seite API-Explorer verwenden.
Private PSA-Instanz
Wenn Sie eine Instanz von Looker (Google Cloud Core) mit privaten Verbindungen verwenden, die den Zugriff auf private Dienste nutzt, werden der Looker Marketplace und der API Explorer nicht unterstützt. Wenn Sie einen KI-Agenten 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.

Im Folgenden finden Sie ein Beispiel für einen curl-Befehl, den Sie mit dem Endpunkt oauth_client_apps verwenden können, um den Agenten 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 }'
Suchen Sie unter der Methode Auth nach dem API-Endpunkt Register OAuth App. Sie können auch im Feld Suchen nach „oauth app“ suchen.
Wählen Sie Ausführen aus.
Geben Sie für client_guid einen benutzerdefinierten String ein (z. B. gemini_cli oder claude-desktop).
Geben Sie im Anfragetext die folgende JSON-Konfiguration ein:
```
{
  "redirect_uri": "AI_AGENT_REDIRECT_URI",
  "display_name": "APPLICATION_NAME",
  "description": "APPLICATION_DESCRIPTION",
  "enabled": true
}
```
Ersetzen Sie Folgendes:
- AI_AGENT_REDIRECT_URI: Der Weiterleitungs-URI für Ihre KI-Agentenerweiterung oder freigegebene Dienstanwendung.
  - Bei in der Cloud gehosteten Anwendungen kann es sich um eine sichere HTTPS-URL handeln: https://AI_AGENT_URL/oauth2callback
  - Für lokal ausgeführte Anwendungen sollte es eine Localhost-URL mit einem statischen Port sein: http://localhost:7777/oauth/callback
    
    Hinweis: Bei einigen Tools, z. B. der Gemini CLI, müssen Sie möglicherweise eine Umgebungsvariable (z. B. export OAUTH_CALLBACK_PORT=7777) festlegen, damit die Tools einen statischen Port verwenden, der mit Ihrem registrierten Weiterleitungs-URI übereinstimmt.
  - In IDEs kann das so aussehen: vscode://google.vscode-looker-official/oauth_callback
- APPLICATION_NAME: Der Anzeigename für Ihre OAuth-Anwendung, z. B. Claude Desktop.
- APPLICATION_DESCRIPTION: Eine kurze Beschreibung Ihrer OAuth-Anwendung.
Klicken Sie das Bestätigungskästchen neben I understand that this API endpoint will change data (Ich verstehe, dass dieser API-Endpunkt Daten ändert) an und wählen Sie dann Run (Ausführen) aus.

MCP Toolbox installieren

Laden Sie die aktuelle Version der MCP Toolbox als Binärprogramm herunter. Wählen Sie das Binärprogramm aus, das Ihrem Betriebssystem und Ihrer CPU-Architektur entspricht. Sie müssen die MCP Toolbox-Version V1.0.0 oder höher verwenden.

linux/amd64

curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/v1.0.0/linux/amd64/toolbox

darwin/arm64

curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/v1.0.0/darwin/arm64/toolbox

darwin/amd64

curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/v1.0.0/darwin/amd64/toolbox

windows/amd64

curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/v1.0.0/windows/amd64/toolbox.exe

Machen Sie das Binärprogramm ausführbar.
```
chmod +x toolbox
```
Prüfen Sie die Installation.
```
./toolbox --version
```

MCP Toolbox als freigegebenen Dienst ausführen

Für MCP-Clients, die eine OAuth-Authentifizierung über HTTPS erfordern, müssen Sie die MCP Toolbox hinter einem HTTPS-Reverse-Proxy (z. B. Cloud Run) bereitstellen. Der Reverse-Proxy beendet SSL und leitet Anfragen an den MCP Toolbox-Container weiter.

Serverumgebung konfigurieren

Legen Sie die folgenden Umgebungsvariablen in Ihrer Bereitstellung fest:
- LOOKER_BASE_URL=YOUR_LOOKER_BASE_URL
- LOOKER_USE_CLIENT_OAUTH=true
Führen Sie die MCP Toolbox mit den folgenden Argumenten aus:
- --prebuilt=looker,looker-dev
- --mcp-prm-file=prm.json
- [--address=0.0.0.0]
- [--port=8080]
Die MCP Toolbox überwacht normalerweise den 127.0.0.1-Port 5000. Wenn sich der Reverse-Proxy auf einem anderen Host befindet, verwenden Sie --address=0.0.0.0, um eine Bindung an alle IP-Adressen herzustellen. Verwenden Sie die Einstellung --port=, wenn Sie einen anderen Überwachungsport als 5000 verwenden müssen. Cloud Run leitet beispielsweise externen Traffic automatisch von Port 443, dem HTTPS-Port, an 8080 weiter.
Erstellen Sie eine PRM-Konfigurationsdatei (Protected Resource Metadata) (prm.json) mit der folgenden Struktur:
```
{
"resource": "https://PROXY_URL/mcp",
"authorization_servers": ["LOOKER_URL"],
"scopes_supported": ["cors_api"]
}
```
Ersetzen Sie Folgendes:
- PROXY_URL: Die Domain und der Basispfad Ihres Reverse-Proxy-Servers.
- LOOKER_URL: Die Basis-URL Ihrer Looker-Instanz.

Ein Beispiel für die Konfiguration des Clients, wenn Sie die MCP Toolbox als freigegebenen Dienst ausführen, finden Sie in der Claude-Desktop-Beispielkonfiguration.

MCP-Client konfigurieren

In diesem Abschnitt wird beschrieben, wie Sie verschiedene Entwicklertools so konfigurieren, dass sie über die MCP Toolbox for Databases eine Verbindung zu Ihrer Looker-Instanz herstellen. Die Toolbox fungiert als Open-Source-Model Context Protocol (MCP)-Server, der sich zwischen Ihrer IDE und Ihrer Datenbank befindet und eine sichere und effiziente Steuerungsebene für Ihre KI-Tools bietet. Wählen Sie den Tab für Ihr Tool aus, um die Konfigurationsanleitung aufzurufen.

Gemini CLI
Gemini Code Assist
Claude Code
Claude für Desktop
Cline (VS Code-Erweiterung)
Cursor
Visual Studio Code (Copilot)
Windsurf (Codium)

Gemini CLI

Wählen Sie die Verbindungsmethode aus, die auf Ihrer Authentifizierungsauswahl basiert:

Option 1: API-Anmeldedaten mit Erweiterung

Installieren Sie die Gemini-Befehlszeile.
Installieren Sie die Looker-Erweiterung für die Gemini CLI aus dem GitHub-Repository mit dem folgenden Befehl:
```
gemini extensions install https://github.com/gemini-cli-extensions/looker
```
Legen Sie Umgebungsvariablen fest, um eine Verbindung zu Ihrer Looker-Instanz herzustellen. Ersetzen Sie dabei die folgenden Umgebungsvariablen durch Ihre Werte:
- LOOKER_URL: Die URL Ihrer Looker-Instanz.
- CLIENT_ID und CLIENT_SECRET: Der API-Schlüssel, der für den Zugriff auf die Looker API verwendet wird.
- VERIFY_SSL: Entweder true oder false, je nachdem, ob Sie die SSL-Verschlüsselung verwenden, um Ihre Datenbank mit Ihrer Looker-Instanz zu verbinden.
```
export LOOKER_BASE_URL="LOOKER_URL"
export LOOKER_CLIENT_ID="CLIENT_ID"
export LOOKER_CLIENT_SECRET="CLIENT_SECRET"
export LOOKER_VERIFY_SSL="VERIFY_SSL"
```
Starten Sie die Gemini CLI im interaktiven Modus:
```
gemini
```
Die CLI lädt automatisch die Looker-Erweiterung für die Gemini CLI-Erweiterung und die zugehörigen Tools, mit denen Sie mit Ihrer Looker-Instanz interagieren können.

Option 2: Remote-Dienst mit OAuth

Wenn Sie über OAuth eine Verbindung zu einem Remote-Dienst herstellen möchten, installieren Sie die Looker-Erweiterung nicht. Konfigurieren Sie stattdessen die Gemini CLI so, dass sie sich direkt mit Ihrem Remote-MCP-Server verbindet.

Installieren Sie die Gemini-Befehlszeile.
Fügen Sie den Remote-MCP-Server mit dem folgenden Befehl hinzu. Ersetzen Sie dabei PROXY_URL durch die Domain Ihres Reverse-Proxy-Servers:
```
gemini mcp add --transport http looker https://PROXY_URL/mcp
```
Alternativ können Sie dies manuell konfigurieren, indem Sie die folgende Konfiguration in die Datei settings.json (in ~/.gemini/settings.json oder Ihrem Projektverzeichnis) einfügen:
```
{
  "mcpServers": {
    "looker": {
      "httpUrl": "https://PROXY_URL/mcp"
    }
  }
}
```
Starten Sie die Gemini CLI im interaktiven Modus:
```
gemini
```
Wenn Sie aufgefordert werden, eine Verbindung herzustellen, initiiert die Befehlszeile den OAuth-Autorisierungsablauf, um sich sicher bei Ihrer Looker-Instanz zu authentifizieren.

Gemini Code Assist

Wir empfehlen, Gemini Code Assist so zu konfigurieren, dass die Gemini CLI verwendet wird. Bei diesem Ansatz ist keine manuelle Konfiguration eines MCP-Servers erforderlich.

Sie müssen die Gemini CLI und entweder die looker-Erweiterung (für API-Anmeldedaten) oder eine Remote-MCP-Serverkonfiguration (für einen freigegebenen Dienst mit OAuth) installiert und konfiguriert haben.
Gemini Code Assist für die Verwendung der Gemini CLI konfigurieren
Sie können jetzt direkt im Gemini Code Assist-Chat in natürlicher Sprache mit Ihrer Looker-Instanz interagieren.

Claude-Code

Wählen Sie die Verbindungsmethode aus, die auf Ihrer Authentifizierungsauswahl basiert:

Option 1: API-Anmeldedaten

Installieren Sie Claude Code.
Erstellen Sie im Stammverzeichnis Ihres Projekts eine .mcp.json-Datei, falls sie noch nicht vorhanden ist.
Fügen Sie die folgende Konfiguration hinzu, ersetzen Sie die folgenden Umgebungsvariablen durch Ihre Werte und speichern Sie die Datei.
- LOOKER_URL: Die URL Ihrer Looker-Instanz.
- CLIENT_ID und CLIENT_SECRET: Der API-Schlüssel, der für den Zugriff auf die Looker API verwendet wird.
- VERIFY_SSL: Entweder true oder false, je nachdem, ob Sie die SSL-Verschlüsselung verwenden, um Ihre Datenbank mit Ihrer Looker-Instanz zu verbinden.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }

Option 2: Remote-Dienst mit OAuth

Installieren Sie Claude Code.
Erstellen Sie im Stammverzeichnis Ihres Projekts eine .mcp.json-Datei, falls sie noch nicht vorhanden ist.
Fügen Sie die folgende Konfiguration hinzu, ersetzen Sie PROXY_URL durch die Domain Ihres Reverse-Proxy-Servers und speichern Sie die Datei.

      {
        "mcpServers": {
          "looker-toolbox": {
            "type": "http",
            "url": "https://PROXY_URL/mcp"
          }
        }
      }

Claude für den Computer

Wählen Sie die Verbindungsmethode aus, die auf Ihrer Authentifizierungsauswahl basiert:

Option 1: API-Anmeldedaten

Öffnen Sie Claude für Desktop und rufen Sie die Einstellungen auf.
Klicken Sie auf dem Tab Entwickler auf Konfiguration bearbeiten, um die Konfigurationsdatei zu öffnen.
Fügen Sie die folgende Konfiguration hinzu, ersetzen Sie die folgenden Umgebungsvariablen durch Ihre Werte und speichern Sie die Datei.
- LOOKER_URL: Die URL Ihrer Looker-Instanz.
- CLIENT_ID und CLIENT_SECRET: Der API-Schlüssel, der für den Zugriff auf die Looker API verwendet wird.
- VERIFY_SSL: Entweder true oder false, je nachdem, ob Sie die SSL-Verschlüsselung verwenden, um Ihre Datenbank mit Ihrer Looker-Instanz zu verbinden.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }

Option 2: Remote-Dienst mit OAuth

Rufen Sie in Claude für Desktop die Einstellungen auf und wählen Sie Connectors aus.
Wählen Sie Benutzerdefinierten Connector hinzufügen aus und geben Sie einen Namen ein (z. B. Looker).
Geben Sie als URL den Endpunkt Ihres Reverse-Proxy-Servers mit dem angehängten Pfad /mcp ein (z. B. https://looker-mcp-toolbox.example.com/mcp).
Geben Sie unter Erweiterte Einstellungen genau den String ein, den Sie bei der Registrierung der OAuth-Anwendung für die client_guid verwendet haben. Lassen Sie den OAuth-Clientschlüssel leer.
Wählen Sie Hinzufügen aus, um den Connector zu speichern. Wenn Sie aufgefordert werden, eine Verbindung herzustellen, initiiert Claude Desktop den PKCE-Autorisierungsablauf sicher über Ihren Browser.

Starten Sie Claude für den Computer neu.

Cline

Wählen Sie die Verbindungsmethode aus, die auf Ihrer Authentifizierungsauswahl basiert:

Option 1: API-Anmeldedaten

Ö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, ersetzen Sie die folgenden Umgebungsvariablen durch Ihre Werte und speichern Sie die Datei.
- LOOKER_URL: Die URL Ihrer Looker-Instanz.
- CLIENT_ID und CLIENT_SECRET: Der API-Schlüssel, der für den Zugriff auf die Looker API verwendet wird.
- VERIFY_SSL: Entweder true oder false, je nachdem, ob Sie die SSL-Verschlüsselung verwenden, um Ihre Datenbank mit Ihrer Looker-Instanz zu verbinden.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }

Nachdem der Server erfolgreich verbunden wurde, wird ein grüner Aktivitätsstatus angezeigt.

Option 2: Remote-Dienst mit OAuth

Ö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, ersetzen Sie PROXY_URL durch die Domain Ihres Reverse-Proxy-Servers und speichern Sie die Datei.

      {
        "mcpServers": {
          "looker-toolbox": {
            "type": "http",
            "url": "https://PROXY_URL/mcp"
          }
        }
      }

Nachdem der Server erfolgreich verbunden wurde, wird ein grüner Aktivitätsstatus angezeigt.

Cursor

Wählen Sie die Verbindungsmethode aus, die auf Ihrer Authentifizierungsauswahl basiert:

Option 1: API-Anmeldedaten

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, ersetzen Sie die folgenden Umgebungsvariablen durch Ihre Werte und speichern Sie die Datei.
- LOOKER_URL: Die URL Ihrer Looker-Instanz.
- CLIENT_ID und CLIENT_SECRET: Der API-Schlüssel, der für den Zugriff auf die Looker API verwendet wird.
- VERIFY_SSL: Entweder true oder false, je nachdem, ob Sie die SSL-Verschlüsselung verwenden, um Ihre Datenbank mit Ihrer Looker-Instanz zu verbinden.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }

Öffnen Sie Cursor und rufen Sie Einstellungen > Cursor-Einstellungen > MCP auf. Wenn der Server eine Verbindung herstellt, wird ein grüner Aktivitätsstatus angezeigt.

Option 2: Remote-Dienst mit OAuth

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, ersetzen Sie PROXY_URL durch die Domain Ihres Reverse-Proxy-Servers und speichern Sie die Datei.

      {
        "mcpServers": {
          "looker-toolbox": {
            "type": "http",
            "url": "https://PROXY_URL/mcp"
          }
        }
      }

Öffnen Sie Cursor und rufen Sie Einstellungen > Cursor-Einstellungen > MCP auf. Wenn der Server eine Verbindung herstellt, wird ein grüner Aktivitätsstatus angezeigt.

Visual Studio Code (Copilot)

Wählen Sie die Verbindungsmethode aus, die auf Ihrer Authentifizierungsauswahl basiert:

Option 1: API-Anmeldedaten

Ö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, ersetzen Sie die folgenden Umgebungsvariablen durch Ihre Werte und speichern Sie die Datei.
- LOOKER_URL: Die URL Ihrer Looker-Instanz.
- CLIENT_ID und CLIENT_SECRET: Der API-Schlüssel, der für den Zugriff auf die Looker API verwendet wird.
- VERIFY_SSL: Entweder true oder false, je nachdem, ob Sie die SSL-Verschlüsselung verwenden, um Ihre Datenbank mit Ihrer Looker-Instanz zu verbinden.

      {
        "servers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }

Option 2: Remote-Dienst mit OAuth

Ö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, ersetzen Sie PROXY_URL durch die Domain Ihres Reverse-Proxy-Servers und speichern Sie die Datei.

      {
        "servers": {
          "looker-toolbox": {
            "type": "http",
            "url": "https://PROXY_URL/mcp"
          }
        }
      }

Windsurf

Wählen Sie die Verbindungsmethode aus, die auf Ihrer Authentifizierungsauswahl basiert:

Option 1: API-Anmeldedaten

Ö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, ersetzen Sie die folgenden Umgebungsvariablen durch Ihre Werte und speichern Sie die Datei.
- LOOKER_URL: Die URL Ihrer Looker-Instanz.
- CLIENT_ID und CLIENT_SECRET: Der API-Schlüssel, der für den Zugriff auf die Looker API verwendet wird.
- VERIFY_SSL: Entweder true oder false, je nachdem, ob Sie die SSL-Verschlüsselung verwenden, um Ihre Datenbank mit Ihrer Looker-Instanz zu verbinden.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }

Option 2: Remote-Dienst mit OAuth

Ö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, ersetzen Sie PROXY_URL durch die Domain Ihres Reverse-Proxy-Servers und speichern Sie die Datei.

      {
        "mcpServers": {
          "looker-toolbox": {
            "type": "http",
            "url": "https://PROXY_URL/mcp"
          }
        }
      }

KI-Tools verwenden

Ihr KI-Tool ist jetzt über MCP mit Looker verbunden. Bitten Sie Ihren KI-Assistenten, Modelle, Explores, Dimensionen und Messwerte aufzulisten. Sie können eine Abfrage auch ausführen, indem Sie den SQL-Code für eine Abfrage abrufen oder einen gespeicherten Look ausführen.

Dem LLM stehen die folgenden Tools zur Verfügung:

Looker-Modell- und Abfragetools

Mit diesen Tools können Sie Informationen zu einem Looker-Modell abrufen und Abfragen für dieses Modell ausführen.

get_models: Alle LookML-Modelle in Ihrer Looker-Instanz auflisten.
get_explores: Listet die Explores in einem bestimmten Modell auf.
get_dimensions: Listet die Dimensionen in einem bestimmten Explore auf.
get_measures: Listet die Measures in einem bestimmten Explore auf.
get_filters: Listet die Filter in einem bestimmten Explore auf.
get_parameters: Listet die Parameter in einem bestimmten Explore auf.
query: Abfrage ausführen und Daten zurückgeben.
query_sql: Gibt den SQL-Code zurück, der von Looker für eine Abfrage generiert wird.
query_url: Gibt einen Link zur Abfrage in Looker zurück, um weitere Analysen durchzuführen.

Looker-Inhaltstools

Diese Tools rufen gespeicherte Inhalte (Looks und Dashboards) aus einer Looker-Instanz ab und erstellen neue gespeicherte Inhalte.

get_looks: Gibt die gespeicherten Looks zurück, die mit einem Titel oder einer Beschreibung übereinstimmen.
run_look: Einen gespeicherten Look ausführen und die Daten zurückgeben.
make_look: Erstellt einen gespeicherten Look in Looker und gibt die URL zurück.
get_dashboards: Gibt die gespeicherten Dashboards zurück, die mit einem Titel oder einer Beschreibung übereinstimmen.
make_dashboard: Erstellt ein gespeichertes Dashboard in Looker und gibt die URL zurück.
add_dashboard_element: Einem Dashboard eine Tile hinzufügen.

Tools für den Zustand von Looker-Instanzen

Diese Tools bieten dieselben Systemdiagnose-Algorithmen wie das beliebte CLI-Tool Henry.

health_pulse: Den Status einer Looker-Instanz prüfen.
health_analyze: Analysieren Sie die Nutzung eines Looker-Objekts.
health_vacuum: Finden Sie LookML-Elemente, die möglicherweise nicht verwendet werden.

LookML-Authoring-Tools

Mit diesen Tools kann der Aufrufer LookML-Dateien schreiben und ändern sowie das Datenbankschema abrufen, das zum effektiven Schreiben von LookML erforderlich ist.

dev_mode: Aktivieren und deaktivieren Sie den Entwicklungsmodus für die Sitzung. LookML-Inhalte müssen im Entwicklungsmodus erstellt werden. Abfragen, die im Entwicklungsmodus ausgeführt werden, verwenden die geänderte LookML, sodass Sie die Auswirkungen Ihrer Änderungen testen können.
get_projects: Liste der verfügbaren LookML-Projekte abrufen.
get_project_files: Ruft die Liste der LookML-Dateien in einem Projekt ab.
get_project_file: Den Inhalt einer LookML-Datei abrufen.
create_project_file: Erstellen Sie eine neue LookML-Datei.
update_project_file: Eine vorhandene LookML-Datei ändern.
delete_project_file: LookML-Datei löschen.
get_connections: Liste der Verbindungen abrufen.
get_connection_schemas: Ruft die Liste der Schemas für eine Verbindung ab.
get_connection_databases: Liste der Datenbanken für eine Verbindung abrufen.
get_connection_tables: Liste der Tabellen für eine Verbindung abrufen.
get_connection_table_columns: Ruft die Liste der Spalten für eine Tabelle in einer Verbindung ab.

MCP Toolbox for Databases verwenden

Gemini CLI und Erweiterungen

Funktionsweise von Erweiterungen

Looker-Authentifizierung vorbereiten

Option 1: API-Anmeldedaten

Option 2: OAuth-Anwendungsregistrierung

API Explorer installiert

API Explorer nicht installiert

Private PSA-Instanz

MCP Toolbox installieren

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

MCP Toolbox als freigegebenen Dienst ausführen

Serverumgebung konfigurieren

MCP-Client konfigurieren

Gemini CLI

Option 1: API-Anmeldedaten mit Erweiterung

Option 2: Remote-Dienst mit OAuth

Gemini Code Assist

Claude-Code

Option 1: API-Anmeldedaten

Option 2: Remote-Dienst mit OAuth

Claude für den Computer

Option 1: API-Anmeldedaten

Option 2: Remote-Dienst mit OAuth

Cline

Option 1: API-Anmeldedaten

Option 2: Remote-Dienst mit OAuth

Cursor

Option 1: API-Anmeldedaten

Option 2: Remote-Dienst mit OAuth

Visual Studio Code (Copilot)

Option 1: API-Anmeldedaten

Option 2: Remote-Dienst mit OAuth

Windsurf

Option 1: API-Anmeldedaten

Option 2: Remote-Dienst mit OAuth

KI-Tools verwenden

Looker-Modell- und Abfragetools

Looker-Inhaltstools

Tools für den Zustand von Looker-Instanzen

LookML-Authoring-Tools