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

Conecta tu IDE a Looker con MCP Toolbox

En esta página, se muestra cómo usar MCP Toolbox para bases de datos y conectar tu instancia de Looker a entornos de desarrollo integrados (IDE) y herramientas para desarrolladores que admitan el Protocolo de contexto del modelo (MCP). Usa estas herramientas para ejecutar consultas e interactuar con Looker. Esta guía está dirigida a los desarrolladores que usan sus IDE y herramientas de desarrollo existentes para trabajar con Looker.

El MCP es un protocolo abierto para conectar modelos de lenguaje grandes (LLM) a fuentes de datos, como Looker. En esta página, se describe cómo usar MCP Toolbox for Databases para exponer tus herramientas de asistencia para desarrolladores a una instancia de Looker con los siguientes IDE:

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

Configurar Looker

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.
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 archivo binario. Selecciona el objeto binario que corresponda a tu SO y arquitectura de CPU. Debes usar la versión V0.10.0 o una posterior de MCP Toolbox.

linux/amd64

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

darwin/arm64

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

darwin/amd64

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

windows/amd64

curl -O https://storage.googleapis.com/genai-toolbox/v0.12.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

CLI de Gemini

Instala la CLI de Gemini.
En tu directorio de trabajo, crea una carpeta llamada .gemini. Dentro de esa carpeta, crea un archivo settings.json.
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",
     }
    }
  }
}

Código de Claude

Instala Claude Code.
Crea el archivo .mcp.json en la raíz del 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

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 Servidores de MCP.
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 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 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.