Utiliser MCP Toolbox for Databases

Remarque : Le serveur MCP géré par Looker est la méthode recommandée pour connecter des applications d'IA à des instances Looker hébergées par Looker. Il fournit une intégration intégrée, sécurisée et sans infrastructure directement dans la plate-forme Looker. Pour obtenir des instructions de configuration, consultez la page de documentation Serveur MCP géré par Looker.

Cette page vous explique comment utiliser MCP Toolbox for Databases pour connecter votre instance Looker à des environnements de développement intégrés (IDE) et à des outils pour les développeurs compatibles avec le Model Context Protocol (MCP). La boîte à outils MCP est une bonne option si vous utilisez une instance hébergée par le client ou si vous préférez gérer votre propre infrastructure. Sinon, nous vous recommandons d'utiliser le serveur MCP géré par Looker.

Nous vous recommandons d'utiliser l'extension Looker dédiée pour Gemini CLI avec MCP Toolbox. Utilisez la couche sémantique de Looker pour fournir à Gemini CLI un accès sécurisé, gouverné et à la demande à des données fiables, et accélérez les workflows en automatisant la création de rapports, de visualisations et de tableaux de bord à partir de requêtes en langage naturel. En tant qu'interface de ligne de commande de nouvelle génération de Google Cloud, Gemini CLI est l'outil recommandé pour interagir avec vos instances Looker depuis la ligne de commande.

Vous pouvez également connecter d'autres environnements de développement intégrés (IDE) et outils de développement compatibles avec le protocole MCP (Model Context Protocol) à l'aide de la boîte à outils MCP pour les bases de données. MCP Toolbox est un serveur MCP Open Source qui simplifie la connexion des agents 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.

Remarque : MCP Toolbox est un projet Open Source fourni "en l'état". Il ne s'agit pas d'un produit Google Cloud compatible, et il n'est pas couvert par les consignes relatives aux services d'assistance technique Google Cloud ni par les contrats de niveau de service. Pour obtenir de l'aide, consultez la page des problèmes GitHub du projet.

À propos de Gemini CLI et des extensions

Gemini CLI est un agent IA Open Source conçu pour accélérer les workflows de développement en vous aidant à coder, à déboguer, à explorer des 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

Gemini CLI est hautement extensible, ce qui permet d'ajouter de nouveaux outils et de nouvelles fonctionnalités via des 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 ensemble complet de fonctionnalités, y compris de nouveaux outils, des commandes à barre oblique et des requêtes pour simplifier votre workflow.

Préparer l'authentification Looker

Vous avez deux options pour authentifier votre client MCP auprès de Looker : vous pouvez utiliser des identifiants API standards ou authentifier le client via l'enregistrement d'une application OAuth.

Option 1 : Identifiants d'API

1. Obtenez un ID client et un code secret du client Looker. Suivez les instructions de la page de documentation Authentification de l'API Looker.
2. Vous devez disposer de l'URL de base de votre instance Looker. Il ressemble probablement à https://looker.example.com. Dans certains cas, l'API écoute sur un port différent. Vous devrez alors utiliser https://looker.example.com:19999.

Option 2 : Enregistrement de l'application OAuth

1. Ouvrez l'explorateur d'API Looker.

   APIs Explorer installé

   Si l'API Explorer est déjà installée sur votre instance Looker, vous pouvez y accéder avec ce format d'URL :

   LOOKER_INSTANCE_URL/extensions/marketplace_extension_api_explorer::api-explorer/
   

   APIs Explorer n'est pas installé

   Si votre instance Looker ne dispose pas d'APIs Explorer, vous pouvez l'installer depuis le Marketplace Looker. Pour savoir comment installer l'explorateur d'API, consultez la page Utiliser l'explorateur d'API.

   Instance privée PSA

   Si vous utilisez une instance de connexions privées Looker (Google Cloud Core) qui utilise l'accès aux services privés, la Marketplace Looker et l'explorateur d'API ne sont pas compatibles. Pour enregistrer un agent IA, vous devez appeler directement le point de terminaison de l'API oauth_client_apps. Si vous utilisez cette méthode, vous pouvez ignorer les étapes restantes de cette procédure APIs Explorer.

   Voici un exemple de commande curl que vous pouvez utiliser avec le point de terminaison oauth_client_apps pour enregistrer l'agent.

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

2. Sous la méthode Auth, recherchez le point de terminaison de l'API Register OAuth App. Vous pouvez également rechercher "application oauth" dans le champ Rechercher.

3. Sélectionnez Exécuter.

4. Pour client_guid, saisissez une chaîne personnalisée (par exemple, gemini_cli ou claude-desktop).

