Volver al blog
Guía · Seguridad

Permisos de acceso a la base de datos para agentes de IA: cómo controlar qué pueden leer y escribir

Aprende a controlar los permisos de acceso de un agente de IA a la base de datos: limitar lecturas, validar escrituras, aplicar reglas de negocio y auditar cada acción con Claix Retrieve y Guard.

Claix · Actualizado noviembre 2026. Guías relacionadas: por qué el acceso SQL directo es peligroso (/es/blog/why-ai-agent-direct-sql-access-is-dangerous), siete huecos de un rol de Postgres de solo lectura (/es/blog/read-only-postgres-role-for-ai-agents), guardrails de base de datos para agentes de IA (/es/blog/database-guardrails-for-ai-agents) y acceso multi-tenant de agentes de IA a la base de datos (/es/blog/ai-agent-multi-tenant-database-access). Productos: Claix Retrieve y Claix Guard.

Dar a un agente de IA acceso a una base de datos de producción es distinto de dárselo a un desarrollador humano.

Un desarrollador suele trabajar con una tarea conocida, un proceso de revisión y una comprensión del sistema. Un agente de IA puede recibir una instrucción, elegir una herramienta, generar una consulta y actuar en segundos. Esa velocidad es útil, pero también hace esenciales los permisos, la validación y la auditabilidad.

La pregunta central no es simplemente: «¿Puede el agente conectarse a la base de datos?» La pregunta real es: «¿Qué puede leer este agente, qué puede cambiar, para qué usuario y cómo demostramos lo que ocurrió?»

Esta guía explica cómo diseñar permisos de acceso a base de datos para agentes de IA, por qué el acceso de solo lectura es solo una capa, y cómo Claix ayuda a los equipos a controlar tanto la recuperación como las escrituras.

Por qué importan los permisos de base de datos para agentes de IA

Los agentes de IA necesitan cada vez más datos de negocio en tiempo real. Pueden responder preguntas sobre pedidos, inventario, clientes, reservas, tickets de soporte u operaciones internas.

Sin un acceso controlado a la base de datos, un agente puede afrontar varios riesgos:

  • Puede recuperar datos que no debería ver.
  • Puede exponer datos de clientes o de tenants en el contexto equivocado.
  • Puede generar consultas caras o ineficientes.
  • Puede proponer escrituras que violan reglas de negocio.
  • Puede modificar o eliminar registros sin querer.
  • Puede hacer que las acciones sean difíciles de auditar después.

Un prompt no es un modelo de permisos. Las instrucciones se pueden malinterpretar, anular o manipular. Un sistema robusto necesita límites técnicos que no dependan de que el modelo se comporte a la perfección.

Las cuatro capas del acceso de agentes de IA a la base de datos

Un modelo seguro de acceso a base de datos para agentes de IA debe combinar varios controles. Ninguna capa basta por sí sola.

CapaQué controlaEjemplo
Rol y privilegios de base de datosQué puede hacer el usuario de la baseUn rol de Postgres de solo lectura no puede ejecutar escrituras
Alcance de recuperaciónQué tablas y columnas puede usar un agenteUn agente de soporte puede acceder a pedidos, pero no a detalles de pago
Reglas de negocioQué acciones están permitidas en un contexto concretoLos descuentos no pueden superar el 20 por ciento
Auditoría y trazasQué se pidió, se decidió y se ejecutóCada consulta y cada decisión de escritura es revisable

Los privilegios de base de datos son la base. Impiden que un agente haga cosas que el propio rol de la base no permite.

Pero no resuelven todos los problemas. Un rol de solo lectura sigue pudiendo recuperar datos de tablas que no deberían exponerse a un usuario concreto. Y un rol con capacidad de escritura puede realizar una operación válida que viola una regla de negocio.

Por eso los equipos necesitan una capa de control por encima de las credenciales crudas de la base de datos.

El acceso de solo lectura es necesario, pero no suficiente

El acceso de solo lectura a la base de datos es un buen valor por defecto para agentes de IA que solo necesitan responder preguntas. Impide que el agente cree, actualice o elimine registros a través de esa conexión.

