Questa pagina è stata tradotta dall'API Cloud Translation.

Utilizzare Firestore con MCP, Gemini CLI e altri agenti

Questa pagina mostra come connettere il database Firestore a vari strumenti per sviluppatori.

Per un'esperienza integrata, ti consigliamo di utilizzare l'estensione Firestore dedicata per l'interfaccia a riga di comando di Gemini. In quanto interfaccia a riga di comando di nuova generazione di Google Cloud, Gemini CLI raggruppa il server MCP sottostante direttamente nell'estensione, eliminando la necessità di una configurazione separata del server. Puoi configurare Gemini Code Assist per utilizzare la CLI Gemini, che offre vantaggi di configurazione simili nel tuo IDE.

Per altri strumenti per sviluppatori che supportano il Model Context Protocol (MCP), puoi connetterti configurando manualmente MCP Toolbox for Databases. MCP Toolbox è un server MCP open source che connette gli agenti AI ai tuoi dati gestendo attività come l'autenticazione e il pool di connessioni. In questo modo puoi interagire con i tuoi dati utilizzando il linguaggio naturale direttamente dal tuo IDE. Per questi strumenti, questo metodo fornisce funzionalità di interazione di base con il database. Questa pagina descrive come utilizzare MCP Toolbox for Databases per esporre gli strumenti di assistenza per gli sviluppatori a un'istanza Firestore utilizzando i seguenti IDE:

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

Informazioni sull'interfaccia a riga di comando di Gemini e sulle estensioni

Gemini CLI è un agente AI open source progettato per assistere i flussi di lavoro di sviluppo aiutando con la programmazione, il debug, l'esplorazione dei dati e la creazione di contenuti. La sua missione è fornire un'interfaccia di agente per interagire con i servizi Data Cloud e i database open source più diffusi.

Come funzionano le estensioni

Gemini CLI è altamente estensibile e consente l'aggiunta di nuovi strumenti e funzionalità tramite le estensioni. Puoi caricare le estensioni da un URL GitHub, da una directory locale o da un registro configurabile. Forniscono nuovi strumenti, comandi slash e prompt per aiutarti nel tuo flusso di lavoro.

Utilizzare l'estensione dell'interfaccia a riga di comando di Gemini per Firestore

L'integrazione con la CLI Gemini avviene tramite un'estensione dedicata che offre funzionalità aggiuntive rispetto alla connessione standard di MCP Toolbox. L'estensione offre una procedura di installazione semplificata e un insieme di strumenti. L'estensione open source contiene informazioni dettagliate su installazione, configurazione ed esempi di utilizzo. Per ulteriori informazioni, consulta Estensione della CLI Gemini - Firestore.

L'estensione firestore-native include strumenti per eseguire query sul database, aggiornare i documenti e gestire le regole di sicurezza di Firestore.

Categoria	Strumenti	Esempio di prompt in linguaggio naturale
Recupero di documenti e dati	`get_documents`	Mostrami i dati di Firestore per gli utenti di test qa_user_123 e qa_user_456 della raccolta users-staging.
	`list_collections`	Elenca tutte le raccolte secondarie nella raccolta users-staging.
	`query_collection`	Trova tutti gli utenti nella raccolta users-staging la cui lista dei desideri contiene product-glasses.
Aggiornamenti ed eliminazioni di documenti	`add_documents`	Aggiungi il documento qa_user_789 alla raccolta users-staging con i campi name: tester1 e location: USA.
	`delete_documents`	Elimina il documento qa_user_789 dalla raccolta users-staging.
	`update_document`	Aggiorna il documento con ID order-987 nella raccolta orders per impostare lo stato su "Spedito". Per tutti i 20 utenti di test che hai appena trovato, rimuovi product-glasses(inactive) dalla loro lista dei desideri.
Gestione delle regole di sicurezza	`get_rules`	Mostrami le regole di sicurezza di Firestore attive per questo database.
Gestione delle regole di sicurezza	`validate_rules`	new_rules.txt è una nuova regola di sicurezza Firestore a cui sto lavorando per lo staging. Puoi convalidarlo per me?

Prima di iniziare

Per utilizzare gli strumenti nell'estensione Gemini CLI per Firestore, devi disporre di uno dei seguenti ruoli Identity and Access Management (IAM) o di un ruolo personalizzato con autorizzazioni equivalenti:

Attività	Nome ruolo	Ruolo Identity and Access Management (IAM) richiesto
Leggi e scrivi dati nel database Firestore	Cloud Datastore User	`roles/datastore.user`
Visualizzare e testare le regole di sicurezza	Firebase Rules Viewer	`roles/firebaserules.viewer`

Configura Firestore

