Cette page a été traduite par l'API Cloud Translation.

Utiliser Looker avec MCP, la CLI Gemini et d'autres agents

Cette page vous explique comment connecter votre instance Looker à différents outils pour les développeurs.

Pour une expérience plus puissante et intégrée, nous vous recommandons d'utiliser l'extension Looker dédiée à la CLI Gemini. Utilisez la couche sémantique de Looker pour fournir à la CLI Gemini un accès sécurisé, contrôlé et à la demande à des données fiables. Accélérez vos workflows en automatisant la création de rapports, de visualisations et de tableaux de bord à partir de requêtes en langage naturel. Interface de ligne de commande nouvelle génération de Google Cloud, Gemini CLI est l'outil recommandé pour interagir avec vos instances Looker à partir de la ligne de commande.

Vous pouvez également connecter d'autres environnements de développement intégrés (IDE) et outils pour les développeurs compatibles avec le Model Context Protocol (MCP) à l'aide de la MCP Toolbox for Databases à usage général. MCP Toolbox est un serveur MCP Open Source qui simplifie la connexion des agents d'IA à vos données en gérant des complexités telles que l'authentification et le regroupement de connexions. Vous pouvez ainsi interagir avec vos données en langage naturel directement depuis votre IDE. Pour ces outils, cette méthode fournit des fonctionnalités d'interaction de base avec la base de données.

À propos de la CLI Gemini et des extensions

La CLI Gemini est un agent d'IA Open Source conçu pour accélérer les workflows de développement en aidant à coder, à déboguer, à explorer les données et à créer du contenu. Sa mission est de fournir une expérience agentique élégante pour interagir avec les services de cloud de données et les bases de données Open Source populaires.

Fonctionnement des extensions

La CLI Gemini est très extensible et permet d'ajouter de nouveaux outils et fonctionnalités grâce aux extensions. Ces extensions sont faciles à installer. Vous pouvez les charger à partir d'une URL GitHub, d'un répertoire local ou d'un registre configurable. Ces extensions offrent un large éventail de fonctionnalités, y compris de nouveaux outils, des commandes à barre oblique et des requêtes pour simplifier votre workflow.

Configurer Looker

Obtenez un ID client et un code secret client Looker. Suivez les instructions de la page de documentation Authentification de l'API Looker.
Ayez l'URL de base de votre instance Looker à portée de main. Il s'agit probablement de quelque chose comme https://looker.example.com. Dans certains cas, l'API écoute sur un port différent. Vous devrez alors utiliser https://looker.example.com:19999.

Installer la boîte à outils MCP

Téléchargez la dernière version de MCP Toolbox en tant que binaire. Sélectionnez le fichier binaire qui correspond à votre système d'exploitation et à l'architecture de votre processeur. Vous devez utiliser la version V0.14.0 ou ultérieure de MCP Toolbox.

linux/amd64

curl -O https://storage.googleapis.com/genai-toolbox/v0.14.0/linux/amd64/toolbox

darwin/arm64

curl -O https://storage.googleapis.com/genai-toolbox/v0.14.0/darwin/arm64/toolbox

darwin/amd64

curl -O https://storage.googleapis.com/genai-toolbox/v0.14.0/darwin/amd64/toolbox

windows/amd64

curl -O https://storage.googleapis.com/genai-toolbox/v0.14.0/windows/amd64/toolbox.exe

Rendez le binaire exécutable.
```
chmod +x toolbox
```
Vérifiez l'installation.
```
./toolbox --version
```

Configurer le client MCP

Cette section explique comment configurer différents outils pour les développeurs afin de se connecter à votre instance Looker à l'aide de la MCP Toolbox for Databases. Cette boîte à outils fait office de serveur Model Context Protocol (MCP) Open Source qui se situe entre votre IDE et votre base de données. Elle fournit un plan de contrôle sécurisé et efficace pour vos outils d'IA. Sélectionnez l'onglet correspondant à votre outil pour afficher les instructions de configuration.

