A sua instância Cloud SQL não tem IP público.
Alcance-a pelo nome, sem VM bastion.
O AgentsRoom inicia o Cloud SQL Auth Proxy quando você abre a conexão e conecta o cliente de banco de dados dele a ele. Você informa o nome de conexão da instância, project:region:instance, ou a escolhe na lista que o seu login do gcloud consegue ver.
O proxy é autorizado pelas suas Application Default Credentials (credenciais padrão do aplicativo), então o AgentsRoom não armazena nenhuma chave de conta de serviço. Com a autenticação de banco de dados IAM, também não há senha de banco de dados. E um agente de IA de programação pode consultar a mesma instância, somente leitura.
Como o AgentsRoom alcança uma instância Cloud SQL pelo IP privado dela por meio do Cloud SQL Auth Proxy, sem armazenar nada do lado do aplicativo.
Uma instância Cloud SQL só com IP privado é a configuração certa, e também a incômoda. O banco de dados vive na sua VPC, o IP público dele está desligado, e as únicas máquinas que conseguem alcançá-lo são as que estão dentro dessa rede. Aí um bug exige olhar três linhas, a partir de um notebook.
O Google já entrega a resposta: o Cloud SQL Auth Proxy. Ele abre uma conexão criptografada com a instância, autorizada pela sua identidade Google em vez de uma lista de IPs permitidos, e a expõe como uma porta local. O atrito está em tudo ao redor: instalá-lo, lembrar o nome de conexão da instância, iniciá-lo em um terminal antes de abrir um cliente e esquecê-lo rodando depois.
O AgentsRoom cuida dessa parte. Você escolhe Google Cloud SQL no campo Acessar através de de uma conexão de banco de dados, informa a instância, marca IP privado ou Autenticação de banco de dados IAM se precisar, e a partir daí abrir esse banco é um clique. O proxy inicia com a conexão e para com ela.
Os atalhos de sempre custam alguma coisa
Três respostas para o mesmo problema, e o que cada uma delas cobra de você.
Uma VM bastion só para isso
Uma VM do Compute Engine com uma porta SSH, mantida na VPC só para que alguém possa abrir um túnel até o banco de vez em quando. Ela precisa de atualizações, custa dinheiro a cada hora, e as chaves SSH e as regras de firewall dela se desatualizam conforme a equipe muda.
Um IP público e uma lista de permissões
Ligar o IP público e adicionar o endereço da sua casa às redes autorizadas funciona até o endereço mudar, e nesse meio-tempo o banco de dados fica escutando na internet. É a exceção que nunca é removida.
Uma chave de conta de serviço em um notebook
Baixar uma chave JSON para rodar o proxy é o atalho de que todo mundo se arrepende: uma credencial de longa duração em uma pasta Downloads, copiada para scripts e prompts, que ninguém rotaciona e que ninguém consegue rastrear.
De uma instância Cloud SQL privada a um resultado
Quatro passos, feitos uma vez, e depois é só um clique.
Faça login com o gcloud, uma vez
Rode gcloud auth application-default login na sua máquina. As Application Default Credentials que ele cria são as que o proxy usa para alcançar a instância. O AgentsRoom não lê nada delas e não armazena nada delas.
Escolha a instância em Acessar através de
Crie uma conexão MySQL ou PostgreSQL e escolha Google Cloud SQL em Acessar através de. Digite o nome de conexão da instância, project:region:instance, ou clique em Listar minhas instâncias para escolhê-la entre as que o seu login do gcloud consegue ver. Host e porta somem: o endereço é a instância.
Escolha IP privado e autenticação IAM
Marque IP privado quando a instância não tem endereço público e a sua máquina alcança a VPC dela por uma VPN ou um Interconnect. Marque Autenticação de banco de dados IAM para entrar com a sua identidade Google: o campo de senha some e o usuário é o seu usuário de banco de dados IAM.
Consulte você, ou deixe um agente consultar
Abrir a conexão reserva uma porta loopback livre, inicia o cloud-sql-proxy nela e espera até que aceite uma conexão TCP. O console se conecta a 127.0.0.1 como em qualquer outra conexão, e um agente de IA pode consultá-la por MCP, somente leitura. Fechar a conexão para o proxy.
O comando que o AgentsRoom executa
Nada é reimplementado. O AgentsRoom roda o binário cloud-sql-proxy do próprio Google (versão 2) como processo filho, com os argumentos passados diretamente e não por um shell. Se você já iniciou o proxy na mão, essa é a linha que você já conhece.
cloud-sql-proxy acme-prod:europe-west1:orders \
--address 127.0.0.1 --port 54321 \
--private-ip \
--auto-iam-authnA instância e as duas opções vêm da conexão que você salvou. A porta local é escolhida pelo sistema operacional na hora de abrir.
O proxy aceita a conexão local antes de verificar qualquer coisa, depois a derruba e registra o motivo quando algo está errado. O AgentsRoom lê esse log e mostra a causa real: o proxy não está instalado, o seu login do gcloud expirou (com o comando a rodar), a sua conta não tem o papel Cloud SQL Client, a instância não tem IP privado, ou o nome da instância está errado.
O que precisa estar de pé para funcionar
O AgentsRoom conduz a sua configuração do Google Cloud, não a substitui. São as mesmas coisas de que o proxy precisa sozinho.
cloud-sql-proxy na sua máquina
A versão 2 do Cloud SQL Auth Proxy, no seu PATH. gcloud components install cloud-sql-proxy é o jeito mais rápido; o Google também o distribui como download independente. Se estiver faltando, o AgentsRoom avisa e indica o comando.
Application Default Credentials
gcloud auth application-default login, rodado uma vez. Quando esse login expira, o erro manda rodá-lo de novo em vez de mostrar um socket fechado.
O papel Cloud SQL Client
A sua conta Google precisa do papel Cloud SQL Client no projeto da instância, e a API Cloud SQL Admin precisa estar ativada lá. A autenticação de banco de dados IAM também exige o papel Cloud SQL Instance User e um usuário IAM na instância.
gcloud para a lista de escolha
Listar minhas instâncias roda gcloud sql instances list no seu projeto ativo, ou no projeto que você começou a digitar. Sem o gcloud, você ainda pode digitar o nome de conexão à mão.
Uma rota até a VPC para o IP privado
IP privado significa que a sua própria máquina precisa alcançar a VPC da instância, por uma VPN, um Interconnect ou uma máquina dentro da rede. Sem essa rota, deixe IP privado desligado e use o IP público com a criptografia do proxy.
O que o proxy faz, e o que ele se recusa a fazer
As propriedades que decidem se dá para deixar isso configurado em um notebook com segurança.
Apenas loopback
O proxy escuta em 127.0.0.1 e em mais nada. O banco de dados nunca é republicado na rede local, então o Wi-Fi de uma cafeteria não vira um caminho até a produção.
Uma porta escolhida pelo sistema
O AgentsRoom pede uma porta livre ao sistema operacional e a entrega ao proxy. Sem porta fixa para lembrar, sem colisão com outro proxy que você tenha iniciado à mão.
Pronto significa pronto
A conexão só abre quando a porta local aceita TCP, e um proxy que sai de imediato informa o motivo que imprimiu. Sem espera arbitrária, sem cliente se conectando cedo demais.
Nenhuma chave armazenada
O proxy é autorizado pelas suas Application Default Credentials. O AgentsRoom armazena o nome de conexão da instância e duas opções, nenhuma delas uma credencial, e nenhuma chave de conta de serviço chega a tocar o aplicativo.
O banco continua somente leitura
Uma conexão de banco de dados nasce somente leitura. Escrever exige tornar essa conexão gravável e uma confirmação explícita, mais enfática em uma conexão marcada como produção.
Uma instrução por chamada
Cada chamada leva exatamente uma instrução, então nada se esconde atrás de um ponto e vírgula, e os resultados têm limite para que uma consulta larga não inunde uma janela nem o contexto de um agente.
Por que isso é menos acesso, não mais
Nada é aberto do lado da instância. O IP público pode continuar desligado, nenhuma rede é adicionada à lista de autorizadas e nenhuma VM com porta SSH fica ligada para a consulta ocasional. O proxy criptografa a conexão de ponta a ponta até a instância.
A autorização fica onde a sua organização a gerencia: a sua identidade Google e os papéis IAM dela. O acesso concedido a essa identidade é registrado como qualquer outra conexão ao Cloud SQL e termina no dia em que o papel é removido. O AgentsRoom guarda o nome da instância, a escolha de IP privado e a escolha de IAM, e nada que possa ser reaproveitado por quem os lesse.
Do lado do banco, as proteções são as mesmas de toda conexão do AgentsRoom: somente leitura por padrão, uma instrução por chamada, resultados limitados e uma marca de produção que endurece a confirmação de escrita. Um agente de IA que consulta por MCP recebe um resultado, nunca uma credencial, e não consegue escrever a menos que você tenha tornado essa conexão gravável e ativado Permitir que os agentes escrevam para ela.
MySQL e PostgreSQL, ainda não SQL Server
O Cloud SQL roda MySQL, PostgreSQL e SQL Server. O AgentsRoom alcança os dois primeiros pelo proxy e hoje não tem um cliente SQL Server. O AlloyDB, que tem proxy próprio, também não é coberto.
Qual motor ou serviço vem em seguida é decidido pelo que as pessoas pedem. Se o seu está faltando, diga qual no backlog público e ele entra na conta.
Peça o seu motor de banco de dadosUm agente também pode consultá-la, somente leitura
Depois que a conexão existe, um agente de IA de programação a usa pelo MCP do AgentsRoom, citando-a pelo nome: db_list, db_schema para percorrer tabelas e colunas, db_query para uma única instrução com linhas limitadas. Um agente também pode registrar sozinho uma conexão Cloud SQL com db_connection_new ou db_connection_save, informando o nome de conexão da instância.
O AgentsRoom inicia o proxy por conta própria quando o agente pede, então o agente nunca lida com uma credencial Google, uma senha de banco de dados ou um número de porta. O que volta é um resultado. Escrever exige uma conexão gravável e a configuração Permitir que os agentes escrevam, desligada por padrão.
Um agente depurando contra uma réplica de produção lê as linhas que explicam o bug, sem credencial para vazar no contexto dele e sem caminho até o banco de dados depois que o aplicativo é fechado.
Perguntas frequentes
Como me conecto a uma instância Cloud SQL que só tem IP privado?
Crie uma conexão MySQL ou PostgreSQL, escolha Google Cloud SQL em Acessar através de, informe o nome de conexão da instância e marque IP privado. O AgentsRoom inicia o Cloud SQL Auth Proxy com --private-ip em uma porta loopback e conecta o cliente dele a ela. A sua máquina precisa alcançar a VPC da instância, por exemplo por uma VPN ou um Interconnect.
O AgentsRoom armazena uma chave de conta de serviço?
Não. O proxy é autorizado pelas Application Default Credentials que gcloud auth application-default login criou na sua máquina. O AgentsRoom armazena o nome de conexão da instância e as duas opções, nenhuma delas uma credencial.
Posso me conectar sem senha de banco de dados?
Sim, com a autenticação de banco de dados IAM. Marque-a na conexão e o proxy roda com --auto-iam-authn: ele entra com a sua identidade Google, o campo de senha some e o usuário é o seu usuário de banco de dados IAM. A instância precisa ter a autenticação IAM ativada e esse usuário criado.
O que preciso ter instalado?
O Cloud SQL Auth Proxy, versão 2 (gcloud components install cloud-sql-proxy, ou o download independente do Google), e um login do gcloud para as Application Default Credentials. O gcloud em si só é necessário para o botão Listar minhas instâncias.
O que acontece quando o meu login do gcloud expira?
O proxy recusa a conexão e registra o motivo. O AgentsRoom lê esse log e mostra uma mensagem clara mandando você rodar gcloud auth application-default login, em vez de um simples erro de conexão. Depois você tenta de novo.
Qual porta local é usada, e quem consegue alcançá-la?
O sistema operacional escolhe uma porta livre quando a conexão abre, e o proxy escuta somente em 127.0.0.1. Nada na rede local consegue alcançá-la, e o proxy para quando a conexão fecha ou o aplicativo é encerrado.
Quais motores do Cloud SQL são suportados?
Cloud SQL para MySQL e Cloud SQL para PostgreSQL. O Cloud SQL para SQL Server não é suportado porque o AgentsRoom ainda não tem um cliente SQL Server; peça no backlog público e ele entra na conta.
Funciona no Windows e no Linux?
Sim. O cloud-sql-proxy é um binário nativo no macOS, no Windows e no Linux, e o AgentsRoom o inicia do mesmo jeito nos três. O aplicativo do celular lista as mesmas conexões e as consulta somente leitura pelo seu desktop.
Um agente de IA pode consultar o banco de dados pelo proxy?
Sim, somente leitura por padrão. Um agente cita uma conexão salva pelo MCP do AgentsRoom, o aplicativo inicia o proxy e executa a instrução por conta própria, e só o resultado volta. O agente nunca recebe uma credencial Google nem uma senha de banco de dados, e o db_query recusa qualquer coisa que não seja leitura, a menos que a conexão seja gravável e você tenha ativado Permitir que os agentes escrevam para ela.
Você também pode gostar
Conexões de banco de dados
Salve suas conexões MySQL, PostgreSQL e MongoDB, alcance um banco de dados em uma sub-rede privada por um túnel SSH ou uma sessão AWS SSM, e deixe seus agentes de IA consultá-lo por MCP. Somente leitura por padrão, uma instrução por chamada, resultados limitados, e a senha nunca chega ao agente. Exportação, importação e cópia de um banco sobre outro incluídas.
RDS via AWS SSM
Alcance uma instância Amazon RDS que não tem endpoint público, a partir da sua própria máquina, com aws ssm start-session e o documento AWS-StartPortForwardingSessionToRemoteHost. Sem bastion para manter, sem VPN, sem regra SSH de entrada. O AgentsRoom abre a sessão em uma porta loopback e conecta o cliente de banco de dados através dela. MySQL, PostgreSQL e MongoDB, ou seja, RDS MySQL, RDS PostgreSQL, Aurora e DocumentDB.
Gerenciador de segredos
Armazene chaves de API, tokens e senhas no chaveiro do seu sistema operacional, referencie-os como {{secret:NAME}} nos comandos de dev e nos ambientes dos agentes, e deixe o AgentsRoom resolvê-los na inicialização. Os agentes veem os nomes, nunca os valores, e nada é sincronizado com um servidor.
Conexões SSH
Salve suas conexões SSH, abra um terminal integrado via SSH e execute o Claude Code, o Codex ou o Antigravity CLI diretamente no seu servidor remoto ou VPS. Autenticação por chave SSH ou senha, perfis de conexão por projeto, sem precisar de um cliente SSH separado.
Consulte a sua instância Cloud SQL privada
Baixe o AgentsRoom, escolha a sua instância Cloud SQL e consulte-a pelo Cloud SQL Auth Proxy com o seu próprio login do gcloud: sem VM bastion, sem IP público, sem chave no disco.
App complementar: acompanhe seus agentes em qualquer lugar
Use Claude, Codex, Antigravity CLI ou outro provedor de IA.
Envie bugs e pedidos direto para o seu backlog público.