1. Prima di iniziare
Dovresti avere accesso a un'istanza Looker in esecuzione. Avrai bisogno di un client_id e di un client_secret dell'API.
Prerequisiti
- Avere un'istanza Looker in esecuzione
- Avere accesso a una riga di comando Linux o macOS
Cosa imparerai a fare
- Come installare Gemini CLI
- Come installare MCP Toolbox
- Come connettere Gemini CLI a Looker utilizzando MCP Toolbox
Che cosa ti serve
- L'URL del server API Looker. In genere è lo stesso dell'URL di Looker, ma potrebbe essere necessario aggiungere un numero di porta, ad esempio
:19999, ad esempio:https://looker.example.com:19999. Se le cose non funzionano correttamente, prova a chiedere al tuo amministratore di Looker.
2. Preparativi
Devi recuperare un client_id e un client_secret.
Accedi all'istanza Looker e fai clic sul profilo utente nell'angolo in alto a destra dello schermo. Seleziona Account. Nella schermata Account, accanto all'etichetta API Keys, premi il pulsante Manage.
Nella pagina di gestione delle chiavi API, premi il pulsante Create New API Key.
Nella voce appena creata, aggiungi lo scopo MCP Toolbox o qualcosa di simile e fai clic sul segno di spunta per salvarlo. Quindi copia e incolla il client_id e il client_secret in un luogo sicuro. Dovrai premere l'icona a forma di occhio accanto al secret per visualizzarlo e copiarlo.
Ora puoi chiudere le finestre del browser Looker.
3. Installazione di Gemini CLI
Apri l'app Terminale per accedere a una riga di comando macOS o Linux.
Esegui questo comando:
npm install -g @google/gemini-cli
Se non va a buon fine per qualsiasi motivo, consulta la pagina https://github.com/google-gemini/gemini-cli?tab=readme-ov-file#-installation per le opzioni di installazione o per ricevere assistenza.
Ora esegui Gemini CLI con questo comando:
gemini
Ti verrà chiesto di accedere. Segui queste istruzioni e dovresti essere pronto per iniziare.
4. Installazione di MCP Toolbox
Creazione della directory di MCP Toolbox
Nell'app Terminale, crea una directory mcp-toolbox. Quindi inserisci questa directory:
mkdir $HOME/mcp-toolbox
cd $HOME/mcp-toolbox
Identificazione dell'architettura di sistema
Esegui il comando uname per scoprire il tipo di sistema in cui ti trovi:
uname -a
Questo comando restituirà una stringa simile alla seguente:
Linux hostname.example.com 6.16.12-amd64 #1 SMP PREEMPT_DYNAMIC Debian 6.16.12 (2025-11-10) x86_64 GNU/Linux
Presta attenzione alla fine della riga. Se utilizzi Linux, la riga terminerà con x86_64 GNU/Linux. Per macOS, la riga indicherà Darwin e arm64 per il processore Apple o x86_64 i386 per il processore Intel verso la fine della stringa.
Download di MCP Toolbox
Se utilizzi Linux, esegui questo comando per scaricare MCP Toolbox:
curl https://storage.googleapis.com/genai-toolbox/v0.26.0/linux/amd64/toolbox
Se utilizzi macOS con un processore Apple, esegui questo comando per scaricare MCP Toolbox:
curl https://storage.googleapis.com/genai-toolbox/v0.26.0/darwin/arm64/toolbox
Se utilizzi macOS con un processore Intel, esegui questo comando per scaricare MCP Toolbox:
curl https://storage.googleapis.com/genai-toolbox/v0.26.0/darwin/amd64/toolbox
Rendere eseguibile MCP Toolbox
Rendi eseguibile il programma MCP Toolbox eseguendo questo comando:
chmod +x toolbox
Recupero del percorso completo di Toolbox
Recupera il percorso completo del file Toolbox eseguendo questo comando:
echo $HOME/mcp-toolbox/toolbox
Probabilmente il risultato sarà simile al seguente:
/home-or-User/YOUR-USER-NAME/mcp-toolbox/toolbox
Salva il risultato in un luogo comodo.
5. Configurazione di Gemini CLI
Modifica il file $HOME/.gemini/settings.json. Utilizza l'editor di testo che preferisci. Se non modifichi spesso i file in Linux o macOS, nano è una buona scelta.
Aggiungi la seguente sezione al file 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"
}
}
}
Sostituisci le informazioni salvate nei passaggi precedenti con FULL_PATH_TO_TOOLBOX, URL_OF_LOOKER_INSTANCE, CLIENT_ID e CLIENT_SECRET. Salva il file modificato.
6. Utilizzo di MCP Toolbox con Gemini CLI
Avvia Gemini CLI inserendo gemini nella riga di comando.
Elenca gli strumenti disponibili digitando quanto segue al prompt di Gemini:
/mcp list looker
Il risultato dovrebbe avere un aspetto simile al seguente:
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
Ora inizia a chiedere a Gemini CLI informazioni sui dati disponibili. Prova alcune delle seguenti opzioni:
- Quali modelli sono disponibili in Looker?
- Quali esplorazioni sono disponibili in MODEL_NAME?
- Quali misure e dimensioni sono disponibili in EXPLORE_NAME?
Sostituisci i tuoi valori per MODEL_NAME e EXPLORE_NAME.
Poi, prova a eseguire alcune query in linguaggio naturale a cui i dati nell'istanza Looker possono rispondere: "Qual è il mio fatturato totale per il 2025?", "Quanti widget ho venduto nel quarto trimestre?", ecc.
7. Altri prompt da provare
Puoi anche provare a eseguire Look e dashboard salvati, creare Look e dashboard e persino modificare i modelli LookML.
- Esegui un Look salvato inserendo un prompt come "Esegui il Look 'Inventario mensile'." Gemini dovrebbe cercare un Look denominato "Inventario mensile", quindi eseguire la query associata e condividere i risultati.
- Esegui una dashboard fornendo un prompt come "Riassumi la dashboard 'Monitoraggio clienti'." Gemini dovrebbe cercare una dashboard denominata "Monitoraggio clienti", eseguire le query associate a ogni riquadro e fornire un riepilogo.
- Per creare un Look salvato, prova un prompt come "Crea un Look per monitorare il mio fatturato mensile suddiviso per categoria di prodotto. Visualizza i dati come un grafico a colonne in pila."
- Per creare una dashboard, prova un prompt come "Creami una dashboard di monitoraggio delle vendite per l'anno 2026."
Se sei uno sviluppatore LookML, puoi modificare LookML con Gemini. Sperimenta con prompt come questi:
- Chiedi a Gemini di recuperare l'elenco dei progetti LookML con "Quali progetti LookML sono disponibili?"
- Chiedi a Gemini di recuperare i file di progetto dell'elenco. "Quali file sono disponibili nel progetto PROJECT_NAME?" Sostituisci il nome del progetto.
- Chiedi a Gemini di aggiungere una misura. "Crea una misura per calcolare la media del campo sales_price nella vista VIEW_NAME." Sostituisci il nome della vista.
- Recupera l'elenco delle connessioni con "Quali connessioni sono disponibili in Looker?"
- Recupera gli schemi associati. "Quali schemi sono in CONNECTION_NAME?" Sostituisci il nome della connessione.
- Recupera le tabelle associate. "Quali tabelle sono in CONNECTION_NAME nello schema SCHEMA_NAME?" Sostituisci i nomi della connessione e dello schema.
- Recupera le colonne di una tabella. "Quali colonne sono in TABLE_NAME?" Sostituisci il nome della tabella.
- Ora chiedi a Gemini di aggiungere una colonna a una vista LookML. "Crea una dimensione per la colonna COLUMN_NAME." Sostituisci il nome della colonna.
Utilizza l'interfaccia utente di Looker per testare le modifiche e, se necessario, eseguirne il commit. Gemini e MCP Toolbox non possono eseguire il commit delle modifiche LookML e inviarle alla produzione.