🌱 ¿Nuevo por aquí?
Verás nombres como asistente de código, n8n, MCP, skill, workflow e agente. Cada uno se explica en un recuadro «¿Qué es X?» la primera vez. No lo memorices: el objetivo es entender el papel de cada pieza. Piensa en un equipo: está el cerebro (asistente), la línea de montaje (n8n), los enchufes que conectan apps externas (MCP), los manuales de procedimiento (skills) y el empleado autónomo (agente).
Ve todo el ecosistema de una vez. En el centro está el asistente de código — el cerebro que lee, escribe y decide. A su alrededor están las piezas que dirige o utiliza: el constructor visual (n8n), el protocolo que conecta herramientas externas (MCP), las instrucciones reutilizables (skills/workflows) y el resultado final, que puede ejecutarse en tu máquina o por su cuenta en la nube.
Diagrama ilustrativo — el asistente (cian) es el coordinador en el centro; a su alrededor, las piezas que dirige o utiliza; a la derecha, dónde puede ejecutarse el resultado. Conocerás cada una a continuación.
🧠 El asistente de código
Qué es
O asistente de código es el cerebro del ecosistema: una IA que vive dentro de tu editor de texto y sabe hacer cuatro cosas concretas — leer los archivos de tu proyecto, escribir y editar código, ejecutar comandos en la terminal y conectar herramientas externas a través de MCP. Es con él que conversas en lenguaje natural; todo lo demás (n8n, skills, agentes) o recibe instrucciones de él o alimenta su trabajo.
¿Qué es?Editor de texto (editor de código) — el programa donde vive el asistente y donde se ven los archivos del proyecto (panel de chat, explorador de archivos a la izquierda, terminal abajo). Terminal — la ventana donde se escriben comandos para la computadora; el asistente puede usarla por ti.
Una disciplina importante desde aquí: una carpeta por proyecto. Abres solo la carpeta dedicada de ese proyecto —nunca una carpeta raíz con varios proyectos dentro—. Así, el asistente solo ve lo que importa y no se confunde ni mezcla contextos. Además, hay modos de permiso (preguntar antes de editar, editar automáticamente, modo de planificación…) que controlan cuánto actúa el asistente por su cuenta.
Por qué aprender
Entender al asistente como coordinador lo cambia todo: dejas de buscar «qué botón presiono» y pasas a pensar «qué resultado describo». Es la pieza que transforma tu frase en archivos, comandos y conexiones reales.
- •Lee y escribe: ve tus archivos y crea/edita lo que haga falta.
- •Ejecuta comandos: instala cosas, ejecuta scripts — sin que tengas que memorizar comandos.
- •Conecta el resto: a través de MCP, obtiene acceso a apps y servicios externos.
Conceptos clave
Coordina todas las piezas.
Leer, escribir, ejecutar, conectar.
Abre solo la carpeta dedicada.
Controlan cuánto actúa.
🔗 n8n — el constructor visual
Qué es
O n8n es un constructor visual de workflows (flujos de automatización) del tipo low/no-code: en vez de escribir código, conectas nodos (nodos) en una pantalla, y cada nodo hace algo: leer un correo, filtrar, llamar a una API, guardar en una hoja de cálculo. Al conectar los nodos, creas automatizaciones que vinculan aplicaciones, datos, IA y servicios externos.
¿Qué es?Workflow (flujo) — una secuencia de pasos automatizados, desde el disparador hasta la acción. Nodo (node) — cada bloque del flujo, con un solo trabajo. Low/no-code — construir con poca o ninguna escritura de código, conectando bloques visuales.
Construir n8n a mano es potente, pero laborioso y propenso a errores: es difícil encontrar una configuración incorrecta en un nodo. Justo ahí entra el asistente: conectado a tu n8n, lee, crea, modifica, prueba y depura los workflows por ti. n8n se convierte en la «línea de montaje» determinista; el asistente se encarga de montarla y repararla.
Diagrama ilustrativo — cada nodo tiene una tarea y pasa el resultado al siguiente. El asistente conecta y ajusta estos nodos por ti.
Por qué aprender
n8n es donde viven muchas automatizaciones. Saber que es determinista (la misma entrada genera la misma salida) y visual ayuda a entender por qué es confiable para tareas repetitivas y por qué combinar n8n (la línea predecible) con IA (el cerebro flexible) es tan potente.
Conceptos clave
Conecta bloques en una pantalla.
Cada uno hace una cosa.
Correo electrónico, hojas de cálculo, API, IA.
Crea, prueba y depura por ti.
🔌 MCP — el protocolo de las herramientas
Qué es
MCP (Model Context Protocol, "protocolo de contexto del modelo") es el estándar que ofrece herramientas externas al asistente. Piensa en un enchufe universal: una única conexión (un MCP server) expone un conjunto completo de acciones. Por ejemplo, un servidor de correo expone «enviar», «redactar», «buscar mensajes», y el asistente decide por sí solo qué acción llamar, cuándo y con qué parámetros.
¿Qué es?Protocolo — un «idioma» acordado para que dos cosas se comuniquen. MCP server — el programita que conecta el asistente con un servicio externo (correo electrónico, base de datos, raspador de sitios web…). Herramienta (tool) — cada acción que ofrece ese server. API — la «puerta de entrada» de un servicio para que otros programas se comuniquen con él.
Por qué aprender
Sin MCP, el asistente solo sabe lo que hay dentro del editor. Con MCP, llega al mundo: extraer datos de la web, leer una base de datos, crear documentos, enviar mensajes. MCP permite, por ejemplo, conectar el asistente a tu n8n para que construya workflows ahí mismo. Descubrir e instalar servers (mediante directorios o repositorios) amplía el abanico de tareas.
✓ Qué hace el MCP
- ✓Expone muchas herramientas mediante una sola conexión.
- ✓El asistente elige por su cuenta la acción y los parámetros.
- ✓Conecta categorías: web, bases de datos, documentos, comunicación.
✗ Qué evitar
- ✗Pegar la clave de API en el chat (va en el
.env, no en la conversación). - ✗Dejar muchos servers activados sin usarlos (consume contexto).
- ✗Configurar a nivel global cuando lo correcto es hacerlo por proyecto.
Conceptos clave
Una conexión, muchas acciones.
Conecta el asistente al servicio.
Las acciones disponibles.
Ella elige cuál usar.
📄 Skills & workflows
Qué es
Workflows e skills son, en el fondo, lo mismo: instrucciones reutilizables escritas en markdown (texto simple con títulos, listas y negrita). Funcionan como un manual de procedimiento (SOP) que le indica al asistente qué hacer, paso a paso. La diferencia está solo en dónde viven y cómo se llaman: una skill reside en una carpeta especial y se convierte en un comando rápido (slash command, por ejemplo: /rascunhar-email) que invocas cuando lo necesitas.
¿Qué es?Markdown — una forma simple de dar formato al texto (con # para títulos, - para listas). SOP — «procedimiento operativo estándar», un manual para realizar una tarea. Comando slash — un atajo escrito con una barra (/) que activa una skill.
Por qué aprender
Las skills te evitan tener que volver a explicar la misma tarea cada vez. Incluyen coherencia (el mismo proceso siempre), ahorro (se cargan solo cuando se las llama, no ocupan contexto innecesariamente), y compartir (el equipo usa la misma). Y, como una skill puede llamar herramientas (scripts que hacen el trabajo), el sistema de instrucciones + herramientas sigue intacto por debajo.
🎯 Consejo práctico
Usa una skill cuando la tarea se repite, exige consistencia o tiene pasos fáciles de olvidar. Para algo puntual o tan simple que cabe en una frase, es mejor solo escribir — una skill sería exagerado.
Conceptos clave
Instrucciones en texto simple.
No vuelvas a explicarlo cada vez.
Invoca bajo demanda.
Puede activar scripts.
🤖 Agentes — cuándo decide el sistema
Qué es
Un agente es lo que surge cuando el sistema deja de solo «ejecutar pasos fijos» y empieza a decidir por su cuenta. En una automatización tradicional, defines cada paso y, si algo falla, lo reparas. En un workflow agéntico, dices el resultado que quieres y el agente razona, se adapta, hace preguntas para aclarar y hasta se corrige solo cuando algo falla.
¿Qué es?Agéntico — comportamiento de quien razona y elige el camino, en vez de seguir un guion fijo. Autorreparación (self-healing) — cuando el agente se equivoca, diagnostica el problema y lo corrige por su cuenta durante la sesión. Determinístico × no determinístico — la automatización tradicional es predecible; el agente es flexible y puede variar.
Diagrama ilustrativo — la diferencia está en la línea de abajo: el agente no se detiene ante el error; lo diagnostica y sigue hasta alcanzar el objetivo.
Por qué aprender
Entender qué es un agente evita dos errores: creer que toda IA "decide por sí sola" (no siempre es así) y creer que una automatización fija es "tonta" (es confiable a propósito). La analogía ayuda: contratar a un desarrollador experimentado (agente) es diferente de seguir una receta al pie de la letra (automatización tradicional). Tú eliges la opción adecuada para cada tarea.
Conceptos clave
Razona sobre el camino.
Haz preguntas, ajusta.
Falla, diagnostica, corrige.
Tú dices el «qué».
🖥️☁️ Local vs. alojado
Qué es
La última pieza es una elección: ejecutar localmente o ejecutar en un servidor alojado. Local = en tu máquina: abres el asistente, inicias el trabajo y se ejecuta allí, contigo presente. Alojado = en la nube: el código se coloca en un servicio que lo ejecuta solo, en Internet, a una hora programada o como respuesta a un evento, sin que nadie tenga que presionar el botón.
¿Qué es?Alojar (deploy) — poner el código en funcionamiento en un servidor en internet, no en tu máquina. Cron (programación) — un reloj que activa la tarea a una hora determinada (p. ej., todos los días a las 7h). Webhook — una «campana digital»: una URL que, al recibir datos, activa la tarea.
Por qué aprender
Local es excelente para aprender y construir: ves cómo sucede todo y desarrollas intuición. Pero la automatización activada por una persona solo escala a la velocidad a la que alguien se presenta. Alojarla es lo que hace que la automatización trabaje mientras duermes. El precio es el agentic gap: en la nube, el asistente no está pendiente para autocurarse, así que la confiabilidad (logs, manejo de errores, alertas) pasa a ser tu responsabilidad desde el inicio.
🖥️ Local — tu máquina
- ✓Lo ejecutas y haces seguimiento en tiempo real.
- ✓El asistente se autocorrige al instante.
- ✓Ideal para aprender y crear prototipos.
☁️ Alojado — la nube
- ✓Se ejecuta solo: según un cronograma (cron) o a partir de un evento (webhook).
- ✓Escala sin que estés presente.
- !Exige logs, manejo de errores y alertas (agentic gap).
Conceptos clave
En tu máquina, contigo.
En la nube, por su cuenta.
Por agenda o por evento.
Sin autocuración en la nube.
En el ecosistema, quién es el coordinador que lee archivos, escribe, ejecuta comandos y activa las otras piezas?
📌 Resumen del módulo
Siguiente módulo:
1.3 — Glosario esencial (parte 1: IA, Claude Code, n8n)