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

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 Gemini CLI können Sie über die semantische Ebene von Looker sicheren, verwalteten und On-Demand-Zugriff auf vertrauenswürdige Daten erhalten und Workflows beschleunigen, indem Sie die Erstellung von Berichten, Visualisierungen und Dashboards aus Prompts in natürlicher Sprache automatisieren. Als Befehlszeile der nächsten Generation von Google Cloudist die Gemini CLI 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 Komplexitäten 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 die Entwicklung beschleunigen soll, indem er beim Programmieren, Debuggen, bei der Datenexploration und beim Erstellen von Inhalten unterstützt. Ziel ist es, eine elegante, auf Agenten basierende Möglichkeit zur Interaktion mit Data Cloud-Diensten und beliebten Open-Source-Datenbanken zu bieten.

So funktionieren Erweiterungen

Die Gemini CLI ist sehr flexibel und kann durch Erweiterungen um neue Tools und Funktionen ergänzt werden. Diese Erweiterungen lassen sich ganz einfach 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 Looker-Clientschlüssel ab. Folgen Sie der Anleitung auf der Dokumentationsseite Looker API-Authentifizierung.
Sie benötigen die Basis-URL Ihrer Looker-Instanz. Wahrscheinlich ist es etwas wie https://looker.example.com. In einigen Fällen wird die API an einem anderen Port überwacht. In diesem Fall müssen Sie https://looker.example.com:19999 verwenden.

Option 2: OAuth-Anwendung registrieren

Ö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 den API Explorer nicht enthält, 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 genutzt wird, 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.

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 }'
Suchen Sie unter der Methode Auth nach dem API-Endpunkt OAuth-App registrieren. 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-Agent-Erweiterung oder freigegebene Dienstanwendung.
  - Bei in der Cloud gehosteten Anwendungen kann es sich um eine sichere HTTPS-URL handeln: https://AI_AGENT_URL/oauth2callback
  - Bei lokal ausgeführten Anwendungen sollte es sich um eine Localhost-URL mit einem statischen Port handeln: 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 Ihrer registrierten Weiterleitungs-URI übereinstimmt.
  - Für 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.
Setzen Sie ein Häkchen in das Bestätigungsfeld neben I understand that this API endpoint will change data (Ich bestätige, dass dieser API-Endpunkt Daten ändern wird) 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 in Ihrer Bereitstellung die folgenden Umgebungsvariablen 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 Port 5000 auf 127.0.0.1. Wenn sich der Reverse-Proxy auf einem anderen Host befindet, verwenden Sie --address=0.0.0.0, um an alle IP-Adressen zu binden. Verwenden Sie die Einstellung --port=, wenn Sie einen anderen Überwachungsport als 5000 verwenden müssen. Cloud Run leitet beispielsweise externen Traffic von Port 443 (dem HTTPS-Port) automatisch an Port 8080 weiter.
Erstellen Sie eine Konfigurationsdatei für Metadaten geschützter Ressourcen (Protected Resource Metadata, PRM) (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-Proxyservers.
- 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 unter Claude-Desktopkonfiguration.

MCP-Client konfigurieren

In diesem Abschnitt wird beschrieben, wie Sie verschiedene Entwicklertools so konfigurieren, dass sie mit der 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 das jeweilige 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 Authentifizierung 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 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 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 ihre Tools, mit denen Sie mit Ihrer Looker-Instanz interagieren können.

Option 2: Gemeinsam genutzter Remotedienst mit OAuth

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

Installieren Sie die Gemini-Befehlszeile.
Fügen Sie den Remote-MCP-Server mit dem folgenden Befehl hinzu und ersetzen Sie 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 Ihre settings.json-Datei (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 CLI 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 muss kein MCP-Server manuell konfiguriert werden.

Achten Sie darauf, dass Sie 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 direkt im Gemini Code Assist-Chat mit Ihrer Looker-Instanz interagieren und dabei natürliche Sprache verwenden.

Claude-Code

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

Option 1: API-Anmeldedaten

Installieren Sie 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, 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 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: Gemeinsam genutzter Remotedienst mit OAuth

Installieren Sie 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, 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 Authentifizierung 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 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: Gemeinsam genutzter Remotedienst 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 für die 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 den genauen String ein, den Sie für client_guid bei der Registrierung Ihrer OAuth-App 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 sicher den PKCE-Autorisierungsablauf über Ihren Browser.

Starten Sie Claude für Desktop neu.

Cline

Wählen Sie die Verbindungsmethode aus, die auf Ihrer Authentifizierung 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 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",
          }
          }
        }
      }

Nach erfolgreicher Verbindung des Servers wird ein grüner aktiver Status angezeigt.

