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
Resultados

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
Antes de empezar

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
Contenido

El temario, módulo por módulo

Abre cualquiera para ver sus lecciones.

Bootcamps

Aprende con clases en vivo y revisión de tus entregas.

En grupo o 1 a 1, según tu horario.

Dudas frecuentes

Lo que suele preguntarse

Empieza cuando quieras

Reseñas

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!