Utilizzare Cloud SQL per SQL Server con MCP, Gemini CLI e altri agenti

MySQL   |  PostgreSQL   |  SQL Server

Questa pagina mostra come connettere l'istanza Cloud SQL a vari strumenti di assistenza per sviluppatori AI, tra cui:

• Estensione Gemini CLI per Cloud SQL per SQL Server
• Estensione Gemini CLI per SQL Server

• Gemini Code Assist
• Cloud Code
• Claude desktop
• Codex
• Cline (estensione VS Code)
• Cursore
• Visual Studio Code (Copilot)
• Windsurf (Codeium)
• Antigravity

Per un'esperienza integrata, ti consigliamo di utilizzare l'estensione Gemini CLI per Cloud SQL per SQL Server dedicata.

In quanto interfaccia a riga di comando di nuova generazione, Gemini CLI raggruppa le competenze sottostanti direttamente nell'estensione, il che semplifica l'installazione e la configurazione. Puoi configurare Gemini Code Assist in modo che utilizzi Gemini CLI, offrendo vantaggi di configurazione simili nel tuo IDE. Google Cloud

Per altri strumenti per sviluppatori che supportano il Model Context Protocol (MCP), puoi connetterti configurando manualmente MCP Toolbox for Databases (Toolbox). 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.

Per maggiori informazioni, consulta Strumenti predefiniti e MCP Toolbox for Databases su GitHub.

Informazioni su Gemini CLI e le estensioni

Gemini CLI è un agente AI open source progettato per assistere i workflow di sviluppo aiutando con la programmazione, il debug, l'esplorazione dei dati e la creazione di contenuti. Fornisce un'interfaccia agentica per interagire con servizi di database e analisi e con i database open source più diffusi.

Come funzionano le estensioni

L'interfaccia a riga di comando di Gemini è 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, competenze e prompt per aiutarti nel tuo flusso di lavoro.

Utilizzare le estensioni della CLI Gemini in Cloud SQL per SQL Server

L'estensione Gemini CLI per Cloud SQL si basa su MCP Toolbox per i database.

L'integrazione con Gemini CLI avviene tramite un'estensione dedicata che offre funzionalità aggiuntive rispetto alla connessione standard di Toolbox. L'estensione offre un processo di installazione semplificato e un insieme di competenze basate sugli strumenti MCP.

Per saperne di più, consulta la documentazione di GitHub per l'estensione Gemini CLI per Cloud SQL per SQL Server.

Estensione Gemini CLI per i database Cloud SQL per SQL Server

L'estensione cloud-sql-sqlserver include competenze per eseguire query sul database e monitorarne l'integrità.

Per tutte le competenze disponibili, consulta le competenze Cloud SQL su GitHub. L'estensione cloud-sql-sqlserver-observability fornisce un'interfaccia unificata per la gestione e il monitoraggio delle prestazioni e dell'integrità del database direttamente dalla Gemini CLI.

Categoria	Strumenti
Osservabilità	get_system_metrics: recupera le metriche di sistema per un'istanza Cloud SQL.

Estensione Gemini CLI per i database SQL Server

Per un elenco di queste operazioni, consulta MCP Toolbox for Databases e Estensione Gemini CLI per SQL Server.

Prima di iniziare

• Nella console Google Cloud , nella pagina di selezione del progetto, seleziona o crea un progetto Google Cloud .

• Verifica che la fatturazione sia attivata per il tuo progetto Google Cloud .

• Abilita l'API Cloud SQL Admin nel progetto Google Cloud .

• Per impostazione predefinita, Cloud SQL assegna un indirizzo IP pubblico a una nuova istanza. A seconda del tuo caso d'uso, assicurati che sia configurato un IP pubblico o un IP privato per le tue istanze Cloud SQL. Toolbox si connette in modo sicuro utilizzando i connettori dei linguaggi di Cloud SQL.

