Integraciones · n8n
Acceso seguro a la base de datos para tus agentes de n8n
No entregues SQL en bruto a un agente de n8n. Que lea a través de una capa de recuperación acotada y de solo lectura, y envía cada INSERT, UPDATE o DELETE que proponga a una comprobación allow/deny antes de que tu nodo de Postgres o MySQL se ejecute.
Con Claix son dos llamadas HTTP Request: una a Retrieve para lecturas y otra a Guard para escrituras. Respuestas tipadas, trazas y kill switch incluidos.
Relacionado
De un vistazo
Qué necesitas en n8n
| Qué necesitas | Qué usar en n8n | Endpoint Claix |
|---|---|---|
| Respuestas desde datos en vivo | AI Agent + HTTP Request Tool (o MCP Client Tool) | POST /retrieve/{agent_name} |
| Escrituras seguras | HTTP Request → IF → Postgres/MySQL | POST /check-sql |
| Saber qué pasó | Webhook desde Guard Traces | Guard Traces |
| Parada de emergencia | Nodo HTTP Request | POST /agents/pause/{agent_id} |
El problema
Por qué una credencial de base de datos no basta
Un nodo AI Agent de n8n actúa como Tools Agent: el modelo decide qué herramienta llamar y con qué argumentos. Si una de esas herramientas es Postgres o MySQL con permisos de escritura, el modelo puede enviar cualquier sentencia que esa credencial permita.
Un system prompt que diga que nunca borre nada es una petición al modelo, no una restricción sobre la base de datos. El control tiene que estar fuera del modelo y dar siempre la misma respuesta.
Comparativa
Cuatro formas de conectar un agente n8n a una base de datos
| Enfoque | ¿Puede cambiar datos? | ¿Tablas/columnas acotadas? | ¿Respuestas tipadas? | ¿Reglas de escritura? | Auditoría |
|---|---|---|---|---|---|
| Herramienta Postgres (lectura/escritura) | Todo lo que el rol permita | Solo GRANTs manuales | No | Solo el prompt | Log de ejecución n8n |
| Herramienta Postgres (solo lectura) | No | GRANTs manuales | No | N/A | Log de ejecución n8n |
| MCP genérico de base de datos | Depende | Depende | Depende | Depende | Depende |
| Claix Retrieve + Guard | Solo tras allow | Por ruta y agente | Sí | Reglas en lenguaje natural | Trazas completas |
Cómo funciona
Qué hace Claix por tu agente de n8n
Retrieve (lecturas)
Conecta Postgres, MySQL, MariaDB o Supabase con un rol de solo lectura. Define rutas y agentes. Tu agente de n8n pregunta en lenguaje natural; Claix responde dentro del perímetro que marques—tipado para nodos IF.
Guard (escrituras)
Escribes reglas en español o inglés. Claix las convierte en reglas exactas con tests. Tu flujo envía cada sentencia propuesta a Guard, recibe allow o deny, y entonces ejecuta—o no. Claix nunca toca tus datos.
Trazas
Cada consulta y cada veredicto quedan registrados, con webhooks opcionales a Slack, email o ticket cuando algo se bloquea.
Configuración
Conecta tu base de datos a n8n con Claix
Puedes montar el flujo completo en una tarde. Mantén la credencial de escritura solo en el nodo que corre después de Guard.
- 01
Dale a Claix un rol de solo lectura
Crea un rol con SELECT en las tablas que el agente necesita. Conéctalo en el dashboard para que Claix redacte el Data Map.
- 02
Crea una ruta y un agente
Elige tablas y columnas, escribe una guía corta, adjunta la ruta al agente y usa el modo razonado si quieres respuestas tipadas.
- 03
Guarda la API key en n8n
Credencial Header Auth llamada x-api-key (también vale Bearer). Nunca pongas la clave en un prompt.
- 04
Añade una herramienta Retrieve
HTTP Request Tool en el AI Agent: POST https://claix.dev/retrieve/{agent_name} con la pregunta rellenada por $fromAI.
- 05
Escribe reglas de Guard
Por ejemplo: los agentes pueden cambiar el estado de una reserva pero nunca borrarla; ninguna sentencia puede cambiar más de 5 filas.
- 06
Monta el flujo de escritura con Guard
Solo acciones con nombre: Set (sql, params) → POST /check-sql → IF allowed → escritura Postgres/MySQL. Cierra en fallo en cualquier otro caso.
- 07
Alertas y kill switch
Apunta los webhooks de denegación a un Webhook de n8n. Pausa un agente con POST /agents/pause/{agent_id}. Limita consultas correctas por día, semana o mes.
Retrieve
Cuerpo del HTTP Request Tool para lecturas
El agente escribe la pregunta; tu nodo controla la URL, la auth y el formato. Varias preguntas en una petición vuelven en orden.
{
"questions": [
{
"question": "{{ $fromAI('question', 'La pregunta sobre los datos en vivo, en lenguaje natural') }}",
"format": "string"
}
]
}Guard
Comprueba antes de escribir
Construye la sentencia una vez y reutilízala en la comprobación y en la escritura. Usa $1/$2 en Postgres y ? en MySQL/MariaDB. Si se deniega, envía el motivo al agente.
{
"sql": "UPDATE reservations SET status = $1 WHERE id = $2",
"params": ["cancelled", 4812]
}Ejemplo
Un asistente de operaciones de restaurante
| Qué pide el usuario | Qué ocurre | Resultado |
|---|---|---|
| ¿Cuántas mesas hay reservadas esta noche? | Retrieve con format int | Un número que el flujo puede usar |
| ¿Hay alguien de turno después de medianoche? | Retrieve con format boolean | true/false para un nodo IF |
| Cancelar la reserva 4812 | Subflujo monta UPDATE → Guard | Permitido; luego corre Postgres |
| Borrar todas las reservas del mes pasado | El agente propone DELETE → Guard | Denegado; no se ejecuta nada |
Seguridad
Checklist para agentes n8n con acceso a la base
Solo lectura para Claix
Usa un rol de solo lectura para la conexión de Claix.
Credencial de escritura aislada
Solo en el nodo posterior a Guard—nunca en una herramienta del agente.
Cerrar en fallo
Ejecuta solo con HTTP 200 y allowed: true.
Una sentencia por comprobación
Comprueba exactamente lo que ejecutas; guarda la clave en credentials; revisa las trazas.
Precios
Precios y un ejemplo de coste
Cada cuenta tiene 30 llamadas correctas al mes gratis, sin tarjeta. Solo pagas las llamadas correctas (HTTP 200).
| Retrieve · IA gestionada Claix | 0,10 € / pregunta |
|---|---|
| Retrieve · tu clave LLM (BYOK) | 0,02 € / pregunta |
| Guard | 0,01 € / comprobación |
| Enterprise | Self-hosted · a medida |
Ejemplo: 1.000 preguntas y 1.000 comprobaciones ≈ 100 € + 10 € con IA gestionada, o 20 € + 10 € con tu propia clave (antes de las 30 gratis y los tokens del proveedor).
Preguntas frecuentes
- ¿Cómo doy a un agente de n8n acceso seguro a mi base de datos?
- Conecta la base a una capa controlada con un rol de solo lectura, expón solo tablas y columnas concretas con una herramienta de recuperación, y pasa cada escritura por una comprobación allow/deny antes de que el nodo de base se ejecute. Claix lo hace con un HTTP Request Tool para lecturas y Guard para escrituras.
- ¿Puede un agente de n8n borrar mi base de datos?
- Puede si le das una herramienta de base con permisos de borrado y confías en el prompt. Para evitarlo, usa un rol de solo lectura para lecturas, mantén la credencial de escritura lejos de las herramientas del agente y exige un veredicto allow de Guard antes de escribir.
- ¿Basta un usuario Postgres de solo lectura?
- Es una buena base porque el agente no puede escribir. No acota columnas por agente sin GRANTs a mano, devuelve filas sin tipar y no te da reglas para las escrituras que querrás permitir más adelante.
- ¿Funciona Claix con el nodo AI Agent de n8n?
- Sí. Llama a Retrieve desde el HTTP Request Tool, usa el MCP Client Tool con la herramienta MCP de Claix, o llámalo desde cualquier nodo HTTP Request.
- ¿Claix ejecuta el INSERT, UPDATE o DELETE?
- No. Retrieve usa un rol de solo lectura y Guard solo responde si el cambio propuesto está permitido. Tu flujo de n8n lo ejecuta.
- ¿Qué bases de datos admite?
- Cualquier base SQL, incluidos Postgres, MySQL y MariaDB, y entornos compatibles con Postgres como Supabase.
- ¿Puedo usar mi propia clave de LLM?
- Sí. Con tu clave de OpenAI, Google, Anthropic o xAI, la tarifa de Claix baja de 0,10 € a 0,02 € por pregunta y pagas al proveedor directamente.
- ¿Puedo hospedarlo yo?
- El self-hosting está disponible en el plan Enterprise.
Conecta Claix a tu agente de n8n
Lecturas acotadas, escrituras comprobadas, trazas y pausa. Treinta llamadas correctas al mes gratis—suficiente para probar el flujo completo.