Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

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

La extensión Looker by Google Cloud para Visual Studio Code (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 el "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:

Un IDE local basado en VS Code El IDE debe contener un agente de IA integrado (por ejemplo, Cursor) o, si no lo contiene, debe estar integrado con una herramienta de agente independiente (como Gemini CLI o Claude Code). Consulta la documentación de tu IDE local para saber cómo conectarlo a un agente.
La extensión de Looker para VS Code
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:

Servidor de MCP administrado por Looker (opcional, pero recomendado): Si planeas usar el desarrollo asistido por IA, conecta tu IDE y tu agente de IA al servidor de MCP administrado por Looker. Las instrucciones para configurar el servidor de MCP 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.
Configuración del proyecto: Debes tener un proyecto en Looker (ya sea configurado como un repositorio básico o configurado para Git).
Instalación de Git (opcional): Si planeas clonar tu repositorio de LookML, debes tener Git instalado en tu máquina local.
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 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
IDE de Antigravity (disponible en Looker 26.12 o 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
Kiro (la compatibilidad con OAuth para Kiro está disponible en Looker 26.16 o versiones posteriores)	kiro://google.vscode-looker-official/oauth_callback
Looker	looker://google.vscode-looker-official/oauth_callback
VS Code	vscode://google.vscode-looker-official/oauth_callback
Windsurf	windsurf://google.vscode-looker-official/oauth_callback

Asegúrate de que el campo Habilitado esté establecido en true.
Completa los campos 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. Asegúrate de que el URI de redireccionamiento coincida con lo que ingresaste en el parámetro de la solicitud. Puedes usar el extremo Get OAuth Client App con el valor client_guid para revisar los detalles de tu registro.

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

Instala la extensión

La extensión está disponible en los dos principales mercados de extensiones:

Visual Studio Marketplace (para VS Code estándar)
Registro de Open VSX (para Cursor, IDE de Antigravity y VSCodium)

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

Abre tu IDE, como VS Code o Cursor.
Haz clic en el ícono de Extensiones en la barra de actividades.
Busca Looker by Google Cloud 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

Para configurar la extensión con los detalles de tu instancia de Looker, ejecuta la guía interactiva de integración:

Con un espacio de trabajo abierto, abre la paleta de comandos (Comando-Mayúsculas-P en macOS o Ctrl+Mayúsculas+P en Windows/Linux).
Ejecuta el comando Looker: Show Onboarding Walkthrough para abrir la explicación de la integración.
Sigue las instrucciones de la guía para ingresar la URL de tu instancia de Looker, el ID del proyecto y los detalles de autenticación. Si usas un repositorio básico, también se te pedirá que completes tu espacio de trabajo con los archivos LookML del proyecto durante este proceso.

Autenticación con OAuth (recomendado)

OAuth 2.1 es el flujo de autenticación recomendado. Cuando se te solicite durante la guía de integración, elige OAuth y proporciona los siguientes valores de configuración:

URL de la instancia de Looker: Es la URL de tu instancia de Looker.
ID de cliente de OAuth: Es el ID de cliente de OAuth (client_guid) que recibes de tu administrador de Looker.
ID del proyecto: Es el nombre del proyecto de LookML 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. Cuando se te solicite durante el recorrido de incorporación, elige las credenciales de la API y proporciona los siguientes valores de configuración:

URL de la instancia de Looker: Es la URL de tu instancia de Looker.
ID de cliente y secreto del cliente: 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 para ver tus IDs y secretos de cliente.
ID del proyecto: 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

Aunque se recomienda usar el recorrido de incorporación, también puedes configurar los parámetros de configuración de la extensión en tu archivo settings.json de VS Code. Este archivo se encuentra en la carpeta .vscode de tu espacio de trabajo (.vscode/settings.json) o en tu archivo de configuración global del usuario (settings.json). También puedes configurarlos con el editor visual de configuración de VS Code (Preferencias: Abrir configuración (IU)).

Todas las propiedades de looker.<setting> deben definirse en los archivos settings.json de VS Code, incluido el parámetro de configuración de MCP de la extensión looker.mcpServerUrl. Definir estos parámetros de configuración en el archivo de configuración de MCP de un agente de IA (como .agents/mcp_config.json) o en otros archivos de configuración no funcionará con la extensión.

Puedes configurar los siguientes parámetros de configuración de la extensión en settings.json:

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. Obsoleto. Usa el tutorial de incorporación para configurar las credenciales de la API.	-
`looker.projectId`	ID del proyecto de LookML.	-
`looker.mcpServerUrl`	Es la URL del servidor de MCP de destino al que el proxy de MCP local de la extensión reenvía las solicitudes. Solo se establece si es diferente de `looker.instanceURL/mcp` (por ejemplo, `http://localhost:5000/mcp`).	`looker.instanceURL/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 al proxy de MCP local de la extensión en http://127.0.0.1:5050/mcp.

Tu agente de IA hace referencia a su propio archivo de configuración de MCP (como .agents/mcp_config.json en VS Code, .mcp.json en Claude Code o .cursor/mcp.json en Cursor). Si apuntas esta configuración al proxy local, la extensión podrá capturar las solicitudes de MCP de tu agente y reenviarlas con los encabezados de autenticación adecuados.

Servidor de MCP administrado por Looker (opción predeterminada y recomendada)

La extensión ejecuta un proxy inverso local (predeterminado: http://127.0.0.1:5050/mcp) que se conecta al servidor de MCP administrado integrado de Looker (LOOKER_INSTANCE_URL/mcp). El proxy inserta automáticamente tokens de portador de OAuth y almacena en búfer las solicitudes de herramientas del agente de IA hasta que se completan las sincronizaciones de archivos locales pendientes, lo que garantiza que las herramientas de validación nunca evalúen código obsoleto en el servidor.

Servidor de MCP personalizado o autoalojado (opcional)

Si tu organización aloja un servidor de MCP personalizado (como MCP Toolbox para bases de datos independiente):

En la configuración de VS Code, establece looker.mcpServerUrl en la URL de tu servidor personalizado (por ejemplo, http://localhost:5000/mcp).
Configura el cliente de MCP de tu IDE para que apunte al proxy de extensión en http://127.0.0.1:5050/mcp.

Visual Studio Code (Copilot)

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

      {
        "mcpServers": {
          "Looker": {
            "serverUrl": "http://127.0.0.1:5050/mcp",
            "disabledTools": [
              "query_url",
              "get_looks",
              "run_look",
              "make_look",
              "get_dashboards",
              "run_dashboard",
              "make_dashboard",
              "add_dashboard_element",
              "add_dashboard_filter",
              "generate_embed_url",
              "health_pulse",
              "health_analyze",
              "health_vacuum",
              "get_project_files",
              "get_project_file",
              "create_project_file",
              "update_project_file",
              "delete_project_file",
              "get_project_directories",
              "create_project_directory",
              "delete_project_directory",
              "project_git_branch"
            ]
          }
        }
      }

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/mcp"
          }
        }
      }

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/mcp"
          }
        }
      }

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/mcp"
          }
        }
      }

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/mcp"
          }
        }
      }

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.

Cómo completar tu proyecto de LookML local

Para comenzar el desarrollo, abre tu proyecto de LookML en tu IDE local con el método adecuado para la configuración de tu repositorio:

Repositorio de Git

Si tu proyecto de LookML está configurado para Git, sigue estos pasos:

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.

Modo de repositorio básico

Si tu proyecto de LookML está configurado como un repositorio básico, sigue estos pasos:

Con un espacio de trabajo abierto, crea y abre una carpeta local vacía para tu proyecto.
Abre la paleta de comandos (Comando-Mayúsculas-P en macOS o Ctrl+Mayúsculas+P en Windows/Linux).
Ejecuta el comando Looker: Show Onboarding Walkthrough para abrir la explicación de la integración.
En el paso Select Project, selecciona el proyecto de LookML en el que deseas trabajar y haz clic en Next.
La extensión reconoce que tu carpeta local está vacía y te solicita que completes el espacio de trabajo con los archivos del proyecto. Haz clic en Populate Workspace para propagar el espacio de trabajo.
Completa la guía de incorporación.

Una vez que se completa el espacio de trabajo, la extensión comienza automáticamente a sincronizar tu carpeta local 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.