Antes de construir cualquier cosa, el entorno necesita cuatro componentes conectados. El diagrama de abajo muestra cómo el asistente de código se conecta con tu proyecto y con n8n, y qué debes verificar antes de empezar.
Diagrama ilustrativo — recreación conceptual del entorno, no es una captura de pantalla real.
🗣️ Qué es el vibe coding
Vibe coding es crear software y automatizaciones conversando con una IA en lenguaje natural: describes el resultado que quieres y la IA se encarga de la implementación técnica. En vez de aprender la mecánica de cada nodo o cada línea de código, te enfocas en el problema; la selección de herramientas, la configuración y la depuración quedan a cargo de la IA.
💡 La idea central
La conversación en lenguaje natural dirige la creación y la iteración. Cuando hay que cambiar algo, no vuelves a abrir un editor de configuración: simplemente pides el cambio. La IA hace el "trabajo pesado": elegir los nodos, configurar parámetros y depurar.
- •Velocidad: del concepto al prototipo funcional en minutos, no en horas.
- •Baja sobrecarga técnica: sin memorizar la mecánica de cada nodo.
- •Enfoque en el problema: el esfuerzo se dedica al resultado, no a la herramienta.
✓ Describe el RESULTADO
- ✓"Revisa Gmail cada 10 minutos; si llega un correo nuevo, envía un DM en Slack."
- ✓Deja que la IA elija los nodos y la estructura.
- ✓Responder sus preguntas de aclaración.
✗ No dictes los PASOS técnicos
- ✗"Agrega un nodo de activación, conéctalo a un IF, luego a un nodo de código…"
- ✗Microgestionar la configuración de cada parámetro.
- ✗Esperar que la IA adivine sin responder a sus preguntas.
🎯 Consejo práctico
Empieza la frase por el objetivo ("quiero que…"), no por la herramienta. Di qué debe ocurrir al final; deja que la IA proponga cómo hacerlo. Tú sigues aprobando todo antes de que se ejecute cualquier cosa.
El lenguaje natural dirige la construcción.
Cambiar es solo pedirlo.
La IA elige y configura los nodos.
Fundamentos → build → enhancement.
🧠 El asistente de código en el editor
El asistente de código ejecuta dentro del editor (un editor de terceros, como VS Code, que instalas para alojarlo). Puede leer los archivos del proyecto, escribir y editar código, ejecutar comandos en el terminal y conectar herramientas externas mediante MCP. Es el motor que convierte tu conversación en acciones reales en el proyecto.
📊 Suscripción vs. API: el ahorro de tokens
La IA vuelve a leer toda la conversación con cada mensaje nuevo, así que cuanto más larga sea la sesión, más caro será cada mensaje. Entender el modelo de cobro evita sorpresas.
- Suscripción: tarifa fija, basada en chat/texto, con límite de mensajes: recomendada para este tipo de trabajo.
- API: basada en tokens, paga por uso — dirigida a quienes están creando aplicaciones.
✓ Buenas prácticas
- ✓Mantén las sesiones enfocadas para controlar el costo.
- ✓"Una carpeta por proyecto" — abre solo la carpeta dedicada.
- ✓Usa la vía de suscripción para este trabajo.
✗ Evita
- ✗Abre una carpeta raíz con varios proyectos dentro.
- ✗Sesiones gigantes que mezclan tareas no relacionadas.
- ✗Ignorar que cada mensaje vuelve a leer todo el historial.
Ve el proyecto completo.
Crea y modifica código.
Ejecuta en la terminal.
Conecta herramientas externas.
📄 Proyecto dedicado + CLAUDE.md
Configurar el proyecto significa crear una carpeta dedicada y un archivo CLAUDE.md, que funciona como un system prompt persistente: define el rol, el contexto y las preferencias que la IA sigue a lo largo de todo el proyecto. En vez de repetir el contexto en cada conversación, lo escribes una vez en ese archivo.
🧭 Qué va en CLAUDE.md
- •Papel: quién es la IA en este proyecto (p. ej., asistente de workflows de n8n).
- •Contexto: lo que estás construyendo (automatizaciones) y por qué.
- •Preferencias: estilo de comunicación, restricciones técnicas, lo que se debe y no se debe hacer.
# Rol Eres un asistente de workflows de n8n. # Contexto Estoy creando automatizaciones para una agencia de IA. Ayúdame a crearlas, depurarlas y optimizarlas. # Preferencias - Explicaciones concisas y directas. - Siempre propón un plan antes de ejecutar.
No necesitas escribir ese archivo a mano: pídele a la IA que lo genere («crea un CLAUDE.md para este proyecto; estoy construyendo workflows de n8n para una agencia: ayúdame a construirlos, depurarlos y optimizarlos»). Después, itera pidiendo ajustes («agrega una sección sobre cómo mantener las explicaciones concisas»).
🎯 Consejo práctico
Empieza con una carpeta completamente vacía y nombrada según su propósito. El CLAUDE.md se puede editar en cualquier momento: basta con pedirle a la IA que lo actualice a medida que el proyecto crece.
Aplica a todo el proyecto.
Texto simple, fácil de editar.
La IA escribe la primera versión.
Pide cambios cuando quieras.
🔌 Conectar n8n mediante servidor MCP
O n8n es un constructor visual de workflows basado en nodos, que conecta apps, datos, IA y APIs externas. Un MCP server conecta n8n con el asistente de código para que la IA lea, cree, modifique, pruebe, depure e incluso se autocorrija en sus propios workflows. Construir todo a mano lleva tiempo, es propenso a errores y difícil de depurar: el MCP elimina esa fricción.
Paso a paso de la instalación
Clonar el repositorio del MCP
Pídele a la IA que clone el repositorio y lo configure. Si ofrece instalarlo mediante NPX, recházalo; clónalo manualmente.
Configuración a nivel de proyecto
Mantén la configuración de MCP dentro de la carpeta del proyecto. La configuración global muestra una alerta de seguridad en cada reinicio.
Crear la API key + copiar la URL de la instancia
En la configuración de n8n, crea una clave de API (etiqueta y vencimiento) y cópiala en ese momento. Copia también la URL de la instancia (cloud o localhost/custom).
Pegar las credenciales en .env y ejecutar el health check
Pega la API key y la URL en el archivo .env del proyecto. Pídele a la IA que inicie el MCP y ejecute un health check.
⚠️ Atención: seguridad de las credenciales
- ✗Nunca pegues credenciales en el chat: solo en el
.env. - ✗No dejes que la IA ejecute la instalación mediante NPX; causa fallas silenciosas difíciles de diagnosticar.
- ✗La API key aparece una sola vez al crearla: cópiala y guárdala de forma segura.
🎯 Consejo práctico
El health check es tu primera señal de vida: confirma el estado de la conexión, la URL de la instancia, la versión del MCP y el tiempo de respuesta de la API. Ejecútalo siempre que algo parezca extraño.
Constructor visual de workflows.
Puente IA ↔ n8n.
Único lugar donde se guardan las credenciales.
Confirma la conexión.
📚 Skills de n8n
Las skills son documentación que enseña a la IA a usar n8n: sus tipos de nodos, parámetros, mejores prácticas y patrones comunes. Con ellas, la IA entiende cómo funciona cada nodo y cómo estructurar un workflow, para que tú no necesitas saber eso. La instalación es idéntica a la del MCP server; solo cambia la URL del repositorio.
Instalación y verificación
Clonar el repositorio de skills
Pídele a la IA que lo clone y configure (el mismo proceso que el MCP, con otro enlace). Aprueba las solicitudes de permisos durante la instalación.
Actualizar el CLAUDE.md y reiniciar
Pídele que actualice el CLAUDE.md y anote que la IA ahora tiene acceso a la documentación de n8n. Reinicia el asistente para registrar los nuevos componentes.
Verificar preguntando sobre un nodo
Pregunta «háblame sobre el nodo de activación de Gmail» y confirma que la respuesta incluya detalles correctos (intervalo de polling, parámetros, filtros).
🎯 Consejo práctico
Si el MCP server no aparece después de la instalación, reinicia el asistente antes de cualquier troubleshooting — la mayoría de las veces, eso lo resuelve.
Tipos, parámetros, valores predeterminados.
Igual al MCP, otro repo.
Registra los componentes.
Pregunta sobre un nodo real.
✅ Verificación de las 4 conexiones
Antes de construir, ejecuta una secuencia de verificación para confirmar que el asistente tiene acceso a los archivos del proyecto, a la conexión MCP, a la capacidad de leer workflows y a la documentación de los nodos. Son cuatro pruebas simples: cada una, una pregunta en lenguaje natural.
Las 4 pruebas
Directorio del proyecto
"Muéstrame qué hay en mi directorio del proyecto."
Confirma que existan CLAUDE.md, .env, archivos del MCP y la carpeta de skills (todavía sin workflows).
Conexión MCP
"¿Confirmas que estás conectado a mi instancia de n8n?"
Confirma que la conexión esté activa: instancia conectada, API configurada, herramientas disponibles.
Leer workflows
"¿Qué workflows tengo actualmente?"
Confirma que la IA enumere los workflows (o informe "ninguno" en una cuenta nueva), con el recuento de nodos y el estado.
Documentación de nodos
"Háblame sobre el nodo de activación de Gmail."
Confirma los detalles a nivel de nodo: intervalo de polling, parámetros, filtros.
✓ Entorno listo
- ✓Las 4 pruebas pasan sin errores.
- ✓La IA puede ver archivos, la instancia, los workflows y los nodos.
- ✓Puedes empezar a construir con seguridad.
✗ Errores comunes (y cómo solucionarlos)
- ✗API key inválida/parcial → verifica que no se haya truncado.
- ✗MCP no conecta → reinicia el server.
- ✗La autorización de n8n falla → vuelve a verificar las credenciales.
🎯 Consejo práctico
Si aparece un error en cualquier prueba, pídele a la IA que lo diagnostique: la mayoría de las veces identifica la causa y sugiere una solución. No necesitas descifrar el mensaje por tu cuenta.
Autocuración (opcional): ¿dónde deben estar las credenciales (API key + URL de la instancia)?
📌 Resumen del módulo
Próximo Módulo:
1.2 — El ciclo completo: Plan → Build → Troubleshoot → Optimize