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, la CLI de Gemini es la herramienta recomendada 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 la CLI de Gemini 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

La CLI de Gemini 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

  1. Obtén un ID de cliente y un secreto de cliente de Looker. Sigue las instrucciones de la página de documentación sobre la autenticación de la API de Looker.
  2. 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

  1. Descarga la versión más reciente de MCP Toolbox como un archivo 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

  2. Haz que el objeto binario sea ejecutable.

    chmod +x toolbox
    
  3. 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 conectarse a tu instancia de Looker con MCP Toolbox for Databases. 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

  1. Instala la CLI de Gemini.
  2. Instala la extensión de Looker para la CLI de Gemini desde el repositorio de GitHub con el siguiente comando:
    gemini extensions install https://github.com/gemini-cli-extensions/looker
    
  3. 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"
    
  4. Inicia Gemini CLI en modo interactivo:
    gemini
    
    La CLI carga automáticamente la extensión de Looker para la extensión de la CLI de Gemini 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 la CLI de Gemini. Este enfoque elimina la necesidad de configurar manualmente un servidor de MCP.

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

Claude Code

  1. Instala Claude Code.
  2. Crea el archivo .mcp.json en la raíz de tu proyecto si no existe.
  3. 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

  1. Abre Claude Desktop y navega a Configuración.
  2. En la pestaña Desarrollador, haz clic en Editar configuración para abrir el archivo de configuración.
  3. 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",
          }
          }
        }
      }
  
  1. Reinicia Claude para computadoras de escritorio.
  2. En la nueva pantalla de chat, se muestra un ícono de martillo (MCP) con el nuevo servidor de MCP.

Cline

  1. Abre la extensión Cline en VS Code y haz clic en el ícono de Servidores de MCP.
  2. Haz clic en Configure MCP Servers para abrir el archivo de configuración.
  3. 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 verde después de que el servidor se conecta correctamente.

Cursor

  1. Crea el directorio .cursor en la raíz del proyecto si no existe.
  2. Crea el archivo .cursor/mcp.json si no existe y ábrelo.
  3. 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",
          }
          }
        }
      }
  
  1. 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)

  1. Abre VS Code y crea el directorio .vscode en la raíz de tu proyecto si no existe.
  2. Crea el archivo .vscode/mcp.json si no existe y ábrelo.
  3. 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

  1. Abre Windsurf y navega al asistente de Cascade.
  2. Haz clic en el ícono de MCP y, luego, en Configurar para abrir el archivo de configuración.
  3. 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 muestre una lista de modelos, Exploraciones, dimensiones y 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:

  • 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 una exploración determinada.
  • 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: Devuelve un vínculo a la consulta en Looker para una mayor exploración.
  • 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.