Questa pagina è stata tradotta dall'API Cloud Translation.

Connetti il tuo IDE a Looker utilizzando MCP Toolbox

Questa pagina mostra come utilizzare MCP Toolbox for databases per connettere l'istanza di Looker a ambienti di sviluppo integrati (IDE) e strumenti per sviluppatori che supportano il Model Context Protocol (MCP). Utilizza questi strumenti per eseguire query e interagire con Looker. Questa guida è rivolta agli sviluppatori che utilizzano gli IDE e gli strumenti per sviluppatori esistenti per lavorare con Looker.

MCP è un protocollo aperto per connettere modelli linguistici di grandi dimensioni (LLM) a origini dati come Looker. Questa pagina descrive come utilizzare MCP Toolbox for Databases per esporre gli strumenti di assistenza per sviluppatori a un'istanza Looker utilizzando i seguenti IDE:

Interfaccia a riga di comando di Gemini
Cursore
Windsurf (Codium)
Visual Studio Code (Copilot)
Cline (estensione VS Code)
Claude desktop
Claude code

Configura Looker

Ottieni un ID client e un client secret di Looker. Segui le istruzioni riportate nella pagina della documentazione Autenticazione API Looker.
Avere a disposizione l'URL di base dell'istanza di Looker. Probabilmente è qualcosa di simile a https://looker.example.com. In alcuni casi, l'API è in ascolto su una porta diversa e dovrai utilizzare https://looker.example.com:19999.

Installare MCP Toolbox

Scarica l'ultima versione di MCP Toolbox come file binario. Seleziona il file binario corrispondente al tuo sistema operativo e all'architettura della CPU. Devi utilizzare MCP Toolbox versione V0.10.0 o successive.

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

Rendi il binario un eseguibile.
```
chmod +x toolbox
```
Verifica l'installazione.
```
./toolbox --version
```

Configura il client MCP

Interfaccia a riga di comando di Gemini

Installa l'interfaccia a riga di comando di Gemini.
Nella directory di lavoro, crea una cartella denominata .gemini. All'interno di questa cartella, crea un file settings.json.
Aggiungi la seguente configurazione, sostituendo le seguenti variabili di ambiente con i tuoi valori, quindi salva.
- LOOKER_URL: l'URL della tua istanza di Looker.
- CLIENT_ID e CLIENT_SECRET: la chiave API utilizzata per accedere all'API Looker.
- VERIFY_SSL: true o false, a seconda che utilizzi la crittografia SSL per connettere il database all'istanza di 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",
     }
    }
  }
}

Codice Claude

Installa Claude Code.
Crea il file .mcp.json nella root del progetto, se non esiste.
Aggiungi la seguente configurazione, sostituendo le seguenti variabili di ambiente con i tuoi valori, quindi salva.
- LOOKER_URL: l'URL della tua istanza di Looker.
- CLIENT_ID e CLIENT_SECRET: la chiave API utilizzata per accedere all'API Looker.
- VERIFY_SSL: true o false, a seconda che utilizzi la crittografia SSL per connettere il database all'istanza di 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 desktop

Apri Claude Desktop e vai a Impostazioni.
Nella scheda Sviluppatore, fai clic su Modifica configurazione per aprire il file di configurazione.
Aggiungi la seguente configurazione, sostituendo le seguenti variabili di ambiente con i tuoi valori, quindi salva.
- LOOKER_URL: l'URL della tua istanza di Looker.
- CLIENT_ID e CLIENT_SECRET: la chiave API utilizzata per accedere all'API Looker.
- VERIFY_SSL: true o false, a seconda che utilizzi la crittografia SSL per connettere il database all'istanza di 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",
     }
    }
  }
}

Riavvia Claude Desktop.
Nella nuova schermata della chat viene visualizzata un'icona a forma di martello (MCP) con il nuovo server MCP.

Cline

