Server MCP gestito da Looker
Il server MCP gestito da Looker è un'integrazione integrata che incorpora un server Model Context Protocol (MCP) direttamente nella piattaforma Looker. Consente ai client MCP, come gli agenti AI e gli IDE (ad esempio, Gemini CLI, Claude Desktop, Cursor e Copilot), di connettersi in modo sicuro a un'istanza di Looker e interagire con i dati aziendali e i modelli LookML.
Ospitando il server, Looker elimina la necessità di eseguire il deployment e la manutenzione della tua infrastruttura middleware, fornendo un gateway plug-and-play, sicuro e regolamentato per insight aziendali affidabili.
Se utilizzi un'istanza ospitata dal cliente o se preferisci gestire la tua infrastruttura, puoi connetterti utilizzando MCP Toolbox for Databases autonomo. MCP Toolbox è un server MCP open source che puoi eseguire sul tuo computer locale o sul tuo server per fungere da ponte tra gli agenti AI e la tua istanza di Looker. Per ulteriori informazioni, consulta la pagina della documentazione Utilizza Looker con MCP, Gemini CLI e altri agenti.
Prima di iniziare
Per utilizzare il server MCP gestito da Looker, devi soddisfare i seguenti requisiti:
Requisiti dell'istanza
- Devi utilizzare un'istanza di Looker (Google Cloud core) o di Looker (originale).
- L'istanza deve essere ospitata da Looker.
Autorizzazioni obbligatorie
- Per gestire l'accesso allo strumento: devi disporre del ruolo Looker Amministratore.
- Per registrare o abilitare l'agente AI come client OAuth: devi disporre del ruolo Looker Amministratore.
- Per connettere un agente AI al server MCP gestito da Looker: devi disporre delle credenziali di accesso standard di Looker per l'autenticazione durante il processo di connessione OAuth. L'agente AI deve prima essere registrato come client OAuth da un amministratore di Looker. Una volta connesso, l'agente AI erediterà i ruoli e l'accesso di Looker dell'utente che ha eseguito l'autenticazione.
Configura il server MCP gestito
Configura l'accesso allo strumento per configurare il server MCP gestito.
Configura le impostazioni dello strumento
Per impostazione predefinita, tutti gli strumenti MCP sono disabilitati per il server MCP gestito. Gli amministratori di Looker devono abilitare esplicitamente gli strumenti MCP che i client MCP possono utilizzare. Per i passaggi per attivare gli strumenti, consulta la pagina della documentazione Impostazioni amministratore - MCP (Model Context Protocol).
Configura le impostazioni CORS
Se il client MCP è in esecuzione direttamente in un browser web e vuole comunicare con il server MCP gestito da Looker utilizzando CORS, l'amministratore di Looker deve aggiungere il dominio del sito web del client alla lista consentita dei domini incorporati nel pannello Amministratore.
Registra un client MCP tramite OAuth
Per connettere un client MCP al server MCP gestito da Looker, un amministratore deve abilitarlo o registrarlo come applicazione client OAuth nella pagina Gestisci client OAuth nel pannello di amministrazione Amministratore di Looker.
Puoi attivare i client MCP preconfigurati dalla scheda Libreria delle applicazioni o registrare un client personalizzato nella scheda Client personalizzati:
- Libreria di applicazioni (consigliata): utilizza le registrazioni dei client OAuth preconfigurate e gestite da Looker per gli agenti AI e gli IDE più diffusi, come Cursor, VS Code, Claude Code, Claude Desktop, ChatGPT, Gemini CLI, Cline, Windsurf, Antigravity e l'estensione Looker per VS Code.
- Client personalizzati: registra un nuovo client OAuth personalizzato se il tuo client MCP non è disponibile nella scheda Libreria di applicazioni o se devi configurare un URI o una porta di reindirizzamento personalizzati.
Opzione 1: attiva un client MCP preconfigurato dalla libreria delle applicazioni
Ti consigliamo di controllare prima la scheda Libreria delle applicazioni.
Per attivare un client MCP preconfigurato, segui questi passaggi:
- Nel pannello Amministratore di Looker, vai alla sezione Autenticazione e seleziona Gestisci client OAuth.
- Seleziona la scheda Libreria di applicazioni.
- Individua l'applicazione client (ad esempio Cursor, Claude Code, Cline o Gemini CLI). Puoi utilizzare la barra di ricerca per filtrare in base al nome.
- Imposta l'opzione Attiva su ON.
- Copia l'ID client visualizzato nella riga del client. Questo ID client è necessario per configurare le impostazioni del client MCP (ad esempio, in
mcp.jsono nei flag di avvio). Se gli utenti di Looker che non dispongono del ruolo di amministratore di Looker devono utilizzare questo client, distribuisci loro l'ID client.
URI di reindirizzamento e gestione dinamica delle porte
Looker richiede che gli URI di reindirizzamento OAuth corrispondano esattamente ai valori registrati e non supporta gli URI di reindirizzamento con caratteri jolly. Alcuni client MCP utilizzano porte locali dinamiche o temporanee per impostazione predefinita quando avviano un callback OAuth (ad esempio Claude Code o Cline). Per supportare questi client, Looker preregistra una porta predefinita fissa per ogni client di libreria (ad esempio, la porta 8080 per Claude Code e Cline o la porta 7777 per Gemini CLI).
Per utilizzare un client di libreria preconfigurato con porte dinamiche, scegli una delle seguenti opzioni:
- Configura il client in modo che utilizzi la porta statica preregistrata: nelle impostazioni o nel comando di avvio del client, specifica la porta preregistrata. Ad esempio:
- Claude Code: esegui Claude Code con il flag
--callback-port 8080(o configura"callbackPort": 8080inmcp.json). - Cline: configura la porta di callback OAuth su
8080. - Gemini CLI: imposta la variabile di ambiente
export OAUTH_CALLBACK_PORT=7777. - VS Code: utilizza l'URI statico preregistrato
http://127.0.0.1:33418/.
- Claude Code: esegui Claude Code con il flag
- Registra un client personalizzato: se devi utilizzare una porta diversa o un URL di callback personalizzato, registra un client personalizzato con l'URI di reindirizzamento che preferisci, come descritto nella sezione successiva.
Opzione 2: registra un client MCP personalizzato
Se il tuo client MCP non è incluso nella scheda Libreria di applicazioni o se devi utilizzare un URL o una porta di callback personalizzati, completa i passaggi descritti nella documentazione Impostazioni amministratore - Gestisci i client OAuth per registrare un client personalizzato. Dopo aver aggiunto il client, copia l'ID client da utilizzare per configurare il client MCP.
Registrazione programmatica (Explorer API o API)
Per i deployment automatizzati (come le pipeline CI/CD o gli script di provisioning), gli amministratori di Looker possono registrare i client OAuth in modo programmatico.
Espandi questa sezione per scoprire come registrare un client OAuth utilizzando l'API o Explorer API.
Puoi registrare un client OAuth utilizzando l'endpoint API oauth_client_apps direttamente con curl:
curl -X POST "https://LOOKER_INSTANCE_URL/api/4.0/oauth_client_apps/CLIENT_GUID" \
-H "Authorization: token ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"redirect_uri": "REDIRECT_URI",
"display_name": "CLIENT_NAME",
"description": "OAuth client to access MCP server using CLIENT_NAME",
"enabled": true
}'
In alternativa, puoi utilizzare Explorer API di Looker:
- Nella sezione del metodo Auth, individua l'endpoint API Register OAuth App.
- Fai clic su Esegui, inserisci
CLIENT_GUID,redirect_uri,display_nameedescription, seleziona la casella di controllo di conferma e poi fai clic su Esegui.- Gemini CLI
http://localhost:7777/oauth/callback
Nota: alcuni client MCP, come Gemini CLI, potrebbero richiedere l'impostazione di una variabile di ambiente (ad esempio
export OAUTH_CALLBACK_PORT=7777) per garantire che i client utilizzino una porta statica corrispondente all'URI di reindirizzamento registrato. - Gemini Code Assist
http://localhost:7777/oauth/callback
Ti consigliamo di utilizzare Gemini CLI con Gemini Code Assist, in modo che condividano lo stesso server di callback locale e la stessa configurazione della porta.
- Gemini Enterprise
https://vertexaisearch.cloud.google.com/oauth-redirect
- Claude Code
Claude Code utilizza una porta casuale disponibile per il callback OAuth, ma devi correggerla utilizzando il flag
(o con l'impostazione--callback-port 8080callbackPortinmcp.json) in modo che corrisponda all'URI registrato.http://localhost:8080/callback
- VS Code
Per VS Code, utilizza il seguente URI.
http://127.0.0.1:33418/
Nota: lo slash finale (
/) alla fine dell'URI è obbligatorio. - App in hosting su cloud
Per le applicazioni in hosting su cloud, potrebbe avere l'aspetto di un URL HTTPS sicuro:
https://AI_AGENT_URL/oauth2callback
- App locali
Per le applicazioni in esecuzione in locale, l'URI di reindirizzamento deve essere un URL localhost con una porta statica:
http://localhost:7777/oauth/callback
- Gemini CLI
- Per verificare la registrazione, esegui l'endpoint Get OAuth Client App con il tuo
CLIENT_GUID.
Configura il client MCP
Una volta registrata l'applicazione come client OAuth, puoi connetterla all'endpoint MCP gestito come client MCP. Per completare la configurazione, consulta la documentazione del client.
- URL server:
LOOKER_INSTANCE_URL/mcp - Autenticazione: OAuth 2.1
Esempi di configurazioni (mcp.json)
Questa sezione descrive come configurare vari client MCP per connettersi alla tua istanza di Looker utilizzando il server MCP gestito da Looker. Il server MCP si trova tra il client e Looker, fornendo un control plane sicuro e regolamentato per gli strumenti MCP. Seleziona la scheda relativa al tuo client specifico per visualizzare le istruzioni di configurazione.
Gemini CLI
Configura Gemini CLI per connetterti direttamente al server MCP gestito da Looker.
- Installa Gemini CLI.
- Aggiungi il server MCP remoto utilizzando il seguente comando, sostituendo
LOOKER_INSTANCE_URLcon l'URL della tua istanza di Looker:gemini mcp add --transport http looker LOOKER_INSTANCE_URL/mcp
In alternativa, puoi configurarlo manualmente aggiungendo la seguente configurazione al file
settings.json(che si trova in~/.gemini/settings.jsono nella directory del progetto):{ "mcpServers": { "looker": { "httpUrl": "LOOKER_INSTANCE_URL/mcp", "oauth": { "clientId": "CLIENT_GUID" } } } } - Avvia Gemini CLI in modalità interattiva:
Quando ti viene chiesto di connetterti, l'interfaccia a riga di comando avvia il flusso di autorizzazione OAuth per l'autenticazione sicura con l'istanza Looker.gemini
Gemini Code Assist
Ti consigliamo di configurare Gemini Code Assist per utilizzare Gemini CLI. Questo approccio elimina la necessità di configurare manualmente un server MCP.
- Assicurati di aver installato e configurato Gemini CLI e il server MCP gestito da Looker.
- Configura Gemini Code Assist per utilizzare Gemini CLI.
- Inizia a interagire con la tua istanza di Looker utilizzando il linguaggio naturale direttamente nella chat di Gemini Code Assist.
Gemini Enterprise
Configura Gemini Enterprise per connetterti al server MCP gestito da Looker come datastore del server MCP personalizzato.
- Segui la documentazione ufficiale per creare un datastore del server MCP personalizzato in Gemini Enterprise.
- Per la configurazione del datastore, utilizza i seguenti valori, sostituendo
LOOKER_INSTANCE_URLcon l'URL dell'istanza di Looker eCLIENT_GUIDcon la stringa esatta che hai utilizzato durante la registrazione dell'app OAuth:{ "instance_uri": "LOOKER_INSTANCE_URL/mcp", "auth_uri": "LOOKER_INSTANCE_URL/auth", "auth_uri_params": "&response_type=code&code_challenge_method=S256", "token_uri": "LOOKER_INSTANCE_URL/api/token", "client_id": "CLIENT_GUID", "client_secret": "none", "scopes": "cors_api", "pkce_support_enabled": "true" }PKCE non richiede un client secret OAuth, ma Gemini Enterprise richiede un valore nel campo
client_secret. Puoi inserirenonecome mostrato nella configurazione di esempio. - Per procedere, esegui l'autenticazione tramite OAuth.
- Imposta la descrizione del server MCP per aiutare Gemini a capire quando richiamarlo. Ad esempio:
Looker Agent with API access to various aspects of Looker. Primarily used to fetch data and run dashboards from Looker.
- Definisci le istruzioni dell'agente del server MCP. Ad esempio:
Use this server exclusively to interact with the Looker instance for monitoring health, checking status, and retrieving data. Invoke the Looker MCP server for the following request categories: - Instance Health Checks: Auditing connection status, uptime, performance metrics, or system errors. - Analytics Queries & Data Retrieval: Fetching live business metrics from Explores, Looks, or Dashboards. Strict Constraints: - No Local Estimation: Do not guess. Always fetch real-time data via MCP tools. - Fallback Behavior: Inform the user of connectivity failures immediately.
- Vai alla scheda Azioni nel datastore MCP personalizzato che hai appena creato e attiva gli strumenti che vuoi che Gemini Enterprise utilizzi.
- Completa la configurazione andando su Gemini Enterprise, facendo clic sull'icona Connettore e autorizzando il server MCP.
Claude Code
- Installa Claude Code.
- Crea il file
.mcp.jsonnella directory root del progetto, se non esiste. - Aggiungi la seguente configurazione, sostituendo
LOOKER_INSTANCE_URLcon l'URL della tua istanza di Looker eCLIENT_GUIDcon il GUID del tuo client OAuth, quindi salva.
{
"mcpServers": {
"looker": {
"type": "http",
"url": "LOOKER_INSTANCE_URL/mcp",
"oauth": {
"clientId": "CLIENT_GUID",
"callbackPort": 8080
}
}
}
}
Claude per computer
- In Claude per computer, vai a Impostazioni e seleziona Connettori.
- Scegli Aggiungi connettore personalizzato e inserisci un nome (ad esempio, Looker).
- Per l'URL, inserisci l'URL dell'istanza di Looker con il percorso
/mcpaggiunto (ad esempio,https://looker.example.com/mcp). - In Impostazioni avanzate, inserisci la stringa esatta che hai utilizzato per
CLIENT_GUIDdurante la registrazione dell'app OAuth. Lascia vuoto il client secret OAuth. - Seleziona Aggiungi per salvare il connettore. Quando ti viene chiesto di connetterti, Claude per computer avvia in modo sicuro il flusso di autorizzazione PKCE tramite il tuo browser.
- Riavvia Claude per computer.
Cline
- Apri l'estensione Cline nell'IDE e fai clic sull'icona Server MCP.
- Fai clic su Configura i server MCP per aprire il file di configurazione.
- Aggiungi la seguente configurazione, sostituendo
LOOKER_INSTANCE_URLcon l'URL di Looker, quindi salva.
{
"mcpServers": {
"looker": {
"type": "http",
"url": "LOOKER_INSTANCE_URL/mcp"
}
}
}
Cursore
- Se non esiste, crea la directory
.cursornella directory root del progetto. - Crea il file
.cursor/mcp.jsonse non esiste e aprilo. - Aggiungi la seguente configurazione, sostituendo
LOOKER_INSTANCE_URLcon l'URL di Looker, quindi salva.
{
"mcpServers": {
"looker": {
"url": "LOOKER_INSTANCE_URL/mcp",
auth: {
"CLIENT_ID": "CLIENT_GUID"
}
}
}
}
- Apri Cursor e vai a Settings > Cursor Settings > MCP. Quando il server si connette, viene visualizzato lo stato attivo verde.
Visual Studio Code (Copilot)
- Apri VS Code e crea la directory
.vscodenella directory root del progetto, se non esiste. - Crea il file
.vscode/mcp.jsonse non esiste e aprilo. - Aggiungi la seguente configurazione, sostituendo
LOOKER_INSTANCE_URLcon l'URL della tua istanza di Looker, quindi salva.
{
"servers": {
"looker": {
"type": "http",
"url": "LOOKER_INSTANCE_URL/mcp"
}
}
}
Windsurf
- Apri Windsurf e vai all'assistente Cascade.
- Fai clic sull'icona MCP, quindi su Configura per aprire il file di configurazione.
- Aggiungi la seguente configurazione, sostituendo
LOOKER_INSTANCE_URLcon l'URL della tua istanza di Looker, quindi salva.
{
"mcpServers": {
"looker": {
"type": "http",
"url": "LOOKER_INSTANCE_URL/mcp"
}
}
}
Esegui l'autenticazione con il client
Dopo aver configurato il client MCP con le impostazioni di mcp.json, la prima volta che tenti di interagire con Looker tramite quel client, verrà avviato il flusso di autenticazione OAuth 2.1. In genere, il client apre una finestra del browser in cui devi accedere alla tua istanza di Looker utilizzando le tue credenziali standard e concedere all'applicazione l'autorizzazione per accedere a Looker per tuo conto.
Questa procedura di accesso è il passaggio di autenticazione interattiva che consente al client MCP di ottenere un token di accesso per effettuare richieste future.
Per ulteriori dettagli, consulta la documentazione del client.
Una volta stabilita la connessione, il client eredita i tuoi ruoli Looker e l'accesso ai contenuti. Il client ha anche accesso agli strumenti MCP abilitati dall'amministratore di Looker per il server MCP. Per un elenco di tutti gli strumenti possibili, consulta la documentazione Utilizza gli strumenti AI.
Sicurezza e governance
Il server MCP gestito è progettato per ereditare il framework di sicurezza e governance esistente di Looker.
- Limite delle autorizzazioni: il server applica autorizzazioni rigorose a livello di utente. Un agente AI non può accedere a dati o modelli che l'utente autenticato non è autorizzato a visualizzare.
- Controlli di servizio VPC: per le istanze di Looker (Google Cloud core) che utilizzano i Controlli di servizio VPC, l'endpoint MCP gestito rispetta i confini dei Controlli di servizio VPC esistenti senza richiedere policy o configurazioni aggiuntive.
- Chiavi di crittografia gestite dal cliente (CMEK): per le istanze di Looker (Google Cloud core) che utilizzano CMEK, il server MCP gestito è conforme a CMEK senza richiedere policy o configurazioni aggiuntive.
- Liste consentite di IP: per le istanze che utilizzano una lista consentita di IP in Looker (Google Cloud core) o Looker (originale), l'endpoint MCP gestito rispetta le regole della lista consentita di IP esistenti senza richiedere ulteriori configurazioni.
Audit logging
Ogni azione eseguita da un agente AI viene registrata in Attività di sistema di Looker e in Cloud Audit Logs.
Attività di sistema
L'attività del server MCP gestito da Looker viene monitorata nelle esplorazioni Cronologia e Attributo evento. La pagina della documentazione Monitoraggio dell'utilizzo di Looker con le esplorazioni di Attività del sistema fornisce le seguenti query di esempio:
- Quali chiamate API sono state avviate dal server MCP gestito da Looker?
- Quali eventi sono correlati a una richiesta dal server MCP gestito da Looker?
- Quali aggiornamenti sono stati apportati alle impostazioni dello strumento del server MCP gestito da Looker dagli amministratori di Looker?
- Quali query sono state eseguite dagli utenti del server MCP gestito da Looker?
Cloud Audit Logs
Le istanze di Looker (Google Cloud core) monitorano anche l'attività del server MCP gestito da Looker tramite Cloud Audit Logs. La pagina della documentazione Audit logging di Looker (Google Cloud core) fornisce query di esempio.
Limitazioni
- Ambiti granulari: gli ambiti OAuth non sono ancora supportati per il server MCP gestito. Il controllo degli accessi si basa sulla lista consentita globale degli strumenti e sulle autorizzazioni di base dell'utente.
- Registrazione dinamica: la registrazione dinamica dei client non è supportata.
- Aggiornamento del client: le modifiche alla lista consentita degli strumenti non vengono inviate automaticamente ai client connessi. Gli utenti devono attendere 30 secondi dopo aver apportato una modifica all'elenco degli strumenti, quindi ricollegare il client per aggiornare il manifest degli strumenti. Consulta la documentazione del tuo client per informazioni su come ricollegarti al server MCP.
- Capacità del server: durante la fase di anteprima, il server MCP gestito è configurato con una capacità fissa per aiutarci a raccogliere dati sul rendimento. Durante i periodi di utilizzo intenso, potresti riscontrare timeout occasionali. Questo è un comportamento previsto.
Prezzi e quote
Il server MCP gestito da Looker è disponibile senza costi aggiuntivi. Tuttavia, le chiamate allo strumento MCP effettuate dai client connessi consumano le quote API standard basate su query e amministrative dell'istanza. Un'attività elevata del client potrebbe ridurre la quota API disponibile.