07 · Conexiones y seguridad anti-caídas

Claude no trabaja aislado: puede conectarse con otras aplicaciones. Aquí ves cómo, y sobre todo aprendes las reglas para que nada se caiga ni se rompa.

⏱ 35 minutos 📶 Requiere: módulo 06 🔒 Seguridad

Al terminar este módulo vas a poder…

Entender qué es un MCP y ver tus conexiones activas.
Usar la IA con planillas y generar PDF.
Saber dónde vive cada credencial y por qué.
Construir automatizaciones que no se caigan ni te dejen expuesto.

¿Qué es un MCP?

MCP es un "traductor" que le permite a Claude hablar con otras aplicaciones. Sin él, Claude solo trabaja con tus archivos; con un MCP conectado, puede además manejar tu n8n, tu GitHub, tu calendario, y más.

Analogía: si Claude fuera un ejecutivo, los MCP son sus teléfonos directos con cada área. Uno lo conecta con n8n, otro con GitHub, otro con tu correo. Cada MCP es una línea dedicada a una aplicación.

Para ver qué conexiones tienes activas, dentro de Claude Code escribe:

/mcp

Añadir o quitar conexiones

No hace falta editar archivos a mano. Dentro de Claude Code, el comando /mcp te muestra las conexiones activas y te deja gestionarlas. Para agregar una nueva, lo más simple es pedírselo a Claude: "conéctate a mi n8n en esta dirección", y te va guiando.

Regla de oro de las conexiones

Una conexión MCP le da a la IA llaves reales de un sistema real. Antes de conectar cualquier cosa, pregúntate: "si esto se equivoca, ¿qué es lo peor que puede pasar?"

Conecta primero lo inofensivo (un calendario de prueba, una instancia de práctica). Nunca conectes producción hasta que sepas exactamente qué permisos estás entregando. Y las claves de conexión, como siempre, van en el .env — nunca escritas dentro de un archivo que pueda subirse a internet.

¿Qué es un CLI?

CLI significa "Command Line Interface" — interfaz de línea de comandos. Es un programa que se usa escribiendo comandos de texto, en vez de hacer clics en botones y ventanas.

App de ventanas (GUI)	Programa de comandos (CLI)
Usas el mouse: clic en botones, menús, íconos.	Escribes instrucciones de texto y presionas Enter.
Word, Excel, tu navegador.	PowerShell, y Claude Code.
Fácil de explorar, más lento para tareas repetidas.	Curva inicial, pero rapidísimo y automatizable.

Sí: Claude Code es un CLI. Por eso lo usas escribiendo claude y conversando con texto. La ventaja es que todo lo que hace se puede automatizar y repetir.

GitHub: el respaldo de tu trabajo

GitHub es un servicio en internet para guardar y versionar proyectos (código, páginas web). "Versionar" significa que guarda el historial de cambios: puedes volver atrás si algo sale mal, como un "deshacer" gigante que nunca se borra.

Cada guardado con historial se llama commit (una foto del proyecto en ese momento).
El proyecto completo guardado en GitHub se llama repositorio (o "repo").
Hay un MCP de GitHub que le permite a Claude subir cambios por ti.

Ejemplo real de Aut-Inos: la web aut-inos.com vive en un repositorio de GitHub. Cuando se actualiza el sitio, Claude sube ("pushea") los cambios al repo, y desde ahí se publican. Tú, para tus tareas administrativas, usarás GitHub sobre todo como respaldo seguro de tus proyectos.

Recuerda el guardián

Antes de subir algo a GitHub, verifica que tu .gitignore incluya .env (módulo 04). Así tus secretos nunca viajan a internet, aunque el resto del proyecto sí.

Excel y planillas

Claude puede leer y escribir planillas. Le pasas un archivo de Excel o CSV y le pides que lo ordene, lo resuma o cree uno nuevo:

Lee ventas-enero.csv, calcula el total por vendedor y crea
resumen-vendedores.html con una tabla ordenada de mayor a menor.
No modifiques el archivo original.

Y desde n8n también puedes exportar datos a Google Sheets o Excel automáticamente. Por ejemplo, un workflow que cada semana vuelca los datos nuevos a una planilla compartida, sin que tú abras nada.

Crear PDF

Dos caminos fáciles:

Desde un HTML: abre el archivo .html en tu navegador, presiona Ctrl + P (Imprimir) y elige "Guardar como PDF". Perfecto para informes y propuestas.
Pidiéndoselo a Claude: "convierte este informe en PDF" — según las herramientas conectadas, puede generarlo directamente.

¿Dónde viven las credenciales? (repaso)

Para que quede grabado, este es el mapa de dónde va cada secreto:

