1. Antes de comenzar
Debes tener acceso a una instancia de Looker en ejecución. Necesitarás un client_id y un client_secret de la API.
Requisitos previos
- Tener una instancia de Looker en ejecución
- Tener acceso a una línea de comandos de Linux o macOS
Qué aprenderás
- Cómo instalar Gemini CLI
- Cómo instalar MCP Toolbox
- Cómo conectar Gemini CLI a Looker con MCP Toolbox
Requisitos
- La URL del servidor de la API de Looker. Por lo general, es la misma que la URL de Looker, pero es posible que debas agregar un número de puerto, como
:19999. Por ejemplo:https://looker.example.com:19999. Si las cosas no funcionan correctamente, intenta comunicarte con tu administrador de Looker.
2. Preparaciones
Debes recuperar un client_id y un client_secret.
Accede a tu instancia de Looker y haz clic en el perfil de usuario en la esquina superior derecha de la pantalla. Selecciona Cuenta. En la pantalla Cuenta, junto a la etiqueta API Keys, presiona el botón Manage.
En la página de administración de Claves de API, presiona el botón Create New API Key.
En la entrada recién creada, agrega el propósito MCP Toolbox o algo similar y haz clic en la marca de verificación para guardarlo. Luego, copia y pega el client_id y el client_secret en un lugar seguro. Deberás presionar el ícono de ojo junto al secreto para verlo y copiarlo.
Ahora puedes cerrar las ventanas del navegador de Looker.
3. Instala Gemini CLI
Abre la app de la terminal para acceder a una línea de comandos de macOS o Linux.
Ejecuta el siguiente comando:
npm install -g @google/gemini-cli
Si falla por algún motivo, consulta https://github.com/google-gemini/gemini-cli?tab=readme-ov-file#-installation para obtener opciones de instalación o ayuda.
Ahora ejecuta Gemini CLI con este comando:
gemini
Se te pedirá que accedas. Sigue esas instrucciones y deberías estar listo para comenzar.
4. Instala MCP Toolbox
Crea el directorio de MCP Toolbox
En la app de la terminal, crea un directorio mcp-toolbox. Luego, ingresa ese directorio:
mkdir $HOME/mcp-toolbox
cd $HOME/mcp-toolbox
Identifica la arquitectura del sistema
Ejecuta el comando uname para averiguar qué tipo de sistema tienes:
uname -a
Este comando mostrará una cadena similar a la siguiente:
Linux hostname.example.com 6.16.12-amd64 #1 SMP PREEMPT_DYNAMIC Debian 6.16.12 (2025-11-10) x86_64 GNU/Linux
Presta mucha atención al final de esa línea. Si usas Linux, terminará con x86_64 GNU/Linux. En el caso de macOS, indicará Darwin y arm64 para el procesador de Apple o x86_64 i386 para el procesador de Intel cerca del final de esa cadena.
Descarga MCP Toolbox
Si tienes Linux, ejecuta el siguiente comando para descargar MCP Toolbox:
curl https://storage.googleapis.com/mcp-toolbox-for-databases/v1.0.0/linux/amd64/toolbox
Si tienes macOS con un procesador de Apple, ejecuta el siguiente comando para descargar MCP Toolbox:
curl https://storage.googleapis.com/mcp-toolbox-for-databases/v1.0.0/darwin/arm64/toolbox
Si tienes macOS con un procesador de Intel, ejecuta el siguiente comando para descargar MCP Toolbox:
curl https://storage.googleapis.com/mcp-toolbox-for-databases/v1.0.0/darwin/amd64/toolbox
Haz que MCP Toolbox sea ejecutable
Para que el programa MCP Toolbox sea ejecutable, ejecuta el siguiente comando:
chmod +x toolbox
Obtén la ruta de acceso completa a la caja de herramientas
Para obtener la ruta de acceso completa al archivo de la caja de herramientas, ejecuta el siguiente comando:
echo $HOME/mcp-toolbox/toolbox
Probablemente, el resultado sea similar al siguiente:
/home-or-User/YOUR-USER-NAME/mcp-toolbox/toolbox
Guarda el resultado en un lugar conveniente.
5. Configura Gemini CLI
Edita el archivo $HOME/.gemini/settings.json. Usa tu editor de texto preferido. Si no editas archivos en Linux o macOS con mucha frecuencia, nano es una buena opción.
Agrega la siguiente estrofa al archivo json:
"mcpServers": {
"looker": {
"command": "FULL_PATH_TO_TOOLBOX",
"args": [
"--stdio",
"--prebuilt",
"looker,looker-dev"
],
"env": {
"LOOKER_BASE_URL": "URL_OF_LOOKER_INSTANCE",
"LOOKER_CLIENT_ID": "CLIENT_ID",
"LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
"LOOKER_VERIFY_SSL": "true"
}
}
}
Sustituye la información que guardaste en los pasos anteriores por FULL_PATH_TO_TOOLBOX, URL_OF_LOOKER_INSTANCE, CLIENT_ID y CLIENT_SECRET. Guarda el archivo editado.
6. Usa MCP Toolbox con Gemini CLI
Para iniciar Gemini CLI, ingresa gemini en la línea de comandos.
Para enumerar las herramientas disponibles, escribe lo siguiente en la instrucción de Gemini:
/mcp list looker
El resultado debería tener un aspecto similar al siguiente:
Configured MCP servers: 🟢 looker - Ready (33 tools) Tools: - add_dashboard_element - add_dashboard_filter - create_project_file - delete_project_file - dev_mode - generate_embed_url - get_connection_databases - get_connection_schemas - get_connection_table_columns - get_connection_tables - get_connections - get_dashboards - get_dimensions - get_explores - get_filters - get_looks - get_measures - get_models - get_parameters - get_project_file - get_project_files - get_projects - health_analyze - health_pulse - health_vacuum - make_dashboard - make_look - query - query_sql - query_url - run_dashboard - run_look - update_project_file
Ahora comienza a preguntarle a Gemini CLI sobre los datos disponibles. Prueba con lo siguiente:
- ¿Qué modelos están disponibles en Looker?
- ¿Qué exploraciones están disponibles en MODEL_NAME?
- ¿Qué mediciones y dimensiones están disponibles en EXPLORE_NAME?
Sustituye tus propios valores por MODEL_NAME y EXPLORE_NAME.
A continuación, intenta realizar algunas consultas en lenguaje natural que puedan responder los datos de tu instancia de Looker: "¿Cuáles son mis ingresos totales para 2025?", "¿Cuántos widgets vendí en el cuarto trimestre?", etc.
7. Más instrucciones para probar
También puedes intentar ejecutar vistas y paneles guardados, crear vistas y paneles, e incluso editar modelos de LookML.
- Para ejecutar una vista guardada, ingresa una instrucción como "Ejecuta la vista ‘Inventario mensual’". Gemini debería buscar una vista llamada "Inventario mensual", ejecutar la consulta asociada y compartir los resultados.
- Para ejecutar un panel, da una instrucción como "Resume el panel ‘Seguimiento de clientes’". Gemini debería buscar un panel llamado "Seguimiento de clientes", ejecutar las consultas asociadas con cada mosaico y dar un resumen.
- Para crear una vista guardada, prueba con una instrucción como "Crea una vista para hacer un seguimiento de mis ingresos mensuales desglosados por categoría de producto. Muestra los datos como un gráfico de columnas apiladas".
- Para crear un panel, prueba con una instrucción como "Crea un panel de tendencias de ventas para el año 2026".
Si eres desarrollador de LookML, puedes modificar LookML con Gemini. Experimenta con instrucciones como las siguientes:
- Pídele a Gemini que obtenga la lista de proyectos de LookML con "¿Qué proyectos de LookML están disponibles?".
- Pídele a Gemini que recupere los archivos del proyecto de la lista. "¿Qué archivos están disponibles en el proyecto PROJECT_NAME?". Sustituye el nombre de tu proyecto.
- Pídele a Gemini que agregue una medición. "Crea una medición para promediar el campo sales_price en la vista VIEW_NAME". Sustituye el nombre de tu vista.
- Recupera la lista de conexiones con "¿Qué conexiones están disponibles en Looker?".
- Obtén los esquemas asociados. "¿Qué esquemas hay en CONNECTION_NAME?". Sustituye el nombre de tu conexión.
- Obtén las tablas asociadas. "¿Qué tablas hay en CONNECTION_NAME en el esquema SCHEMA_NAME?". Sustituye los nombres de tu conexión y esquema.
- Obtén las columnas de una tabla. "¿Qué columnas hay en TABLE_NAME?". Sustituye el nombre de tu tabla.
- Ahora pídele a Gemini que agregue una columna a una vista de LookML. "Crea una dimensión para la columna COLUMN_NAME". Sustituye el nombre de tu columna.
Usa la IU de Looker para probar los cambios y, posiblemente, confirmarlos. Gemini y MCP Toolbox no pueden confirmar los cambios de LookML ni enviarlos a producción.