GuíaBásico
Guía de MCP a Fondo
Es la continuación directa de la Guía de Fundamentos de Agentes y Tool Calling: toma las tools de Reservo ya construidas ahí (`get_quote`, `list_rooms`, `book_room`, `cancel_booking`) y las expone a través del Model Context Protocol (MCP), el estándar abierto que Anthropic publicó en noviembre de 2024 para resolver el problema de integración M×N (cada agente reimplementando su propio adaptador para cada herramienta) con una solución M+N (un servidor MCP se construye una vez y lo reutiliza cualquier cliente compatible). La guía construye un servidor y un cliente MCP de Reservo reales: el wire protocol —JSON-RPC 2.0 sobre stdio— implementado a mano con Python 3.14 y su librería estándar (`subprocess`, sin instalar el SDK oficial, $0, sin red), el handshake `initialize`/`initialized`, y los tres primitivos del protocolo: tools, resources y prompts. Cierra conectando el servidor a un `.mcp.json` real, como el que usaría Claude Code. Ancla su enseñanza a la revisión estable `2025-06-18` (la que está desplegada hoy en el ecosistema real) y nombra honestamente, sin reimplementarla, la revisión moderna stateless `2026-07-28` como el rumbo del protocolo. La decisión del LLM de qué tool/resource/prompt usar es concepto; el protocolo de cable se ejecuta de verdad y se verifica contra la especificación oficial.
- 64
- lecciones
- 8
- módulos
- Inglés · Español
- disponible en
- Sí
- certificado
- Gratis
- acceso
Resultados
Lo que vas a poder hacer
- Explicar por qué existe MCP: el problema de integración M×N que resuelve una solución M+N, y la arquitectura host/client/server (un host crea un client por cada server con el que se conecta)
- Implementar el wire protocol de MCP a mano: JSON-RPC 2.0 sobre el transporte stdio (`stdout` exclusivo para mensajes válidos, `stderr` para logs), verificado byte a byte contra la especificación oficial
- Ejecutar el handshake `initialize` → respuesta con `capabilities`/`serverInfo` → `notifications/initialized`, con `protocolVersion` fijo en `2025-06-18`, antes de cualquier operación
- Construir un servidor MCP de tools reales: la capability `tools`, `tools/list` y `tools/call` — y contrastar explícitamente el JSON Schema (`inputSchema`) de MCP con el protocolo `tool_use`/`tool_result` de la Messages API de Claude que ya conocen de agent-fundamentals
- Exponer resources (datos de contexto identificados por URI, *application-driven*) con `resources/list`/`resources/read`, y decidir cuándo un resource es la herramienta correcta frente a una tool de búsqueda
- Exponer prompts (plantillas reutilizables, *user-controlled*) con `prompts/list`/`prompts/get`, contrastando los tres modelos de interacción del protocolo: tools (model-controlled), resources (application-driven) y prompts (user-controlled)
- Construir un cliente MCP completo: negociar capacidades tras el handshake y descubrir los tres primitivos de un servidor en una sola corrida
- Conectar un servidor MCP a Claude Code con un archivo `.mcp.json` real, y distinguir los transportes de producción (stdio local vs Streamable HTTP remoto)
- Reconocer la frontera de confianza de un servidor MCP de terceros — las descriptions de sus tools y el texto de sus resources son datos no confiables salvo que el servidor lo sea — y saber a qué guía acudir para el endurecimiento real
- Ensamblar el servidor MCP de Reservo completo (las cuatro tools con sus schemas, dos resources de políticas y el prompt `plan_booking`) junto con un cliente que lo descubre y lo usa de punta a punta
Antes de empezar
Qué necesitas traer
Es para ti si...
- Devs que ya construyeron un agente con tool calling y quieren exponer esas herramientas de forma estándar y reutilizable en vez de tenerlas hardcodeadas en el proceso del agente
- Devs que van a conectar o construir servidores MCP para Claude Code, Claude Desktop u otro host compatible
- Backend developers que quieren entender el protocolo de cable real —JSON-RPC 2.0 sobre stdio— en vez de depender únicamente de un SDK
- Quien está evaluando adoptar MCP en su equipo y necesita entender primero el problema de integración que resuelve y su arquitectura host/client/server
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, manejo de excepciones
- Python 3.14 instalado con su librería estándar; no requiere API key, conexión a internet ni instalar el SDK oficial de MCP
Contenido
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 vs. el 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 3: Tools sobre MCP
- La capability `tools`
- `tools/list`: anunciar qué ofrece el servidor
- El `inputSchema`: mismo JSON Schema, protocolo nuevo
- `tools/call`: invocar una tool
- La forma del resultado: `content` y `isError`
- Las tools de Reservo sobre MCP, ejecutadas
- Mini-proyecto: un servidor de tools para Reservo
- Módulo 7: Conectar con Claude Code y servidores de terceros
- El archivo de configuración `.mcp.json`
- Registrar el servidor Reservo
- Transportes stdio vs. HTTP en producción
- Servidores MCP de terceros
- La frontera de confianza de un servidor
- Cuándo un servidor no es confiable
- Mini-proyecto: un `.mcp.json` para Reservo
Dudas frecuentes
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 del Club, y cada quince días hay un live con un instructor donde se resuelven dudas en vivo.
Sí. Al terminar todas las lecciones se emite automáticamente, con un código verificable que puedes compartir en LinkedIn.
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!