Cómo conectar Supabase a un agente de IA paso a paso

· DoubleX

Respuesta rápida

Para conectar Supabase a un agente de IA, abre la pantalla Conectores, elige Supabase y autoriza el acceso con tu cuenta. Luego define en el agente qué acciones puede ejecutar, deja solo lectura al inicio y prueba con una consulta. En DoubleX Agentes, el agente pide confirmación antes de alterar datos.

Supabase concentra el proyecto, la base Postgres, las migraciones y las edge functions de muchos equipos. Conectarlo a un agente de IA permite consultar y revisar todo eso con pedidos en lenguaje natural, pero conviene hacerlo con orden: primero quién autoriza, luego qué puede hacer el agente y al final una prueba segura.

¿Qué permite el conector de Supabase al agente?#

El conector de Supabase permite al agente gestionar proyectos, bases de datos, migraciones y edge functions. Es decir, el agente usa las herramientas de Supabase en tu nombre, dentro de los límites que tú definas.

Un conector es un sistema ligado a la plataforma cuyas herramientas pueden usar los agentes. Estos son ejemplos de lo que puedes pedir:

TareaCómo ayuda el agenteTipo de acción
Revisar la estructura de una tablaLista tablas y columnas del proyectoLectura
Entender el estado de las migracionesConsulta las migraciones del proyecto y las resumeLectura
Revisar edge functionsMuestra qué funciones existen en el proyectoLectura
Aplicar una migraciónPrepara el cambio y espera tu confirmaciónModifica datos

Si quieres ideas de pedidos y rutinas ya armadas, consulta la guía Supabase con agente de IA: ejemplos de pedidos y rutinas.

¿Qué preparar antes de conectar (cuenta, proyecto y quién autoriza)?#

Antes de conectar necesitas tres cosas: una cuenta de DoubleX Agentes, acceso a la cuenta de Supabase y claridad sobre quién va a autorizar la conexión. Crear la cuenta es gratis y no pide tarjeta.

Usa esta lista de verificación:

ElementoQué confirmar
Cuenta de DoubleX AgentesCreada, con el segmento de la empresa y el objetivo informados
Cuenta de SupabaseAcceso al proyecto que el agente va a consultar
Quién autorizaUna persona con permiso real sobre el proyecto de Supabase
Alcance de la conexiónPersonal, del equipo o de la empresa
Agente que lo usaráCreado o generado desde el diagnóstico

Una conexión puede ser personal (vale solo para ti), del equipo o de la empresa. Si el agente será usado por varias personas, define con quién se comparte antes de autorizar. Si todavía no tienes agentes, el diagnóstico es una conversación de 5 a 10 minutos con la consultora de IA del producto y puede convertirse en un equipo de agentes con un clic. Lo explica el Inicio rápido.

¿Cómo conectar Supabase en la pantalla Conectores?#

Se conecta desde la pantalla Conectores: eliges Supabase, autorizas con tu cuenta y asignas el conector al agente. Estos son los pasos en DoubleX Agentes:

  1. Entra en la pantalla Agentes y abre el agente que usará Supabase, o créalo describiendo lo que necesitas con tus propias palabras.
  2. Ve a Conectores y busca Supabase en la lista.
  3. Inicia la conexión y autoriza el acceso con la cuenta de Supabase que corresponda.
  4. Elige el alcance de la conexión: personal, del equipo o de la empresa.
  5. Vuelve al agente y activa el conector de Supabase entre los sistemas que puede usar.
  6. Define las acciones permitidas (siguiente sección) antes del primer pedido.

Las contraseñas, tokens y claves de las conexiones se guardan cifrados con AES-256-GCM. Para quienes desarrollan, la referencia de conectores de la API explica cómo gestionarlos de forma programática.

¿Cómo limitar al agente a solo lectura y exigir confirmación?#

Para cada agente, la empresa elige qué sistemas usa y, dentro de cada sistema, qué acciones puede ejecutar. Las acciones que modifican datos pueden quedar desactivadas, de modo que el agente solo lea.

Lo recomendable es este orden:

  1. Deja activadas solo las acciones de consulta (listar tablas, leer migraciones, ver funciones).
  2. Mantén desactivadas las acciones que modifican datos, como aplicar migraciones o publicar cambios.
  3. Prueba el agente durante unos días con pedidos de lectura.
  4. Si hace falta, activa una acción de escritura puntual y concreta.
  5. Recuerda que, antes de enviar, borrar o alterar algo en los sistemas, el agente pide confirmación y muestra el paso a paso de lo que hizo.

También puedes asignar este agente solo a las personas que realmente lo necesitan. Los roles de dueño, administrador y miembro, y el compartir por persona, equipo o empresa, ayudan a controlar quién lo usa.

¿Cómo probar la conexión con un primer pedido?#

La mejor prueba es un pedido de solo lectura, que no cambie nada y confirme que el agente llega al proyecto correcto. Escribe el pedido en el chat del agente y revisa la respuesta.

Ejemplos que puedes copiar:

  • "Lista las tablas del proyecto de Supabase y dime cuántas columnas tiene cada una."
  • "Muéstrame las migraciones aplicadas y resume qué cambió en la última."
  • "Revisa qué edge functions existen en el proyecto y descríbelas en una frase cada una."
  • "Dame un resumen de la estructura de la tabla de clientes, sin modificar nada."

Si la respuesta coincide con lo que ves en Supabase, la conexión funciona. Si el agente dice que no tiene acceso, revisa que el conector esté activado en el agente y que la cuenta autorizada tenga permiso sobre el proyecto.

¿Qué revisar en el historial de la tarea después de la prueba?#

Cada pedido a un agente se convierte en una tarea con historial completo: el pedido, cada herramienta que usó el agente y el resultado. Ábrelo en la pantalla Tareas y confirma tres cosas.

  • Herramientas usadas: que solo aparezcan acciones de lectura.
  • Proyecto consultado: que sea el proyecto que querías.
  • Quién lo pidió y cuándo: que quede registrado para auditoría.

Cuando el historial salga limpio en varias pruebas, puedes pasar a rutinas programadas, por ejemplo un resumen semanal de migraciones. Una rutina se ejecuta con los permisos de quien la creó, así que revisa tus permisos antes de programarla. Los detalles están en la documentación de Disparadores.

Preguntas frecuentes#

¿Necesito saber programar para conectar Supabase?#

No. Conectas desde la pantalla Conectores y describes lo que necesitas con tus palabras. Quien quiera ir más lejos tiene API REST, CLI y servidor MCP.

¿El agente puede modificar mi base de datos?#

Solo si tú activas esas acciones. Puedes dejar el agente en solo lectura, y cuando una acción altera datos, el agente pide confirmación antes de ejecutarla.

¿Mis datos se usan para entrenar modelos?#

No. El contenido de la empresa no se usa para entrenar modelos, y los pedidos solo van a proveedores de IA que no usan lo que reciben para entrenamiento. Además, cada empresa tiene su propia base de datos, separada de las demás.

¿La conexión debe ser personal o de la empresa?#

Depende de quién usará el agente. Para pruebas, la conexión personal es más prudente; para uso compartido, puedes crear una del equipo o de la empresa.

¿Puedo usar Supabase también desde ChatGPT o Claude?#

Sí, a través del servidor MCP de DoubleX Agentes puedes crear agentes y conversar con ellos desde esas aplicaciones. Mira ChatGPT y Claude (MCP) para el detalle.

Guías relacionadas

Más guías de Supabase