5. Dans le corps de la requête, saisissez la configuration JSON suivante :

   {
     "redirect_uri": "AI_AGENT_REDIRECT_URI",
     "display_name": "APPLICATION_NAME",
     "description": "APPLICATION_DESCRIPTION",
     "enabled": true
   }
   

   Remplacez les éléments suivants :

   • AI_AGENT_REDIRECT_URI : URI de redirection de votre extension d'agent IA ou de votre application de service partagé.

     • Pour les applications hébergées dans le cloud, elle peut ressembler à une URL HTTPS sécurisée : https://AI_AGENT_URL/oauth2callback.

     • Pour les applications exécutées localement, il doit s'agir d'une URL localhost avec un port statique : http://localhost:7777/oauth/callback

       Remarque : Certains outils, comme Gemini CLI, peuvent nécessiter la définition d'une variable d'environnement (par exemple, export OAUTH_CALLBACK_PORT=7777) pour s'assurer qu'ils utilisent un port statique correspondant à l'URI de redirection enregistré.

     • Pour les IDE, cela peut ressembler à ceci : vscode://google.vscode-looker-official/oauth_callback

   • APPLICATION_NAME : nom à afficher de votre application OAuth, par exemple Claude Desktop.

   • APPLICATION_DESCRIPTION : brève description de votre application OAuth.

6. Cochez la case de confirmation à côté de Je comprends que ce point de terminaison d'API modifiera les données, puis sélectionnez Exécuter.

Installer MCP Toolbox

Remarque : Si vous utilisez Gemini CLI ou Gemini Code Assist pour vous connecter à votre instance Looker à l'aide de MCP Toolbox for Databases, vous n'avez pas besoin d'installer MCP Toolbox. MCP Toolbox sera installé lorsque l'extension Gemini sera installée lors de l'étape de configuration.

1. Téléchargez la dernière version de MCP Toolbox sous forme de binaire. Sélectionnez le binaire correspondant à votre OS et à votre architecture de processeur. Vous devez utiliser MCP Toolbox version 1.0.0 ou ultérieure.

   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
   
   

2. Rendez le binaire exécutable.

   chmod +x toolbox
   

3. Vérifiez l'installation.

   ./toolbox --version
   

Exécuter MCP Toolbox en tant que service partagé

Pour les clients MCP qui nécessitent une authentification OAuth via HTTPS, vous devez déployer MCP Toolbox derrière un proxy inverse HTTPS (comme Cloud Run). Le proxy inverse met fin au protocole SSL et transfère les requêtes au conteneur MCP Toolbox.

Configurer l'environnement du serveur

1. Définissez les variables d'environnement suivantes dans votre déploiement :

   • LOOKER_BASE_URL=YOUR_LOOKER_BASE_URL
   • LOOKER_USE_CLIENT_OAUTH=true

2. Exécutez MCP Toolbox avec les arguments suivants :

   • --prebuilt=looker,looker-dev
   • --mcp-prm-file=prm.json
   • [--address=0.0.0.0]
   • [--port=8080]

   MCP Toolbox écoute normalement sur le port 127.0.0.1 5000. Si le proxy inverse se trouve sur un autre hôte, utilisez --address=0.0.0.0 pour lier toutes les adresses IP. Utilisez le paramètre --port= si vous devez utiliser un port d'écoute autre que 5000. Par exemple, Cloud Run transfère automatiquement le trafic externe du port 443 (le port HTTPS) vers 8080.

3. Créez un fichier de configuration de métadonnées de ressource protégée (PRM) (prm.json) avec la structure suivante :

   {
   "resource": "https://PROXY_URL/mcp",
   "authorization_servers": ["LOOKER_URL"],
   "scopes_supported": ["cors_api"]
   }
   

   Remplacez les éléments suivants :

   • PROXY_URL : domaine et chemin d'accès de base de votre serveur proxy inverse.
   • LOOKER_URL : URL de base de votre instance Looker.

Pour savoir comment configurer le client lorsque vous exécutez MCP Toolbox en tant que service partagé, consultez l'exemple de configuration de Claude Desktop.

Configurer le client MCP

Cette section explique comment configurer différents outils pour les développeurs afin de vous connecter à votre instance Looker à l'aide de MCP Toolbox for Databases. La boîte à outils agit comme un serveur MCP (Model Context Protocol) Open Source qui se situe entre votre IDE et votre base de données, fournissant 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
• Claude Code
• Claude pour ordinateur
• Cline (extension VS Code)
• Cursor
• Visual Studio Code (Copilot)
• Windsurf (Codium)

CLI Gemini

Choisissez la méthode de connexion en fonction de votre choix d'authentification :

Option 1 : Identifiants API avec extension

1. Installez la CLI Gemini.
2. 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
   

3. 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 ou non 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"
   

4. Démarrez la Gemini CLI en mode interactif :

   gemini
   

   La CLI charge automatiquement l'extension Looker pour Gemini CLI et ses outils, que vous pouvez utiliser pour interagir avec votre instance Looker.