Secreto	Dónde va
API keys de tus proyectos	En el archivo `.env` (módulo 04), protegido por `.gitignore`.
Configuración de Claude / MCP	En la configuración de Claude Code, gestionada con `/mcp`. Debe apuntar a variables de entorno, nunca guardar el valor de la clave directamente.
Accesos que usa n8n	En la sección Credentials de tu n8n (módulo 06).

La regla, una vez más

Los secretos nunca van dentro del código, ni en documentos, ni en mensajes, ni en capturas. Solo en su lugar seguro. Si un día dudas dónde pegar una clave, la respuesta correcta casi siempre es "en el .env, no aquí".

Seguridad anti-caídas: que nada se rompa

Las automatizaciones pueden fallar si no se cuidan. Estas reglas están sacadas de errores que le ocurren a todo el mundo tarde o temprano. Aprenderlas ahora te ahorra los mismos dolores de cabeza.

Reglas técnicas (cuando trabajes con n8n)

Prefiere "Set nodes" antes que "Code nodes". Los nodos que ejecutan código a mano son la fuente número uno de fallos silenciosos, sobre todo en servidores con poca memoria. Para transformar datos, el nodo "Set" es más estable y más fácil de depurar. Si le pides workflows a Claude, dile: "sin Code nodes, usa Set nodes".
Cuidado con Redis. Es una pieza de memoria rápida que, mal usada, puede colgarse o quedarse sin espacio (los famosos "timeouts" y "OOM"). Úsalo solo cuando de verdad haga falta.
En flujos que ya están productivos, pon tres seguros:
- executionTimeout — un tiempo máximo, para que un flujo colgado se corte solo en vez de quedar pegado horas.
- continueOnFail — que un error en un paso no bote todo el flujo, cuando corresponde.
- errorWorkflow — un flujo aparte que te avisa cuando algo falla, para enterarte a tiempo.

Buenas prácticas (siempre)

Prueba con pocos datos antes de activar. Corre el flujo a mano con 1 o 2 casos. Recién cuando funcione perfecto, actívalo para que trabaje solo.
Valida las entradas. No asumas que el dato que llega es correcto: ¿y si el correo viene vacío, o el número es texto? Un flujo robusto revisa antes de actuar.
No expongas webhooks sin protección. Un "webhook" es una puerta de entrada por internet a tu flujo. Si la dejas abierta sin clave, cualquiera podría tocarla. Ponle autenticación.
Maneja los errores, no asumas éxito. Pregúntate siempre "¿y si esto falla?" y deja previsto qué pasa en ese caso, en vez de dar por hecho que todo saldrá bien.
Respalda antes de cambios grandes. Igual que en el módulo 03: copia o versiona antes de una modificación importante. Deshacer siempre es más fácil si tienes de dónde volver.

La mentalidad correcta

La diferencia entre una automatización que da tranquilidad y una que da sustos es asumir que las cosas pueden fallar y prepararse para eso. Un poco de precaución al construir te ahorra muchas urgencias después.

Practica ahora — un informe en PDF desde una planilla

Junta todo lo del módulo en un solo pedido. Ten a mano un CSV cualquiera (o pídele a la IA que invente uno de prueba):

Crea un archivo ventas-prueba.csv con 10 ventas inventadas
(fecha, vendedor, monto). Luego léelo y genera
informe-ventas.html con el total por vendedor en una tabla
ordenada de mayor a menor y un título claro.

Cuando esté listo, ábrelo en el navegador, presiona Ctrl+P (o Cmd+P) y guárdalo como PDF. Acabas de convertir datos crudos en un informe presentable, sin abrir Excel.

Comprueba que lo entendiste

Vas a dejar un workflow corriendo solo que recibe pedidos desde un formulario en tu web por un webhook. ¿Qué es lo mínimo que no puede faltar?

Correcto. Un webhook es una puerta abierta a internet: sin autenticación, cualquiera puede tocarla. Y como no controlas qué datos te van a llegar, tienes que validar antes de actuar. Las credenciales van siempre en su sección aparte, y los Set nodes son más estables que los Code nodes. Construir pensando en "¿y si esto falla?" es lo que separa una automatización tranquila de una que da sustos.

Lo que te llevas de este módulo

MCP = puente entre Claude y otras apps; míralos con /mcp.
CLI = programa por comandos de texto; Claude Code es uno.
GitHub respalda y versiona tu trabajo (commits, repos); protege el .env con .gitignore.
Claude maneja Excel/planillas y genera PDF (desde HTML con Ctrl+P → Guardar como PDF).
Anti-caídas: sin Code nodes, cuidado con Redis, pon timeout/continueOnFail/errorWorkflow, prueba con pocos datos, valida entradas, protege webhooks y respalda.

Ya dominas las herramientas

Ahora viene lo que las empresas de verdad necesitan: decidir qué automatizar, con qué datos, y con qué reglas para tu equipo. Eso es el módulo 08.