Apri l'estensione Cline in VS Code e fai clic sull'icona Server MCP.
Fai clic su Configura server MCP per aprire il file di configurazione.
Aggiungi la seguente configurazione, sostituendo le seguenti variabili di ambiente con i tuoi valori, quindi salva.
- LOOKER_URL: l'URL della tua istanza di Looker.
- CLIENT_ID e CLIENT_SECRET: la chiave API utilizzata per accedere all'API Looker.
- VERIFY_SSL: true o false, a seconda che utilizzi la crittografia SSL per connettere il database all'istanza di 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",
     }
    }
  }
}

Dopo la connessione riuscita del server, viene visualizzato uno stato attivo verde.

Cursore

Crea la directory .cursor nella root del progetto, se non esiste.
Crea il file .cursor/mcp.json se non esiste e aprilo.
Aggiungi la seguente configurazione, sostituendo le seguenti variabili di ambiente con i tuoi valori, quindi salva.
- LOOKER_URL: l'URL della tua istanza di Looker.
- CLIENT_ID e CLIENT_SECRET: la chiave API utilizzata per accedere all'API Looker.
- VERIFY_SSL: true o false, a seconda che utilizzi la crittografia SSL per connettere il database all'istanza di 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",
     }
    }
  }
}

Apri Cursore e vai a Impostazioni > Impostazioni cursore > MCP. Quando il server si connette, viene visualizzato uno stato attivo verde.

Visual Studio Code (Copilot)

Apri VS Code e crea la directory .vscode nella radice del progetto, se non esiste.
Crea il file .vscode/mcp.json se non esiste e aprilo.
Aggiungi la seguente configurazione, sostituendo le seguenti variabili di ambiente con i tuoi valori, quindi salva.
- LOOKER_URL: l'URL della tua istanza di Looker.
- CLIENT_ID e CLIENT_SECRET: la chiave API utilizzata per accedere all'API Looker.
- VERIFY_SSL: true o false, a seconda che utilizzi la crittografia SSL per connettere il database all'istanza di 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

Apri Windsurf e vai all'assistente per le cascate.
Fai clic sull'icona di MCP, quindi su Configura per aprire il file di configurazione.
Aggiungi la seguente configurazione, sostituendo le seguenti variabili di ambiente con i tuoi valori, quindi salva.
- LOOKER_URL: l'URL della tua istanza di Looker.
- CLIENT_ID e CLIENT_SECRET: la chiave API utilizzata per accedere all'API Looker.
- VERIFY_SSL: true o false, a seconda che utilizzi la crittografia SSL per connettere il database all'istanza di 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",
     }
    }
  }
}

Utilizzare gli strumenti di AI

Il tuo strumento di AI è ora connesso a Looker tramite MCP. Prova a chiedere all'assistente AI di elencare modelli, esplorazioni, dimensioni e misure. Puoi anche eseguire una query recuperando l'SQL per una query o eseguendo un Look salvato.

Sono disponibili i seguenti strumenti per il LLM:

get_models: elenca tutti i modelli LookML nell'istanza Looker.
get_explores: Elenca le esplorazioni in un determinato modello.
get_dimensions: Elenca le dimensioni in una determinata esplorazione.
get_measures: Elenca le misure in un'esplorazione specifica.
get_filters: Elenca i filtri in un'esplorazione specifica.
get_parameters: elenca i parametri in una determinata esplorazione.
query: esegui una query e restituisci i dati.
query_sql: restituisce l'SQL generato da Looker per una query.
query_url: restituisce un link alla query in Looker per ulteriori esplorazioni.
get_looks: restituisce i look salvati che corrispondono a un titolo o a una descrizione.
run_look: esegui una Look salvata e restituisci i dati.
make_look: crea un look salvato in Looker e restituisce l'URL.
get_dashboards: restituisce i dashboard salvati che corrispondono a un titolo o a una descrizione.
make_dashboard: crea una dashboard salvata in Looker e restituisce l'URL.
add_dashboard_element: aggiungi un riquadro a una dashboard.