Necesitas:

• Una cuenta Claix con acceso al panel (/dashboard).
• Una base PostgreSQL accesible por internet con TLS (Neon, Supabase, RDS, Cloud SQL, un VPS con hostname público, etc.).
• Permisos de administrador en esa base para crear el rol claix_agent y las políticas.
• El hostname DNS de la base (nunca una IP literal), el nombre de la base de datos y una contraseña fuerte para el rol.

En el panel, la pantalla está en Conexión a Base de Datos (/dashboard/database-connection).

• Nunca uses el usuario admin (postgres, supabase_admin, etc.) en Claix.
• Claix solo acepta el usuario claix_agent.
• No des a ese rol SUPERUSER, CREATEDB, CREATEROLE, REPLICATION ni BYPASSRLS.
• Abre solo las tablas que necesites, con SELECT (Retrieve) o SELECT + INSERT (Ingest). No des UPDATE, DELETE ni TRUNCATE.
• El host debe ser un nombre DNS público. Localhost, IPs y redes privadas están bloqueadas.
• La contraseña se prueba al conectar y se guarda en Vault: no permanece en el navegador ni en tablas públicas del panel.

En el editor SQL de tu proveedor (Neon, Supabase SQL Editor, psql, etc.), ejecuta el script siguiente. Sustituye tu-contraseña-fuerte y, si tu base no se llama postgres, cambia el nombre en el grant connect.

create role claix_agent login password 'tu-contraseña-fuerte';
grant connect on database postgres to claix_agent;
grant usage on schema public to claix_agent;

Si ya tenías el rol antiguo claix_ingest, renómbralo:

alter role claix_ingest rename to claix_agent;

Sin USAGE en el schema, Claix conectará pero no verá tablas. Si usas schemas distintos de public, repite el grant usage para cada uno.

Elige el tipo de acceso según el producto que vayas a usar. Sustituye public.tu_tabla por cada tabla real.

Solo lectura (Retrieve / agentes) — la opción más restrictiva:

grant select on public.tu_tabla to claix_agent;
create policy claix_agent_select on public.tu_tabla
  for select to claix_agent using (true);

Ingest (leer e insertar) — para escribir filas con Claix Ingest:

grant select, insert on public.tu_tabla to claix_agent;
grant usage, select on all sequences in schema public to claix_agent;
create policy claix_agent_ingest_select on public.tu_tabla
  for select to claix_agent using (true);
create policy claix_agent_ingest_insert on public.tu_tabla
  for insert to claix_agent with check (true);

Si la tabla tiene RLS activado y no creas la policy, claix_agent no verá filas aunque tenga el grant.

Abre el firewall o el allow-list de tu proveedor para que Claix pueda alcanzar el puerto por TLS desde internet. Si el host solo acepta IPs concretas, añade las de Claix cuando tu proveedor o el soporte te las indiquen.

1. Entra en /dashboard e inicia sesión.
2. En la barra lateral abre Conexión a Base de Datos.
3. Confirma que el motor es PostgreSQL (es el disponible hoy).
4. Completa nombre de la conexión, host, puerto, database, usuario claix_agent, contraseña y modo SSL.
5. Si usas verify-full, pega el certificado CA completo (líneas BEGIN CERTIFICATE / END CERTIFICATE).
6. Pulsa Probar y guardar. Claix valida el rol, el TLS y los permisos.
7. Si todo va bien, verás la conexión activa. Usa Recargar schema para refrescar tablas y columnas.

Si falla, lee el mensaje del panel: suele indicar host inalcanzable, SSL incorrecto, usuario distinto de claix_agent o falta de USAGE / policies.

Con la base enlazada puedes:

• Retrieve: crear el Data Map, rutas y agentes en el menú Retrieve, y probarlos en el Sandbox.
• Ingest / Reglas: mapear schemas Claix a tablas PostgreSQL y definir qué campos se escriben.
• Revisar tablas visibles: si la lista está vacía, vuelve a conceder USAGE en el schema y policies SELECT en las tablas.

Para desconectar, usa la opción de desconexión en la misma página (pide confirmación). Los productos que dependan de esa conexión dejarán de poder consultarla hasta que vuelvas a conectar.

1. Rol claix_agent creado con LOGIN y sin privilegios peligrosos.
2. GRANT CONNECT a la database y USAGE al schema.
3. Policy + grant en cada tabla (SELECT o SELECT+INSERT).
4. Host DNS público, puerto permitido, SSL activo.
5. Formulario del panel con usuario exacto claix_agent.
6. «Probar y guardar» en verde y schema recargado.

¿Puedo usar Supabase o Neon? Sí. Usa el hostname de conexión que te da el proveedor, el puerto (a menudo 5432 o el pooler) y crea claix_agent en el SQL Editor.

¿Por qué no veo tablas? Casi siempre falta GRANT USAGE ON SCHEMA … o las policies RLS para claix_agent.

¿La contraseña se guarda en el navegador? No. Solo se envía al probar la conexión y se almacena en Vault en el backend.

¿Puedo conectar varias bases a la vez? El panel trabaja con la conexión activa del workspace. Desconecta o sustituye antes de apuntar a otra instancia.

¿Retrieve necesita INSERT? No. Para agentes de consulta basta la política de solo SELECT. Reserva INSERT para flujos de Ingest.