1. Avant de commencer
Vous devez avoir accès à une instance Looker en cours d'exécution. Vous aurez besoin d'un client_id et d'un client_secret pour l'API.
Prérequis
- Disposer d'une instance Looker en cours d'exécution
- Avoir accès à une ligne de commande Linux ou macOS
Points abordés
- Installer Gemini CLI
- Installer MCP Toolbox
- Connecter Gemini CLI à Looker à l'aide de MCP Toolbox
Prérequis
- URL du serveur de l'API Looker. Il s'agit généralement de la même URL que celle de Looker, mais vous devrez peut-être ajouter un numéro de port tel que
:19999, par exemple :https://looker.example.com:19999. Si les choses ne fonctionnent pas correctement, essayez de contacter votre administrateur Looker.
2. préparations
Vous devez récupérer un client_id et un client_secret.
Connectez-vous à votre instance Looker, puis cliquez sur le profil utilisateur en haut à droite de l'écran. Sélectionnez Compte. Sur l'écran "Compte", à côté du libellé API Keys, appuyez sur le bouton Manage.
Sur la page de gestion des clés API, appuyez sur le bouton Create New API Key.
Dans l'entrée que vous venez de créer, ajoutez l'objectif MCP Toolbox ou une mention similaire, puis cliquez sur la coche pour l'enregistrer. Copiez ensuite l'ID client et le code secret du client et collez-les dans un endroit sûr. Vous devrez appuyer sur l'icône en forme d'œil à côté du code secret pour le voir et le copier.
Vous pouvez maintenant fermer les fenêtres du navigateur Looker.
3. Installer Gemini CLI
Ouvrez l'application Terminal pour accéder à une ligne de commande macOS ou Linux.
Exécutez la commande suivante :
npm install -g @google/gemini-cli
Si cela ne fonctionne pas pour une raison quelconque, consultez https://github.com/google-gemini/gemini-cli?tab=readme-ov-file#-installation pour obtenir des options ou de l'aide concernant l'installation.
Exécutez maintenant Gemini CLI avec cette commande :
gemini
Vous serez invité à vous connecter. Suivez ces instructions et vous devriez être prêt.
4. Installer MCP Toolbox
Créer un répertoire MCP Toolbox
Dans votre application de terminal, créez un répertoire mcp-toolbox. Accédez ensuite à ce répertoire :
mkdir $HOME/mcp-toolbox
cd $HOME/mcp-toolbox
Identifier l'architecture système
Exécutez la commande uname pour connaître le type de système que vous utilisez :
uname -a
Cette commande renverra une chaîne semblable à celle-ci :
Linux hostname.example.com 6.16.12-amd64 #1 SMP PREEMPT_DYNAMIC Debian 6.16.12 (2025-11-10) x86_64 GNU/Linux
Portez une attention particulière à la fin de cette ligne. Si vous utilisez Linux, il se terminera par x86_64 GNU/Linux. Pour macOS, Darwin et arm64 pour le processeur Apple ou x86_64 i386 pour le processeur Intel s'affichent à la fin de cette chaîne.
Télécharger la boîte à outils MCP
Si vous utilisez Linux, exécutez la commande suivante pour télécharger MCP Toolbox :
curl https://storage.googleapis.com/genai-toolbox/v0.26.0/linux/amd64/toolbox
Si vous disposez d'un appareil macOS avec un processeur Apple, exécutez la commande suivante pour télécharger MCP Toolbox :
curl https://storage.googleapis.com/genai-toolbox/v0.26.0/darwin/arm64/toolbox
Si vous disposez d'un ordinateur macOS avec un processeur Intel, exécutez la commande suivante pour télécharger MCP Toolbox :
curl https://storage.googleapis.com/genai-toolbox/v0.26.0/darwin/amd64/toolbox
Rendre la boîte à outils MCP exécutable
Rendez le programme MCP Toolbox exécutable en exécutant la commande suivante :
chmod +x toolbox
Obtenir le chemin d'accès complet à la boîte à outils
Obtenez le chemin d'accès complet au fichier de la boîte à outils en exécutant la commande suivante :
echo $HOME/mcp-toolbox/toolbox
Le résultat devrait ressembler à ceci :
/home-or-User/YOUR-USER-NAME/mcp-toolbox/toolbox
Enregistrez le résultat à un emplacement pratique.
5. Configurer Gemini CLI
Modifiez le fichier $HOME/.gemini/settings.json. Utilisez l'éditeur de texte de votre choix. Si vous ne modifiez pas souvent des fichiers sous Linux ou macOS, nano est un bon choix.
Ajoutez le stanza suivant au fichier JSON :
"mcpServers": {
"looker": {
"command": "FULL_PATH_TO_TOOLBOX",
"args": [
"--stdio",
"--prebuilt",
"looker"
],
"env": {
"LOOKER_BASE_URL": "URL_OF_LOOKER_INSTANCE",
"LOOKER_CLIENT_ID": "CLIENT_ID",
"LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
"LOOKER_VERIFY_SSL": "true"
}
}
}
Remplacez FULL_PATH_TO_TOOLBOX, URL_OF_LOOKER_INSTANCE, CLIENT_ID et CLIENT_SECRET par les informations que vous avez enregistrées lors des étapes précédentes. Enregistrez le fichier modifié.
6. Utiliser MCP Toolbox avec la CLI Gemini
Démarrez Gemini CLI en saisissant gemini sur la ligne de commande.
Pour lister les outils disponibles, saisissez la requête suivante dans Gemini :
/mcp list looker
Vous devriez obtenir le résultat suivant :
Configured MCP servers: 🟢 looker - Ready (33 tools) Tools: - add_dashboard_element - add_dashboard_filter - create_project_file - delete_project_file - dev_mode - generate_embed_url - get_connection_databases - get_connection_schemas - get_connection_table_columns - get_connection_tables - get_connections - get_dashboards - get_dimensions - get_explores - get_filters - get_looks - get_measures - get_models - get_parameters - get_project_file - get_project_files - get_projects - health_analyze - health_pulse - health_vacuum - make_dashboard - make_look - query - query_sql - query_url - run_dashboard - run_look - update_project_file
Commencez maintenant à interroger la CLI Gemini sur les données disponibles. Voici quelques suggestions :
- Quels sont les modèles disponibles dans Looker ?
- Quelles sont les explorations disponibles dans MODEL_NAME ?
- Quelles mesures et dimensions sont disponibles dans EXPLORE_NAME ?
Remplacez MODEL_NAME et EXPLORE_NAME par vos propres valeurs.
Ensuite, essayez de formuler des requêtes en langage naturel auxquelles les données de votre instance Looker peuvent répondre : "Quel est mon revenu total pour 2025 ?", "Combien de widgets ai-je vendus au quatrième trimestre ?", etc.
7. Autres requêtes à tester
Vous pouvez également essayer d'exécuter des explorations et des tableaux de bord enregistrés, de créer des explorations et des tableaux de bord, et même de modifier des modèles LookML.
- Exécutez un Look enregistré en saisissant une requête telle que "Exécute le Look 'Inventaire mensuel'." Gemini doit rechercher un look intitulé "Inventaire mensuel", exécuter la requête associée et partager les résultats.
- Exécutez un tableau de bord en saisissant une requête telle que "Résume le tableau de bord "Suivi des clients"." Gemini doit rechercher un tableau de bord nommé "Suivi des clients", exécuter les requêtes associées à chaque vignette et fournir un récapitulatif.
- Pour créer un Look enregistré, essayez une requête comme "Crée un Look pour suivre mes revenus mensuels par catégorie de produits. Affiche les données sous forme de graphique à colonnes empilées."
- Pour créer un tableau de bord, essayez une requête comme "Crée-moi un tableau de bord sur les tendances des ventes pour l'année 2026".
Si vous êtes développeur LookML, vous pouvez modifier le code LookML avec Gemini. Essayez des requêtes comme celles-ci :
- Demandez à Gemini d'obtenir la liste des projets LookML en saisissant "Quels projets LookML sont disponibles ?".
- Demandez à Gemini de récupérer la liste des fichiers du projet. "Quels fichiers sont disponibles dans le projet PROJECT_NAME ?" Remplacez-le par le nom de votre projet.
- Demandez à Gemini d'ajouter une mesure. "Crée une mesure pour calculer la moyenne du champ sale_price dans la vue VIEW_NAME." Remplacez-le par le nom de votre propre vue.
- Récupérez la liste des connexions avec "Quelles connexions sont disponibles dans Looker ?"
- Obtenez les schémas associés. "Quels schémas sont inclus dans CONNECTION_NAME ?" Remplacez-le par le nom de votre propre connexion.
- Obtenez les tables associées. "Quelles sont les tables de CONNECTION_NAME dans le schéma SCHEMA_NAME ?" Remplacez les noms de connexion et de schéma par les vôtres.
- Obtenez les colonnes d'une table. "Quelles sont les colonnes de TABLE_NAME ?" Remplacez-le par le nom de votre table.
- Demandez maintenant à Gemini d'ajouter une colonne à une vue LookML. "Crée une dimension pour la colonne COLUMN_NAME." Remplacez-le par le nom de votre propre colonne.
Utilisez l'interface utilisateur Looker pour tester les modifications et éventuellement les valider. Les outils Gemini et MCP ne peuvent pas valider les modifications LookML ni les déployer en production.