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
- Es 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, consulta 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. Seleccione 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 del 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 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 ver las opciones de instalación o solicitar 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 la caja de herramientas de MCP
En la app de terminal, crea un directorio mcp-toolbox. Luego, ingresa a 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 devolverá 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 macOS, se indicará Darwin y arm64 para el procesador de Apple o x86_64 i386 para el procesador de Intel cerca del final de esa cadena.
Descargar MCP Toolbox
Si tienes Linux, ejecuta el siguiente comando para descargar MCP Toolbox:
curl https://storage.googleapis.com/genai-toolbox/v0.26.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/genai-toolbox/v0.26.0/darwin/arm64/toolbox
Si tienes macOS con un procesador Intel, ejecuta el siguiente comando para descargar MCP Toolbox:
curl https://storage.googleapis.com/genai-toolbox/v0.26.0/darwin/amd64/toolbox
Cómo hacer que MCP Toolbox sea ejecutable
Ejecuta el siguiente comando para que el programa de MCP Toolbox sea ejecutable:
chmod +x toolbox
Cómo obtener la ruta de acceso completa a la caja de herramientas
Ejecuta el siguiente comando para obtener la ruta de acceso completa al archivo de la caja de herramientas:
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"
],
"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 hacerle preguntas a Gemini CLI sobre los datos disponibles. Prueba alguna de las siguientes opciones:
- ¿Qué modelos están disponibles en Looker?
- ¿Qué exploraciones están disponibles en MODEL_NAME?
- ¿Qué medidas 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 se puedan responder con los datos de tu instancia de Looker: "¿Cuáles son mis ingresos totales para el 2025?". "¿Cuántos widgets vendí en el cuarto trimestre?", etcétera.
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.
- Ejecuta una vista guardada ingresando una instrucción como "Ejecuta la vista ‘Inventario mensual’". Gemini debería buscar una vista llamada "Inventario mensual", ejecutar la búsqueda asociada y compartir los resultados.
- Ejecuta un panel con una instrucción como "Resume el panel "Seguimiento de clientes"". Gemini debe buscar un panel llamado "Seguimiento de clientes", ejecutar las consultas asociadas a cada tarjeta y proporcionar un resumen.
- Para crear un Look guardado, prueba con una instrucción como "Crea un Look 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 control 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 la lista de proyectos de LookML con la instrucción "¿Qué proyectos de LookML están disponibles?".
- Pídele a Gemini que recupere la lista de archivos del proyecto. "¿Qué archivos están disponibles en el proyecto PROJECT_NAME?" Sustituye el nombre de tu proyecto.
- Dale instrucciones a Gemini para que agregue una medida. "Crea una medición para calcular el promedio del campo sale_price en la vista VIEW_NAME". Sustituye el nombre de tu propia 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 tu propio nombre de conexión.
- Obtiene las tablas asociadas. "¿Qué tablas hay en CONNECTION_NAME en el esquema SCHEMA_NAME?" Sustituye tus propios nombres de conexión y esquema.
- Obtiene las columnas de una tabla. "¿Qué columnas hay en TABLE_NAME?" Sustituye el nombre de tu propia 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 tu propio nombre de columna.
Usa la IU de Looker para probar los cambios y, posiblemente, confirmarlos. Las herramientas de Gemini y MCP no pueden confirmar los cambios de LookML ni enviarlos a producción.