La tua istanza Cloud SQL non ha un IP pubblico.
Raggiungila per nome, senza VM bastion.
AgentsRoom avvia il Cloud SQL Auth Proxy quando apri la connessione e ci collega il suo client di database. Indichi il nome di connessione dell'istanza, project:region:instance, oppure lo scegli dall'elenco che il tuo login gcloud riesce a vedere.
Il proxy è autorizzato dalle tue Application Default Credentials (credenziali predefinite dell'applicazione), quindi AgentsRoom non conserva nessuna chiave di service account. Con l'autenticazione database IAM non c'è nemmeno una password del database. E un agente di coding IA può interrogare la stessa istanza, in sola lettura.
Come AgentsRoom raggiunge un'istanza Cloud SQL sul suo IP privato tramite il Cloud SQL Auth Proxy, senza salvare nulla lato app.
Un'istanza Cloud SQL con solo IP privato è la configurazione giusta, ma scomoda. Il database vive nella tua VPC, il suo IP pubblico è spento e le uniche macchine che possono raggiungerlo sono quelle dentro quella rete. Poi arriva un bug e bisogna guardare tre righe, da un portatile.
Google ha già la risposta: il Cloud SQL Auth Proxy. Apre una connessione cifrata verso l'istanza, autorizzata dalla tua identità Google invece che da una lista di IP consentiti, e la espone come porta locale. L'attrito sta in tutto ciò che sta intorno: installarlo, ricordare il nome di connessione dell'istanza, avviarlo in un terminale prima di aprire un client, e dimenticarlo in esecuzione dopo.
AgentsRoom si occupa di questa parte. Scegli Google Cloud SQL nel campo Raggiungi tramite di una connessione di database, indichi l'istanza, spunti IP privato o Autenticazione database IAM se ti servono, e da quel momento aprire quel database è un clic. Il proxy parte con la connessione e si ferma con essa.
Le solite scorciatoie hanno tutte un prezzo
Tre risposte allo stesso problema, e quello che ciascuna ti fa pagare.
Una VM bastion solo per questo
Una VM Compute Engine con una porta SSH, tenuta nella VPC solo perché qualcuno possa ogni tanto fare un tunnel verso il database. Va aggiornata, costa soldi ogni ora, e le sue chiavi SSH e le regole del firewall si sfilacciano man mano che il team cambia.
Un IP pubblico e una lista di indirizzi consentiti
Attivare l'IP pubblico e aggiungere il tuo indirizzo di casa alle reti autorizzate funziona finché il tuo indirizzo non cambia, e nel frattempo il database è in ascolto su internet. È l'eccezione che nessuno toglie mai.
Una chiave di service account su un portatile
Scaricare una chiave JSON per far girare il proxy è la scorciatoia di cui tutti si pentono: una credenziale di lunga durata in una cartella Download, copiata in script e prompt, che nessuno ruota e che nessuno sa tracciare.
Da un'istanza Cloud SQL privata a un risultato
Quattro passaggi, fatti una volta sola, poi basta un clic.
Accedi con gcloud, una volta
Esegui gcloud auth application-default login sulla tua macchina. Le Application Default Credentials che crea sono quelle che il proxy usa per raggiungere l'istanza. AgentsRoom non ne legge nulla e non ne conserva nulla.
Scegli l'istanza in Raggiungi tramite
Crea una connessione MySQL o PostgreSQL e scegli Google Cloud SQL in Raggiungi tramite. Scrivi il nome di connessione dell'istanza, project:region:instance, oppure clicca Elenca le mie istanze per sceglierla tra quelle che il tuo login gcloud riesce a vedere. Host e porta spariscono: l'indirizzo è l'istanza.
Scegli IP privato e autenticazione IAM
Spunta IP privato quando l'istanza non ha un indirizzo pubblico e la tua macchina raggiunge la sua VPC tramite una VPN o un Interconnect. Spunta Autenticazione database IAM per accedere con la tua identità Google: il campo password sparisce e l'utente è il tuo utente di database IAM.
Interrogala, oppure lascia che lo faccia un agente
Aprire la connessione riserva una porta di loopback libera, avvia cloud-sql-proxy su di essa e aspetta che accetti una connessione TCP. La console si collega a 127.0.0.1 come con qualsiasi altra connessione, e un agente IA può interrogarla tramite MCP, in sola lettura. Chiudere la connessione ferma il proxy.
Il comando che AgentsRoom lancia
Nulla viene reimplementato. AgentsRoom esegue il binario cloud-sql-proxy di Google (versione 2) come processo figlio, con gli argomenti passati direttamente e non tramite una shell. Se hai mai avviato il proxy a mano, questa è la riga che conosci già.
cloud-sql-proxy acme-prod:europe-west1:orders \
--address 127.0.0.1 --port 54321 \
--private-ip \
--auto-iam-authnL'istanza e le due opzioni vengono dalla connessione che hai salvato. La porta locale è scelta dal sistema operativo al momento dell'apertura.
Il proxy accetta la connessione locale prima di controllare qualsiasi cosa, poi la chiude e registra il motivo se qualcosa non va. AgentsRoom legge quel log e ti dice la causa reale: il proxy non è installato, il tuo login gcloud è scaduto (con il comando da eseguire), il tuo account non ha il ruolo Cloud SQL Client, l'istanza non ha un IP privato, oppure il nome dell'istanza è sbagliato.
Cosa deve essere vero prima che funzioni
AgentsRoom guida la tua configurazione Google Cloud, non la sostituisce. Sono le stesse cose di cui il proxy ha bisogno da solo.
cloud-sql-proxy sulla tua macchina
La versione 2 del Cloud SQL Auth Proxy, nel tuo PATH. gcloud components install cloud-sql-proxy è il modo più rapido; Google lo distribuisce anche come download autonomo. Se manca, AgentsRoom lo dice e indica il comando.
Application Default Credentials
gcloud auth application-default login, eseguito una volta. Quando quel login scade, l'errore ti dice di rieseguirlo invece di mostrarti un socket chiuso.
Il ruolo Cloud SQL Client
Il tuo account Google ha bisogno del ruolo Cloud SQL Client sul progetto dell'istanza, e l'API Cloud SQL Admin deve essere abilitata lì. L'autenticazione database IAM richiede anche il ruolo Cloud SQL Instance User e un utente IAM sull'istanza.
gcloud per l'elenco di scelta
Elenca le mie istanze esegue gcloud sql instances list nel tuo progetto attivo, o nel progetto che hai iniziato a scrivere. Senza gcloud puoi comunque scrivere il nome di connessione a mano.
Una via verso la VPC per l'IP privato
IP privato significa che la tua macchina deve raggiungere da sola la VPC dell'istanza, tramite una VPN, un Interconnect o una macchina dentro la rete. Senza quella via, lascia IP privato disattivato e usa l'IP pubblico con la cifratura del proxy.
Cosa fa il proxy, e cosa si rifiuta di fare
Le proprietà che decidono se è prudente lasciarlo configurato su un portatile.
Solo loopback
Il proxy è in ascolto su 127.0.0.1 e basta. Il database non viene mai ripubblicato sulla rete locale, quindi il Wi-Fi di un bar non diventa una strada verso la produzione.
Una porta scelta dal sistema operativo
AgentsRoom chiede al sistema operativo una porta libera e la passa al proxy. Nessuna porta fissa da ricordare, nessuna collisione con un altro proxy avviato a mano.
Pronto vuol dire pronto
La connessione si apre solo quando la porta locale accetta il TCP, e un proxy che esce subito riporta il motivo che ha stampato. Nessuna attesa arbitraria, nessun client che si collega troppo presto.
Nessuna chiave salvata
Il proxy è autorizzato dalle tue Application Default Credentials. AgentsRoom conserva il nome di connessione dell'istanza e due opzioni, nessuna delle quali è una credenziale, e nessuna chiave di service account tocca mai l'app.
Il database resta in sola lettura
Una connessione di database nasce in sola lettura. Per scrivere serve rendere quella connessione scrivibile e una conferma esplicita, più marcata su una connessione segnata come produzione.
Un'istruzione per chiamata
Ogni chiamata porta esattamente un'istruzione, quindi niente si nasconde dietro un punto e virgola, e i risultati sono limitati perché una query troppo larga non possa inondare una finestra o il contesto di un agente.
Perché è meno accesso, non di più
Nulla viene aperto lato istanza. L'IP pubblico può restare spento, nessuna rete viene aggiunta all'elenco di quelle autorizzate e nessuna VM con una porta SSH resta accesa per la query occasionale. Il proxy cifra la connessione da un capo all'altro fino all'istanza.
L'autorizzazione resta dove la gestisce la tua organizzazione: la tua identità Google e i suoi ruoli IAM. L'accesso concesso a quell'identità viene registrato come qualsiasi altra connessione a Cloud SQL e finisce il giorno in cui il ruolo viene rimosso. AgentsRoom conserva il nome dell'istanza, la scelta IP privato e la scelta IAM, e nulla che chi li legge possa riutilizzare.
Lato database le protezioni sono le stesse di ogni connessione AgentsRoom: sola lettura per impostazione predefinita, un'istruzione per chiamata, risultati limitati e un'indicazione di produzione che rafforza la conferma di scrittura. Un agente IA che interroga tramite MCP riceve un risultato, mai una credenziale, e non può scrivere a meno che tu abbia reso scrivibile quella connessione e attivato Consenti agli agenti di scrivere per essa.
MySQL e PostgreSQL, non ancora SQL Server
Cloud SQL esegue MySQL, PostgreSQL e SQL Server. AgentsRoom raggiunge i primi due tramite il proxy e oggi non ha un client SQL Server. Nemmeno AlloyDB, che ha un proprio proxy, è coperto.
Quale motore o servizio arriva dopo lo decide ciò che le persone chiedono. Se il tuo manca, dì quale sul backlog pubblico e verrà conteggiato.
Richiedi il tuo motore di databasePuò interrogarla anche un agente, in sola lettura
Una volta creata la connessione, un agente di coding IA la usa tramite l'MCP di AgentsRoom nominandola: db_list, db_schema per scorrere tabelle e colonne, db_query per una singola istruzione con righe limitate. Un agente può anche registrare da sé una connessione Cloud SQL con db_connection_new o db_connection_save, indicando il nome di connessione dell'istanza.
AgentsRoom avvia il proxy da solo quando l'agente lo chiede, quindi l'agente non maneggia mai una credenziale Google, una password del database o un numero di porta. Quello che torna indietro è un risultato. Le scritture richiedono una connessione scrivibile e l'impostazione Consenti agli agenti di scrivere, disattivata per impostazione predefinita.
Un agente che fa debug su una replica di produzione legge le righe che spiegano il bug, senza credenziali che possano finire nel suo contesto e senza nessuna via verso il database una volta chiusa l'app.
FAQ
Come mi connetto a un'istanza Cloud SQL che ha solo un IP privato?
Crea una connessione MySQL o PostgreSQL, scegli Google Cloud SQL in Raggiungi tramite, indica il nome di connessione dell'istanza e spunta IP privato. AgentsRoom avvia il Cloud SQL Auth Proxy con --private-ip su una porta di loopback e ci collega il suo client. La tua macchina deve raggiungere la VPC dell'istanza, per esempio tramite una VPN o un Interconnect.
AgentsRoom conserva una chiave di service account?
No. Il proxy è autorizzato dalle Application Default Credentials create sulla tua macchina da gcloud auth application-default login. AgentsRoom conserva il nome di connessione dell'istanza e le due opzioni, nessuna delle quali è una credenziale.
Posso connettermi senza una password del database?
Sì, con l'autenticazione database IAM. Spuntala nella connessione e il proxy parte con --auto-iam-authn: accede con la tua identità Google, il campo password sparisce e l'utente è il tuo utente di database IAM. L'istanza deve avere l'autenticazione IAM abilitata e quell'utente creato.
Cosa devo avere installato?
Il Cloud SQL Auth Proxy, versione 2 (gcloud components install cloud-sql-proxy, oppure il download autonomo di Google), e un login gcloud per le Application Default Credentials. gcloud in sé serve solo per il pulsante Elenca le mie istanze.
Cosa succede quando il mio login gcloud scade?
Il proxy rifiuta la connessione e registra il motivo. AgentsRoom legge quel log e mostra un messaggio chiaro che ti dice di eseguire gcloud auth application-default login, invece di un semplice errore di connessione. Poi riprovi.
Quale porta locale viene usata, e chi può raggiungerla?
Il sistema operativo sceglie una porta libera quando la connessione si apre, e il proxy è in ascolto solo su 127.0.0.1. Nulla sulla rete locale può raggiungerla, e il proxy si ferma quando la connessione si chiude o l'app esce.
Quali motori Cloud SQL sono supportati?
Cloud SQL per MySQL e Cloud SQL per PostgreSQL. Cloud SQL per SQL Server non è supportato perché AgentsRoom non ha ancora un client SQL Server; chiedilo sul backlog pubblico e verrà conteggiato.
Funziona su Windows e Linux?
Sì. cloud-sql-proxy è un binario nativo su macOS, Windows e Linux, e AgentsRoom lo avvia allo stesso modo su tutti e tre. L'app per telefono elenca le stesse connessioni e le interroga in sola lettura tramite il tuo desktop.
Un agente IA può interrogare il database tramite il proxy?
Sì, in sola lettura per impostazione predefinita. Un agente nomina una connessione salvata tramite l'MCP di AgentsRoom, l'app avvia il proxy ed esegue l'istruzione da sola, e torna indietro solo il risultato. L'agente non riceve mai una credenziale Google né una password del database, e db_query rifiuta tutto ciò che non è una lettura, a meno che la connessione sia scrivibile e tu abbia attivato Consenti agli agenti di scrivere per essa.
Potrebbe interessarti anche
Connessioni database
Salva le tue connessioni MySQL, PostgreSQL e MongoDB, raggiungi un database in una subnet privata tramite un tunnel SSH o una sessione AWS SSM, e lascia che i tuoi agenti IA lo interroghino via MCP. In sola lettura per impostazione predefinita, una sola istruzione per chiamata, risultati limitati, e la password non arriva mai all'agente. Esportazione, importazione e copia da database a database incluse.
RDS tramite AWS SSM
Raggiungi dalla tua macchina un'istanza Amazon RDS priva di endpoint pubblico, tramite aws ssm start-session e il documento AWS-StartPortForwardingSessionToRemoteHost. Nessun bastion da mantenere, nessuna VPN, nessuna regola SSH in ingresso. AgentsRoom apre la sessione su una porta di loopback e ci collega attraverso il suo client di database. MySQL, PostgreSQL e MongoDB, quindi RDS MySQL, RDS PostgreSQL, Aurora e DocumentDB.
Gestore di segreti
Conserva chiavi API, token e password nel portachiavi del tuo sistema operativo, richiamali come {{secret:NAME}} nei comandi di sviluppo e negli ambienti degli agenti, e lascia che AgentsRoom li risolva all'avvio. Gli agenti vedono i nomi, mai i valori, e nulla viene mai sincronizzato su un server.
Connessioni SSH
Salva le tue connessioni SSH, apri un terminale SSH integrato ed esegui Claude Code, Codex o Antigravity CLI direttamente sul tuo server remoto o VPS. Autenticazione con chiave SSH o password, profili di connessione per progetto, senza un client SSH separato.
Interroga la tua istanza Cloud SQL privata
Scarica AgentsRoom, scegli la tua istanza Cloud SQL e interrogala tramite il Cloud SQL Auth Proxy con il tuo login gcloud: nessuna VM bastion, nessun IP pubblico, nessuna chiave su disco.
App companion: monitora i tuoi agenti in movimento
Usa Claude, Codex, Antigravity CLI o un altro provider IA.
Invia bug e richieste direttamente nel tuo backlog pubblico.