Esta página se ha traducido con Cloud Translation API.

Conectar tu IDE a Looker con MCP Toolbox

En esta página se explica cómo usar MCP Toolbox para bases de datos con el fin de conectar tu instancia de Looker a entornos de desarrollo integrados (IDEs) y herramientas para desarrolladores que admitan Model Context Protocol (MCP). Usa estas herramientas para ejecutar consultas e interactuar con Looker. Esta guía está dirigida a los desarrolladores que usan sus IDEs y herramientas de desarrollo para trabajar con Looker.

MCP es un protocolo abierto para conectar modelos de lenguaje extenso (LLMs) 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 mediante los siguientes IDEs:

Gemini CLI
Cursor
Windsurf (Codium)
Visual Studio Code (Copilot)
Cline (extensión de VS Code)
Claude para ordenadores
Código de Claude

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.
Tener disponible la URL base de tu instancia de Looker. Es probable que sea algo parecido a https://looker.example.com. En algunos casos, la API está escuchando en un puerto diferente y tendrás que usar https://looker.example.com:19999.

Instalar MCP Toolbox

Descarga la última versión de MCP Toolbox como archivo binario. Selecciona el binario que corresponda a tu sistema operativo y a la arquitectura de tu 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

Convierte el binario en un archivo ejecutable.
```
chmod +x toolbox
```
Verifica la instalación.
```
./toolbox --version
```

Configurar el cliente de MCP

Gemini CLI

Instala la CLI de Gemini.
En tu directorio de trabajo, crea una carpeta llamada .gemini. Dentro de esa carpeta, crea un archivo settings.json.
Añade la siguiente configuración, sustituye las variables de entorno por tus valores y, a continuación, guarda los cambios.
- LOOKER_URL: 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: true o false, en función de si usas el cifrado 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 de tu proyecto, si no existe.
Añade la siguiente configuración, sustituye las variables de entorno por tus valores y, a continuación, guarda los cambios.
- LOOKER_URL: 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: true o false, en función de si usas el cifrado 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 ordenadores

Abre Claude Desktop y ve a Configuración.
En la pestaña Desarrollador, haz clic en Editar configuración para abrir el archivo de configuración.
Añade la siguiente configuración, sustituye las variables de entorno por tus valores y, a continuación, guarda los cambios.
- LOOKER_URL: 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: true o false, en función de si usas el cifrado 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 Desktop.
En la nueva pantalla de chat se muestra un icono de martillo (MCP) con el nuevo servidor MCP.

Cline

Abre la extensión Cline en VS Code y haz clic en el icono Servidores MCP.
Haz clic en Configurar servidores MCP para abrir el archivo de configuración.
Añade la siguiente configuración, sustituye las variables de entorno por tus valores y, a continuación, guarda los cambios.
- LOOKER_URL: 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: true o false, en función de si usas el cifrado 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",
     }
    }
  }
}

Si el servidor se conecta correctamente, aparecerá el estado activo en verde.

Cursor

Crea el directorio .cursor en la raíz de tu proyecto si no existe.
Crea el archivo .cursor/mcp.json si no existe y ábrelo.
Añade la siguiente configuración, sustituye las variables de entorno por tus valores y, a continuación, guarda los cambios.
- LOOKER_URL: 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: true o false, en función de si usas el cifrado 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 ve a Configuración > Configuración del cursor > MCP. Cuando el servidor se conecta, aparece el estado activo en 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.
Añade la siguiente configuración, sustituye las variables de entorno por tus valores y, a continuación, guarda los cambios.
- LOOKER_URL: 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: true o false, en función de si usas el cifrado 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 ve al asistente de Cascade.
Haz clic en el icono de MCP y, a continuación, en Configurar para abrir el archivo de configuración.
Añade la siguiente configuración, sustituye las variables de entorno por tus valores y, a continuación, guarda los cambios.
- LOOKER_URL: 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: true o false, en función de si usas el cifrado 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",
     }
    }
  }
}

Usar herramientas de IA

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

El LLM tiene acceso a las siguientes herramientas:

get_models: muestra todos los modelos de LookML de tu instancia de Looker.
get_explores: muestra los explores de un modelo concreto.
get_dimensions: muestra las dimensiones de una exploración determinada.
get_measures: enumera las medidas de una exploración determinada.
get_filters: muestra los filtros de una Exploración determinada.
get_parameters: muestra los parámetros de una exploración determinada.
query: ejecuta una consulta y devuelve los datos.
query_sql: devuelve el SQL que genera Looker para una consulta.
query_url: devuelve un enlace a la consulta en Looker para que puedas seguir investigando.
get_looks: devuelve los Looks guardados que coincidan con un título o una descripción.
run_look: ejecuta un Look guardado y devuelve los datos.
make_look: crea una vista guardada en Looker y devuelve la URL.
get_dashboards: devuelve los paneles de control guardados que coincidan con un título o una descripción.
make_dashboard: crea un panel de control guardado en Looker y devuelve la URL.
add_dashboard_element: añade una tarjeta a un panel de control.