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

Premiers pas avec l'extension Looker pour VS Code

L'extension Looker pour VS Code vous permet de développer LookML directement dans votre environnement de bureau local. Il offre une coloration syntaxique riche, une synchronisation bidirectionnelle des fichiers avec votre instance Looker et l'intégration d'agents de codage IA pour le "vibe coding".

L'extension est conçue à l'aide du framework Visual Studio Code (VS Code). Elle est compatible avec les environnements de développement intégrés (IDE) basés sur l'IDE VS Code, tels que les IDE et outils de programmation suivants :

Claude Code
Codex
Cursor
Kiro
VS Code
Windsurf
Zed

Les IDE qui ne sont pas des forks de VS Code, tels qu'IntelliJ et Eclipse, ne sont pas compatibles avec l'extension Looker pour VS Code.

Ce guide explique comment configurer et authentifier l'extension.

Workflow optimisé par l'IA

L'extension Looker pour VS Code fait partie d'un workflow de développement agentique optimisé par l'IA permettant de modifier et de créer des fichiers LookML. Pour activer ce workflow, configurez les outils suivants :

L'extension Looker pour VS Code.
Un IDE local basé sur VS Code. L'IDE doit contenir un agent d'IA intégré (par exemple, Cursor). Si l'IDE ne contient pas d'agent d'IA intégré (comme VS Code de base), il doit être intégré à un outil agentique autonome (comme Gemini CLI ou Claude Code). Consultez la documentation de votre IDE local pour savoir comment connecter votre IDE à un agent.
Un serveur MCP, tel que le serveur MCP géré par Looker.

Pour en savoir plus sur le workflow optimisé par l'IA, consultez la page de documentation Développement assisté par l'IA (codage Vibe) avec Looker.

Avant de commencer

Avant d'installer l'extension, vous devez remplir les conditions suivantes :

Se connecter aux outils d'IA : si vous prévoyez d'utiliser le développement assisté par l'IA, connectez votre IDE et votre agent d'IA au serveur MCP géré par Looker. La configuration et un exemple de configuration sont disponibles sur la page de documentation Serveur MCP géré par Looker. Pour en savoir plus, consultez la documentation de vos outils.
Autorisations Looker : vous devez disposer de l'autorisation Looker develop pour tous les modèles que vous souhaitez modifier.
Instance Looker : votre instance doit exécuter Looker 26.6 ou version ultérieure.
Installation de Git : vous devez avoir installé Git sur votre machine locale pour cloner et gérer votre dépôt LookML.
Configuration du projet : votre projet LookML doit être configuré pour Git.
ID client OAuth : si vous utilisez l'authentification OAuth (recommandée), vous devez obtenir un ID client OAuth auprès de votre administrateur Looker.

Configuration par l'administrateur

Si votre organisation utilise OAuth pour l'authentification, un administrateur Looker doit enregistrer l'extension Looker pour VS Code en tant que client OAuth dans l'interface utilisateur d'administration Looker.

Utilisez l'explorateur d'API Looker pour configurer l'intégration OAuth. Vous pouvez accéder à l'explorateur d'API à l'aide de l'une des méthodes suivantes :

APIs Explorer installé

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

LOOKER_INSTANCE_URL/extensions/marketplace_extension_api_explorer::api-explorer/

API Explorer non installé

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

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, le Marketplace Looker et l'API Explorer 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 API 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
}'

Pour enregistrer l'extension, procédez comme suit :

Suivez les instructions de la documentation Enregistrer une application cliente OAuth pour enregistrer l'extension.
Pour le champ client_guid, procédez comme suit :
- Utilisez n'importe quel ID unique au niveau mondial.
- Préparez-vous à distribuer l'ID à tous les développeurs LookML qui souhaitent utiliser l'extension.

Pour redirect_uri, saisissez l'URL de rappel de votre IDE. Selon votre IDE ou votre outil de programmation, utilisez l'une des URL de rappel suivantes :

IDE ou outil	URL de rappel
VS Code	vscode://google.vscode-looker-official/oauth_callback
Antigravity	antigravity://google.vscode-looker-official/oauth_callback
Code-OSS	code-oss://google.vscode-looker-official/oauth_callback
Cursor	cursor://google.vscode-looker-official/oauth_callback
HTTPS	https://google.vscode-looker-official/oauth_callback
Looker	looker://google.vscode-looker-official/oauth_callback
Windsurf	windsurf://google.vscode-looker-official/oauth_callback

Renseignez display_name et description comme décrit dans la documentation Enregistrer une application cliente OAuth.

Une fois l'application enregistrée, l'explorateur d'API renvoie une réponse avec un récapitulatif de l'enregistrement. Vous pouvez utiliser le point de terminaison Get OAuth Client App avec client_guid pour consulter les détails de votre enregistrement.

