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 resaltado de sintaxis enriquecido, sincronización de archivos bidireccional con tu instancia de Looker y la integración con agentes de programació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 (IDE) basados en el IDE de VS Code, como los siguientes IDE 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 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 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 el servidor de MCP administrado por Looker.

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 las herramientas de IA: Si planeas usar el desarrollo asistido por IA, conecta tu IDE y tu agente de IA al servidor de MCP administrado por Looker. La configuración y un ejemplo aparecen en la página de documentación del servidor de MCP administrado por Looker. 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:

Explorador de API instalado

Si tu instancia de Looker ya tiene instalado el Explorador de APIs, puedes acceder a él con este formato de URL:

LOOKER_INSTANCE_URL/extensions/marketplace_extension_api_explorer::api-explorer/

El Explorador de API no está instalado

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 API para obtener información sobre cómo instalar el Explorador de API.

Instancia privada del PSA

Si usas una instancia de conexiones privadas de Looker (Google Cloud Core) que utiliza el acceso privado a servicios, no se admiten Looker Marketplace ni el Explorador de APIs. Para registrar un agente de IA, debes llamar directamente al extremo de API de oauth_client_apps. Si usas este método, puedes omitir los pasos restantes de este procedimiento del Explorador de APIs.

A continuación, se muestra un ejemplo de un comando curl que puedes usar con el extremo oauth_client_apps para registrar el agente.

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

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, ingresa la URL de devolución de llamada de tu IDE. Según tu IDE o herramienta de codificación, usa una de las siguientes URLs de devolución de llamada:

IDE o herramienta	URL de devolución de llamada
VS Code	vscode://google.vscode-looker-official/oauth_callback
IDE de Antigravity (disponible en Looker 26.12 y versiones posteriores)	antigravity-ide://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

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

Configura la extensión

Puedes configurar la extensión con los detalles de tu instancia de Looker en el archivo settings.json de tu espacio de trabajo, el editor visual de configuración de VS Code (Preferencias: Abrir configuración del espacio de trabajo) o la IU interactiva de incorporación de la extensión de Looker.

En los siguientes pasos, se muestra cómo editar el archivo settings.json como ejemplo. Si, en cambio, usas el editor de configuración de VS Code o la IU de la extensión de Looker, obtendrás el mismo resultado.

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, como se describe en las siguientes secciones.

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 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`	Es el 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 al que se realizará 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`

Configura tu cliente de MCP

Para permitir que tu agente de IA interactúe con Looker a través de la extensión, debes configurar tu agente para que se conecte a la URL del proxy de MCP de la extensión. De forma predeterminada, el proxy se ejecuta de forma local en http://127.0.0.1:5050.

Si tu servidor de MCP se ejecuta en un puerto que no sea 5000 o en una máquina remota, debes actualizar la configuración del proxy de la extensión. Para ello, actualiza el parámetro de configuración looker.mcpServerUrl en la configuración del espacio de trabajo de VS Code. Consulta la sección Configuración para obtener más información.

Visual Studio Code (Copilot)

Abre VS Code y crea el directorio .vscode en la raíz del proyecto, si aún no existe.
Crea el archivo .vscode/mcp.json, si aún no existe, y ábrelo.
Agrega la siguiente configuración y guarda el archivo:

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

Claude Code

Crea el archivo .mcp.json en la raíz de tu proyecto si aún no existe.
Agrega la siguiente configuración y guarda el archivo:

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

Cursor

Crea el directorio .cursor en la raíz de tu proyecto si aún no existe.
Crea el archivo .cursor/mcp.json, si aún no existe, y ábrelo.
Agrega la siguiente configuración y guarda el archivo:

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

Abre Cursor y navega a Configuración > Configuración del cursor > MCP. Cuando el servidor se conecta, aparece un estado activo de color verde.

Cline

Abre la extensión Cline en VS Code y haz clic en el ícono de Servidores de MCP.
Haz clic en Configure MCP Servers para abrir el archivo de configuración.
Agrega la siguiente configuración y guarda el archivo:

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

Windsurf

Abre Windsurf y navega al asistente de Cascade.
Haz clic en el ícono de MCP y, luego, en Configurar para abrir el archivo de configuración.
Agrega la siguiente configuración y guarda el archivo:

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

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 que extrajiste 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 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 valores de 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.