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
certificado
Gratis
acceso
NIEVA

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.

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!