Comienza a usar la extensión de Looker para VS Code

La extensión de Looker para VS Code te permite desarrollar LookML directamente en tu entorno de escritorio local. Proporciona un resaltado de sintaxis enriquecido, sincronización bidireccional de archivos con tu instancia de Looker y la integración con agentes de codificación de IA para "vibe coding".

La extensión se compila con el framework de Visual Studio Code (VS Code) y admite IDEs basados en el IDE de VS Code, como los siguientes IDEs y herramientas de codificación:

Claude Code
Codex
Cursor
Kiro
VS Code
Windsurf
Zed

La extensión de Looker para VS Code no admite IDE que no sean bifurcaciones de VS Code, como IntelliJ y Eclipse.

En esta guía, se explica cómo configurar y autenticar la extensión.

Flujo de trabajo potenciado por IA

La extensión de Looker para VS Code forma parte de un flujo de trabajo de desarrollo asistido por agentes y habilitado para la IA que permite editar y crear archivos de LookML. Para habilitar este flujo de trabajo, configura las siguientes herramientas:

La extensión de Looker para VS Code
Un IDE local basado en VS Code El IDE debe contener un agente de IA integrado (por ejemplo, Cursor) o, si no lo contiene (como VS Code básico), debe estar integrado con una herramienta con agentes independiente (como Gemini CLI o Claude Code). Consulta la documentación de tu IDE local para saber cómo conectarlo a un agente.
Un servidor de MCP, como MCP Toolbox para bases de datos.

Para obtener más información sobre el flujo de trabajo habilitado por IA, consulta la página de documentación Desarrollo asistido por IA (programación de ambiente) con Looker.

Antes de comenzar

Antes de instalar la extensión, debes cumplir con los siguientes requisitos:

Conéctate a herramientas de IA: Si planeas usar el desarrollo asistido por IA, conecta tu IDE y tu agente de IA a MCP Toolbox for Databases. Como ejemplo, en la documentación de Usa Looker con MCP, Gemini CLI y otros agentes, se muestra una configuración de muestra para conectar MCP Toolbox a Gemini CLI. Consulta la documentación de tus herramientas para obtener más detalles.
Permisos de Looker: Debes tener el permiso de Looker develop para los modelos que quieras editar.
Instancia de Looker: Tu instancia debe ejecutar Looker 26.6 o una versión posterior.
Instalación de Git: Debes tener Git instalado en tu máquina local para clonar y administrar tu repositorio de LookML.
Configuración del proyecto: Tu proyecto de LookML debe estar configurado para Git.
ID de cliente de OAuth: Si usas la autenticación de OAuth (recomendada), debes obtener un ID de cliente de OAuth de tu administrador de Looker.

Configuración para administradores

Si tu organización usa OAuth para la autenticación, un administrador de Looker debe registrar la extensión de Looker para VS Code como cliente de OAuth en la IU de administrador de Looker.

Usa el Explorador de APIs de Looker para configurar la integración de OAuth. Puedes acceder al Explorador de APIs con uno de los siguientes métodos:

Si tu instancia de Looker ya tiene instalado el Explorador de APIs, puedes acceder a él con este formato de URL:
```
https://LOOKER_INSTANCE_URL/extensions/marketplace_extension_api_explorer::api-explorer/
```
Si tu instancia de Looker no tiene el Explorador de APIs, puedes instalarlo desde Looker Marketplace. Consulta la página Cómo usar el Explorador de APIs para obtener más información.

Para registrar la extensión, completa los siguientes pasos:

Sigue las instrucciones de la documentación Cómo registrar una aplicación cliente de OAuth para registrar la extensión.
Para el campo client_guid, completa los siguientes pasos:
- Usa cualquier ID único a nivel global.
- Prepárate para distribuir el ID a los desarrolladores de LookML que quieran usar la extensión.

Para redirect_uri, usa lo siguiente:

vscode://google.vscode-looker-official/oauth_callback

Completa display_name y description como se describe en la documentación de Registro de una aplicación cliente de OAuth.

Una vez que se registre la app, el Explorador de APIs devolverá una respuesta con un resumen del registro. Puedes usar el extremo Get OAuth Client App con client_guid para revisar los detalles de tu registro.

Proporciona el client_guid generado a tus desarrolladores, quienes lo usarán cuando configuren la extensión.

Instala la extensión

Para instalar la extensión, completa los siguientes pasos:

Instala la extensión de Looker para VS Code desde Visual Studio Marketplace.
Abre tu IDE, como VS Code o Cursor.
Haz clic en el ícono de Extensiones en la barra de actividades.
Busca la extensión de Looker para VS Code y haz clic en Instalar.
Una vez que se instala la extensión, aparece el ícono de Looker en la barra de actividades.

Configura la extensión

Debes configurar la extensión con los detalles de tu instancia de Looker en el archivo settings.json de tu espacio de trabajo.

Con un espacio de trabajo abierto, abre la paleta de comandos (Comando-Mayúsculas-P en Mac o Ctrl+Mayúsculas+P en Windows/Linux).
Busca y selecciona Preferences: Open Workspace Settings (JSON).
Agrega las variables de configuración a tus parámetros. Las variables de configuración variarán según si tu método de autenticación es OAuth o credenciales de API.

