Tu instancia de Cloud SQL no tiene IP pública.
Llega hasta ella por su nombre, sin VM bastión.
AgentsRoom arranca el Cloud SQL Auth Proxy al abrir la conexión y conecta a través de él su cliente de base de datos. Das el nombre de conexión de la instancia, project:region:instance, o la eliges de la lista que tu propio inicio de sesión de gcloud puede ver.
El proxy lo autorizan tus Application Default Credentials (credenciales predeterminadas de la aplicación), así que AgentsRoom no guarda ninguna clave de cuenta de servicio. Con la autenticación IAM de la base de datos, tampoco hay contraseña. Y un agente de código con IA puede consultar la misma instancia, en solo lectura.
Cómo AgentsRoom llega a una instancia de Cloud SQL por su IP privada mediante el Cloud SQL Auth Proxy, sin guardar nada en la app.
Una instancia de Cloud SQL solo con IP privada es la configuración correcta, y también una incómoda. La base de datos vive en tu VPC, su IP pública está apagada, y las únicas máquinas que pueden llegar a ella son las que están dentro de esa red. Y entonces un bug te obliga a mirar tres filas, desde un portátil.
Google ya trae la respuesta: el Cloud SQL Auth Proxy. Abre una conexión cifrada con la instancia, autorizada por tu identidad de Google en lugar de por una lista de IP permitidas, y la expone como un puerto local. La fricción de siempre está en todo lo que lo rodea: instalarlo, acordarte del nombre de conexión de la instancia, arrancarlo en una terminal antes de abrir un cliente, y olvidarlo funcionando después.
AgentsRoom se encarga de esa parte. Eliges Google Cloud SQL en el campo Llegar a través de de una conexión de base de datos, indicas la instancia, marcas IP privada o Autenticación IAM de la base de datos si las necesitas, y a partir de ahí abrir esa base es cuestión de un clic. El proxy arranca con la conexión y se detiene con ella.
Las salidas habituales tienen todas un precio
Tres respuestas al mismo problema, y lo que te cobra cada una.
Una VM bastión solo para esto
Una VM de Compute Engine con un puerto SSH, mantenida en la VPC únicamente para que alguien pueda abrir de vez en cuando un túnel hacia la base de datos. Hay que parchearla, cuesta dinero cada hora, y sus claves SSH y sus reglas de firewall se van desajustando conforme el equipo cambia.
Una IP pública y una lista de permitidas
Activar la IP pública y añadir la dirección de tu casa a las redes autorizadas funciona hasta que esa dirección cambia, y mientras tanto la base de datos está escuchando en internet. Es la excepción que nunca se retira.
Una clave de cuenta de servicio en un portátil
Descargar una clave JSON para ejecutar el proxy es el atajo que todo el mundo acaba lamentando: una credencial de larga duración en una carpeta de Descargas, copiada en scripts y prompts, que nadie renueva y que nadie puede rastrear.
De una instancia privada de Cloud SQL a un resultado de consulta
Cuatro pasos, hechos una vez, y después es un clic.
Inicia sesión con gcloud, una sola vez
Ejecuta gcloud auth application-default login en tu máquina. Las Application Default Credentials que crea son las que usa el proxy para llegar a la instancia. AgentsRoom no lee nada de eso ni guarda nada de eso.
Elige la instancia en Llegar a través de
Crea una conexión MySQL o PostgreSQL y elige Google Cloud SQL en Llegar a través de. Escribe el nombre de conexión de la instancia, project:region:instance, o haz clic en Listar mis instancias para elegirla entre las que tu sesión de gcloud puede ver. El host y el puerto desaparecen: la instancia es la dirección.
Elige IP privada y autenticación IAM
Marca IP privada cuando la instancia no tenga dirección pública y tu máquina llegue a su VPC mediante una VPN o Interconnect. Marca Autenticación IAM de la base de datos para entrar con tu identidad de Google: el campo de contraseña desaparece, y el usuario es tu usuario de base de datos IAM.
Consúltala, o deja que la consulte un agente
Al abrir la conexión se reserva un puerto loopback libre, se arranca cloud-sql-proxy en él y se espera a que acepte una conexión TCP. La consola se conecta a 127.0.0.1 como con cualquier otra conexión, y un agente de IA puede consultarla por MCP, en solo lectura. Al cerrar la conexión, el proxy se detiene.
El comando que lanza AgentsRoom
No se reimplementa nada. AgentsRoom ejecuta el binario cloud-sql-proxy de Google (versión 2) como proceso hijo, con sus argumentos pasados directamente en lugar de a través de un shell. Si alguna vez has arrancado el proxy a mano, esta es la línea que ya conoces.
cloud-sql-proxy acme-prod:europe-west1:orders \
--address 127.0.0.1 --port 54321 \
--private-ip \
--auto-iam-authnLa instancia y las dos opciones salen de la conexión que guardaste. El puerto local lo elige el sistema operativo al abrir.
El proxy acepta la conexión local antes de comprobar nada, y luego la corta y registra el motivo cuando algo va mal. AgentsRoom lee ese registro y te dice la causa real: el proxy no está instalado, tu sesión de gcloud ha caducado (con el comando que debes ejecutar), tu cuenta no tiene el rol Cloud SQL Client, la instancia no tiene IP privada, o el nombre de la instancia es incorrecto.
Lo que tiene que cumplirse para que funcione
AgentsRoom maneja tu configuración de Google Cloud, no la sustituye. Son las mismas cosas que el proxy necesita por sí solo.
cloud-sql-proxy en tu máquina
La versión 2 del Cloud SQL Auth Proxy, en tu PATH. gcloud components install cloud-sql-proxy es la forma más rápida; Google también lo ofrece como descarga independiente. Si falta, AgentsRoom lo dice y te da el comando.
Application Default Credentials
gcloud auth application-default login, ejecutado una vez. Cuando esa sesión caduca, el error te indica que la vuelvas a ejecutar en lugar de mostrar un socket cerrado.
El rol Cloud SQL Client
Tu cuenta de Google necesita el rol Cloud SQL Client en el proyecto de la instancia, y la API de Cloud SQL Admin debe estar habilitada allí. La autenticación IAM de la base de datos necesita además el rol Cloud SQL Instance User y un usuario IAM en la instancia.
gcloud para la lista de selección
Listar mis instancias ejecuta gcloud sql instances list en tu proyecto activo, o en el proyecto que hayas empezado a escribir. Sin gcloud, aun así puedes escribir el nombre de conexión a mano.
Una ruta hasta la VPC para la IP privada
IP privada significa que tu propia máquina debe llegar a la VPC de la instancia, mediante una VPN, Interconnect o una máquina dentro de la red. Sin esa ruta, deja IP privada sin marcar y usa la IP pública con el cifrado del proxy.
Lo que hace el proxy, y lo que se niega a hacer
Las propiedades que deciden si es seguro dejar esto configurado en un portátil.
Solo loopback
El proxy escucha en 127.0.0.1 y en ningún otro sitio. La base de datos nunca se republica en la red local, así que el wifi de una cafetería no se convierte en un camino hacia producción.
Un puerto elegido por el sistema
AgentsRoom pide al sistema operativo un puerto libre y se lo entrega al proxy. Ningún puerto fijo que recordar, ninguna colisión con otro proxy que hayas arrancado a mano.
Listo significa listo
La conexión solo se abre cuando el puerto local acepta TCP, y un proxy que termina enseguida informa del motivo que imprimió. Ninguna espera arbitraria, ningún cliente que se conecte demasiado pronto.
Ninguna clave guardada
El proxy lo autorizan tus Application Default Credentials. AgentsRoom guarda el nombre de conexión de la instancia y dos opciones, ninguna de las cuales es una credencial, y ninguna clave de cuenta de servicio llega nunca a la app.
La base de datos sigue en solo lectura
Una conexión de base de datos es de solo lectura al crearse. Una escritura exige que esa conexión se haga escribible y una confirmación explícita, más contundente en una conexión marcada como producción.
Una sentencia por llamada
Cada llamada lleva exactamente una sentencia, así que nada se esconde tras un punto y coma, y los resultados tienen un tope para que una consulta ancha no inunde una ventana ni el contexto de un agente.
Por qué esto es menos acceso, no más
No se abre nada en el lado de la instancia. La IP pública puede seguir apagada, no se añade ninguna red a la lista de autorizadas, y no se mantiene viva ninguna VM con un puerto SSH para la consulta ocasional. El proxy cifra la conexión de extremo a extremo hasta la instancia.
La autorización se queda donde tu organización la gestiona: tu identidad de Google y sus roles de IAM. El acceso concedido a esa identidad queda registrado como cualquier otra conexión a Cloud SQL y termina el día en que se retira el rol. AgentsRoom guarda el nombre de la instancia, la elección de IP privada y la de IAM, y nada que pueda reutilizar alguien que los haya leído.
En el lado de la base de datos, las salvaguardas son las que recibe toda conexión de AgentsRoom: solo lectura por defecto, una sentencia por llamada, resultados con tope y un indicador de producción que endurece la confirmación de escritura. Un agente de IA que consulta por MCP recibe un conjunto de resultados, nunca una credencial, y no puede escribir a menos que hayas hecho escribible esa conexión y activado Permitir que los agentes escriban para ella.
MySQL y PostgreSQL, SQL Server todavía no
Cloud SQL ejecuta MySQL, PostgreSQL y SQL Server. AgentsRoom llega a los dos primeros a través del proxy, y hoy no tiene un cliente de SQL Server. AlloyDB, que tiene su propio proxy, tampoco está cubierto.
Qué motor o servicio llega después lo decide lo que pide la gente. Si falta el tuyo, dilo en el backlog público y se contabiliza.
Pide tu motor de base de datosUn agente también puede consultarla, en solo lectura
Una vez creada la conexión, un agente de código con IA la usa a través del MCP de AgentsRoom nombrándola: db_list, db_schema para recorrer tablas y columnas, db_query para una sentencia con un tope de filas. Un agente también puede registrar él mismo una conexión de Cloud SQL con db_connection_new o db_connection_save, indicando el nombre de conexión de la instancia.
AgentsRoom arranca el proxy por sí mismo cuando el agente lo pide, así que el agente nunca maneja una credencial de Google, una contraseña de base de datos ni un número de puerto. Lo que vuelve es un conjunto de resultados. Las escrituras exigen una conexión escribible y el ajuste Permitir que los agentes escriban, desactivado por defecto.
Un agente que depura contra una réplica de producción lee las filas que explican el bug, sin ninguna credencial que pueda filtrarse a su contexto y sin ningún camino hacia la base de datos una vez cerrada la app.
FAQ
¿Cómo me conecto a una instancia de Cloud SQL que solo tiene IP privada?
Crea una conexión MySQL o PostgreSQL, elige Google Cloud SQL en Llegar a través de, indica el nombre de conexión de la instancia y marca IP privada. AgentsRoom arranca el Cloud SQL Auth Proxy con --private-ip en un puerto loopback y conecta su cliente a él. Tu máquina debe llegar a la VPC de la instancia, por ejemplo mediante una VPN o Interconnect.
¿AgentsRoom guarda una clave de cuenta de servicio?
No. El proxy lo autorizan las Application Default Credentials que gcloud auth application-default login creó en tu máquina. AgentsRoom guarda el nombre de conexión de la instancia y las dos opciones, ninguna de las cuales es una credencial.
¿Puedo conectarme sin contraseña de base de datos?
Sí, con la autenticación IAM de la base de datos. Márcala en la conexión y el proxy se ejecuta con --auto-iam-authn: te autentica con tu identidad de Google, el campo de contraseña desaparece, y el usuario es tu usuario de base de datos IAM. La instancia debe tener la autenticación IAM habilitada y ese usuario creado.
¿Qué necesito tener instalado?
El Cloud SQL Auth Proxy, versión 2 (gcloud components install cloud-sql-proxy, o la descarga independiente de Google), y un inicio de sesión de gcloud para las Application Default Credentials. gcloud en sí solo hace falta para el botón Listar mis instancias.
¿Qué pasa cuando caduca mi sesión de gcloud?
El proxy rechaza la conexión y registra el motivo. AgentsRoom lee ese registro y muestra un mensaje claro que te indica ejecutar gcloud auth application-default login, en lugar de un error de conexión a secas. Después vuelves a intentarlo.
¿Qué puerto local se usa y quién puede acceder a él?
El sistema operativo elige un puerto libre al abrir la conexión, y el proxy escucha únicamente en 127.0.0.1. Nada de la red local puede llegar a él, y el proxy se detiene cuando la conexión se cierra o la app se cierra.
¿Qué motores de Cloud SQL están soportados?
Cloud SQL for MySQL y Cloud SQL for PostgreSQL. Cloud SQL for SQL Server no está soportado porque AgentsRoom todavía no tiene un cliente de SQL Server; pídelo en el backlog público y se contabiliza.
¿Funciona en Windows y Linux?
Sí. cloud-sql-proxy es un binario nativo en macOS, Windows y Linux, y AgentsRoom lo arranca de la misma forma en los tres. La app del móvil lista las mismas conexiones y las consulta en solo lectura a través de tu escritorio.
¿Puede un agente de IA consultar la base de datos a través del proxy?
Sí, en solo lectura por defecto. Un agente nombra una conexión guardada a través del MCP de AgentsRoom, la app arranca el proxy y ejecuta la sentencia ella misma, y solo vuelve el conjunto de resultados. El agente nunca recibe una credencial de Google ni una contraseña de base de datos, y db_query rechaza cualquier cosa que no sea una lectura, a menos que la conexión sea escribible y hayas activado Permitir que los agentes escriban para ella.
También te puede interesar
Conexiones de base de datos
Guarda tus conexiones MySQL, PostgreSQL y MongoDB, llega a una base de datos en una subred privada a través de un túnel SSH o una sesión de AWS SSM, y deja que tus agentes de IA la consulten por MCP. Solo lectura por defecto, una sentencia por llamada, conjuntos de resultados limitados y la contraseña nunca llega al agente. Exportación, importación y copia de una base de datos sobre otra incluidas.
RDS a través de AWS SSM
Llega desde tu propia máquina a una instancia Amazon RDS sin endpoint público, con aws ssm start-session y el documento AWS-StartPortForwardingSessionToRemoteHost. Ningún bastión que mantener, ninguna VPN, ninguna regla SSH de entrada. AgentsRoom abre la sesión en un puerto loopback y conecta a través de ella su cliente de base de datos. MySQL, PostgreSQL y MongoDB, es decir RDS MySQL, RDS PostgreSQL, Aurora y DocumentDB.
Gestor de secretos
Guarda claves de API, tokens y contraseñas en el llavero de tu sistema operativo, referéncialas como {{secret:NAME}} en tus comandos de desarrollo y en el entorno de tus agentes, y deja que AgentsRoom las resuelva al arrancar. Los agentes ven los nombres, nunca los valores, y nada se sincroniza con un servidor.
Conexiones SSH
Guarda tus conexiones SSH, abre una terminal SSH integrada y ejecuta Claude Code, Codex o Antigravity CLI directamente en tu servidor remoto o VPS. Autenticación por clave SSH o contraseña, perfiles de conexión por proyecto, sin necesidad de un cliente SSH aparte.
Consulta tu instancia privada de Cloud SQL
Descarga AgentsRoom, elige tu instancia de Cloud SQL y consúltala a través del Cloud SQL Auth Proxy con tu propio inicio de sesión de gcloud: sin VM bastión, sin IP pública, sin ninguna clave en el disco.
App complementaria: supervisa tus agentes en movimiento
Usa Claude, Codex, Antigravity CLI u otro proveedor de IA.
Envía bugs y peticiones directamente a tu backlog público.