• Concedi i ruoli Identity and Access Management (IAM) necessari all'utente che eseguirà il server MCP. Gli strumenti disponibili dipendono dai ruoli concessi:

  Attività	Nome ruolo	Ruolo IAM richiesto
  Fornisce l'accesso di sola lettura alle risorse, incluse le seguenti operazioni: get_instance list_instances list_databases wait_for_operation	Cloud SQL Viewer	roles/cloudsql.viewer
  Fornisce l'accesso di sola lettura ai dati di monitoraggio, come le metriche delle serie temporali.	Visualizzatore Cloud Monitoring	roles/monitoring.viewer
  Fornisce le autorizzazioni per gestire le risorse esistenti, tra cui: Tutti gli strumenti di viewer create_database	Cloud SQL Editor	roles/cloudsql.editor
  Fornisce il controllo completo di tutte le risorse, tra cui: Tutti gli strumenti viewer e editor create_instance create_user	Cloud SQL Admin	roles/cloudsql.admin

• Configura le Credenziali predefinite dell'applicazione (ADC) per il tuo ambiente.

• Crea o riutilizza un utente di database e tieni a portata di mano il nome utente e la password.

Contattare Antigravity

Puoi connettere Cloud SQL per SQL Server ad Antigravity nei seguenti modi:

• Utilizzare lo store MCP
• Utilizzare una configurazione personalizzata

Nota: non è necessario scaricare il file binario di MCP Toolbox per utilizzare questi metodi.

MCP Store

Il metodo più consigliato per connettersi a Cloud SQL per SQL Server in Antigravity è utilizzare l'archivio MCP integrato.

1. Apri Antigravity e il pannello dell'agente dell'editor.
2. Fai clic sull'icona "..." nella parte superiore del riquadro e seleziona Server MCP.
3. Individua Cloud SQL per SQL Server nell'elenco dei server disponibili e fai clic su Installa.
4. Segui le istruzioni sullo schermo per collegare in modo sicuro i tuoi account, se applicabile.

Dopo aver installato Cloud SQL per SQL Server in MCP Store, le risorse e gli strumenti del server sono automaticamente disponibili per l'editor.

Configurazione personalizzata

Per connetterti a un server MCP personalizzato:

1. Apri Antigravity e il pannello dell'agente dell'editor.
2. Fai clic sull'icona "..." nella parte superiore del riquadro e seleziona Server MCP.
3. Fai clic su Gestisci server MCP > Visualizza configurazione non elaborata per aprire il file mcp_config.json.
4. Aggiungi la seguente configurazione, sostituisci le variabili di ambiente con i tuoi valori e salva.

