Conecta un proyecto de Atoms a Supabase cuando quieras que la app use una base de datos de Supabase, autenticación, almacenamiento de archivos o funciones de backend.

Esta guía te lleva por todo el proceso completo: preparar una cuenta y un proyecto de Supabase, autorizar la organización correcta, conectar el proyecto, comprobar que la conexión funcionó y desconectarlo cuando sea necesario.

Cómo funciona la conexión

Cada proyecto de Supabase pertenece a una organización, que controla quién puede acceder y administrar los proyectos dentro de ella. Cuando conectas Supabase a Atoms, primero autorizas a Atoms para acceder a la organización que quieres usar y luego seleccionas un proyecto de esa organización para conectarlo.

Cada proyecto de Atoms puede conectarse a un proyecto de Supabase a la vez. Sin embargo, el mismo proyecto de Supabase puede conectarse a más de un proyecto de Atoms.

Supabase y Nube de Atoms son opciones alternativas de backend. No puedes conectar ambas al mismo proyecto de Atoms al mismo tiempo.

Antes de empezar

Antes de conectar Supabase, asegúrate de que:

• Eres el propietario del espacio de trabajo de Atoms que contiene el proyecto. Solo el propietario del espacio de trabajo puede autorizar, conectar o desconectar Supabase.
• Tienes una cuenta de Supabase o estás listo para crear una durante la configuración.
• Tienes permiso para autorizar la organización de Supabase y acceder al proyecto con el que quieres conectarte.
• El Agente ha terminado su tarea actual y el Modo Carrera está desactivado.
• Tu navegador permite ventanas emergentes de Atoms.
• Tu proyecto de Atoms no está ya conectado a Nube de Atoms.

Si estás probando esta conexión por primera vez, considera usar un proyecto de prueba mientras aprendes el proceso.

Nunca pegues una contraseña de Supabase, clave de API, token de acceso u otra credencial en Chat.

Conectar Supabase

Abre el conector de Supabase

1. Abre el proyecto que quieres conectar.
2. Haz clic en el nombre del proyecto, en la parte superior derecha del panel de chat.
3. Selecciona Connectors en el menú desplegable que aparece.
4. Busca Supabase en la lista de conectores disponibles y haz clic en connect.

También puedes abrir Settings → Connectors → Supabase y seleccionar Connect.

Abre Settings → Connectors y selecciona Connect para Supabase.

Autoriza Atoms en Supabase

Si Organizations ya muestra la organización de Supabase que quieres usar, ya ha sido autorizada. Puedes continuar con Elegir el proyecto de Supabase.

1. Atoms abre una ventana de autorización de Supabase. Inicia sesión en la cuenta de Supabase que quieres conectar o crea una cuenta nueva si es necesario.
2. Comprueba que has iniciado sesión en la cuenta correcta de Supabase y luego selecciona la organización a la que quieres que Atoms acceda.
3. Revisa los permisos solicitados por Atoms. Para ver todos los permisos, selecciona Show detailed permissions. Si estás de acuerdo, selecciona Authorize Atoms.
4. Vuelve a Atoms y espera el mensaje Connect success.
5. En Atoms, abre Connectors → Supabase y confirma que la organización aparece en Organizations.

Atoms solicita acceso de lectura y escritura a Base de datos, Secrets, Auth, Edge Functions, Environment, Projects, PostgREST y Storage. También solicita acceso de lectura a Organizations y Domains. Estos permisos permiten a Atoms conectar y administrar los servicios compatibles de Supabase que usa tu proyecto.

Esta autorización se aplica a la organización de Supabase seleccionada y no está limitada al proyecto de Supabase que luego conectes al proyecto actual de Atoms. Atoms no puede acceder a organizaciones o proyectos a los que la propia cuenta de Supabase conectada no pueda acceder, y los permisos de Supabase pueden imponer restricciones adicionales.

Revisa la organización y los permisos antes de autorizar Atoms.

Elegir el proyecto de Supabase

1. En Organizations, expande la organización que autorizaste.
2. En Projects, busca el proyecto activo de Supabase que quieres conectar.
3. Si la organización que necesitas no aparece en la lista, selecciona New Organization y autorízala. Esto no crea una nueva organización de Supabase; te permite autorizar otra organización que ya existe en tu cuenta de Supabase.
4. Si aún no tienes un proyecto, selecciona Create Project y crea uno en Supabase. Espera hasta que el proyecto esté activo y listo para usar, luego vuelve a Atoms y selecciona Update para actualizar la lista de proyectos.
5. Junto al proyecto que quieres usar, selecciona Connect.

Elige un proyecto de Supabase de la organización autorizada.

Confirma el proyecto

1. En la ventana de confirmación, comprueba la organización y el proyecto que se muestran en Supabase Project.
2. Si es necesario, usa Supabase Dashboard o View Tables para confirmar que seleccionaste el proyecto correcto.
3. Selecciona Connect.
4. Atoms añade un elemento de conexión de Supabase al Chat del proyecto. Mantén la página abierta y espera a que termine antes de pedirle al Agente que cree una base de datos, autenticación, almacenamiento o una función de backend.