Fournissez le client_guid généré à vos développeurs. Ils l'utiliseront lors de la configuration de l'extension.

Installer l'extension

Pour installer l'extension, procédez comme suit :

Installez l'extension Looker pour VS Code depuis le Visual Studio Marketplace.
Ouvrez votre IDE, tel que VS Code ou Cursor.
Cliquez sur l'icône Extensions dans la barre d'activité.
Recherchez l'extension Looker pour VS Code, puis cliquez sur Installer.
Une fois l'extension installée, l'icône Looker s'affiche dans la barre d'activité.

Configurer l'extension

Vous pouvez configurer l'extension avec les détails de votre instance Looker dans le fichier settings.json de votre espace de travail, l'éditeur visuel des paramètres VS Code (Préférences : Ouvrir les paramètres de l'espace de travail) ou l'interface utilisateur d'intégration interactive de l'extension Looker.

Les étapes suivantes montrent comment modifier le fichier settings.json à titre d'exemple. Si vous utilisez plutôt l'éditeur de paramètres VS Code ou l'UI de l'extension Looker, vous obtiendrez le même résultat.

Ouvrez un espace de travail, puis la palette de commandes (Cmd+Maj+P sur Mac ou Ctrl+Maj+P sur Windows/Linux).
Recherchez et sélectionnez Préférences : Ouvrir les paramètres de l'espace de travail (JSON).
Ajoutez les variables de configuration à vos paramètres. Les variables de configuration varient selon que votre méthode d'authentification est OAuth ou les identifiants API, comme décrit dans les sections suivantes.

S'authentifier avec OAuth (recommandé)

OAuth 2.1 est le flux d'authentification recommandé. Collez ces paramètres dans le fichier settings.json de votre espace de travail.

{
  "looker.instanceUrl": "https://YOUR_INSTANCE_URL",
  "looker.oauthClientId": "YOUR_OAUTH_CLIENT_ID",
  "looker.projectId": "YOUR_PROJECT_ID"
}

Remplacez les éléments suivants :

https://YOUR_INSTANCE_URL : URL de votre instance Looker.
YOUR_OAUTH_CLIENT_ID : ID client OAuth (client_guid) que vous recevez de votre administrateur Looker.
YOUR_PROJECT_ID : nom du projet que vous souhaitez modifier. Pour le trouver, ouvrez la page Projets LookML dans votre instance Looker. L'ID du projet se trouve dans la colonne Projet.

S'authentifier avec des identifiants API

Si vous préférez utiliser des clés API Looker, suivez la documentation pour créer des identifiants API. Vous devez également fournir l'ID de votre projet.

{
  "looker.instanceUrl": "https://YOUR_INSTANCE_URL",
  "looker.clientId": "YOUR_CLIENT_ID",
  "looker.clientSecret": "YOUR_CLIENT_SECRET",
  "looker.projectId": "YOUR_PROJECT_ID"
}

Remplacez les éléments suivants :

https://YOUR_INSTANCE_URL : URL de votre instance Looker.
YOUR_CLIENT_ID et YOUR_CLIENT_SECRET : ID client et code secret du client pour les identifiants API que vous utilisez pour l'authentification. Pour trouver ces identifiants, ouvrez la page Compte dans votre instance Looker, puis cliquez sur le bouton Gérer dans la section Clés API. La page Clés API s'ouvre, sur laquelle vous pouvez afficher vos ID et codes secrets client.
YOUR_PROJECT_ID : nom du projet que vous souhaitez modifier. Pour trouver le nom du projet, ouvrez la page Projets LookML dans votre instance Looker. L'ID du projet se trouve dans la colonne Projet.

Paramètres

Vous pouvez configurer les paramètres MCP suivants dans votre espace de travail IDE.

Paramètre	Description	Par défaut
`looker.instanceURL`	URL de base de l'instance Looker (par exemple, `https://mycompany.looker.com`).	-
`looker.authURL`	URL à utiliser pour l'authentification OAuth. Ne définissez cette valeur que si elle est différente de l'URL de votre instance.	`looker.instanceURL`
`looker.sdkURL`	URL à utiliser pour les requêtes d'API. Ne définissez cette valeur que si elle est différente de l'URL de votre instance.	`looker.instanceURL`
`looker.oauthClientId`	ID client OAuth Looker. Obligatoire pour OAuth.	-
`looker.clientId`	ID client de l'API Looker. Obligatoire pour l'authentification par clé API.	-
`looker.clientSecret`	Code secret du client de l'API Looker. Obligatoire pour l'authentification par clé API.	-
`looker.projectId`	ID du projet Looker.	-
`looker.mcpServerUrl`	URL du serveur MCP externe à proxyser (par exemple, `http://localhost:5000/mcp`).	-
`looker.acceptSelfSignedCertificates`	Ignorer les erreurs de certificat SSL (par exemple, pour les certificats autosignés). Avertissement : Il n'est pas recommandé d'activer cette option.	`false`
`looker.askBeforeOverwritingRemote`	Demande toujours avant d'écraser des fichiers distants lorsqu'un conflit est détecté.	`false`

Configurer votre client MCP

Pour permettre à votre agent d'IA d'interagir avec Looker via l'extension, vous devez configurer votre agent pour qu'il se connecte à l'URL du proxy MCP de l'extension. Par défaut, le proxy s'exécute localement sur http://127.0.0.1:5050.

Si votre serveur MCP s'exécute sur un port autre que 5000 ou sur une machine distante, vous devez mettre à jour la configuration du proxy de l'extension. Pour ce faire, mettez à jour le paramètre looker.mcpServerUrl dans les paramètres de votre espace de travail VS Code. Pour en savoir plus, consultez la section Paramètres.

Visual Studio Code (Copilot)

Ouvrez VS Code et créez le répertoire .vscode à la racine de votre projet, s'il n'existe pas déjà.
Créez le fichier .vscode/mcp.json s'il n'existe pas encore, puis ouvrez-le.
Ajoutez la configuration suivante et enregistrez le fichier :

      {
        "servers": {
          "looker": {
            "type": "http",
            "url": "http://127.0.0.1:5050"
          }
        }
      }

Claude Code

Créez le fichier .mcp.json à la racine de votre projet, s'il n'existe pas déjà.
Ajoutez la configuration suivante et enregistrez le fichier :

      {
        "mcpServers": {
          "looker": {
            "type": "http",
            "url": "http://127.0.0.1:5050"
          }
        }
      }

Cursor

Créez le répertoire .cursor à la racine de votre projet, s'il n'existe pas déjà.
Créez le fichier .cursor/mcp.json s'il n'existe pas encore, puis ouvrez-le.
Ajoutez la configuration suivante et enregistrez le fichier :

      {
        "mcpServers": {
          "looker": {
            "type": "http",
            "url": "http://127.0.0.1:5050"
          }
        }
      }

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.

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 et enregistrez le fichier :

      {
        "mcpServers": {
          "looker": {
            "type": "http",
            "url": "http://127.0.0.1:5050"
          }
        }
      }

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 et enregistrez le fichier :

      {
        "mcpServers": {
          "looker": {
            "type": "http",
            "url": "http://127.0.0.1:5050"
          }
        }
      }

S'authentifier via Looker

Si vous utilisez l'authentification OAuth, vous devez vous connecter pour associer votre IDE local à votre compte Looker.

Ouvrez la palette de commandes.
Exécutez la commande Looker: Sign In (OAuth).
Confirmez l'invite pour ouvrir votre navigateur.
Dans le navigateur, autorisez l'extension à accéder à votre compte Looker.
Une fois l'autorisation accordée, le navigateur vous redirige vers votre IDE. La notification Connexion à Looker réussie ! devrait s'afficher.

Cloner votre projet LookML

Pour commencer le développement, vous devez cloner votre dépôt LookML sur votre machine locale.

Dans VS Code, ouvrez une nouvelle fenêtre.
Ouvrez la palette de commandes et sélectionnez Git : Cloner.
Saisissez l'URL de votre dépôt Git distant (par exemple, depuis GitHub ou GitLab) et choisissez un dossier local.
Ouvrez le dossier cloné dans votre IDE.

L'extension détecte automatiquement les fichiers LookML et commence la synchronisation avec votre branche extraite dans le mode Développement de votre instance Looker.

Dépannage

Vous pouvez afficher les journaux d'extension dans le panneau Sortie de votre IDE. Sélectionnez le canal Looker pour afficher les journaux. Pour obtenir des journaux plus détaillés, ouvrez la palette de commandes, exécutez la commande Développeur : Définir le niveau de journalisation, puis sélectionnez Débogage ou Trace.

Erreurs d'authentification : vérifiez que vos looker.instanceUrl et looker.oauthClientId sont corrects. Assurez-vous que l'URI de redirection dans Looker correspond exactement.
Problèmes de synchronisation : consultez les journaux d'extension pour résoudre les problèmes de synchronisation. Pour afficher les journaux, ouvrez le panneau Output (Sortie) et sélectionnez Looker dans le menu déroulant.
Réponse "Bad Request" (Requête incorrecte) lors de l'authentification OAuth : assurez-vous que votre instance Looker est accessible depuis votre réseau local et que vous disposez d'une connexion Internet valide.

Si vous rencontrez des problèmes avec l'extension, l'exécution de la commande Développeur : Recharger la fenêtre à partir de la palette de commandes peut vous aider à les résoudre.