Crea un nuovo Google Cloud progetto o selezionane uno esistente.
Abilitare l'API Firestore in modalità nativa per il tuo progetto.
Se non l'hai ancora fatto, crea un database Firestore.
Configura l'autenticazione per l'ambiente locale.
- Installa gcloud CLI
- Esegui gcloud auth application-default login per l'autenticazione

Configura il client MCP

Questa sezione descrive come configurare vari strumenti per sviluppatori per connettersi all'istanza Firestore utilizzando MCP Toolbox for Databases. Il toolbox funge da server Model Context Protocol (MCP) open source che si trova tra l'IDE e il database, fornendo un piano di controllo sicuro ed efficiente per i tuoi strumenti di AI. Seleziona la scheda relativa a uno dei seguenti strumenti per visualizzare le istruzioni di configurazione.

Interfaccia a riga di comando di Gemini

Installa l'interfaccia a riga di comando di Gemini.
Installa l'estensione Firestore per Gemini CLI dal repository GitHub utilizzando il seguente comando:
```
gemini extensions install https://github.com/gemini-cli-extensions/firestore-native
```
Imposta le variabili di ambiente per connetterti al database Firestore. La variabile FIRESTORE_DATABASE è facoltativa e il valore predefinito è (default):
```
export FIRESTORE_PROJECT="PROJECT_ID"
export FIRESTORE_DATABASE="DATABASE_NAME"
```
L'estensione Gemini CLI per Firestore utilizza le credenziali predefinite dell'applicazione (ADC) per l'autenticazione.
Avvia l'interfaccia a riga di comando di Gemini in modalità interattiva:
```
gemini
```
L'interfaccia a riga di comando carica automaticamente l'estensione Firestore per l'estensione Gemini CLI e i relativi strumenti, che puoi utilizzare per interagire con il tuo database.

Gemini Code Assist

Ti consigliamo di configurare Gemini Code Assist in modo che utilizzi l'interfaccia a riga di comando di Gemini. Questo approccio elimina la necessità di configurare manualmente un server MCP.

Assicurati di aver installato e configurato l'interfaccia a riga di comando di Gemini e l'estensione firestore-native.
Configura Gemini Code Assist per utilizzare l'interfaccia a riga di comando di Gemini.
Inizia a interagire con il tuo database Firestore utilizzando il linguaggio naturale direttamente nella chat di Gemini Code Assist.

Codice Claude

Installare MCP Toolbox for Databases

Scarica l'ultima versione di Toolbox come file binario. Seleziona il file binario corrispondente al tuo sistema operativo e all'architettura della CPU. Devi utilizzare Toolbox versione V0.15.0 o successive.
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
Sostituisci version con il numero di versione di Toolbox, ad esempio v0.15.0.
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
Sostituisci version con il numero di versione di Toolbox, ad esempio v0.15.0.
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
Sostituisci version con il numero di versione di Toolbox, ad esempio v0.15.0.
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
Sostituisci version con il numero di versione di Toolbox, ad esempio v0.15.0.
Rendi eseguibile il file binario.
```
chmod +x toolbox
```
Verifica l'installazione.
```
./toolbox --version
```

Connettiti al server MCP

Installa Claude Code.
Crea il file .mcp.json nella root del progetto, se non esiste.
Aggiungi la seguente configurazione, sostituisci le variabili di ambiente con i tuoi valori e salva. La variabile FIRESTORE_DATABASE è facoltativa e il valore predefinito è (default).

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

Riavvia il codice Claude per applicare la nuova configurazione.

Claude desktop

Installare MCP Toolbox for Databases

Scarica l'ultima versione di Toolbox come file binario. Seleziona il file binario corrispondente al tuo sistema operativo e all'architettura della CPU. Devi utilizzare Toolbox versione V0.15.0 o successive.
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
Sostituisci version con il numero di versione di Toolbox, ad esempio v0.15.0.
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
Sostituisci version con il numero di versione di Toolbox, ad esempio v0.15.0.
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
Sostituisci version con il numero di versione di Toolbox, ad esempio v0.15.0.
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
Sostituisci version con il numero di versione di Toolbox, ad esempio v0.15.0.
Rendi eseguibile il file binario.
```
chmod +x toolbox
```
Verifica l'installazione.
```
./toolbox --version
```

Connettiti al server MCP

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, sostituisci le variabili di ambiente con i tuoi valori e salva. La variabile FIRESTORE_DATABASE è facoltativa e il valore predefinito è (default).

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

Riavvia Claude Desktop.
Nella nuova schermata di chat, dovrebbe apparire un'icona a forma di martello (MCP) con il nuovo server MCP disponibile.

Cline

Installare MCP Toolbox for Databases

