Connecter votre IDE à Looker à l'aide de la boîte à outils MCP

Cette page explique comment utiliser MCP Toolbox pour les bases de données afin de 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). Utilisez ces outils pour exécuter des requêtes et interagir avec Looker. Ce guide s'adresse aux développeurs qui utilisent leurs IDE et outils de développement existants pour travailler avec Looker.

MCP est un protocole ouvert permettant de connecter des grands modèles de langage (LLM) à des sources de données telles que Looker. Cette page explique comment utiliser MCP Toolbox for Databases pour exposer vos outils d'aide au développement à une instance Looker à l'aide des IDE suivants :

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

Configurer Looker

1. Obtenez un ID client et un code secret client Looker. Suivez les instructions de la page de documentation Authentification de l'API Looker.
2. 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

1. 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.10.0 ou ultérieure de MCP Toolbox.

   linux/amd64

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

   darwin/arm64

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

   darwin/amd64

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

   windows/amd64

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

2. Rendez le binaire exécutable.

   chmod +x toolbox
   

3. Vérifiez l'installation.

   ./toolbox --version
   

Configurer le client MCP

CLI Gemini

1. Installez la CLI Gemini.
2. Dans votre répertoire de travail, créez un dossier nommé .gemini. Dans ce dossier, créez un fichier settings.json.
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 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",
     }
    }
  }
}

Code Claude

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

1. Ouvrez Claude Desktop et accédez à Settings (Paramètres).
2. Dans l'onglet Développeur, cliquez sur 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 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. Redémarrez Claude Desktop.
5. Le nouvel écran de chat affiche une icône en forme de marteau (MCP) avec le nouveau serveur MCP.

Cline

1. Ouvrez l'extension Cline dans VS Code, puis cliquez sur l'icône 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 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

1. Créez le répertoire .cursor dans 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 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 du curseur > MCP). Un état actif vert s'affiche lorsque le serveur se connecte.

Visual Studio Code (Copilot)

1. Ouvrez VS Code et créez le répertoire .vscode dans 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 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

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

Remarque : Les outils prédéfinis sont antérieurs à la version 1.0. Vous devez donc vous attendre à ce que certains outils changent d'une version à l'autre. Étant donné que les LLM s'adaptent aux outils disponibles, la plupart des utilisateurs ne seront pas concernés.