Sin embargo, el acceso de solo lectura no responde a todas las preguntas de permisos.

Un agente con acceso de solo lectura aún puede recuperar:

  • Registros que pertenecen a otro cliente o tenant.
  • Columnas sensibles que no son relevantes para su tarea.
  • Grandes volúmenes de datos que no deberían entrar en el contexto del modelo.
  • Datos operativos internos que un usuario concreto no debería ver.

Por ejemplo, un agente de soporte puede necesitar comprobar el estado del pedido de un cliente. No necesita acceso a todos los pedidos del sistema, a todas las notas internas ni a todas las columnas de la tabla de pedidos.

El límite correcto no es solo: «Este agente puede leer la base de datos.» Es: «Este agente puede recuperar solo los datos necesarios para esta tarea, para este usuario, dentro de los límites que definimos.» Consulta también los huecos de un rol estándar de Postgres de solo lectura (/es/blog/read-only-postgres-role-for-ai-agents).

Qué deben incluir los permisos de base de datos para agentes de IA

Un modelo práctico de permisos para agentes de IA debe responder a estas preguntas:

  • ¿A qué base de datos puede acceder el agente?
  • ¿De qué tablas puede recuperar datos?
  • ¿Qué columnas puede leer?
  • ¿Qué registros pertenecen al usuario o tenant actual?
  • ¿Cuántos datos puede devolver una sola petición?
  • ¿Puede el agente ejecutar escrituras?
  • ¿Qué operaciones de escritura están permitidas?
  • ¿Qué columnas se pueden modificar?
  • ¿Qué valores y umbrales están permitidos?
  • ¿Qué ocurre cuando se viola una regla?
  • ¿Qué se pidió, se permitió, se denegó y se ejecutó?

Estas preguntas separan la seguridad de la base de datos de la autorización a nivel de aplicación y de la política de negocio.

Una base de datos puede aplicar algunas de estas reglas. Pero no puede expresar con facilidad reglas como «un agente puede actualizar el estado de un pedido, pero nunca su precio» o «los reembolsos por encima de un umbral deben ser revisados por una persona». Ahí es donde resulta útil una capa de control dedicada.

Cómo controla Claix el acceso de agentes de IA a la base de datos

Claix Retrieve es una capa de recuperación de datos controlada para agentes de IA. Se conecta a una base de datos relacional y permite que cada agente recupere solo las tablas y columnas que tú permites, guiado por tus propias reglas y devolviendo resultados validados o respuestas tipadas.

Claix separa el problema en dos partes:

Juntos crean un límite entre el agente y la base de datos.

Claix Retrieve: lecturas controladas

Con Claix Retrieve defines una ruta. Una ruta especifica las tablas y columnas a las que un agente puede acceder, junto con una guía que contiene tus reglas y tu vocabulario.

Luego creas un agente. El agente tiene su propio endpoint, prompt de negocio y rutas asociadas.

Esto significa que un agente de soporte y un asistente de operaciones internas pueden compartir la misma base de datos teniendo límites de acceso distintos.

Por ejemplo:

  • Un agente de soporte puede acceder al estado de pedidos y a la información de contacto del cliente.
  • Un agente de operaciones puede acceder a inventario y datos de turnos.
  • Ninguno de los dos necesita acceso al esquema completo de la base de datos.

Claix se conecta con un rol de solo lectura. Los agentes solo alcanzan las tablas y columnas incluidas en sus rutas asignadas. Todo lo que queda fuera de ese perímetro no está disponible para ellos.

Respuestas tipadas en lugar de texto libre

Claix Retrieve puede devolver valores tipados como booleanos, números, listas y objetos JSON. Esto importa porque un flujo de agente a menudo necesita tomar una decisión a partir de un valor concreto.

En lugar de interpretar texto libre, tu flujo puede recibir una respuesta clara como:

  • Un booleano para «¿este artículo está en stock?»
  • Un número para «¿cuántos pedidos están pendientes?»
  • Una lista de IDs para «¿qué clientes necesitan seguimiento?»
  • Un objeto JSON para datos operativos estructurados.

Esto reduce la ambigüedad y facilita construir flujos de agente fiables.