{
  "mcpServers": {
    "cloud-sql-mssql": {
      "command": "npx",
      "args": ["-y","@toolbox-sdk/server","--prebuilt","cloud-sql-mssql","--stdio"],
      "env": {
          "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
          "CLOUD_SQL_MSSQL_REGION": "REGION",
          "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
          "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
          "CLOUD_SQL_MSSQL_USER": "USER_ID",
          "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

Una volta configurato il server MCP personalizzato, le risorse e gli strumenti del server Cloud SQL per SQL Server sono disponibili per l'editor.

Installa MCP Toolbox

Nota: questo passaggio non è obbligatorio per le estensioni della CLI Gemini.

1. Scarica il file binario corrispondente al tuo sistema operativo e all'architettura della CPU.

<div>
<devsite-selector>
<section>
<h3 id="linux-amd64">linux/amd64</h3>
<pre class="devsite-click-to-copy">curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/linux/amd64/toolbox</pre>
</section>
<section>
<h3 id="darwin-arm64">darwin/arm64</h3>
<pre class="devsite-click-to-copy">curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/darwin/arm64/toolbox</pre>
</section>
<section>
<h3 id="darwin-amd64">darwin/amd64</h3>
<pre class="devsite-click-to-copy">curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/darwin/amd64/toolbox</pre>
</section>
<section>
<h3 id="windows-amd64">windows/amd64</h3>
<pre class="devsite-click-to-copy">curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/windows/amd64/toolbox</pre>
</section>
</devsite-selector>
</div>

Rendi eseguibile il file binario:

```bash
chmod +x toolbox
```

Verifica l'installazione utilizzando il seguente comando:

```bash
./toolbox --version
```

Configura il client MCP

Questa sezione descrive come configurare vari strumenti per sviluppatori per connettersi alla tua istanza Cloud SQL utilizzando Toolbox. 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 AI. Seleziona la scheda dello strumento specifico per visualizzare le istruzioni di configurazione.

Interfaccia a riga di comando Gemini per Cloud SQL per SQL Server

1. Installa la Gemini CLI.
2. Installa l'estensione Cloud SQL per SQL Server per Gemini CLI dal repository GitHub utilizzando il seguente comando:

         gemini extensions install https://github.com/gemini-cli-extensions/cloud-sql-sqlserver
         

   Durante l'installazione dell'estensione, sostituisci quanto segue:

         export CLOUD_SQL_MSSQL_PROJECT="PROJECT_NAME"
         export CLOUD_SQL_MSSQL_REGION="REGION"
         export CLOUD_SQL_MSSQL_INSTANCE="INSTANCE_NAME"
         export CLOUD_SQL_MSSQL_DATABASE="DATABASE_NAME"
         export CLOUD_SQL_MSSQL_USER="DATABASE_USER_NAME"
         export CLOUD_SQL_MSSQL_PASSWORD="PASSWORD"
         export CLOUD_SQL_MSSQL_IP_TYPE="IP_TYPE"
         

   Sostituisci quanto segue:
   • PROJECT_NAME: l' Google Cloud ID progetto.
   • REGION: la regione dell'istanza Cloud SQL.
   • INSTANCE_NAME: l'ID dell'istanza Cloud SQL.
   • DATABASE_NAME: il nome del database a cui connettersi.
   • DATABASE_USER_NAME: (facoltativo) il nome utente del database. Se non specificato, il valore predefinito è l'autenticazione IAM.
   • PASSWORD: (facoltativo) La password per l'utente del database. Se non specificata, il valore predefinito è l'autenticazione IAM.
   • IP_TYPE: (facoltativo) il tipo di IP, ad esempio "Public" (pubblico, predefinito) o "Private" (privato).
3. Avvia Gemini CLI in modalità interattiva:

         gemini
         

   La CLI carica automaticamente l'estensione Gemini CLI per Cloud SQL e i relativi strumenti, che puoi utilizzare per interagire con il tuo database.

   Nella Gemini CLI, utilizza il comando /extensions per verificare che l'estensione sia installata e il comando /mcp list per visualizzare gli strumenti.

Gemini CLI per SQL Server

1. Installa la Gemini CLI.
2. Installa l'estensione software SQL Server per Gemini CLI dal repository GitHub utilizzando il seguente comando:

         gemini extensions install https://github.com/gemini-cli-extensions/sql-server
         

   Durante l'installazione dell'estensione, sostituisci quanto segue:

         export MSSQL_HOST="HOST"
         export MSSQL_PORT="PORT"
         export MSSQL_DATABASE="DATABASE"
         export MSSQL_USER="USER"
         export MSSQL_PASSWORD="PASSWORD"
         

   Sostituisci quanto segue:
   • HOST: il nome host o l'indirizzo IP del server SQL Server.
   • PORT: il numero di porta per il server SQL Server.
   • DATABASE: il nome del database a cui connettersi.
   • USER: Il nome utente del database.
   • PASSWORD: la password per l'utente del database.
3. Avvia Gemini CLI in modalità interattiva:

         gemini
         

   La CLI carica automaticamente l'estensione Gemini CLI per SQL Server e i relativi strumenti, che puoi utilizzare per interagire con il tuo database.

Gemini Code Assist

1. Installa l'estensione Gemini Code Assist in Visual Studio Code.
2. Attiva la modalità Agente nella chat di Gemini Code Assist.
3. Nella directory di lavoro, crea una cartella denominata .gemini. Al suo interno, crea un file settings.json.
4. Aggiungi la seguente configurazione, sostituisci le variabili di ambiente con i tuoi valori e poi salva:

   
   {
     "mcpServers": {
       "cloud-sql-sqlserver": {
         "command": "./PATH/TO/toolbox",
         "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
         "env": {
           "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
           "CLOUD_SQL_MSSQL_REGION": "REGION",
           "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
           "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
           "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
           "CLOUD_SQL_MSSQL_USER": "USER_ID",
           "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
         }
       }
     }
   }
   
   

Claude Code

1. Installa Claude Code.
2. Imposta le variabili di ambiente per connetterti all'istanza Cloud SQL:

         export CLOUD_SQL_MSSQL_PROJECT="PROJECT_NAME"
         export CLOUD_SQL_MSSQL_REGION="REGION"
         export CLOUD_SQL_MSSQL_INSTANCE="INSTANCE_NAME"
         export CLOUD_SQL_MSSQL_DATABASE="DATABASE_NAME"
         export CLOUD_SQL_MSSQL_USER="DATABASE_USER_NAME"
         export CLOUD_SQL_MSSQL_PASSWORD="PASSWORD"
         export CLOUD_SQL_MSSQL_IP_TYPE="IP_TYPE"
         

   Sostituisci quanto segue:
   • PROJECT_NAME: l' Google Cloud ID progetto.
   • REGION: la regione dell'istanza Cloud SQL.
   • INSTANCE_NAME: l'ID dell'istanza Cloud SQL.
   • DATABASE_NAME: il nome del database a cui connettersi.
   • DATABASE_USER_NAME: (facoltativo) il nome utente del database. Se non specificato, il valore predefinito è l'autenticazione IAM.
   • PASSWORD: (facoltativo) La password per l'utente del database. Se non specificata, il valore predefinito è l'autenticazione IAM.
   • IP_TYPE: (facoltativo) il tipo di IP, ad esempio "Public" (pubblico, predefinito) o "Private" (privato).
3. Avvia l'agente:

         claude
         

4. Trova l'ultima versione della release nel repository delle competenze di Cloud SQL per SQL Server e aggiungi il marketplace:

         /plugin marketplace add https://github.com/gemini-cli-extensions/cloud-sql-sqlserver.git#VERSION
         

5. Installa il plug-in:

         /plugin install cloud-sql-sqlserver@cloud-sql-sqlserver-marketplace
         

Suggerimento:esegui /plugin list all'interno di Claude Code per verificare che il plug-in sia attivo o /reload-plugins se l'hai appena installato.

Claude desktop

1. Apri Claude Desktop e vai a Impostazioni.
2. Nella scheda Sviluppatore, tocca Modifica configurazione per aprire il file di configurazione.
3. Aggiungi quanto segue per connetterti al server MCP e impostare le variabili di ambiente:

   
   {
     "mcpServers": {
       "cloud-sql-sqlserver": {
         "command": "./PATH/TO/toolbox",
         "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
         "env": {
           "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
           "CLOUD_SQL_MSSQL_REGION": "REGION",
           "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
           "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
           "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
           "CLOUD_SQL_MSSQL_USER": "USER_ID",
           "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
         }
       }
     }
   }
   
   

4. Riavvia Claude Desktop. La nuova schermata della chat mostra l'icona MCP con il nuovo server MCP disponibile.

Codex

1. Trova l'ultima versione di release nel repository delle competenze di Cloud SQL per SQL Server e clonala:

   git clone --branch VERSION [e-mail]:gemini-cli-extensions/cloud-sql-sqlserver.git
   

2. Installa il plug-in:

   mkdir -p ~/.codex/plugins
   cp -R /absolute/path/to/cloud-sql-sqlserver ~/.codex/plugins/cloud-sql-sqlserver
   

3. Configura le variabili di ambiente per connetterti all'istanza Cloud SQL:

       export CLOUD_SQL_MSSQL_PROJECT="PROJECT_NAME"
       export CLOUD_SQL_MSSQL_REGION="REGION"
       export CLOUD_SQL_MSSQL_INSTANCE="INSTANCE_NAME"
       export CLOUD_SQL_MSSQL_DATABASE="DATABASE_NAME"
       export CLOUD_SQL_MSSQL_USER="DATABASE_USER_NAME"
       export CLOUD_SQL_MSSQL_PASSWORD="PASSWORD"
       export CLOUD_SQL_MSSQL_IP_TYPE="IP_TYPE"
       

   Sostituisci quanto segue:
   • PROJECT_NAME: l' Google Cloud ID progetto.
   • REGION: la regione dell'istanza Cloud SQL.
   • INSTANCE_NAME: l'ID dell'istanza Cloud SQL.
   • DATABASE_NAME: il nome del database a cui connettersi.
   • DATABASE_USER_NAME: (facoltativo) il nome utente del database. Se non specificato, il valore predefinito è l'autenticazione IAM.
   • PASSWORD: (facoltativo) La password per l'utente del database. Se non specificata, il valore predefinito è l'autenticazione IAM.
   • IP_TYPE: (facoltativo) il tipo di IP, ad esempio "Public" (pubblico, predefinito) o "Private" (privato).
4. Crea o aggiorna marketplace.json:

   
   {
     "name": "my-data-cloud-google-marketplace",
     "interface": {
       "displayName": "Google Data Cloud Skills"
     },
     "plugins": [
       {
         "name": "cloud-sql-sqlserver",
         "source": {
           "source": "local",
           "path": "./plugins/cloud-sql-sqlserver"
         },
         "policy": {
           "installation": "AVAILABLE",
           "authentication": "ON_INSTALL"
         },
         "category": "Database"
       }
     ]
   }
   
   

5. Esegui codex plugin list o utilizza il menu interattivo plugins per verificare i plug-in installati.

Cline

1. Apri l'estensione Cline in VS Code e tocca l'icona Server MCP.
2. Tocca Configura server MCP per aprire il file di configurazione.
3. Aggiungi la seguente configurazione, sostituisci le variabili di ambiente con i tuoi valori e salva:

   
   {
     "mcpServers": {
       "cloud-sql-sqlserver": {
         "command": "./PATH/TO/toolbox",
         "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
         "env": {
           "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
           "CLOUD_SQL_MSSQL_REGION": "REGION",
           "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
           "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
           "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
           "CLOUD_SQL_MSSQL_USER": "USER_ID",
           "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
         }
       }
     }
   }
   
   

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

Cursore

1. Crea la directory .cursor nella radice del progetto, se non esiste.
2. Crea il file .cursor/mcp.json se non esiste e aprilo.
3. Aggiungi la seguente configurazione, sostituisci le variabili di ambiente con i tuoi valori e salva:

   
   {
     "mcpServers": {
       "cloud-sql-sqlserver": {
         "command": "./PATH/TO/toolbox",
         "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
         "env": {
           "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
           "CLOUD_SQL_MSSQL_REGION": "REGION",
           "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
           "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
           "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
           "CLOUD_SQL_MSSQL_USER": "USER_ID",
           "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
         }
       }
     }
   }
   
   

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

Visual Studio Code (Copilot)

1. Apri VS Code e crea la directory .vscode nella directory principale del progetto, se non esiste.
2. Crea il file .vscode/mcp.json se non esiste e aprilo.
3. Aggiungi la seguente configurazione, sostituisci le variabili di ambiente con i tuoi valori e salva:

   
   {
     "servers": {
       "cloud-sql-sqlserver": {
         "command": "./PATH/TO/toolbox",
         "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
         "env": {
           "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
           "CLOUD_SQL_MSSQL_REGION": "REGION",
           "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
           "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
           "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
           "CLOUD_SQL_MSSQL_USER": "USER_ID",
           "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
         }
       }
     }
   }
   
   

Windsurf

1. Apri Windsurf e vai ad Assistente a cascata.
2. Tocca l'icona MCP, poi tocca Configura per aprire il file di configurazione.
3. Aggiungi la seguente configurazione, sostituisci le variabili di ambiente con i tuoi valori e salva:

   
   {
     "mcpServers": {
       "cloud-sql-sqlserver": {
         "command": "./PATH/TO/toolbox",
         "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
         "env": {
           "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
           "CLOUD_SQL_MSSQL_REGION": "REGION",
           "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
           "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
           "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
           "CLOUD_SQL_MSSQL_USER": "USER_ID",
           "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
         }
       }
     }
   }