Option 2: Gemeinsam genutzter Remotedienst 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"
          }
        }
      }

Nach erfolgreicher Verbindung des Servers wird ein grüner aktiver Status angezeigt.

Cursor

Wählen Sie die Verbindungsmethode aus, die auf Ihrer Authentifizierung 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 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 gehen Sie zu Einstellungen > Cursoreinstellungen > MCP. Wenn der Server verbunden ist, wird ein grüner aktiver Status angezeigt.

Option 2: Gemeinsam genutzter Remotedienst 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 gehen Sie zu Einstellungen > Cursoreinstellungen > MCP. Wenn der Server verbunden ist, wird ein grüner aktiver Status angezeigt.

Visual Studio Code (Copilot)

Wählen Sie die Verbindungsmethode aus, die auf Ihrer Authentifizierung 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 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: Gemeinsam genutzter Remotedienst 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 Authentifizierung 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 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: Gemeinsam genutzter Remotedienst 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 auch eine Abfrage 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: Führt eine Abfrage aus und gibt die Daten zurück.
query_sql: Gibt das SQL zurück, das von Looker für eine Abfrage generiert wird.
query_url: Gibt einen Link zur Abfrage in Looker zurück, damit Sie sie weiter untersuchen können.

Looker Content Tools

Mit diesen Tools werden gespeicherte Inhalte (Looks und Dashboards) aus einer Looker-Instanz abgerufen und neue gespeicherte Inhalte erstellt.

get_looks: Gibt die gespeicherten Looks zurück, die einem Titel oder einer Beschreibung entsprechen.
run_look: Führt einen gespeicherten Look aus und gibt die Daten zurück.
make_look: Erstellt einen gespeicherten Look in Looker und gibt die URL zurück.
get_dashboards: Gibt die gespeicherten Dashboards zurück, die einem Titel oder einer Beschreibung entsprechen.
make_dashboard: Erstelle ein gespeichertes Dashboard in Looker und gib die URL zurück.
add_dashboard_element: Fügen Sie einem Dashboard eine Kachel hinzu.

Tools für den Looker-Instanzzustand

Diese Tools bieten dieselben Systemdiagnosealgorithmen wie die beliebte CLI Henry.

health_pulse: Den Zustand einer Looker-Instanz prüfen.
health_analyze: Analysieren Sie die Verwendung eines Looker-Objekts.
health_vacuum: LookML-Elemente finden, 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 Entwicklermodus für die Sitzung. LookML-Code muss im Entwicklermodus erstellt werden. Bei Abfragen, die im Entwicklungsmodus ausgeführt werden, wird die geänderte LookML verwendet. So können Sie die Auswirkungen Ihrer Änderungen testen.
get_projects: Ruft die Liste der verfügbaren LookML-Projekte ab.
get_project_files: Ruft die Liste der LookML-Dateien in einem Projekt ab.
get_project_file: Ruft den Inhalt einer LookML-Datei ab.
create_project_file: Erstellen Sie eine neue LookML-Datei.
update_project_file: Eine vorhandene LookML-Datei ändern.
delete_project_file: Eine LookML-Datei löschen.
get_connections: Ruft die Liste der Verbindungen ab.
get_connection_schemas: Ruft die Liste der Schemas für eine Verbindung ab.
get_connection_databases: Ruft die Liste der Datenbanken für eine Verbindung ab.
get_connection_tables: Ruft die Liste der Tabellen für eine Verbindung ab.
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

So funktionieren Erweiterungen

Looker-Authentifizierung vorbereiten

Option 1: API-Anmeldedaten

Option 2: OAuth-Anwendung registrieren

API Explorer installiert

API Explorer nicht installiert

Private Instanz für den Zugriff auf private Dienste

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: Gemeinsam genutzter Remotedienst mit OAuth

Gemini Code Assist

Claude-Code

Option 1: API-Anmeldedaten

Option 2: Gemeinsam genutzter Remotedienst mit OAuth

Claude für den Computer

Option 1: API-Anmeldedaten

Option 2: Gemeinsam genutzter Remotedienst mit OAuth

Cline

Option 1: API-Anmeldedaten

Option 2: Gemeinsam genutzter Remotedienst mit OAuth

Cursor

Option 1: API-Anmeldedaten

Option 2: Gemeinsam genutzter Remotedienst mit OAuth

Visual Studio Code (Copilot)

Option 1: API-Anmeldedaten

Option 2: Gemeinsam genutzter Remotedienst mit OAuth

Windsurf

Option 1: API-Anmeldedaten

Option 2: Gemeinsam genutzter Remotedienst mit OAuth

KI-Tools verwenden

Looker-Modell und Abfragetools

Looker Content Tools

Tools für den Looker-Instanzzustand

LookML-Authoring-Tools