Option 2 : Service partagé distant avec OAuth

Pour vous connecter à un service partagé distant à l'aide d'OAuth, n'installez pas l'extension Looker. Configurez plutôt Gemini CLI pour qu'il se connecte directement à votre serveur MCP distant.

1. Installez la CLI Gemini.
2. Ajoutez le serveur MCP distant à l'aide de la commande suivante, en remplaçant PROXY_URL par le domaine de votre serveur proxy inverse :

   gemini mcp add --transport http looker https://PROXY_URL/mcp
   

   Vous pouvez également configurer cela manuellement en ajoutant la configuration suivante à votre fichier settings.json (situé dans ~/.gemini/settings.json ou dans le répertoire de votre projet) :

   {
     "mcpServers": {
       "looker": {
         "httpUrl": "https://PROXY_URL/mcp"
       }
     }
   }
   

3. Démarrez la Gemini CLI en mode interactif :

   gemini
   

   Lorsque vous êtes invité à vous connecter, la CLI lance le flux d'autorisation OAuth pour s'authentifier de manière sécurisée auprès de votre instance Looker.

Gemini Code Assist

Nous vous recommandons de configurer Gemini Code Assist pour utiliser la CLI Gemini. Cette approche évite d'avoir à configurer manuellement un serveur MCP.

1. Assurez-vous d'avoir installé et configuré Gemini CLI et l'extension looker (pour les identifiants d'API) ou une configuration de serveur MCP distant (pour un service partagé avec OAuth).
2. Configurez Gemini Code Assist pour utiliser la CLI Gemini.
3. Commencez à interagir avec votre instance Looker en langage naturel directement dans le chat Gemini Code Assist.

Claude Code

Choisissez la méthode de connexion en fonction de votre choix d'authentification :

Option 1 : Identifiants d'API

1. Installez Claude Code.
2. Créez le fichier .mcp.json à la racine de votre projet, s'il n'existe pas.
3. 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 ou non 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",
          }
          }
        }
      }
  

Option 2 : Service partagé distant avec OAuth

1. Installez Claude Code.
2. Créez le fichier .mcp.json à la racine de votre projet, s'il n'existe pas.
3. Ajoutez la configuration suivante, en remplaçant PROXY_URL par le domaine de votre serveur proxy inverse, puis enregistrez.

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

Claude pour ordinateur

Choisissez la méthode de connexion en fonction de votre choix d'authentification :

Option 1 : Identifiants d'API

1. Ouvrez Claude pour ordinateur et accédez à Paramètres.
2. Dans l'onglet Developer (Développeur), cliquez sur Edit Config (Modifier la configuration) pour ouvrir le fichier de configuration.
3. 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 ou non 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",
          }
          }
        }
      }
  

Option 2 : Service partagé distant avec OAuth

1. Dans Claude pour ordinateur, accédez à Settings (Paramètres) et sélectionnez Connectors (Connecteurs).
2. Sélectionnez Ajouter un connecteur personnalisé, puis saisissez un nom (par exemple, Looker).
3. Pour l'URL, saisissez le point de terminaison de votre serveur proxy inverse en ajoutant le chemin d'accès /mcp (par exemple, https://looker-mcp-toolbox.example.com/mcp).
4. Sous Paramètres avancés, saisissez la chaîne exacte que vous avez utilisée pour client_guid lors de l'enregistrement de l'application OAuth. Laissez le champ "Code secret du client OAuth" vide.
5. Sélectionnez Ajouter pour enregistrer le connecteur. Lorsque vous êtes invité à vous connecter, Claude Desktop lance de manière sécurisée le flux d'autorisation PKCE via votre navigateur.

4. Redémarrez Claude pour ordinateur.

Cline

Choisissez la méthode de connexion en fonction de votre choix d'authentification :

Option 1 : Identifiants d'API

1. Ouvrez l'extension Cline dans VS Code, puis cliquez sur l'icône MCP Servers (Serveurs MCP).
2. Cliquez sur Configurer les serveurs MCP pour ouvrir le fichier de configuration.
3. 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 ou non 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 s'est connecté.

Option 2 : Service partagé distant avec OAuth

1. Ouvrez l'extension Cline dans VS Code, puis cliquez sur l'icône MCP Servers (Serveurs MCP).
2. Cliquez sur Configurer les serveurs MCP pour ouvrir le fichier de configuration.
3. Ajoutez la configuration suivante, en remplaçant PROXY_URL par le domaine de votre serveur proxy inverse, puis enregistrez.

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

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

Cursor

Choisissez la méthode de connexion en fonction de votre choix d'authentification :

Option 1 : Identifiants d'API

1. Créez le répertoire .cursor à la racine de votre projet s'il n'existe pas.
2. Créez le fichier .cursor/mcp.json s'il n'existe pas, puis ouvrez-le.
3. 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 ou non 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",
          }
          }
        }
      }
  

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