Validación de consultas y trazas

Claix valida las consultas antes de ejecutarlas y traza cada petición. Puedes revisar qué se preguntó, qué ruta respondió y qué se devolvió.

Esto crea un rastro de auditoría útil cuando necesitas entender un resultado inesperado, investigar un incidente o mejorar el comportamiento de un agente.

Claix Guard: escrituras controladas

Claix Guard es un comprobador de reglas para los cambios de base de datos que proponen los agentes de IA. Antes de que un agente ejecute un INSERT, UPDATE o DELETE, Guard comprueba la sentencia propuesta contra reglas que tú aprobaste.

El resultado es simple:

  • Allow: tu código puede ejecutar la sentencia.
  • Deny: tu código no debe ejecutarla, y el agente recibe el motivo.

No hay un tercer veredicto. Si un cambio debe ser revisado por una persona, Guard lo deniega y tu propio flujo (Slack, correo, n8n) encamina esa denegación para su revisión.

Claix Guard no ejecuta la sentencia. Tu propio código sí, con sus propias credenciales de base de datos.

Esta separación es importante. El agente propone una acción. Guard la evalúa. Tu ejecutor decide si la ejecuta.

Qué puede aplicar Guard

Claix Guard te permite definir reglas en lenguaje llano, revisar las reglas exactas propuestas y aprobarlas antes de aplicarlas.

Ejemplos:

  • Los agentes pueden crear y actualizar pedidos, pero nunca eliminarlos.
  • Los agentes pueden actualizar el estado de un pedido, pero nunca su precio.
  • Los descuentos no pueden superar un porcentaje definido.
  • Los reembolsos por encima de un umbral se deniegan para que tu flujo los envíe a una persona.
  • Una actualización o un borrado debe dirigirse a un registro concreto.
  • Ciertas transiciones de estado no están permitidas.
  • El número de reembolsos por hora está limitado.

Estas son reglas de negocio. Van más allá de lo que un rol de base de datos o una restricción de esquema suelen expresar.

Por qué importan las comprobaciones deterministas

Claix Guard usa reglas exactas en lugar de preguntar a otro modelo de IA si una sentencia parece segura. La misma sentencia con los mismos parámetros recibe la misma decisión.

Eso hace que la comprobación sea predecible, explicable y comprobable.

Un modelo puede ayudar a proponer reglas cuando las creas. Pero la comprobación en sí es determinista, así que no depende del juicio de un modelo en el momento de la ejecución.

Una arquitectura práctica para el acceso de agentes de IA a la base de datos

Una configuración sólida combina controles a nivel de base de datos con una capa de control a nivel de aplicación.

ControlPropósito
Rol dedicado de solo lecturaEvita escrituras a través de la conexión de recuperación
Rol de escritura acotadoLimita qué tablas y columnas puede modificar un ejecutor
Rutas de Claix RetrieveDefinen qué tablas y columnas puede leer cada agente
Reglas de Claix GuardDefinen qué escrituras están permitidas y por qué
Row-level securityAyuda a aislar registros por usuario o tenant
Restricciones y validaciónAplican la integridad de los datos a nivel de base
Registros de auditoría y trazasRegistran peticiones, decisiones y resultados

Claix no sustituye los permisos de la base de datos. Añade una capa de control encima de ellos.

Para lecturas, Claix Retrieve define el límite de recuperación. Para escrituras, Claix Guard comprueba los cambios propuestos antes de que tu código los ejecute.

Errores habituales al dar acceso a la base de datos a agentes de IA

Dar al agente credenciales directas de la base de datos

Si un agente tiene credenciales de escritura, puede saltarse los controles a nivel de aplicación. Mantén las credenciales en un ejecutor de confianza y haz que ese ejecutor llame a Guard antes de cada escritura. Ejecuta solo cuando Guard devuelva allow. Consulta por qué el acceso SQL directo es peligroso (/es/blog/why-ai-agent-direct-sql-access-is-dangerous).

Tratar un prompt como un permiso

Un prompt puede guiar el comportamiento, pero no es un mecanismo de aplicación. Los controles técnicos deben decidir qué puede hacer un agente.