Autenticación con OAuth (recomendado)

OAuth 2.1 es el flujo de autenticación recomendado. Pega estos parámetros de configuración en el archivo settings.json de tu espacio de trabajo.

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

Reemplaza lo siguiente:

https://YOUR_INSTANCE_URL: Es la URL de tu instancia de Looker.
YOUR_OAUTH_CLIENT_ID: Es el ID de cliente de OAuth (client_guid) que recibes de tu administrador de Looker.
YOUR_PROJECT_ID: Es el nombre del proyecto que deseas editar. Para encontrarlo, en tu instancia de Looker, abre la página Proyectos de LookML. El ID del proyecto se encuentra en la columna Proyecto.

Autentícate con credenciales de API

Si prefieres usar claves de API de Looker, sigue la documentación para crear credenciales de API. También debes proporcionar el ID de tu proyecto.

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

Reemplaza lo siguiente:

https://YOUR_INSTANCE_URL: Es la URL de tu instancia de Looker.
YOUR_CLIENT_ID y YOUR_CLIENT_SECRET: Son el ID de cliente y el secreto del cliente para las credenciales de la API que usas para la autenticación. Para encontrar estas credenciales, en tu instancia de Looker, abre la página Cuenta y, luego, en la sección Claves de API, haz clic en el botón Administrar. Se abrirá la página Claves de API, en la que podrás ver tus IDs de cliente y secretos.
YOUR_PROJECT_ID: Es el nombre del proyecto que deseas editar. Para encontrar el nombre del proyecto, en tu instancia de Looker, abre la página Proyectos de LookML. El ID del proyecto se encuentra en la columna Proyecto.

Configuración

Puedes configurar los siguientes parámetros de configuración del MCP en tu espacio de trabajo del IDE.

Configuración	Descripción	Predeterminado
`looker.instanceURL`	Es la URL base de la instancia de Looker (por ejemplo, `https://mycompany.looker.com`).	-
`looker.authURL`	Es la URL que se usará para la autenticación de OAuth. Solo se configura si es diferente de la URL de tu instancia.	`looker.instanceURL`
`looker.sdkURL`	Es la URL que se usará para las solicitudes a la API. Solo se configura si es diferente de la URL de tu instancia.	`looker.instanceURL`
`looker.oauthClientId`	ID de cliente de OAuth de Looker. Se requiere para OAuth.	-
`looker.clientId`	ID de cliente de la API de Looker. Se requiere para la autenticación con clave de API.	-
`looker.clientSecret`	Es el secreto del cliente de la API de Looker. Se requiere para la autenticación con clave de API.	-
`looker.projectId`	ID del proyecto de Looker.	-
`looker.mcpServerUrl`	Es la URL del servidor de MCP externo para el proxy (por ejemplo, `http://localhost:5000/mcp`).	-
`looker.acceptSelfSignedCertificates`	Ignora los errores de certificado SSL (por ejemplo, para certificados autofirmados). Advertencia: No se recomienda habilitar esta opción.	`false`
`looker.askBeforeOverwritingRemote`	Siempre pregunta antes de reemplazar archivos remotos cuando se detecta un conflicto.	`false`

Autenticación a través de Looker

Si usas la autenticación de OAuth, debes acceder para vincular tu IDE local a tu cuenta de Looker.

Abre la paleta de comandos.
Ejecuta el comando Looker: Sign In (OAuth).
Acepta el mensaje para abrir el navegador.
En el navegador, autoriza la extensión para que acceda a tu cuenta de Looker.
Después de la autorización, el navegador te redireccionará de nuevo a tu IDE. Deberías ver una notificación que indique Accediste a Looker correctamente.

Clona tu proyecto de LookML

Para comenzar el desarrollo, debes clonar tu repositorio de LookML en tu máquina local.

En VS Code, abre una ventana nueva.
Abre la paleta de comandos y selecciona Git: Clone.
Ingresa la URL de tu repositorio de Git remoto (por ejemplo, de GitHub o GitLab) y elige una carpeta local.
Abre la carpeta clonada en tu IDE.

La extensión detecta automáticamente los archivos LookML y comienza a sincronizarse con la rama confirmada en el modo de desarrollo de tu instancia de Looker.

Soluciona problemas

Puedes ver los registros de la extensión en el panel Output de tu IDE. Selecciona el canal de Looker para ver los registros. Para obtener registros más detallados, abre la paleta de comandos, ejecuta el comando Developer: Set Log Level y selecciona Debug o Trace.

Errores de autenticación: Verifica que tus looker.instanceUrl y looker.oauthClientId sean correctos. Asegúrate de que el URI de redireccionamiento en Looker coincida exactamente.
Problemas de sincronización: Consulta los registros de la extensión para solucionar problemas de sincronización. Para ver los registros, abre el panel Output y selecciona Looker en el menú desplegable.
Respuesta de solicitud incorrecta durante OAuth: Asegúrate de que se pueda acceder a tu instancia de Looker desde tu red local y de que tengas una conexión a Internet válida.

Si tienes problemas con la extensión, ejecutar el comando Developer: Reload Window desde la paleta de comandos puede ayudarte a resolverlos.