Confirma el proyecto de Supabase seleccionado antes de conectarlo.

Comprueba que la conexión funcionó

1. Abre Settings → Connectors → Supabase.
2. Confirma que la organización correcta y el proyecto de Supabase correcto aparecen como conectados.
3. Selecciona Dashboard o Tables y comprueba que abre el mismo proyecto en Supabase.

El panel del proyecto conectado también puede incluir enlaces a Manage Users, SQL Editor, Edge Functions y Manage Secrets. Solo necesitas usar las áreas relevantes para las funciones que estás creando.

Revisa el proyecto de Supabase conectado y sus enlaces de administración.

Prueba que tu app puede guardar datos

Conectar Supabase no añade por sí solo una función de base de datos a tu app. En Chat, pídele al Agente que cree la función que quieres y use el proyecto de Supabase conectado para almacenar sus datos. Después de que el Agente termine, prueba todo el flujo completo.

1. En Chat, describe la función que quieres, qué información debe guardar y dónde deben volver a ver esa información los usuarios. Dile al Agente que use el proyecto de Supabase conectado.
2. Espera a que el Agente termine de crear la función.
3. En el Visor de Apps, usa la función como lo haría un usuario e introduce datos de prueba inofensivos. No uses información personal, confidencial o sensible.
4. Actualiza el Visor de Apps o vuelve a abrir la función. Confirma que la información guardada permanece y aparece en el lugar correcto.
5. Abre Settings → Connectors → Supabase, selecciona Tables y confirma que el registro correspondiente aparece en la tabla correcta.

Si la función permite a los usuarios editar o eliminar información guardada, prueba también esas acciones y confirma que los resultados sean correctos tanto en la app como en Supabase. Que los cambios realizados directamente en Supabase aparezcan inmediatamente en la app depende de cómo se haya creado la app.

Desconectar Supabase

Desconecta Supabase cuando ya no quieras que el proyecto actual de Atoms use el proyecto de Supabase conectado.

1. Abre Settings → Connectors → Supabase.
2. Confirma que estás viendo la conexión del proyecto correcto de Atoms.
3. Selecciona Disconnect Project.
4. Espera a que termine el elemento de desconexión de Supabase en Chat.
5. Vuelve a abrir Connectors → Supabase y confirma que el proyecto ya no aparece como conectado.

Desconectar elimina la conexión del proyecto actual de Atoms. No elimina el proyecto de Supabase ni sus datos, y no elimina la autorización de la organización de Supabase.

Cualquier función de tu proyecto de Atoms que dependa de Supabase puede dejar de funcionar después de desconectarlo. Si tu app ya está publicada, puede que necesites actualizar la versión publicada antes de que el cambio surta efecto. Prueba tanto tu proyecto como la app en vivo después de desconectarlo.

Desconectar Supabase de un proyecto de Atoms no afecta a otros proyectos de Atoms conectados al mismo proyecto de Supabase.

Preguntas frecuentes

¿Por qué ha dejado de funcionar mi conexión de Supabase?

1. Abre el Supabase Dashboard y comprueba el estado del proyecto afectado. Un proyecto del Plan Gratuito con poca actividad puede pausarse después de un período de siete días.
2. Si está pausado, selecciona Resume project y espera hasta que Supabase indique que está activo.
3. Vuelve a Atoms, abre el panel Connectors del proyecto y verifica la conexión de Supabase. Reintenta una vez la acción que falló.
4. Si Supabase ya está activo, captura el error exacto de Atoms o Supabase y comprueba si la conexión aparece como desconectada o expirada. Vuelve a conectarla solo cuando el estado indique que es necesario.

No rotes claves ni crees un proyecto de reemplazo hasta que conozcas la causa y hayas protegido los datos existentes. Si el fallo continúa, contacta con Support con el Chat Link, la hora y la zona horaria, el estado de la conexión y una captura de pantalla del error depurada.

Referencia externa: Supabase — Project Pausing

¿Cómo vuelvo a conectar un proyecto de Supabase que fue pausado?

1. Inicia sesión en la organización correcta de Supabase y abre el proyecto pausado.
2. Selecciona Resume project y espera hasta que su estado sea activo. La guía actual de Supabase dice que los proyectos del Plan Gratuito con poca actividad pueden pausarse después de un período de siete días de baja actividad.
3. Vuelve a Atoms y abre el panel Connectors del proyecto. Confirma que Supabase está conectado y luego vuelve a intentar la operación afectada.
4. Si Atoms sigue mostrando el conector como desconectado o expirado, vuelve a conectarlo y completa la autorización solicitada.

No crees un nuevo proyecto de Supabase ni rotes credenciales hasta que los datos existentes estén protegidos. Si la reconexión falla, proporciona a Support el Chat Link, el estado del proyecto de Supabase, la hora y la zona horaria, y una captura de pantalla del error depurada.

Referencia externa: Supabase — Project Pausing