🧠 MCP, Skills & Agents — Training para Agent Devs

De cero a construir agentes inteligentes con Model Context Protocol Documentación teórico-práctica con ejemplos reales y prompts listos para usar.

⚡ Inicio Rápido (10 minutos)

¿Quieres ver MCP funcionando ahora mismo? Ve directo a:

→ 05-ejemplos-practicos/00-como-integrar-mcp-clima.md

Construyes un MCP Server de clima real (sin API key), lo pruebas con el Inspector visual, y lo conectas a Claude Desktop o Claude Code.

¿Para quién es esto?

Desarrolladores que quieren entender y construir:

• MCP Servers que conectan IAs con el mundo real
• Skills que enseñan nuevas capacidades a agentes
• Agentes que orquestan tareas complejas de forma autónoma

Prerequisitos

• JavaScript/TypeScript básico (o Python)
• Familiaridad con Node.js y npm
• Haber usado algún LLM (Claude, GPT, etc.)
• Terminal/línea de comandos

📚 Estructura del Training

Módulo 1 — Fundamentos

¿Qué problema resuelven? ¿Por qué importan?

| Archivo | Contenido | |---------|-----------| | 01-el-problema.md | El problema N×M de integraciones | | 02-ecosistema.md | MCP vs Skills vs Agents: cuándo usar cada uno | | 03-arquitectura.md | Arquitectura Host → Client → Server |

Módulo 2 — MCP Deep Dive

Construye tu primer MCP Server

| Archivo | Contenido | |---------|-----------| | 01-conceptos-clave.md | Tools, Resources, Prompts en detalle | | 02-primer-servidor.md | Tu primer MCP Server en TypeScript | | 03-servidor-real.md | Ejemplo real: MCP Server de tareas con persistencia |

Módulo 3 — Skills

Enseña capacidades reutilizables a los agentes

| Archivo | Contenido | |---------|-----------| | 01-que-son-skills.md | Anatomía de un SKILL.md | | 02-crear-skill.md | Crea tu primer Skill paso a paso | | 03-patrones.md | Patrones avanzados y composición |

Módulo 4 — Agents

Patrones de diseño para agentes autónomos

| Archivo | Contenido | |---------|-----------| | 01-patrones-agentes.md | Los 5 patrones fundamentales (ReAct, CoT, Router...) | | 02-multi-agente.md | Sistemas multi-agente | | 03-orquestacion.md | Orquestación y flujos reales |

Módulo 5 — Ejemplos Prácticos

Código que puedes ejecutar hoy

| Archivo | Contenido | |---------|-----------| | 00-como-integrar-mcp-clima.md | ⭐ Guía de integración paso a paso (empieza aquí) | | 01-mcp-weather.md | Código completo del MCP de clima | | 02-skill-code-review.md | Skill de code review con criterios reales | | 03-agente-investigador.md | Agente investigador multi-paso |

Módulo 6 — Prompts Listos

Copia, pega, construye

| Archivo | Contenido | |---------|-----------| | prompts.md | 6 prompts para construir MCP Servers, Skills y Agentes |

🗺️ Mapa Mental

                    ┌─────────────┐
                    │   TU APP    │
                    │   (Host)    │
                    └──────┬──────┘
                           │
                    ┌──────┴──────┐
                    │   Client    │
                    │  (Claude,   │
                    │  Cursor...) │
                    └──────┬──────┘
                           │
            ┌──────────────┼──────────────┐
            │              │              │
     ┌──────┴──────┐ ┌────┴────┐  ┌──────┴──────┐
     │ MCP Server  │ │  Skill  │  │   Agent     │
     │ (conexión)  │ │ (saber) │  │ (autonomía) │
     └─────────────┘ └─────────┘  └─────────────┘
     "El enchufe"    "El libro    "El empleado
                      de recetas"  que cocina"

Cómo usar este repo

1. Quiero probar algo ahora: Ve al Módulo 5 — guía de integración
2. Quiero entender desde cero: Empieza por el Módulo 1
3. Solo necesito el código: Cada módulo tiene código listo para copiar y ejecutar
4. Quiero generar mis propios componentes: Usa el Módulo 6 — Prompts con cualquier agente dev

Creado para el training de MCP, Skills & Agents — Marzo 2026