Microsoft Learn

Servidor MCP oficial de Microsoft Learn y herramienta CLI, que potencia LLMs y agentes de IA con documentación y ejemplos de código confiables y en tiempo real de Microsoft.

GitHub
1.8k
Prueba este MCPPatrocinado

Documentación

🌟 Servidor MCP de Microsoft Learn

Install in VS Code Install in VS Code Insiders

Detén las alucinaciones de la IA. Dale a tu asistente de IA (Claude, Cursor, Copilot, Codex, ...) acceso directo a la documentación oficial más reciente de Microsoft.

✨ Gratis. Instalación en un clic. Sin necesidad de clave.

🎯 ¿Por qué instalar esto?

Deja de depender de datos de entrenamiento obsoletos o de búsquedas web arriesgadas. El servidor Learn MCP proporciona acceso seguro y directo a los documentos oficiales de Microsoft.

  • 🧠 Elimina las alucinaciones. Evita que tu IA invente métodos inexistentes del SDK de Azure o alucine paquetes de bibliotecas. Obtén código que realmente compile.

  • 🔌 Plug & Play (sin autenticación). No se requieren claves de API, inicios de sesión ni registros. Solo instala con un clic y comienza a programar de inmediato.

  • 🛡️ 100% confiable y seguro. Protege tu cadena de suministro. A diferencia de las búsquedas web genéricas que pueden extraer blogs inseguros o sitios maliciosos, esta herramienta solo accede a la documentación oficial de Microsoft de primera parte.

  • 💸 Completamente gratis. Alta capacidad de búsqueda diseñada para sesiones de programación intensivas y fluidas.

✨ Ejemplos de indicaciones

"Dame los comandos de la CLI de Azure para crear una Azure Container App con identidad administrada."

"¿Está disponible gpt-5.4 en las regiones de Azure de la UE?"

"¿Estás seguro de que esta es la forma correcta de implementar IHttpClientFactory en una API mínima de .NET 8?"

"Muéstrame código Python ejecutable para realizar una evaluación de daños usando el SDK de evaluación de Azure AI Foundry."

🌐 El punto de conexión del servidor MCP de Microsoft Learn

El servidor MCP de Microsoft Learn es accesible para cualquier IDE, agente o herramienta que admita el Protocolo de Contexto de Modelo (MCP). Cualquier cliente compatible puede conectarse al siguiente punto de conexión MCP remoto:

https://learn.microsoft.com/api/mcp

Nota: Esta URL está destinada a usarse dentro de un cliente MCP compatible mediante HTTP Streamable, como los clientes recomendados que se enumeran en nuestra sección Primeros pasos. No admite acceso directo desde un navegador web y puede devolver un error 405 Method Not Allowed si se accede manualmente. Para los desarrolladores que necesiten crear su propia solución, sigan las pautas obligatorias en la sección Creación de un cliente personalizado para garantizar que su implementación sea resistente y compatible.

Configuración estándar funciona en la mayoría de los clientes:

{
  "servers": {
    "microsoft-learn": {
      "type": "http",
      "url": "https://learn.microsoft.com/api/mcp"
    }
  }
}

Para características experimentales, consulta la sección Características experimentales a continuación.

🧪 Características experimentales

El servidor MCP de Microsoft Learn ofrece características experimentales que están en desarrollo activo. Estas características pueden cambiar o refinarse según los comentarios de los usuarios y los patrones de uso.

Punto de conexión compatible con OpenAI

Para aplicaciones que requieren compatibilidad con los modelos OpenAI Deep Research, puedes usar el punto de conexión compatible con OpenAI:

https://learn.microsoft.com/api/mcp/openai-compatible

Este punto de conexión admite modelos OpenAI Deep Research y sigue la especificación MCP de OpenAI.

Control del presupuesto de tokens

Para administrar el uso de tokens y controlar los costos, puedes agregar el parámetro de consulta maxTokenBudget a la URL del punto de conexión MCP. Este parámetro limita el recuento de tokens en las respuestas de la herramienta de búsqueda truncando el contenido para cumplir con tu presupuesto especificado.

https://learn.microsoft.com/api/mcp?maxTokenBudget=2000

Nota: Estas características experimentales están sujetas a cambios. Agradecemos los comentarios a través de nuestros Debates de GitHub.

🛠️ Herramientas actualmente compatibles

