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

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 de archivos bidireccional 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 entornos de desarrollo integrados (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

Los IDEs que no son bifurcaciones de VS Code, como IntelliJ y Eclipse, no son compatibles con la extensión de Looker para VS Code.

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

Flujo de trabajo habilitado para IA

La extensión de Looker para VS Code forma parte de un flujo de trabajo de desarrollo de agentes habilitado para IA para 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 el IDE no contiene un agente de IA integrado (como VS Code básico), el IDE debe integrarse con una herramienta de agente independiente (como Gemini CLI o Claude Code). Consulta la documentación de tu IDE local para obtener información sobre cómo conectar tu IDE 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 para IA, consulta la página de documentación Desarrollo asistido por IA (codificación de ambiente) con Looker.

Antes de comenzar

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

Conéctate a las herramientas de IA: Si planeas usar el desarrollo asistido por IA, conecta tu IDE y tu agente de IA a la MCP Toolbox para bases de datos. Por ejemplo, en la documentación Usa Looker con MCP, Gemini CLI y otros agentes, aparece 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 develop de Looker para cualquier modelo que desees 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 un cliente de OAuth en la IU de administración 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 Usa el Explorador de APIs para obtener información.

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

Sigue las instrucciones de la documentación Registra 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 cualquier desarrollador de LookML que quiera 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 Registra una aplicación cliente de OAuth.

Una vez que se registre la app, el Explorador de APIs mostrará 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, ya que lo usarán cuando configuren la extensión.

Instala la extensión

Completa los siguientes pasos para instalar la extensión:

Instala la extensión de Looker para VS Code desde el 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 instale la extensión, aparecerá el ícono 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 (Command-Shift-P en Mac o Ctrl+Shift+P en Windows o Linux).
Busca y selecciona Preferences: Open Workspace Settings (JSON).
Agrega las variables de configuración a tus parámetros de configuración. Las variables de configuración variarán según si tu método de autenticación es OAuth o credenciales de API.

Autentica con OAuth (recomendado)

OAuth 2.1 es el flujo de autenticación recomendado. Pega esta 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: La URL de tu instancia de Looker.
YOUR_OAUTH_CLIENT_ID: El ID de cliente de OAuth (client_guid) que recibes de tu administrador de Looker.
YOUR_PROJECT_ID: 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 está en la columna Proyecto.

Autentica 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: La URL de tu instancia de Looker.
YOUR_CLIENT_ID y YOUR_CLIENT_SECRET: El ID de cliente y el secreto del cliente para las credenciales de API que usas para autenticarte. 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 y secretos de cliente.
YOUR_PROJECT_ID: 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 está en la columna Proyecto.

Configuración

Puedes configurar los siguientes parámetros de configuración de MCP en el espacio de trabajo de tu 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 establece si es diferente de la URL de la instancia.	`looker.instanceURL`
`looker.sdkURL`	Es la URL que se usará para las solicitudes a la API. Solo se establece si es diferente de la URL de la instancia.	`looker.instanceURL`
`looker.oauthClientId`	Es el ID de cliente de OAuth de Looker. Es obligatorio para OAuth.	-
`looker.clientId`	Es el ID de cliente de la API de Looker. Es obligatorio para la autenticación de claves de API.	-
`looker.clientSecret`	Es el secreto del cliente de la API de Looker. Es obligatorio para la autenticación de claves de API.	-
`looker.projectId`	Es el 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`

Autentica 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 siguiente comando: Looker: Sign In (OAuth).
Confirma la solicitud para abrir tu navegador.
En el navegador, autoriza la extensión para acceder a tu cuenta de Looker.
Después de la autorización, el navegador se redirecciona a tu IDE. Deberías ver una notificación que diga Se accedió correctamente a Looker.

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, desde GitHub o GitLab) y elige una carpeta local.
Abre la carpeta clonada en tu IDE.

La extensión detecta automáticamente los archivos de 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 extensión en el panel Resultado de tu IDE. Selecciona el canal 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 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 extensión para solucionar problemas de sincronización. Para ver los registros, abre el panel Resultado 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.