Se usó la API de Cloud Translation para traducir esta página.

Usa Looker con MCP, Gemini CLI y otros agentes

En esta página, se muestra cómo conectar tu instancia de Looker a varias herramientas para desarrolladores.

Para disfrutar de la experiencia más potente y completa, te recomendamos que uses la extensión de Looker dedicada para la CLI de Gemini. Usa la capa semántica de Looker para proporcionar a la CLI de Gemini acceso seguro, controlado y a pedido a datos confiables, y acelera los flujos de trabajo automatizando la creación de informes, visualizaciones y paneles a partir de instrucciones de lenguaje natural. Como interfaz de línea de comandos de próxima generación de Google Cloud, se recomienda usar la CLI de Gemini para interactuar con tus instancias de Looker desde la línea de comandos.

También puedes conectar otros entornos de desarrollo integrados (IDE) y herramientas para desarrolladores que admitan el Protocolo de contexto del modelo (MCP) con el kit de herramientas de MCP para bases de datos de uso general. MCP Toolbox es un servidor de MCP de código abierto que simplifica la conexión de agentes de IA a tus datos, ya que controla complejidades como la autenticación y la agrupación de conexiones, lo que te permite interactuar con tus datos en lenguaje natural directamente desde tu IDE. En el caso de estas herramientas, este método proporciona capacidades básicas de interacción con la base de datos.

Acerca de Gemini CLI y las extensiones

La CLI de Gemini es un agente de IA de código abierto diseñado para acelerar los flujos de trabajo de desarrollo, ya que ayuda con la programación, la depuración, la exploración de datos y la creación de contenido. Su misión es proporcionar una experiencia elegante y basada en agentes para interactuar con los servicios de la nube de datos y las bases de datos de código abierto populares.

Cómo funcionan las extensiones

Gemini CLI es altamente extensible, lo que permite agregar nuevas herramientas y capacidades a través de extensiones. Estas extensiones son fáciles de instalar. Puedes cargarlos desde una URL de GitHub, un directorio local o un registro configurable. Estas extensiones proporcionan un amplio conjunto de capacidades, incluidas nuevas herramientas, comandos de barra y mensajes para optimizar tu flujo de trabajo.

Configurar Looker

Obtén un ID de cliente y un secreto del cliente de Looker. Sigue las instrucciones de la página de documentación sobre la autenticación de la API de Looker.
Ten disponible la URL base de tu instancia de Looker. Es probable que sea algo como https://looker.example.com. En algunos casos, la API escucha en un puerto diferente, por lo que deberás usar https://looker.example.com:19999.

Instala MCP Toolbox

Descarga la versión más reciente de MCP Toolbox como un objeto binario. Selecciona el objeto binario que corresponda a tu SO y arquitectura de CPU. Debes usar la versión V0.14.0 o posterior de MCP Toolbox.

linux/amd64

curl -O https://storage.googleapis.com/genai-toolbox/v0.14.0/linux/amd64/toolbox

darwin/arm64

curl -O https://storage.googleapis.com/genai-toolbox/v0.14.0/darwin/arm64/toolbox

darwin/amd64

curl -O https://storage.googleapis.com/genai-toolbox/v0.14.0/darwin/amd64/toolbox

windows/amd64

curl -O https://storage.googleapis.com/genai-toolbox/v0.14.0/windows/amd64/toolbox.exe

Haz que el objeto binario sea ejecutable.
```
chmod +x toolbox
```
Verifica la instalación:.
```
./toolbox --version
```

Configura el cliente de MCP

En esta sección, se describe cómo configurar varias herramientas para desarrolladores para conectarte a tu instancia de Looker con MCP Toolbox para bases de datos. La caja de herramientas actúa como un servidor de Protocolo de contexto del modelo (MCP) de código abierto que se encuentra entre tu IDE y tu base de datos, y proporciona un plano de control seguro y eficiente para tus herramientas de IA. Selecciona la pestaña de tu herramienta específica para ver las instrucciones de configuración.

CLI de Gemini
Gemini Code Assist
Claude Code
Claude para computadoras de escritorio
Cline (extensión de VS Code)
Cursor
Visual Studio Code (Copilot)
Windsurf (Codium)

CLI de Gemini

