GuíaIntermedio
Guía de MCP a Fondo
Aprende el Model Context Protocol (MCP) en su revisión vigente, `2026-07-28`, construyendo a mano el servidor y el cliente MCP de Reservo, un coworking, con Python 3.14 y la librería estándar. Es la continuación de la Guía de Fundamentos de Agentes y Tool Calling: ahí construiste las tools de Reservo (`list_rooms`, `get_quote`, `book_room`, `cancel_booking`); aquí las expones por MCP, el protocolo abierto que Anthropic publicó en noviembre de 2024 para que M aplicaciones y N herramientas no necesiten M×N integraciones, sino M+N. Implementas el protocolo de cable tal como es hoy: JSON-RPC 2.0 por stdio, **stateless** (sin handshake ni sesión: cada request trae su versión y sus capacidades en `_meta`), `server/discover` para preguntar antes de actuar, `resultType` en cada resultado y caché con `ttlMs`. Construyes los tres primitivos del servidor (tools con `outputSchema` y `structuredContent`, resources con templates, prompts con resources embebidos), la **elicitation** con el patrón Multi Round-Trip Requests y un `requestState` sellado con HMAC, un cliente completo que habla con varios servidores, y el mismo servidor por **Streamable HTTP** protegido con **OAuth 2.1** (metadatos del recurso, audiencia, scopes y step-up). Cierras registrándolo en Claude Code y comprobando que el **cliente oficial del SDK** de Python (`mcp` 2.3.0) habla con tu servidor escrito a mano, y que tu cliente habla con el servidor del SDK (`MCPServer`). Todo lo que se ve en la guía se ejecutó de verdad; la decisión de un modelo sobre qué tool usar es concepto.
- lecciones
- 64
- módulos
- 8
- disponible en
- Inglés · Español
- certificado
- Sí
- acceso
- Gratis

Lo que vas a poder hacer
- Explicar por qué existe MCP (el problema M×N que se vuelve M+N) y su arquitectura host, client y server: un client por server, y una conexión que no es una sesión
- Implementar el protocolo de cable de `2026-07-28` a mano: JSON-RPC 2.0 por stdio, el `_meta` de cada request, `server/discover`, `resultType` y los códigos de error modernos (`-32602`, `-32021`, `-32022`)
- Construir un servidor de tools con `inputSchema`, `outputSchema` y `structuredContent`, distinguiendo errores de protocolo de errores de ejecución (`isError`) y usando handles explícitos en lugar de sesión
- Exponer resources (con templates RFC 6570 y pistas de caché `ttlMs`/`cacheScope`) y prompts con resources embebidos, sabiendo quién controla cada primitivo
- Pedir la confirmación de la persona con elicitation en modo form y el patrón Multi Round-Trip Requests, protegiendo el `requestState` con integridad y uso único; saber cuándo usar el modo URL y qué quedó deprecado (roots, sampling, logging)
- Construir un cliente MCP completo: gafete en cada request, descubrimiento, paginación, caché, el bucle de reintentos y varios servidores con nombres sin colisiones
- Servir el mismo servidor por Streamable HTTP con sus cabeceras obligatorias y protegerlo como resource server OAuth 2.1: Protected Resource Metadata, PKCE, validación de audiencia, `403 insufficient_scope` y la prohibición del token passthrough
- Reconocer la frontera de confianza de un servidor de terceros (tool poisoning, SSRF, servidores locales comprometidos, DNS rebinding) y comprobar con una prueba las reglas de un servidor remoto
- Registrar el servidor en Claude Code por stdio y por HTTP con `.mcp.json`, y reescribirlo con el SDK oficial (`MCPServer`) entendiendo qué reemplaza cada línea
- Entregar un proyecto completo y verificar su conformidad con el cliente oficial del SDK en los dos transportes
Qué necesitas traer
Es para ti si...
- Devs que ya construyeron un agente con tool calling y quieren exponer sus herramientas de forma estándar y reutilizable
- Devs que van a construir o conectar servidores MCP para Claude Code u otro host compatible, local o remoto
- Backend developers que quieren entender el protocolo de cable real, y no solo un SDK, para depurar y diseñar con criterio
- Quien evalúa adoptar MCP en su equipo y necesita entender su arquitectura, su modelo de seguridad y cómo cambió en la revisión `2026-07-28`
Requisitos y materiales
- Guía de Fundamentos de Agentes y Tool Calling completada (o equivalente: qué es una tool, su contrato en JSON Schema, el protocolo `tool_use`/`tool_result`)
- Python básico: funciones, diccionarios, clases, manejo de excepciones
- Python 3.14 con su librería estándar; no requiere API key. Las lecciones opcionales con el SDK oficial usan `uv` y conexión a internet
El temario, módulo por módulo
Abre cualquiera para ver sus lecciones.
- Módulo 1: Qué es MCP y por qué existe
- El problema de integración M×N
- Qué es MCP: un USB-C para aplicaciones de IA
- La arquitectura host, client, server
- MCP frente al protocolo de tools de la Messages API
- Los tres primitivos: tools, resources, prompts
- Un primer servidor MCP de juguete, ejecutado
- Mini-proyecto: lista las tools de un servidor
- Módulo 2: El protocolo de cable, JSON-RPC sobre stdio
- JSON-RPC 2.0: el formato de los mensajes
- El transporte stdio
- El `_meta` de cada request
- `server/discover`: preguntar antes de actuar
- Requests, respuestas y notificaciones
- Un intercambio stateless completo, ejecutado
- Mini-proyecto: un servidor MCP moderno mínimo
- Módulo 5: Elicitation y Multi Round-Trip Requests
- Cuándo un servidor necesita preguntar
- El `InputRequiredResult`
- Elicitation en modo formulario
- Proteger el `requestState`
- Elicitation en modo URL para datos sensibles
- Roots, sampling y logging, deprecados
- Mini-proyecto: confirmar una reserva antes de hacerla
- Módulo 7: Servidores remotos: autorización y seguridad
- Streamable HTTP: un POST por mensaje
- Servir Reservo por HTTP
- Por qué un servidor remoto necesita autorización
- El flujo OAuth paso a paso
- Validar tokens y el confused deputy
- La frontera de confianza de los servidores de terceros
- Mini-proyecto: un servidor HTTP de Reservo protegido
Aprende con clases en vivo y revisión de tus entregas.
En grupo o 1 a 1, según tu horario.
Lo que suele preguntarse
Sin límite. Es una guía gratuita: entras cuando quieras, las veces que quieras.
No. Los módulos están ordenados de menos a más, pero puedes saltar al que necesites. Tu progreso se guarda por lección.
Lo que haga falta está en «Qué necesitas traer», arriba. Si no aparece nada ahí, puedes empezar desde cero.
En el grupo de WhatsApp, y cada quince días hay un live con un instructor donde se resuelven dudas en vivo.
Sí. Al terminar todas las lecciones recibes tu constancia de finalización. Si apruebas el examen de certificación de la guía, se convierte en certificado, con un código verificable que puedes compartir en LinkedIn.
No. Esta guía es autoguiada y sin fechas. El bootcamp es en vivo, por cohorte, con entregas que alguien revisa.
Empieza cuando quieras
Lo que dicen los estudiantes
Estas reseñas son de estudiantes inscritos que completaron al menos el 50% del curso. Moderamos las reseñas solo por motivos de contenido (spam, lenguaje ofensivo, datos personales), nunca por ser críticas o negativas.
Aún no hay reseñas aprobadas.
¡Sé el primero en compartir tu experiencia!