Option 2 : Service partagé distant avec OAuth

1. Créez le répertoire .cursor à la racine de votre projet s'il n'existe pas.
2. Créez le fichier .cursor/mcp.json s'il n'existe pas, puis ouvrez-le.
3. Ajoutez la configuration suivante, en remplaçant PROXY_URL par le domaine de votre serveur proxy inverse, puis enregistrez.

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

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

Visual Studio Code (Copilot)

Choisissez la méthode de connexion en fonction de votre choix d'authentification :

Option 1 : Identifiants d'API

1. Ouvrez VS Code et créez le répertoire .vscode à la racine de votre projet s'il n'existe pas.
2. Créez le fichier .vscode/mcp.json s'il n'existe pas, puis ouvrez-le.
3. 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 ou non le chiffrement SSL pour connecter votre base de données à votre instance Looker.

      {
        "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 : Service partagé distant avec OAuth

1. Ouvrez VS Code et créez le répertoire .vscode à la racine de votre projet s'il n'existe pas.
2. Créez le fichier .vscode/mcp.json s'il n'existe pas, puis ouvrez-le.
3. Ajoutez la configuration suivante, en remplaçant PROXY_URL par le domaine de votre serveur proxy inverse, puis enregistrez.

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

Planche à voile

Choisissez la méthode de connexion en fonction de votre choix d'authentification :

Option 1 : Identifiants d'API

1. Ouvrez Windsurf et accédez à l'assistant Cascade.
2. Cliquez sur l'icône MCP, puis sur Configurer pour ouvrir le fichier de configuration.
3. 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 ou non 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",
          }
          }
        }
      }
  

Option 2 : Service partagé distant avec OAuth

1. Ouvrez Windsurf et accédez à l'assistant Cascade.
2. Cliquez sur l'icône MCP, puis sur Configurer pour ouvrir le fichier de configuration.
3. Ajoutez la configuration suivante, en remplaçant PROXY_URL par le domaine de votre serveur proxy inverse, puis enregistrez.

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

Utiliser des outils IA

Votre outil d'IA est désormais connecté à Looker via 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.

Remarque : L'ensemble des outils disponibles sur le serveur MCP géré par Looker est susceptible de changer, car les outils sont optimisés pour les performances et la sécurité.

Les outils suivants sont disponibles pour le LLM :

Outils de modèle et de requête Looker

Ces outils permettent d'obtenir des informations sur un modèle Looker et d'exécuter des requêtes sur ce modèle.

• 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 : lister les mesures d'une exploration donnée.
• get_filters : lister 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.

Outils de contenu Looker

Ces outils récupèrent le contenu enregistré (Looks et tableaux de bord) d'une instance Looker et créent un nouveau contenu enregistré.

• get_looks : renvoie les présentations enregistrées qui correspondent à un titre ou à une description.
• run_look : exécute un Look enregistré 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 une vignette à un tableau de bord.

Outils d'état des instances Looker

Ces outils proposent les mêmes algorithmes de vérification de l'état'état que l'outil CLI populaire Henry.

• health_pulse : vérifiez l'état d'une instance Looker.
• health_analyze : analysez l'utilisation d'un objet Looker.
• health_vacuum : recherchez les éléments LookML qui ne sont peut-être pas utilisés.

Outils de création LookML

Ces outils permettent à l'appelant d'écrire et de modifier des fichiers LookML, ainsi que d'obtenir le schéma de base de données nécessaire pour écrire efficacement du code LookML.

• dev_mode : activez et désactivez le mode Développement pour la session. La création de code LookML doit être effectuée en mode Développement. Les requêtes exécutées en mode Développement utilisent le code LookML modifié, ce qui vous permet de tester l'impact de vos modifications.
• get_projects : permet d'obtenir la liste des projets LookML disponibles.
• get_project_files : récupère la liste des fichiers LookML d'un projet.
• get_project_file : récupère le contenu d'un fichier LookML.
• create_project_file : créez un fichier LookML.
• update_project_file : modifiez un fichier LookML existant.
• delete_project_file : supprime un fichier LookML.
• get_connections : récupérez la liste des connexions.
• get_connection_schemas : récupère la liste des schémas d'une connexion.
• get_connection_databases : récupère la liste des bases de données d'une connexion.
• get_connection_tables : permet d'obtenir la liste des tables d'une connexion.
• get_connection_table_columns : récupère la liste des colonnes d'une table dans une connexion.

Remarque : Les outils prédéfinis sont antérieurs à la version 1.0. Attendez-vous donc à des modifications entre les versions. Comme les LLM s'adaptent aux outils disponibles, la plupart des utilisateurs ne seront pas affectés.