Gemini CLI
Gemini Code Assist
Code Claude
Claude sur ordinateur
Cline (extension VS Code)
Cursor
Visual Studio Code (Copilot)
Windsurf (Codium)

CLI Gemini

Installez la CLI Gemini.
Installez l'extension Looker pour Gemini CLI à partir du dépôt GitHub à l'aide de la commande suivante :
```
gemini extensions install https://github.com/gemini-cli-extensions/looker
```
Définissez des variables d'environnement pour vous connecter à votre instance Looker, en remplaçant les variables d'environnement suivantes par vos valeurs :
- LOOKER_URL : URL de votre instance Looker.
- CLIENT_ID et CLIENT_SECRET : clé API utilisée pour accéder à l'API Looker.
- VERIFY_SSL : true ou false, selon que vous utilisez le chiffrement SSL pour connecter votre base de données à votre instance Looker.
```
export LOOKER_BASE_URL="LOOKER_URL"
export LOOKER_CLIENT_ID="CLIENT_ID"
export LOOKER_CLIENT_SECRET="CLIENT_SECRET"
export LOOKER_VERIFY_SSL="VERIFY_SSL"
```
Démarrez la CLI Gemini en mode interactif :
```
gemini
```
La CLI charge automatiquement l'extension Looker pour l'extension Gemini CLI et ses outils, que vous pouvez utiliser pour interagir avec votre instance Looker.

Gemini Code Assist

Nous vous recommandons de configurer Gemini Code Assist pour utiliser la CLI Gemini. Cette approche élimine la nécessité de configurer manuellement un serveur MCP.

Assurez-vous d'avoir installé et configuré la Gemini CLI et l'extension looker.
Configurez Gemini Code Assist pour utiliser la CLI Gemini.
Commencez à interagir avec votre instance Looker en langage naturel directement dans le chat Gemini Code Assist.

Code Claude

Installez Claude Code.
Créez le fichier .mcp.json à la racine de votre projet, s'il n'existe pas.
Ajoutez la configuration suivante en remplaçant les variables d'environnement suivantes par vos valeurs, puis enregistrez.
- LOOKER_URL : URL de votre instance Looker.
- CLIENT_ID et CLIENT_SECRET : clé API utilisée pour accéder à l'API Looker.
- VERIFY_SSL : true ou false, selon que vous utilisez le chiffrement SSL pour connecter votre base de données à votre instance Looker.

      {
        "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",
          }
          }
        }
      }

Claude sur ordinateur

Ouvrez Claude Desktop et accédez à Settings (Paramètres).
Dans l'onglet Développeur, cliquez sur Modifier la configuration pour ouvrir le fichier de configuration.
Ajoutez la configuration suivante en remplaçant les variables d'environnement suivantes par vos valeurs, puis enregistrez.
- LOOKER_URL : URL de votre instance Looker.
- CLIENT_ID et CLIENT_SECRET : clé API utilisée pour accéder à l'API Looker.
- VERIFY_SSL : true ou false, selon que vous utilisez le chiffrement SSL pour connecter votre base de données à votre instance Looker.

      {
        "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",
          }
          }
        }
      }

Redémarrez Claude Desktop.
Le nouvel écran de chat affiche une icône en forme de marteau (MCP) avec le nouveau serveur MCP.

Cline

Ouvrez l'extension Cline dans VS Code, puis cliquez sur l'icône Serveurs MCP.
Cliquez sur Configurer les serveurs MCP pour ouvrir le fichier de configuration.
Ajoutez la configuration suivante en remplaçant les variables d'environnement suivantes par vos valeurs, puis enregistrez.
- LOOKER_URL : URL de votre instance Looker.
- CLIENT_ID et CLIENT_SECRET : clé API utilisée pour accéder à l'API Looker.
- VERIFY_SSL : true ou false, selon que vous utilisez le chiffrement SSL pour connecter votre base de données à votre instance Looker.

      {
        "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",
          }
          }
        }
      }

