Crea tu primer agente de IA con n8n.
Guía práctica desde cero para crear y poner en funcionamiento tu primer agente de IA utilizando n8n y Claude. No necesitas conocimientos previos de automatización ni programación.
En esta guía vas a aprender a instalar n8n en tu propio servidor, conectar un modelo de IA, añadir memoria y herramientas, y construir un agente funcional capaz de interpretar instrucciones y ejecutar acciones. Al terminar tendrás un agente de IA funcionando de verdad en tu propia instalación de n8n, y las bases necesarias para construir sistemas mucho más avanzados.
¿Qué vamos a construir?
Antes de empezar, quiero que entiendas qué vamos a construir. No vamos a limitarnos a crear un workflow y conectar un modelo de IA — vamos a construir la base de un agente capaz de recibir una petición, analizarla, utilizar herramientas externas y devolver una respuesta o ejecutar una acción.
n8n es la plataforma que utilizaremos para construir y ejecutar nuestro workflow — será el encargado de conectar todas las piezas del sistema. El AI Agent es el componente que permite que nuestro sistema interprete una petición y decida qué debe hacer. El modelo de IA (Claude, en esta guía) proporciona la capacidad de comprender y generar respuestas. Las herramientas son servicios externos que el agente puede utilizar: consultar una base de datos, leer Google Sheets, hacer una petición HTTP, ejecutar acciones en otras aplicaciones. La respuesta/acción es el resultado final — el agente puede responder al usuario o usar una herramienta para actuar.
🧰 ¿QUÉ NECESITAS?
Instala n8n en tu propio servidor.
Si nunca has usado n8n ni tienes un servidor, no te preocupes — empezamos desde cero. El objetivo: VPS funcionando → EasyPanel instalado → n8n instalado → dominio conectado → n8n accesible por HTTPS.
PASO 1 — CREA UNA CUENTA EN HOSTINGER
- 1.1Accede a la página de Hostinger (o de otro proveedor que permita crear un VPS) y crea una cuenta.
- 1.2Inicia sesión y accede a la sección de VPS — no necesitas hosting compartido, para esta guía usamos un VPS.
PASO 2 — CREA TU VPS
- 2.1Dentro de la sección VPS, elige un plan con recursos suficientes — como referencia, ~8 GB de RAM.
- 2.2Sistema operativo: Ubuntu (una versión compatible y actualmente disponible en tu proveedor). Ubuntu es uno de los sistemas más usados para servidores, con amplia comunidad y documentación.
PASO 3 — CONFIGURA EL ACCESO AL VPS
- 3.1Configura el acceso: por contraseña o por clave SSH. Si tienes conocimientos técnicos, la clave SSH es recomendable; si es tu primera vez, usa el método que te ofrezca el proveedor.
- 3.2Una vez creado el VPS, guarda la IP del servidor y el usuario (normalmente
root) — los necesitarás para acceder.
PASO 4 — CONÉCTATE AL VPS
En macOS o Linux, abre Terminal y ejecuta (sustituye por la IP real de tu VPS):
# ejemplo: ssh root@123.123.123.123
Si usas Windows, conéctate con PowerShell, Windows Terminal o un cliente SSH compatible.
PASO 5 — INSTALA EASYPANEL
EasyPanel es la interfaz que usaremos para administrar n8n sin configurar todo manualmente desde terminal. Desde la terminal del VPS, ejecuta el comando de instalación oficial y actual de EasyPanel.
PASO 6 — ACCEDE A EASYPANEL
- 6.1Abre tu navegador e introduce la dirección de acceso que EasyPanel te haya proporcionado.
- 6.2Crea tu cuenta de administrador e inicia sesión.
PASO 7 — CREA UN PROYECTO PARA N8N
- 7.1Dentro de EasyPanel, crea un nuevo proyecto y asígnale un nombre, por ejemplo
n8n.
PASO 8 — INSTALA N8N
- 8.1Accede al catálogo de aplicaciones, busca n8n y selecciona la plantilla oficial o recomendada.
- 8.2Comprueba que es una versión actualizada y despliega.
PASO 9 — CONFIGURA N8N
Durante el despliegue configura URL pública, dominio, zona horaria, credenciales y base de datos. La configuración exacta depende de tu versión de EasyPanel y la plantilla usada — el objetivo es que n8n conozca la dirección desde la que será accesible públicamente, por ejemplo https://n8n.tudominio.com.
PASO 10 — CONECTA TU DOMINIO
Accede al panel DNS de tu proveedor de dominio y crea un registro:
Resultado: n8n.tudominio.com → tu IP. Guarda los cambios — la propagación del DNS puede tardar.
PASO 11 — CONFIGURA HTTPS
Cuando el dominio apunte correctamente al servidor, configúralo dentro de EasyPanel (n8n.tudominio.com). EasyPanel debe gestionar la conexión segura por HTTPS. El objetivo: poder acceder a https://n8n.tudominio.com.
PASO 12 — PRIMER ARRANQUE DE N8N
Accede a https://n8n.tudominio.com. Si todo está bien configurado, aparecerá la pantalla inicial de n8n — crea tu usuario administrador (email + contraseña segura) y guárdalo en un lugar seguro.
El registro A no apunta a la IP correcta, o el dominio todavía no se ha propagado.
Revisa el registro A en el panel DNS y confirma que el dominio está bien configurado en EasyPanel.
Espera unos minutos y vuelve a probar — la propagación DNS puede tardar.
El dominio todavía no apunta realmente al servidor.
Confirma que el registro DNS ya se propagó antes de pedirle a EasyPanel que genere el certificado.
Accede a https://n8n.tudominio.com — si carga con candado, está resuelto.
El VPS se ha quedado sin RAM o CPU disponible.
Comprueba el consumo de recursos en EasyPanel; si está saturado, aumenta la capacidad del VPS.
El panel de monitorización de tu proveedor muestra el uso de RAM/CPU en tiempo real.
Tu primer workflow.
- 1Accede a
https://n8n.tudominio.come inicia sesión. - 2Crea un nuevo workflow: New Workflow.
- 3Añade el nodo Webhook como punto de entrada. El flujo inicial: Webhook → AI Agent.
Conecta el modelo.
Añade el nodo AI Agent y conéctalo: Webhook → AI Agent. Será el encargado de interpretar la petición y decidir qué hacer.
PASO 1 — CONECTA CLAUDE
- 1.1Selecciona el modelo compatible disponible en tu versión de n8n.
PASO 2 — CREA LAS CREDENCIALES DE ANTHROPIC
- 2.1Accede a la consola de Anthropic y crea una nueva API Key.
- 2.2Copia la clave, vuelve a n8n, crea una nueva credencial de Anthropic, pégala y guarda.
🧠 SYSTEM MESSAGE
El System Message define el comportamiento del agente. Puedes empezar con este ejemplo:
Tu objetivo es ayudar al usuario utilizando la información y las herramientas disponibles.
Antes de responder, analiza cuidadosamente la petición del usuario.
Si necesitas información disponible mediante una herramienta, utiliza la herramienta correspondiente.
No inventes información.
Si no tienes suficiente información para responder, indica claramente qué información necesitas.
Responde siempre de forma clara y directa.
Cuando utilices una herramienta, analiza el resultado antes de responder al usuario.
Este prompt define rol (quién es el agente), objetivo (qué debe conseguir), reglas (cómo debe comportarse) y herramientas (cómo debe usarlas).
🧠 ¿QUÉ MODELO DE IA DEBERÍAS USAR?
Que no empiece de cero.
Sin memoria, cada interacción puede comenzar desde cero: el usuario dice "me llamo Carlos", el agente responde, y después "¿cómo me llamo?" — sin memoria, el agente no tiene ese contexto.
Que deje de opinar.
Un chatbot normalmente recibe una pregunta y devuelve una respuesta. Un agente puede usar herramientas para realizar acciones.
HERRAMIENTA 1 — GOOGLE SHEETS
- 1Crea una cuenta de Google y una hoja de cálculo con algunos datos de prueba.
- 2Conecta tus credenciales de Google en n8n y selecciona la hoja.
La descripción de la herramienta es importante — el agente decide cuándo usarla según lo que le digas:
HERRAMIENTA 2 — HTTP REQUEST
Permite que el agente haga peticiones HTTP y se conecte con APIs y servicios externos.
Ponlo en marcha.
- 1Guarda el workflow y comprueba todas las conexiones.
- 2Comprueba las credenciales.
- 3Activa el workflow (toggle "Active").
Cómo encaja todo.
Compruébalo ahora.
En la prueba 1, el agente debería responder explicando sus capacidades. En la prueba 2, debería identificar que necesita usar la herramienta de Google Sheets. Prueba también algo no relacionado con sus herramientas — debería responder con sus instrucciones generales.
Si todo está funcionando: felicidades, has creado tu primer agente de IA con n8n.
Los errores más habituales.
Los errores forman parte del proceso. Aquí tienes los más comunes al montar el agente.
La API Key no es correcta, está incompleta o ha sido revocada.
Comprueba que copiaste la clave completa y que la credencial corresponde al proveedor correcto.
Genera una key nueva en la consola de Anthropic y vuelve a probar.
Las credenciales de Google necesitan volver a autorizarse.
Vuelve a conectar las credenciales OAuth y comprueba que n8n tenga los permisos necesarios.
Ejecuta el nodo de Sheets de forma manual — si responde con datos, está resuelto.
La descripción de la herramienta no explica cuándo debe utilizarse, o no está bien conectada.
Reescribe la descripción: en vez de "Google Sheets", usa "consulta esta herramienta cuando necesites información actualizada de los clientes".
Repite la prueba 2 — el agente debería llamar a la herramienta antes de responder.
No se guardó el workflow, o hay un error en alguno de los nodos.
Guarda el workflow, revisa todos los nodos y ejecuta una prueba manual antes de reactivar.
El toggle "Active" debería quedarse encendido tras guardar.
Amplía sus capacidades.
Cualifica leads automáticamente.
Ahora que has creado tu primer agente, vamos a construir algo más útil para un negocio: un agente que recibe un lead, analiza su información, lo cualifica y actualiza el CRM.
¿Quieres ver más?
Voy añadiendo nuevas guías paso a paso sobre IA y automatización para negocios — échale un vistazo a las que ya están disponibles.