Instala la Gemini CLI.
Instala la extensión de Looker para Gemini CLI desde el repositorio de GitHub con el siguiente comando:
```
gemini extensions install https://github.com/gemini-cli-extensions/looker
```
Configura las variables de entorno para conectarte a tu instancia de Looker y reemplaza las siguientes variables de entorno por tus valores:
- LOOKER_URL: Es la URL de tu instancia de Looker.
- CLIENT_ID y CLIENT_SECRET: La clave de API que se usa para acceder a la API de Looker.
- VERIFY_SSL: Puede ser true o false, según si usas encriptación SSL para conectar tu base de datos a tu instancia de Looker.
```
export LOOKER_BASE_URL="LOOKER_URL"
export LOOKER_CLIENT_ID="CLIENT_ID"
export LOOKER_CLIENT_SECRET="CLIENT_SECRET"
export LOOKER_VERIFY_SSL="VERIFY_SSL"
```
Inicia la Gemini CLI en modo interactivo:
```
gemini
```
La CLI carga automáticamente la extensión de Looker para la extensión de Gemini CLI y sus herramientas, que puedes usar para interactuar con tu instancia de Looker.

Gemini Code Assist

Te recomendamos que configures Gemini Code Assist para que use Gemini CLI. Este enfoque elimina la necesidad de configurar manualmente un servidor de MCP.

Asegúrate de haber instalado y configurado la CLI de Gemini y la extensión de looker.
Configura Gemini Code Assist para usar la CLI de Gemini.
Comienza a interactuar con tu instancia de Looker usando lenguaje natural directamente en el chat de Gemini Code Assist.

Código de Claude

Instala Claude Code.
Crea el archivo .mcp.json en la raíz de tu proyecto si no existe.
Agrega la siguiente configuración, reemplaza las siguientes variables de entorno por tus valores y, luego, guarda los cambios.
- LOOKER_URL: Es la URL de tu instancia de Looker.
- CLIENT_ID y CLIENT_SECRET: La clave de API que se usa para acceder a la API de Looker.
- VERIFY_SSL: Puede ser true o false, según si usas encriptación SSL para conectar tu base de datos a tu instancia de Looker.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }

Claude para computadoras de escritorio

Abre Claude Desktop y navega a Configuración.
En la pestaña Desarrollador, haz clic en Editar configuración para abrir el archivo de configuración.
Agrega la siguiente configuración, reemplaza las siguientes variables de entorno por tus valores y, luego, guarda los cambios.
- LOOKER_URL: Es la URL de tu instancia de Looker.
- CLIENT_ID y CLIENT_SECRET: La clave de API que se usa para acceder a la API de Looker.
- VERIFY_SSL: Puede ser true o false, según si usas encriptación SSL para conectar tu base de datos a tu instancia de Looker.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }

Reinicia Claude para computadoras de escritorio.
En la nueva pantalla de chat, se muestra un ícono de martillo (MCP) con el nuevo servidor de MCP.

Cline

Abre la extensión Cline en VS Code y haz clic en el ícono de MCP Servers.
Haz clic en Configure MCP Servers para abrir el archivo de configuración.
Agrega la siguiente configuración, reemplaza las siguientes variables de entorno por tus valores y, luego, guarda los cambios.
- LOOKER_URL: Es la URL de tu instancia de Looker.
- CLIENT_ID y CLIENT_SECRET: La clave de API que se usa para acceder a la API de Looker.
- VERIFY_SSL: Puede ser true o false, según si usas encriptación SSL para conectar tu base de datos a tu instancia de Looker.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }

Aparece un estado activo de color verde después de que el servidor se conecta correctamente.

Cursor

Crea el directorio .cursor en la raíz del proyecto si no existe.
Crea el archivo .cursor/mcp.json si no existe y ábrelo.
Agrega la siguiente configuración, reemplaza las siguientes variables de entorno por tus valores y, luego, guarda los cambios.
- LOOKER_URL: Es la URL de tu instancia de Looker.
- CLIENT_ID y CLIENT_SECRET: La clave de API que se usa para acceder a la API de Looker.
- VERIFY_SSL: Puede ser true o false, según si usas encriptación SSL para conectar tu base de datos a tu instancia de Looker.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }

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

Visual Studio Code (Copilot)