Usar un único agente compartido para todas las tareas

Tareas distintas necesitan accesos distintos. Un agente de soporte, un agente de operaciones y un asistente interno de analítica no deberían tener automáticamente el mismo acceso a los datos.

Ignorar los límites entre tenants

Si varios clientes comparten la misma base de datos, el aislamiento a nivel de fila y las reglas de recuperación conscientes del tenant son esenciales. Un rol de solo lectura por sí solo no garantiza que un tenant no pueda acceder a los datos de otro. Consulta el acceso multi-tenant de agentes de IA a la base de datos (/es/blog/ai-agent-multi-tenant-database-access).

Omitir los rastros de auditoría

Cuando algo falla, necesitas saber qué pidió el agente, qué regla se aplicó y qué hizo el sistema. Los registros y las trazas no son opcionales en sistemas de producción.

Cómo empezar con Claix

Claix Retrieve admite Postgres, incluidas configuraciones compatibles con Postgres como Supabase. Conectas una base de datos con un rol de solo lectura, revisas el Data Map generado, defines rutas y agentes, y luego llamas a un endpoint desde tu stack existente.

Claix está disponible a través de REST, MCP y A2A. Eso significa que puedes usarlo con frameworks de agentes, clientes compatibles con MCP, herramientas de automatización y sistemas que puedan enviar peticiones HTTP.

Para equipos que necesitan controlar escrituras, Claix Guard admite PostgreSQL, MySQL y MariaDB.

Preguntas frecuentes

¿Qué son los permisos de acceso a base de datos para agentes de IA?
Son los controles técnicos y de política que deciden qué puede leer un agente de IA, qué puede cambiar, para qué usuario o tenant, y cómo se auditan esas acciones. Un prompt no es un modelo de permisos.
¿Basta un rol de base de datos de solo lectura para agentes de IA?
No. Un rol de solo lectura es una base necesaria, pero no limita qué tablas, columnas o filas de tenant puede recuperar un agente, y no expresa reglas de negocio para las escrituras.
¿Cuál es la diferencia entre Claix Retrieve y Claix Guard?
Claix Retrieve controla lo que un agente puede leer de tablas y columnas seleccionadas. Claix Guard comprueba las sentencias INSERT, UPDATE y DELETE propuestas contra reglas aprobadas y devuelve allow o deny. Guard no ejecuta SQL.
¿Claix Guard ejecuta SQL?
No. Claix Guard solo comprueba la sentencia y los parámetros propuestos. Tu propio ejecutor conserva las credenciales de escritura y ejecuta la sentencia solo cuando Guard devuelve allow.
¿Qué bases de datos admite Claix?
Claix Retrieve se conecta con un rol de solo lectura a Postgres, incluidas configuraciones compatibles con Postgres como Supabase. Claix Guard admite PostgreSQL, MySQL y MariaDB.
¿Puede Claix Guard devolver un veredicto de «needs approval»?
No. Guard solo devuelve allow o deny. Si un cambio de alto riesgo debe ser revisado por una persona, Guard lo deniega y tu propio flujo encamina esa denegación a Slack, correo, n8n u otro proceso de revisión.
¿Cómo debería estructurar los permisos para varios agentes?
Da a cada agente su propio límite de recuperación. Un agente de soporte, un agente de operaciones y un asistente de analítica no deberían compartir automáticamente las mismas tablas y columnas, aunque usen la misma base de datos.

Conclusión

Los permisos de acceso a base de datos para agentes de IA requieren más que un usuario y una contraseña.

Necesitas controlar qué pueden leer los agentes, a qué datos pueden acceder, qué escrituras pueden proponer, qué reglas de negocio aplican y qué ocurrió después de la ejecución.

Claix aporta esa capa de control:

  • Retrieve limita y estructura lo que los agentes pueden leer.
  • Guard comprueba las escrituras propuestas antes de que se ejecuten.
  • Las trazas hacen revisables las peticiones y las decisiones.

Si estás construyendo agentes de IA que se conectan a datos de producción, diseña los permisos como un sistema, no como una ocurrencia tardía. Empieza con Claix Retrieve y Claix Guard.