Claix es la capa controlada de recuperación de datos para agentes de IA: se conecta a tu base relacional y permite que cada agente recupere solo las tablas y columnas que tú autorizas, guiado por tus propias reglas y devolviendo resultados validados o respuestas tipadas, sin mover tus datos. Disponible vía API REST, MCP y A2A.

En tres pasos: conecta cualquier base de datos SQL con un rol de solo lectura (Claix redacta un Data Map para que lo revises), define rutas y agentes con tus reglas (sin YAML ni código) y llama a un endpoint para que tu agente obtenga respuestas tipadas en vivo dentro del perímetro que fijaste.

¿Claix copia mis datos a un almacén vectorial?

No. Claix no copia tus datos ni construye un índice vectorial sobre ellos. Los agentes consultan tu base donde vive, dentro de las tablas y columnas que permites. Cada consulta se valida antes de ejecutarse y queda trazada después.

¿Claix escribe en mi base de datos?

No. Claix se conecta con un rol de solo lectura. Cargar documentos en campos estructurados es un producto aparte, Claix Ingest, que usas solo si lo eliges.

¿Qué bases de datos admite Claix?

Cualquier base de datos SQL, incluidas Postgres, MySQL y MariaDB, y los entornos compatibles con Postgres como Supabase. Te conectas con un rol de solo lectura para que los agentes nunca obtengan escritura a través de Claix.

¿Qué son las rutas y los agentes?

Una ruta es una capacidad de recuperación: las tablas y columnas permitidas más una guía breve con tus reglas y vocabulario. Un agente es la identidad que las usa: su propio endpoint, prompt de negocio, rutas asociadas y modo de respuesta (resultados en bruto o respuestas razonadas tipadas). Crea una ruta una vez y asígnala a tantos agentes como necesites.

¿Cómo llamo a un agente Retrieve?

Haz POST a /retrieve/{agent_name} con un body JSON de preguntas (cada una con format opcional: string, int, boolean, json o array:string). Recibes respuestas tipadas en orden y un log_id. El mismo agente está disponible por MCP (claix.retrieve.ask) y A2A.

¿Qué formatos de respuesta puedo pedir?

En modo razonada puedes pedir string, int, boolean, timestamp, timestamptz, date, json, array:string o array:int. Los valores tipados permiten ramificar por booleanos, usar números y listas directamente y evitar parsear texto libre.

¿Cómo funciona el precio?

Con la IA gestionada de Claix la tarifa es 0,10 € por pregunta. Con tu propia clave LLM (BYOK) de OpenAI, Google, Anthropic o xAI, la tarifa de Claix baja a 0,02 € por pregunta y pagas los tokens de tu proveedor. Con tu propia clave, los resultados dependen del modelo: pruébalo en el Sandbox antes de pasar a producción.

¿Agentic RAG es lo mismo que vector RAG?

No. Están en ejes distintos. “Agentic” habla de quién dispara la recuperación (pipeline fijo vs agente que llama a una herramienta). “Vector” habla de cómo se emparejan resultados (embeddings). Un agente puede llamar a SQL, BM25 o embeddings; un pipeline fijo puede usar búsqueda híbrida. Para datos de negocio relacionales, los embeddings suelen ser el default equivocado.

¿La recuperación por SQL es RAG?

Sí. RAG significa que la información recuperada alimenta al modelo. No exige embeddings ni que lo recuperado sean trozos de texto. Una consulta SQL que devuelve registros en vivo para el modelo sigue siendo recuperación.

¿Cuándo sigue teniendo sentido una base vectorial?

Cuando necesitas descubrimiento semántico sobre una colección grande y permanente de texto, mucho tráfico de búsqueda repetido, o un producto donde la búsqueda es el producto. Para valores exactos, conteos, fechas y filas en vivo que ya están en tu base SQL, consulta la base donde vive con acceso acotado en lugar de copiarla a un índice.

¿Puedo usar Claix desde LangChain, Cursor o n8n?

Sí. Claix no es un framework de agentes: es una capa de recuperación que llamas desde el stack que ya usas. Llama por REST desde cualquier cliente HTTP (incluido n8n), expón el agente como herramienta MCP para Cursor y clientes compatibles, o conéctalo por A2A para que otros agentes deleguen preguntas de datos.

¿Qué pasa si la respuesta no está en las tablas permitidas?

El campo vuelve vacío en lugar de una invención. Las consultas solo se ejecutan dentro de las rutas que adjuntaste al agente; todo lo que queda fuera de ese perímetro no existe para ellos. Las trazas muestran qué se preguntó, qué ruta respondió y qué volvió.

¿En qué se diferencia Claix de un servidor MCP genérico sobre la base?

Conectar un MCP de base es rápido, pero el modelo de acceso depende del servidor y del rol. Claix añade rutas, allowlists por agente, validación antes de ejecutar, respuestas tipadas multi-pregunta y una traza revisable: defines el límite una vez y se aplica en cada llamada.

Panel de Claix

Cómo conectar mi MySQL a Claix

Claix se conecta a tu MySQL con un usuario dedicado (claix_agent), prueba la conexión desde el panel y guarda las credenciales de forma segura. Con esa conexión puedes usar Claix Retrieve: Data Map, rutas y agentes de solo lectura.

MySQL en Claix es solo Retrieve. Claix Ingest sigue siendo PostgreSQL. Esta guía cubre requisitos, el SQL del usuario, los GRANT SELECT, el formulario del panel y qué hacer después de conectar. No hace falta tocar la API pública.

1. Antes de empezar

Necesitas:

Una cuenta Claix con acceso al panel (/dashboard).
Un servidor MySQL 8.0 o superior accesible por internet con TLS (RDS, PlanetScale, DigitalOcean, TiDB, un VPS con hostname público, etc.). Si el servidor es MariaDB, usa la guía de MariaDB: Claix rechaza un servidor que no coincide con el motor elegido.
Permisos de administrador para crear el usuario claix_agent y los GRANT.
El hostname DNS (nunca una IP), el nombre de la base y una contraseña fuerte para el usuario.

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

2. Principios de seguridad

Nunca uses root ni el usuario administrador en Claix.
Claix solo acepta el usuario claix_agent.
El usuario se crea con REQUIRE SSL. Sin TLS, Claix no conecta.
Solo SELECT, tabla a tabla. No des INSERT, UPDATE, DELETE, CREATE, DROP, ALTER, GRANT OPTION, roles ni privilegios globales (ON *.*).
No concedas nada sobre mysql, sys, performance_schema ni information_schema.
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.

3. Crear el usuario claix_agent

En el editor SQL de tu proveedor (RDS, MySQL Workbench, el CLI mysql, etc.), ejecuta el script. Cambia tu-contraseña-fuerte.

CREATE USER 'claix_agent'@'%' IDENTIFIED BY 'tu-contraseña-fuerte' REQUIRE SSL;

El host % deja entrar desde internet. Si tu proveedor exige otro host, créalo con ese valor, pero el nombre de usuario tiene que ser exactamente claix_agent. Este usuario no lleva privilegios globales: los GRANT van tabla a tabla.

4. SELECT tabla a tabla

Claix nombra las tablas como base.tabla. Sustituye tu_base y tu_tabla por los nombres reales. El nombre de la base solo puede llevar letras, números y _.

GRANT SELECT ON `tu_base`.`tu_tabla` TO 'claix_agent'@'%';

Repite la línea por cada tabla que Retrieve deba consultar. En el panel, después de conectar, marcas las tablas y Claix genera este SQL por ti: lo copias y lo ejecutas en tu base.

MySQL no usa políticas RLS. El límite es el GRANT: sin él, Claix conecta pero no ve esa tabla.

5. Red, puerto y TLS

Campo	Qué poner
Host	Hostname DNS público (ej. el endpoint de RDS). No uses IP ni localhost.
Puerto	3306, 3307, 3308, 4000 (TiDB) o 25060 (DigitalOcean)
Base de datos	Nombre exacto de la base. Solo letras, números y _.
Usuario	Siempre claix_agent (el campo está fijo)
Contraseña	La del usuario que creaste, no la del administrador
SSL	require (recomendado: cifra y acepta CAs públicas y las de Amazon RDS) o verify-full (pega tu CA en PEM si el certificado es privado)

Abre el firewall o el security group para que el puerto acepte TLS desde internet. Un certificado autofirmado no pasa con require: usa verify-full y pega la CA.

6. Conectar desde el panel (paso a paso)

Entra en /dashboard e inicia sesión.
En la barra lateral abre Conexión a Base de Datos.
Elige el motor MySQL (solo Retrieve).
Copia el SQL de crear claix_agent, cambia la contraseña y ejecútalo en tu MySQL.
Completa nombre de la conexión, host, puerto, base de datos y la contraseña de claix_agent. El usuario no se puede cambiar.
Elige SSL. Con verify-full, pega el certificado CA completo (líneas BEGIN CERTIFICATE / END CERTIFICATE).
Pulsa Probar y guardar. Claix comprueba que el servidor es MySQL, lee SHOW GRANTS y guarda la contraseña en Vault.
Con la conexión activa, marca las tablas y ejecuta el GRANT SELECT que genera el panel. Luego pulsa Recargar schema.

Si falla, el mensaje del panel indica host inalcanzable, SSL, usuario distinto de claix_agent, versión anterior a 8.0, un servidor MariaDB o un privilegio de más (escritura, global o GRANT OPTION).

7. Después de conectar

Con la base enlazada puedes:

Retrieve: crear el Data Map, rutas y agentes en el menú Retrieve, y probarlos en el Sandbox. Cada consulta va en una transacción de solo lectura con límite de tiempo.
Revisar tablas visibles: si la lista está vacía, ejecuta el GRANT SELECT y recarga el schema.

Ingest no usa esta conexión. Para escribir filas, conecta un PostgreSQL. Para desconectar, usa la opción de la misma página (pide escribir disconnect). Los agentes que dependan de esta conexión dejarán de poder consultarla hasta que vuelvas a conectar.

8. Checklist rápido

MySQL 8.0 o superior, con TLS, y usuario claix_agent creado con REQUIRE SSL.
Sin privilegios globales, de escritura, de sistema ni GRANT OPTION.
GRANT SELECT en cada tabla que Retrieve deba leer.
Host DNS público, puerto permitido, SSL activo.
Formulario del panel con motor MySQL y la contraseña de claix_agent.
«Probar y guardar» en verde y schema recargado.

9. Preguntas frecuentes

¿Puedo usar Amazon RDS? Sí. Usa el endpoint (el hostname, no la IP), el puerto 3306, la base que creaste y SSL require. El security group tiene que aceptar el puerto desde internet.

¿Por qué no veo tablas? Falta el GRANT SELECT sobre esas tablas, o no has pulsado Recargar schema después de concederlo.

¿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 muestra la conexión activa del workspace. Desconecta antes de apuntar a otra instancia. Ingest solo carga la conexión PostgreSQL.

El panel dice que el servidor es MariaDB. Elige el motor MariaDB y vuelve a probar. Claix no trata un MariaDB como MySQL.

¿Retrieve necesita INSERT? No. Solo SELECT. Ingest, que sí escribe, es PostgreSQL.