Abre VS Code y crea el directorio .vscode en la raíz de tu proyecto si no existe.
Crea el archivo .vscode/mcp.json si no existe y ábrelo.
Agrega la siguiente configuración, reemplaza las siguientes variables de entorno por tus valores y, luego, guarda los cambios.
- LOOKER_URL: Es la URL de tu instancia de Looker.
- CLIENT_ID y CLIENT_SECRET: La clave de API que se usa para acceder a la API de Looker.
- VERIFY_SSL: Puede ser true o false, según si usas encriptación SSL para conectar tu base de datos a tu instancia de Looker.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }

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, reemplaza las siguientes variables de entorno por tus valores y, luego, guarda los cambios.
- LOOKER_URL: Es la URL de tu instancia de Looker.
- CLIENT_ID y CLIENT_SECRET: La clave de API que se usa para acceder a la API de Looker.
- VERIFY_SSL: Puede ser true o false, según si usas encriptación SSL para conectar tu base de datos a tu instancia de Looker.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }

Usa herramientas de IA

Tu herramienta de IA ahora está conectada a Looker a través de MCP. Intenta pedirle a tu asistente de IA que enumere los modelos, las Exploraciones, las dimensiones y las medidas. También puedes ejecutar una consulta recuperando el código SQL de una consulta o ejecutando un Look guardado.

Las siguientes herramientas están disponibles para el LLM:

Herramientas de consultas y modelos de Looker

Estas herramientas se usan para obtener información sobre un modelo de Looker y ejecutar consultas en ese modelo.

get_models: Enumera todos los modelos de LookML en tu instancia de Looker.
get_explores: Enumera los Explorar en un modelo determinado.
get_dimensions: Enumera las dimensiones en un Explore determinado.
get_measures: Enumera las medidas en una exploración determinada.
get_filters: Enumera los filtros en un Explorar determinado.
get_parameters: Enumera los parámetros en una exploración determinada.
query: Ejecuta una consulta y devuelve los datos.
query_sql: Devuelve el código SQL que Looker genera para una consulta.
query_url: Devolver un vínculo a la consulta en Looker para una mayor exploración

Herramientas de contenido de Looker

Estas herramientas obtienen contenido guardado (Looks y paneles) de una instancia de Looker y crean contenido guardado nuevo.

get_looks: Devuelve los Looks guardados que coinciden con un título o una descripción.
run_look: Ejecuta un Look guardado y devuelve los datos.
make_look: Crea un Look guardado en Looker y devuelve la URL.
get_dashboards: Devuelve los paneles guardados que coinciden con un título o una descripción.
make_dashboard: Crea un panel guardado en Looker y devuelve la URL.
add_dashboard_element: Agrega una tarjeta a un panel.

Herramientas de estado de la instancia de Looker

Estas herramientas ofrecen los mismos algoritmos de verificación de estado que la popular CLI Henry.

health_pulse: Verifica el estado de una instancia de Looker.
health_analyze: Analiza el uso de un objeto de Looker.
health_vacuum: Busca elementos de LookML que podrían no usarse.

Herramientas de creación de LookML

Estas herramientas permiten que la persona que llama escriba y modifique archivos LookML, además de obtener el esquema de la base de datos necesario para escribir LookML de manera eficaz.

dev_mode: Activa y desactiva el Modo de desarrollo para la sesión. La creación de LookML debe realizarse en el modo de desarrollo. Las consultas que se ejecutan en el modo de desarrollo usan el código LookML modificado para que puedas probar el impacto de tus cambios.
get_projects: Obtén la lista de proyectos de LookML disponibles.
get_project_files: Obtiene la lista de archivos de LookML en un proyecto.
get_project_file: Obtiene el contenido de un archivo de LookML.
create_project_file: Crea un archivo nuevo de LookML.
update_project_file: Modifica un archivo de LookML existente.
delete_project_file: Borra un archivo de LookML.
get_connections: Obtén la lista de conexiones.
get_connection_schemas: Obtén la lista de esquemas para una conexión.
get_connection_databases: Obtén la lista de bases de datos para una conexión.
get_connection_tables: Obtén la lista de tablas para una conexión.
get_connection_table_columns: Obtén la lista de columnas de una tabla en una conexión.