Sigue estos pasos para comenzar a usar estos recursos:
- Haz un Fork del Repositorio: Haz clic en
- Clona el Repositorio:
git clone https://github.com/microsoft/mcp-for-beginners.git - Únete al
Árabe | Bengalí | Búlgaro | Birmano (Myanmar) | Chino (Simplificado) | Chino (Tradicional, Hong Kong) | Chino (Tradicional, Macao) | Chino (Tradicional, Taiwán) | Croata | Checo | Danés | Holandés | Estonio | Finés | Francés | Alemán | Griego | Hebreo | Hindi | Húngaro | Indonesio | Italiano | Japonés | Kannada | Jemer | Coreano | Lituano | Malayo | Malayalam | Maratí | Nepalí | Pidgin Nigeriano | Noruego | Persa (Farsi) | Polaco | Portugués (Brasil) | Portugués (Portugal) | Punjabi (Gurmukhi) | Rumano | Ruso | Serbio (Cirílico) | Eslovaco | Esloveno | Español | Suajili | Sueco | Tagalo (Filipino) | Tamil | Telugu | Tailandés | Turco | Ucraniano | Urdu | Vietnamita
¿Prefieres Clonar Localmente?
Este repositorio incluye traducciones en más de 50 idiomas que aumentan significativamente el tamaño de la descarga. Para clonar sin traducciones, usa sparse checkout:
Bash / macOS / Linux:
git clone --filter=blob:none --sparse https://github.com/microsoft/mcp-for-beginners.git cd mcp-for-beginners git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'CMD (Windows):
git clone --filter=blob:none --sparse https://github.com/microsoft/mcp-for-beginners.git cd mcp-for-beginners git sparse-checkout set --no-cone "/*" "!translations" "!translated_images"Esto te da todo lo necesario para completar el curso con una descarga mucho más rápida.
¡Bienvenido a tu viaje en el Protocolo de Contexto de Modelo! Si alguna vez te has preguntado cómo las aplicaciones de IA se comunican con diferentes herramientas y servicios, estás a punto de descubrir la solución elegante que está transformando la manera en que los desarrolladores construyen sistemas inteligentes.
Piensa en MCP como un traductor universal para aplicaciones de IA — así como los puertos USB te permiten conectar cualquier dispositivo a tu computadora, MCP permite que los modelos de IA se conecten a cualquier herramienta o servicio de forma estandarizada. Ya sea que estés construyendo tu primer chatbot o trabajando en flujos de trabajo complejos de IA, entender MCP te dará el poder de crear aplicaciones más capaces y flexibles.
Este curriculum está diseñado con paciencia y cuidado para tu proceso de aprendizaje. Empezaremos con conceptos sencillos que ya conoces y construiremos tu experiencia poco a poco, practicando en tu lenguaje de programación favorito. Cada paso incluye explicaciones claras, ejemplos prácticos y mucho ánimo a lo largo del camino.
Cuando termines este viaje, tendrás la confianza para construir tus propios servidores MCP, integrarlos con las plataformas de IA más populares, y comprender cómo esta tecnología está remodelando el futuro del desarrollo de IA. ¡Comencemos esta emocionante aventura juntos!
Este curriculum está alineado con la Especificación MCP 2025-11-25 (la última versión estable). La especificación MCP utiliza versionado basado en fechas (formato AAAA-MM-DD) para asegurar un claro seguimiento de versiones del protocolo.
Estos recursos se vuelven más valiosos a medida que avanza tu comprensión, pero no te sientas presionado a leer todo de inmediato. ¡Empieza con las áreas que más te interesen!
- 📘 Documentación MCP – Este es tu recurso de referencia para tutoriales paso a paso y guías para usuarios. La documentación está escrita pensando en principiantes, con ejemplos claros que puedes seguir a tu ritmo.
- 📜 Especificación MCP – Considera esto como tu manual de referencia completo. A medida que avances en el curriculum, regresarás aquí para consultar detalles específicos y explorar funcionalidades avanzadas.
- 📜 Versionado de Especificación MCP – Contiene información sobre la historia de versiones del protocolo y cómo MCP utiliza versionado basado en fechas (formato AAAA-MM-DD).
- 🧑💻 Repositorio GitHub de MCP – Aquí encontrarás SDKs, herramientas y ejemplos de código en múltiples lenguajes de programación. Es como un tesoro de ejemplos prácticos y componentes listos para usar.
- 🌐 Comunidad MCP – Únete a otros aprendices y desarrolladores experimentados en discusiones sobre MCP. Es una comunidad solidaria donde preguntas son bienvenidas y el conocimiento se comparte libremente.
Al final de este curriculum, te sentirás seguro y entusiasmado con tus nuevas habilidades. Esto es lo que lograrás:
• Entender los fundamentos de MCP: Comprenderás qué es el Protocolo de Contexto de Modelo y por qué está revolucionando la forma en que las aplicaciones de IA trabajan juntas, utilizando analogías y ejemplos que tengan sentido.
• Construir tu primer servidor MCP: Crearás un servidor MCP funcional en tu lenguaje de programación preferido, comenzando con ejemplos simples y aumentando tu habilidad paso a paso.
• Conectar modelos de IA con herramientas reales: Aprenderás a cerrar la brecha entre modelos de IA y servicios reales, otorgando a tus aplicaciones capacidades nuevas y poderosas.
• Implementar las mejores prácticas de seguridad: Comprenderás cómo mantener seguras tus implementaciones MCP, protegiendo tanto tus aplicaciones como a tus usuarios.
• Desplegar con confianza: Sabrás cómo llevar tus proyectos MCP desde el desarrollo hasta la producción, con estrategias prácticas de despliegue que funcionan en el mundo real.
• Unirte a la comunidad MCP: Formarás parte de una comunidad creciente de desarrolladores que están moldeando el futuro del desarrollo de aplicaciones de IA.
Antes de sumergirnos en los detalles del MCP, asegurémonos de que te sientas cómodo con algunos conceptos básicos. ¡No te preocupes si no eres un experto en estas áreas, te explicaremos todo lo que necesitas saber a medida que avanzamos!
Piensa en un protocolo como las reglas para una conversación. Cuando llamas a un amigo, ambos saben decir “hola” al contestar, turnarse para hablar y decir “adiós” cuando terminan. Los programas informáticos necesitan reglas similares para comunicarse eficazmente.
MCP es un protocolo — un conjunto de reglas acordadas que ayudan a los modelos de IA y a las aplicaciones a tener “conversaciones” productivas con herramientas y servicios. Así como tener reglas de conversación hace la comunicación humana más fluida, tener MCP hace que la comunicación entre aplicaciones de IA sea mucho más confiable y potente.
¡Ya usas relaciones cliente-servidor todos los días! Cuando usas un navegador web (el cliente) para visitar un sitio web, te conectas a un servidor web que te envía el contenido de la página. El navegador sabe cómo pedir la información, y el servidor sabe cómo responder.
En MCP, tenemos una relación similar: los modelos de IA actúan como clientes que solicitan información o acciones, mientras que los servidores MCP proveen esas capacidades. Es como tener un asistente útil (el servidor) a quien la IA puede pedir que ejecute tareas específicas.
Imagina si cada fabricante de autos usara bombas de gasolina de formas distintas — ¡necesitarías un adaptador diferente para cada auto! La estandarización significa acordar enfoques comunes para que las cosas funcionen juntas sin problemas.
MCP proporciona esta estandarización para las aplicaciones de IA. En lugar de que cada modelo de IA necesite código personalizado para funcionar con cada herramienta, MCP crea una forma universal de comunicarse. Esto significa que los desarrolladores pueden construir herramientas una vez y hacer que funcionen con muchos sistemas de IA distintos.
Tu viaje con MCP está cuidadosamente estructurado para construir tu confianza y habilidades progresivamente. Cada fase introduce nuevos conceptos mientras refuerza lo que ya aprendiste.
¡Aquí es donde comienza tu aventura! Te introduciremos a los conceptos de MCP usando analogías familiares y ejemplos simples. Comprenderás qué es MCP, por qué existe y cómo encaja en el mundo más amplio del desarrollo IA.
• Módulo 0 - Introducción a MCP: Empezaremos explorando qué es MCP y por qué es tan importante para las aplicaciones modernas de IA. Verás ejemplos reales de MCP en acción y entenderás cómo resuelve problemas comunes que enfrentan los desarrolladores.
• Módulo 1 - Conceptos Clave Explicados: Aquí aprenderás los bloques fundamentales de MCP. Usaremos muchas analogías y ejemplos visuales para que estos conceptos se sientan naturales y fáciles de entender.
• Módulo 2 - Seguridad en MCP: La seguridad puede sonar intimidante, pero te mostraremos cómo MCP incluye características de seguridad integradas y te enseñaremos las mejores prácticas para proteger tus aplicaciones desde el principio.
¡Ahora comienza la verdadera diversión! Tendrás experiencia práctica construyendo servidores y clientes MCP reales. No te preocupes, empezaremos con cosas simples y te guiaremos en cada paso.
Este módulo incluye múltiples guías prácticas que te permiten practicar en tu lenguaje de programación preferido. Crearás tu primer servidor, construirás un cliente para conectarte a él e incluso integrarás con herramientas de desarrollo populares como VS Code.
Cada guía incluye ejemplos completos de código, consejos para solucionar problemas y explicaciones de por qué tomamos decisiones específicas de diseño. ¡Al final de esta fase, tendrás implementaciones MCP funcionando de las que podrás estar orgulloso!
Con lo básico dominado, estás listo para explorar características más sofisticadas del MCP. Cubriremos estrategias prácticas de implementación, técnicas de depuración y temas avanzados como integración de IA multimodal.
También aprenderás cómo escalar tus implementaciones MCP para uso en producción e integrar con plataformas en la nube como Azure. Estos módulos te preparan para construir soluciones MCP que puedan manejar demandas del mundo real.
La fase final se enfoca en unirte a la comunidad MCP y especializarte en las áreas que más te interesan. Aprenderás cómo contribuir a proyectos MCP de código abierto, implementar patrones avanzados de autenticación y construir soluciones integrales con base de datos.
El módulo 11 merece una mención especial: es un camino completo de aprendizaje práctico con 13 laboratorios que te enseña a construir servidores MCP listos para producción con integración PostgreSQL. ¡Es como un proyecto final que reúne todo lo que has aprendido!
| Módulo | Tema | Descripción | Enlace |
|---|---|---|---|
| Módulos 0-3: Fundamentos | |||
| 00 | Introducción a MCP | Descripción general del Protocolo de Contexto del Modelo y su importancia en pipelines de IA | Leer más |
| 01 | Explicación de Conceptos Clave | Exploración profunda de los conceptos centrales de MCP | Leer más |
| 02 | Seguridad en MCP | Amenazas de seguridad y mejores prácticas | Leer más |
| 03 | Primeros Pasos con MCP | Configuración del entorno, servidores/clientes básicos, integración | Leer más |
| Módulo 3: Construyendo tu Primer Servidor y Cliente | |||
| 3.1 | Primer Servidor | Crea tu primer servidor MCP | Guía |
| 3.2 | Primer Cliente | Desarrolla un cliente MCP básico | Guía |
| 3.3 | Cliente con LLM | Integra modelos de lenguaje extensos | Guía |
| 3.4 | Integración VS Code | Consume servidores MCP en VS Code | Guía |
| 3.5 | Servidor stdio | Crea servidores usando transporte stdio | Guía |
| 3.6 | Streaming HTTP | Implementa streaming HTTP en MCP | Guía |
| 3.7 | Kit de Herramientas AI | Usa AI Toolkit con MCP | Guía |
| 3.8 | Pruebas | Prueba tu implementación de servidor MCP | Guía |
| 3.9 | Despliegue | Despliega servidores MCP a producción | Guía |
| 3.10 | Uso avanzado del servidor | Usa servidores avanzados para características avanzadas y mejor arquitectura | Guía |
| 3.11 | Autenticación simple | Capítulo sobre autenticación desde cero y RBAC | Guía |
| 3.12 | Hosts MCP | Configura Claude Desktop, Cursor, Cline y otros hosts MCP | Guía |
| 3.13 | Inspector MCP | Depura y prueba servidores MCP con la herramienta Inspector | Guía |
| 3.14 | Muestreo | Usa muestreo para colaborar con el cliente | Guía |
| 3.15 | Aplicaciones MCP | Construye aplicaciones MCP | Guía |
| Módulos 4-5: Práctico y Avanzado | |||
| 04 | Implementación Práctica | SDKs, depuración, pruebas, plantillas reutilizables de prompts | Leer más |
| 4.1 | Paginación | Maneja conjuntos grandes de resultados con paginación con cursor | Guía |
| 05 | Temas Avanzados en MCP | IA multimodal, escalabilidad, uso empresarial | Leer más |
| 5.1 | Integración Azure | Integración MCP con Azure | Guía |
| 5.2 | Multimodalidad | Trabajando con múltiples modalidades | Guía |
| 5.3 | Demo OAuth2 | Implementa autenticación OAuth2 | Guía |
| 5.4 | Contextos Raíz | Comprende e implementa contextos raíz | Guía |
| 5.5 | Enrutamiento | Estrategias de enrutamiento MCP | Guía |
| 5.6 | Muestreo | Técnicas de muestreo en MCP | Guía |
| 5.7 | Escalado | Escala implementaciones MCP | Guía |
| 5.8 | Seguridad | Consideraciones avanzadas de seguridad | Guía |
| 5.9 | Búsqueda Web | Implementa capacidades de búsqueda web | Guía |
| 5.10 | Streaming en Tiempo Real | Construye funcionalidad de streaming en tiempo real | Guía |
| 5.11 | Búsqueda en Tiempo Real | Implementa búsqueda en tiempo real | Guía |
| 5.12 | Autenticación Entra ID | Autenticación con Microsoft Entra ID | Guía |
| 5.13 | Integración Foundry | Integra con Azure AI Foundry | Guía |
| 5.14 | Ingeniería de Contexto | Técnicas para ingeniería efectiva de contexto | Guía |
| 5.15 | Transporte Personalizado MCP | Implementaciones personalizadas de transporte | Guía |
| 5.16 | Características del Protocolo | Notificaciones de progreso, cancelación, plantillas de recursos | Guía |
| 5.17 | Razonamiento Multi-Agente Adversarial | Dos agentes discuten lados opuestos usando herramientas MCP compartidas, evaluados por un agente juez | Guía |
| Módulos 6-10: Comunidad y Mejores Prácticas | |||
| 06 | Contribuciones a la Comunidad | Cómo contribuir al ecosistema MCP | Guía |
| 07 | Lecciones de la Adopción Temprana | Historias de implementación en el mundo real | Guía |
| 08 | Mejores Prácticas para MCP | Rendimiento, tolerancia a fallos, resiliencia | Guía |
| 09 | Estudios de Caso MCP | Ejemplos prácticos de implementación | Guía |
| 10 | Taller Práctico | Construcción de un servidor MCP con AI Toolkit | Laboratorio |
| Módulo 11: Laboratorio Práctico Servidor MCP | |||
| 11 | Integración de Base de Datos en Servidor MCP | Ruta completa de aprendizaje práctico con 13 laboratorios para integración PostgreSQL | Laboratorios |
| 11.1 | Introducción | Visión general de MCP con integración de base de datos y caso de uso en analítica retail | Lab 00 |
| 11.2 | Arquitectura Central | Entendiendo arquitectura del servidor MCP, capas de base de datos y patrones de seguridad | Lab 01 |
| 11.3 | Seguridad y Multiinquilino | Seguridad a nivel de fila, autenticación y acceso multi-inquilino a datos | Lab 02 |
| 11.4 | Configuración del Entorno | Configuración del entorno de desarrollo, Docker, recursos Azure | Lab 03 |
| 11.5 | Diseño de Base de Datos | Configuración PostgreSQL, diseño esquema retail y datos de muestra | Lab 04 |
| 11.6 | Implementación del Servidor MCP | Construcción del servidor FastMCP con integración base de datos | Lab 05 |
| 11.7 | Desarrollo de Herramientas | Creación de herramientas de consulta y análisis de esquema | Lab 06 |
| 11.8 | Búsqueda Semántica | Implementación de embeddings vectoriales con Azure OpenAI y pgvector | Lab 07 |
| 11.9 | Pruebas y Depuración | Estrategias de prueba, herramientas de depuración y enfoques de validación | Lab 08 |
| 11.10 | Integración VS Code | Configuración de integración MCP en VS Code y uso de AI Chat | Lab 09 |
| 11.11 | Estrategias de Despliegue | Despliegue con Docker, Azure Container Apps, y consideraciones de escalado | Lab 10 |
| 11.12 | Monitoreo | Application Insights, logging, monitoreo de rendimiento | Lab 11 |
| 11.13 | Mejores Prácticas | Optimización de rendimiento, endurecimiento de seguridad y consejos para producción | Lab 12 |
Una de las partes más emocionantes de aprender MCP es ver cómo tus habilidades de código se desarrollan progresivamente. Diseñamos nuestros ejemplos de código para comenzar simples y volverse más sofisticados a medida que profundizas en el entendimiento. Así es como presentamos los conceptos: con código fácil de entender pero que demuestra principios reales MCP, entenderás no solo qué hace este código, sino por qué está estructurado así y cómo encaja en aplicaciones MCP más grandes.
| Lenguaje | Descripción | Enlace |
|---|---|---|
| C# | Ejemplo de Servidor MCP | Ver Código |
| Java | Calculadora MCP | Ver Código |
| JavaScript | Demo MCP | Ver Código |
| Python | Servidor MCP | Ver Código |
| TypeScript | Ejemplo MCP | Ver Código |
| Rust | Ejemplo MCP | Ver Código |
| Lenguaje | Descripción | Enlace |
|---|---|---|
| C# | Ejemplo Avanzado | Ver Código |
| Java con Spring | Ejemplo Container App | Ver Código |
| JavaScript | Ejemplo Avanzado | Ver Código |
| Python | Implementación Compleja | Ver Código |
| TypeScript | Ejemplo de contenedor | Ver código |
Para aprovechar al máximo este plan de estudios, debes tener:
-
Conocimientos básicos de programación en al menos uno de los siguientes lenguajes: C#, Java, JavaScript, Python o TypeScript
-
Comprensión del modelo cliente-servidor y APIs
-
Familiaridad con conceptos REST y HTTP
-
(Opcional) Conocimientos básicos en conceptos de IA/ML
-
Participar en nuestras discusiones comunitarias para apoyo
Este repositorio incluye varios recursos para ayudarte a navegar y aprender eficazmente:
Hay disponible una Guía de estudio completa para ayudarte a navegar este repositorio eficazmente. Este mapa curricular visual muestra cómo se conectan todos los temas y ofrece orientación sobre cómo usar los proyectos de ejemplo de forma efectiva. Es especialmente útil si eres un aprendiz visual que prefiere ver el panorama completo.
La guía incluye:
- Un mapa curricular visual que muestra todos los temas cubiertos
- Desglose detallado de cada sección del repositorio
- Orientación sobre cómo utilizar los proyectos de ejemplo
- Rutas de aprendizaje recomendadas para diferentes niveles de habilidad
- Recursos adicionales que complementan tu camino de aprendizaje
Mantenemos un detallado Registro de cambios que rastrea todas las actualizaciones significativas de los materiales del plan de estudios, para que puedas estar al día con las últimas mejoras y adiciones.
- Nuevas incorporaciones de contenido
- Cambios estructurales
- Mejoras de características
- Actualizaciones de la documentación
Cada lección en esta guía incluye:
- Explicaciones claras de los conceptos MCP
- Ejemplos de código en vivo en varios lenguajes
- Ejercicios para construir aplicaciones reales de MCP
- Recursos adicionales para estudiantes avanzados
Aprendamos sobre el Protocolo de Contexto de Modelo (MCP), un marco de última generación diseñado para estandarizar las interacciones entre modelos de IA y aplicaciones cliente. A través de esta sesión para principiantes, te introduciremos al MCP y te guiaremos para crear tu primer servidor MCP.
JavaScript: https://aka.ms/letslearnmcp-javascript
¡Felicidades! Acabas de dar el primer paso en un emocionante viaje que ampliará tus capacidades de programación y te conectará con la vanguardia del desarrollo de IA.
Al leer esta introducción, ya has comenzado a construir tu base de conocimiento sobre MCP. Entiendes qué es MCP, por qué es importante y cómo este plan de estudios apoyará tu camino de aprendizaje. Eso es un logro significativo y el comienzo de tu experiencia en esta importante tecnología.
A medida que avances por los módulos, recuerda que todo experto fue alguna vez un principiante. Los conceptos que ahora te parecen complejos se volverán naturales a medida que los practiques y apliques. Cada pequeño paso construye habilidades poderosas que te servirán a lo largo de tu carrera de desarrollo.
Te unes a una comunidad de aprendices y expertos apasionados por MCP y con ganas de ayudar a otros a tener éxito. Ya sea que te atasques en un desafío de programación o estés emocionado por compartir un avance, la comunidad está aquí para apoyar tu viaje.
Si te quedas atascado o tienes preguntas sobre cómo construir aplicaciones de IA, únete a compañeros aprendices y desarrolladores experimentados en discusiones sobre MCP. Es una comunidad solidaria donde las preguntas son bienvenidas y el conocimiento se comparte libremente.
Si tienes comentarios sobre el producto o errores al construir, visita:
Tu aventura MCP comienza ahora. Empieza con el Módulo 0 para sumergirte en tus primeras experiencias prácticas de MCP, o explora los proyectos de ejemplo para ver qué construirás. Recuerda: todo experto empezó exactamente donde estás ahora, y con paciencia y práctica, te sorprenderás de lo que puedes lograr.
¡Bienvenido al mundo del desarrollo con el Protocolo de Contexto de Modelo! ¡Construyamos algo increíble juntos!
Este plan de estudios se fortalece con las contribuciones de aprendices como tú. Ya sea corrigiendo un error tipográfico, sugiriendo una explicación más clara o añadiendo un nuevo ejemplo, tus contribuciones ayudan a otros principiantes a tener éxito.
Gracias al Microsoft Valued Professional Shivam Goyal por contribuir con ejemplos de código.
El proceso de contribución está diseñado para ser acogedor y de apoyo. La mayoría de contribuciones requieren un Acuerdo de Licencia de Contribuyente (CLA), pero las herramientas automatizadas te guiarán suavemente a través del proceso.
Todo este plan de estudios está disponible bajo la LICENSE MIT, lo que significa que puedes usarlo, modificarlo y compartirlo libremente. Esto apoya nuestra misión de hacer accesible el conocimiento MCP para desarrolladores en todo el mundo.
Este proyecto da la bienvenida a contribuciones y sugerencias. La mayoría de contribuciones requieren que aceptes un Acuerdo de Licencia de Contribuyente (CLA) declarando que tienes el derecho, y realmente lo haces, para concedernos los derechos de usar tu contribución. Para más detalles, visita https://cla.opensource.microsoft.com.
Cuando envíes una solicitud de extracción, un bot CLA determinará automáticamente si necesitas proporcionar un CLA y decorará la PR apropiadamente (por ejemplo, verificación de estado, comentario). Simplemente sigue las instrucciones proporcionadas por el bot. Solo necesitarás hacer esto una vez en todos los repositorios que usan nuestro CLA.
Este proyecto ha adoptado el Código de Conducta de Código Abierto de Microsoft. Para más información, consulta las Preguntas frecuentes sobre el Código de Conducta o contacta a opencode@microsoft.com con cualquier pregunta o comentario adicional.
¿Listo para comenzar tu aventura MCP? Empieza con Módulo 00 - Introducción a MCP y da tus primeros pasos en el mundo del desarrollo con el Protocolo de Contexto de Modelo.
¡Nuestro equipo produce otros cursos! Echa un vistazo:
-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA){kind=icon}
-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC){kind=icon}
-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9){kind=icon}
Aviso legal:
Este documento ha sido traducido utilizando el servicio de traducción automática Co-op Translator. Aunque nos esforzamos por la precisión, tenga en cuenta que las traducciones automáticas pueden contener errores o inexactitudes. El documento original en su idioma nativo debe considerarse la fuente autorizada. Para información crítica, se recomienda traducción profesional humana. No nos hacemos responsables de ningún malentendido o interpretación errónea derivada del uso de esta traducción.