Un état actif vert s'affiche une fois que le serveur est connecté.

Cursor

Créez le répertoire .cursor dans la racine de votre projet s'il n'existe pas.
Créez le fichier .cursor/mcp.json s'il n'existe pas, puis ouvrez-le.
Ajoutez la configuration suivante en remplaçant les variables d'environnement suivantes par vos valeurs, puis enregistrez.
- LOOKER_URL : URL de votre instance Looker.
- CLIENT_ID et CLIENT_SECRET : clé API utilisée pour accéder à l'API Looker.
- VERIFY_SSL : true ou false, selon que vous utilisez le chiffrement SSL pour connecter votre base de données à votre instance Looker.

      {
        "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",
          }
          }
        }
      }

Ouvrez Cursor, puis accédez à Settings > Cursor Settings > MCP (Paramètres > Paramètres du curseur > MCP). Un état actif vert s'affiche lorsque le serveur se connecte.

Visual Studio Code (Copilot)

Ouvrez VS Code et créez le répertoire .vscode dans la racine de votre projet s'il n'existe pas.
Créez le fichier .vscode/mcp.json s'il n'existe pas, puis ouvrez-le.
Ajoutez la configuration suivante en remplaçant les variables d'environnement suivantes par vos valeurs, puis enregistrez.
- LOOKER_URL : URL de votre instance Looker.
- CLIENT_ID et CLIENT_SECRET : clé API utilisée pour accéder à l'API Looker.
- VERIFY_SSL : true ou false, selon que vous utilisez le chiffrement SSL pour connecter votre base de données à votre instance Looker.

      {
        "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",
          }
          }
        }
      }

Windsurf

Ouvrez Windsurf et accédez à l'assistant Cascade.
Cliquez sur l'icône MCP, puis sur Configurer pour ouvrir le fichier de configuration.
Ajoutez la configuration suivante en remplaçant les variables d'environnement suivantes par vos valeurs, puis enregistrez.
- LOOKER_URL : URL de votre instance Looker.
- CLIENT_ID et CLIENT_SECRET : clé API utilisée pour accéder à l'API Looker.
- VERIFY_SSL : true ou false, selon que vous utilisez le chiffrement SSL pour connecter votre base de données à votre instance Looker.

      {
        "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",
          }
          }
        }
      }

Utiliser des outils d'IA

Votre outil d'IA est désormais connecté à Looker à l'aide de MCP. Essayez de demander à votre assistant IA de lister les modèles, les explorations, les dimensions et les mesures. Vous pouvez également exécuter une requête en récupérant le code SQL d'une requête ou en exécutant une présentation enregistrée.

Les outils suivants sont à la disposition du LLM :

get_models : liste tous les modèles LookML de votre instance Looker.
get_explores : liste les explorations d'un modèle donné.
get_dimensions : liste les dimensions d'une exploration donnée.
get_measures : liste les mesures d'une exploration donnée.
get_filters : liste les filtres d'une exploration donnée.
get_parameters : liste les paramètres d'une exploration donnée.
query : exécute une requête et renvoie les données.
query_sql : renvoie le code SQL généré par Looker pour une requête.
query_url : renvoie un lien vers la requête dans Looker pour une exploration plus approfondie.
get_looks : renvoie les Looks enregistrés qui correspondent à un titre ou à une description.
run_look : exécute une requête Look enregistrée et renvoie les données.
make_look : créez un Look enregistré dans Looker et renvoyez l'URL.
get_dashboards : renvoie les tableaux de bord enregistrés qui correspondent à un titre ou à une description.
make_dashboard : créez un tableau de bord enregistré dans Looker et renvoyez l'URL.
add_dashboard_element : ajoutez un bloc à un tableau de bord.