Nombre de la herramientaDescripciónParámetros de entrada
microsoft_docs_searchRealiza búsqueda semántica en la documentación técnica oficial de Microsoftquery (cadena): La consulta de búsqueda para la recuperación
microsoft_docs_fetchObtiene y convierte una página de documentación de Microsoft a formato markdownurl (cadena): URL de la página de documentación a leer
microsoft_code_sample_searchBusca fragmentos de código y ejemplos oficiales de Microsoft/Azurequery (cadena): Consulta de búsqueda para fragmentos de código de Microsoft/Azure
language (cadena, opcional): Filtro de lenguaje de programación.

💻 CLI de Microsoft Learn preview

npm version

El paquete @microsoft/learn-cli te da acceso desde la terminal a las mismas herramientas — buscar documentos, obtener páginas y encontrar ejemplos de código — sin un cliente MCP.

# Run instantly (no install)
npx @microsoft/learn-cli search "azure functions timeout"

# Or install globally
npm install -g @microsoft/learn-cli
# then use `mslearn`
mslearn search "azure functions timeout"

Pasa --json para obtener una salida JSON estructurada, útil para procesamiento programático:

mslearn search "azure openai" --json | jq '.results[].title'

Consulta cli/README.md para la referencia completa de comandos.

🤖 Habilidades de agente

Las Habilidades de agente son paquetes de instrucciones portátiles que ayudan a los agentes de IA a usar las herramientas de manera más efectiva. Proporcionamos tres habilidades que guían a los agentes sobre cuándo y cómo usar las herramientas MCP de Microsoft Learn:

HabilidadPropósitoMejor para
microsoft-docsComprender conceptos, tutoriales, arquitectura, límites"¿Cómo funciona X?", aprendizaje, guías de configuración
microsoft-code-referenceBúsquedas de API, ejemplos de código, verificación, corrección de erroresImplementar código, encontrar métodos correctos, solucionar problemas
microsoft-skill-creatorMeta-habilidad que genera habilidades de agente personalizadas para cualquier tecnología de MicrosoftCrear una habilidad para enseñar a los agentes sobre una nueva biblioteca de Azure, característica de .NET u otra tecnología de Microsoft

Configuración rápida

Estas habilidades de agente están empaquetadas en un complemento microsoft-docs junto con el propio servidor Learn MCP. Si usas Claude Code, ejecuta el siguiente comando y reinicia Claude Code:

/plugin install microsoft-docs@claude-plugins-official

O si usas GitHub Copilot CLI, ejecuta este comando:

/plugin install microsoftdocs/mcp

De lo contrario:

  1. Instala primero el servidor MCP — Consulta Instalación a continuación
  2. Copia las carpetas de habilidades al directorio .github/skills/ o .claude/skills/ de tu proyecto:

Agentes compatibles

Las habilidades de agente funcionan en múltiples agentes de IA:

  • VS Code (Insiders) — habilita la configuración chat.useAgentSkills
  • GitHub Copilot CLI y agente de codificación de Copilot
  • Claude Code, Cursor, OpenAI Codex y más

¿Qué habilidad necesito?

Si quieres...Instala
Cubrir todos los escenarios de documentos de MicrosoftLas tres habilidades
Enfocarte en codificación (APIs, ejemplos, errores)Solo microsoft-code-reference
Enfocarte en hechos y conceptos (límites, configuración, tutoriales)Solo microsoft-docs
Generar una habilidad personalizada para una tecnología específica de MicrosoftSolo microsoft-skill-creator

🔌 Instalación y primeros pasos

El servidor MCP de Microsoft Learn admite instalación rápida en múltiples entornos de desarrollo. Elige tu cliente preferido a continuación para una configuración simplificada:

ClienteInstalación en un clicGuía de MCP
VS CodeInstall in VS Code
o busca "@mcp learn" en Extensiones para mostrar "Microsoft Learn" MCP		Guía oficial de MCP para VS Code
GitHub Copilot CLI/plugin install microsoftdocs/mcp
Claude DesktopSigue las instrucciones de "Agregar conector personalizado" en la guía oficial.Guía de MCP remoto para Claude Desktop
Claude Code/plugin install microsoft-docs@claude-plugins-official (incluye servidor MCP + habilidades)Guía de MCP remoto para Claude Code
Visual StudioActualiza a la última versión de VS 2022 o 2026, "Microsoft Learn" MCP ya está integradoGuía oficial de MCP para Visual Studio
Cursor IDEInstall in CursorGuía oficial de MCP para Cursor
Codexcodex mcp add "microsoft-learn" --url "https://learn.microsoft.com/api/mcp"Documentación de MCP para Codex
Roo CodeAbre Roo Code Marketplace, busca Microsoft Learn y haz clic en InstallGuía oficial de MCP para Roo Code
ClineSe requiere configuración manual
Usa "type": "streamableHttp"		Guía oficial de MCP para Cline
Gemini CLISe requiere configuración manual
Ver configuraciónNota: Agrega un objeto mcpServer al archivo .gemini/settings.json
{
  "Microsoft Learn MCP Server": {
     "httpUrl": "https://learn.microsoft.com/api/mcp" 
   }
}
Cómo configurar tu servidor MCP
Qwen CodeSe requiere configuración manual
Ver configuraciónNota: Agrega un objeto mcpServer al archivo .qwen/settings.json
{
  "Microsoft Learn MCP Server": {
     "httpUrl": "https://learn.microsoft.com/api/mcp" 
   }
}
Configura el servidor MCP en settings.json
GitHubSe requiere configuración manual
Ver configuraciónNota: Navega a Configuración → Agente de codificación
{
  "mslearn": {
    "type": "http",
    "url": "https://learn.microsoft.com/api/mcp",
    "tools": [
      "*"
    ]
  }
}
ChatGPTSe requiere configuración manual
Ver instrucciones1. Abre ChatGPT en el navegador
2. Ve a Configuración → Conectores → Configuración avanzada → Activa el modo desarrollador
3. Vuelve a los conectores y haz clic en crear
4. Dale al conector un nombre, ingresa la URL https://learn.microsoft.com/api/mcp, establece la autenticación en No authentication y confía en la aplicación
5. Haz clic en crear
Guía oficial de ChatGPT
WindsurfSe requiere configuración manual
Ver configuración
{
  "mcpServers": {
    "microsoft-learn": {
      "serverUrl": "https://learn.microsoft.com/api/mcp"
    }
  }
}
Guía de MCP para Windsurf
Kiro
Ver configuración
{
  "microsoft-learn": {
    "url": "https://learn.microsoft.com/api/mcp"
    }
}
Guía de MCP para Kiro

⚠️ Creación de un cliente personalizado

Si tu caso de uso requiere una integración directa y programática, es esencial comprender que MCP es un protocolo dinámico, no una API estática. Las herramientas disponibles y sus esquemas evolucionarán.

Para crear un cliente resistente que no se rompa cuando se actualice el servicio, debes seguir los siguientes principios:

  1. Descubre herramientas dinámicamente: Tu cliente debe obtener las definiciones de herramientas actuales del servidor en tiempo de ejecución (por ejemplo, usando tools/list). No codifiques de forma fija los nombres de herramientas o parámetros.
  2. Actualiza en caso de error: Tu cliente debe manejar errores durante las llamadas a tool/invoke. Si una llamada a una herramienta falla con un error que indica que falta o que su esquema ha cambiado (por ejemplo, un error HTTP 404 o 400), tu cliente debe asumir que su caché está obsoleta y activar automáticamente una actualización llamando a tools/list.
  3. Maneja actualizaciones en vivo: Tu cliente debe escuchar las notificaciones del servidor (por ejemplo, listChanged) y actualizar su caché de herramientas en consecuencia.

❓ Solución de problemas

💻 Indicación del sistema

Incluso los modelos amigables con herramientas como Claude Sonnet 4 a veces no llaman a las herramientas MCP de forma predeterminada; usa indicaciones del sistema para fomentar su uso. Aquí hay un ejemplo de una regla de Cursor (un prompt de sistema) que hará que el LLM utilice microsoft-learn con más frecuencia:

## Querying Microsoft Documentation

You have access to MCP tools called `microsoft_docs_search`, `microsoft_docs_fetch`, and `microsoft_code_sample_search` - these tools allow you to search through and fetch Microsoft's latest official documentation and code samples, and that information might be more detailed or newer than what's in your training data set.

When handling questions around how to work with native Microsoft technologies, such as C#, F#, ASP.NET Core, Microsoft.Extensions, NuGet, Entity Framework, the `dotnet` runtime - please use these tools for research purposes when dealing with specific / narrowly defined questions that may occur.

⚠️ Problemas Comunes

ProblemaPosible Solución
Errores de conexiónVerifique su conexión de red y que la URL del servidor esté ingresada correctamente
No se devolvieron resultadosIntente reformular su consulta con términos técnicos más específicos
La herramienta no aparece en VS CodeReinicie VS Code o verifique que la extensión MCP esté instalada correctamente
Estado HTTP 405El método no permitido ocurre cuando un navegador intenta conectarse al endpoint. Intente usar el servidor MCP a través de VS Code GitHub Copilot o MCP Inspector en su lugar.

🆘 Obtener Soporte

📚 Recursos Adicionales