Scarica l'ultima versione di Toolbox come file binario. Seleziona il file binario corrispondente al tuo sistema operativo e all'architettura della CPU. Devi utilizzare Toolbox versione V0.15.0 o successive.
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
Sostituisci version con il numero di versione di Toolbox, ad esempio v0.15.0.
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
Sostituisci version con il numero di versione di Toolbox, ad esempio v0.15.0.
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
Sostituisci version con il numero di versione di Toolbox, ad esempio v0.15.0.
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
Sostituisci version con il numero di versione di Toolbox, ad esempio v0.15.0.
Rendi eseguibile il file binario.
```
chmod +x toolbox
```
Verifica l'installazione.
```
./toolbox --version
```

Connettiti al server MCP

Apri l'estensione Cline in VS Code e tocca l'icona Server MCP.
Fai clic su Configura server MCP per aprire il file di configurazione.
Aggiungi la seguente configurazione, sostituisci le variabili di ambiente con i tuoi valori e salva. La variabile FIRESTORE_DATABASE è facoltativa e il valore predefinito è (default).

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

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

Cursore

Installare MCP Toolbox for Databases

Scarica l'ultima versione di Toolbox come file binario. Seleziona il file binario corrispondente al tuo sistema operativo e all'architettura della CPU. Devi utilizzare Toolbox versione V0.15.0 o successive.
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
Sostituisci version con il numero di versione di Toolbox, ad esempio v0.15.0.
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
Sostituisci version con il numero di versione di Toolbox, ad esempio v0.15.0.
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
Sostituisci version con il numero di versione di Toolbox, ad esempio v0.15.0.
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
Sostituisci version con il numero di versione di Toolbox, ad esempio v0.15.0.
Rendi eseguibile il file binario.
```
chmod +x toolbox
```
Verifica l'installazione.
```
./toolbox --version
```

Connettiti al server MCP

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, sostituisci le variabili di ambiente con i tuoi valori e salva. La variabile FIRESTORE_DATABASE è facoltativa e il valore predefinito è (default).

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

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

Visual Studio Code (Copilot)

Installare MCP Toolbox for Databases

Scarica l'ultima versione di Toolbox come file binario. Seleziona il file binario corrispondente al tuo sistema operativo e all'architettura della CPU. Devi utilizzare Toolbox versione V0.15.0 o successive.
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
Sostituisci version con il numero di versione di Toolbox, ad esempio v0.15.0.
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
Sostituisci version con il numero di versione di Toolbox, ad esempio v0.15.0.
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
Sostituisci version con il numero di versione di Toolbox, ad esempio v0.15.0.
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
Sostituisci version con il numero di versione di Toolbox, ad esempio v0.15.0.
Rendi eseguibile il file binario.
```
chmod +x toolbox
```
Verifica l'installazione.
```
./toolbox --version
```

Connettiti al server MCP

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, sostituisci le variabili di ambiente con i tuoi valori e salva. La variabile FIRESTORE_DATABASE è facoltativa e il valore predefinito è (default).

 {
    "servers":{
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

Windsurf

Installare MCP Toolbox for Databases

Scarica l'ultima versione di Toolbox come file binario. Seleziona il file binario corrispondente al tuo sistema operativo e all'architettura della CPU. Devi utilizzare Toolbox versione V0.15.0 o successive.
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
Sostituisci version con il numero di versione di Toolbox, ad esempio v0.15.0.
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
Sostituisci version con il numero di versione di Toolbox, ad esempio v0.15.0.
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
Sostituisci version con il numero di versione di Toolbox, ad esempio v0.15.0.
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
Sostituisci version con il numero di versione di Toolbox, ad esempio v0.15.0.
Rendi eseguibile il file binario.
```
chmod +x toolbox
```
Verifica l'installazione.
```
./toolbox --version
```

Connettiti al server MCP

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, sostituisci le variabili di ambiente con i tuoi valori e salva. La variabile FIRESTORE_DATABASE è facoltativa e il valore predefinito è (default).

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

Utilizzare Firestore con MCP, Gemini CLI e altri agenti

Informazioni sull'interfaccia a riga di comando di Gemini e sulle estensioni

Come funzionano le estensioni

Utilizzare l'estensione dell'interfaccia a riga di comando di Gemini per Firestore

Prima di iniziare

Configura Firestore

Configura il client MCP

Interfaccia a riga di comando di Gemini

Gemini Code Assist

Codice Claude

Installare MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Connettiti al server MCP

Claude desktop

Installare MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Connettiti al server MCP

Cline

Installare MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Connettiti al server MCP

Cursore

Installare MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Connettiti al server MCP

Visual Studio Code (Copilot)

Installare MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Connettiti al server MCP

Windsurf

Installare MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Connettiti al server MCP