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.9k

Prueba este MCPPatrocinado

Servidor MCP alojado

npx add-mcp 'https://learn.microsoft.com/api/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

🌟 Servidor MCP de Microsoft Learn

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 con un clic. No se necesita clave.

🎯 ¿Por qué instalar esto?

Deja de depender de datos de entrenamiento desactualizados o búsquedas web riesgosas. El servidor MCP de Learn 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). Sin claves de API, sin inicios de sesión, sin registros. Solo instalación con un clic y comienza a codificar de inmediato.
🛡️ 100% confiable y seguro. Protege tu cadena de suministro. A diferencia de las búsquedas web genéricas que pueden extraer contenido de blogs inseguros o sitios maliciosos, esta herramienta solo accede a documentación oficial de Microsoft de primera parte.
💸 Completamente gratis. Alta capacidad de búsqueda diseñada para sesiones de codificació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 evaluación de daños usando el SDK de evaluación de Azure AI Foundry."

🌐 El endpoint 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 endpoint MCP remoto:

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

Nota: Esta URL está diseñada para 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 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 resiliente 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 funciones experimentales, consulta la sección Funciones experimentales a continuación.

🧪 Funciones experimentales

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

Endpoint compatible con OpenAI

Para aplicaciones que requieran compatibilidad con los modelos OpenAI Deep Research, puedes usar el endpoint compatible con OpenAI:

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

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

Control del presupuesto de tokens

Para gestionar el uso de tokens y controlar costos, puedes agregar el parámetro de consulta maxTokenBudget a la URL del endpoint MCP. Este parámetro limita el recuento de tokens en las respuestas de la herramienta de búsqueda al truncar el contenido para cumplir con tu presupuesto especificado.

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

Nota: Estas funciones experimentales están sujetas a cambios. Agradecemos tus comentarios a través de nuestros Debates de GitHub.

🛠️ Herramientas actualmente compatibles

Nombre de la herramienta	Descripción	Parámetros de entrada
`microsoft_docs_search`	Realiza búsqueda semántica en la documentación técnica oficial de Microsoft	`query` (cadena): La consulta de búsqueda para la recuperación
`microsoft_docs_fetch`	Obtiene y convierte una página de documentación de Microsoft a formato markdown	`url` (cadena): URL de la página de documentación a leer
`microsoft_code_sample_search`	Busca fragmentos de código y ejemplos oficiales de Microsoft/Azure	`query` (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

El paquete @microsoft/learn-cli te brinda 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"

Instalar el paquete npm por sí solo no instala la detección de agentes. La CLI puede instalar una habilidad de tipo CLI-first para los mismos ecosistemas compatibles con los plugins de este repositorio: GitHub Copilot, Claude Code y Codex.

# User profile (default)
mslearn setup --cli

# Current repository
mslearn setup --cli --project

# Override auto-detection with explicit targets
mslearn setup --cli --copilot
mslearn setup --cli --claude
mslearn setup --cli --codex
mslearn setup --cli --copilot --project
mslearn setup --cli --claude --project
mslearn setup --cli --codex --project

# Multiple agents
mslearn setup --cli --copilot --claude --codex

Elimina solo el contenido de descubrimiento administrado con:

mslearn remove --cli
mslearn remove --cli --copilot
mslearn remove --cli --claude --codex --project

Agente	Ámbito de usuario	Ámbito de proyecto
GitHub Copilot	`~/.copilot/skills/`	`.github/skills/`
Claude Code	`~/.claude/skills/`	`.claude/skills/`
Codex	`~/.agents/skills/`	`.agents/skills/`

Cuando no se especifica un destino, la configuración detecta los agentes instalados a partir de sus directorios de usuario o proyecto conocidos. La eliminación detecta solo agentes con artefactos de descubrimiento administrados por la CLI de Microsoft Learn. Los destinos explícitos (--copilot, --claude o --codex) anulan la detección y se pueden combinar. Este flujo de trabajo no configura MCP ni instala agentes fuera de los ecosistemas de plugins como Cursor. Cuando ambas integraciones están instaladas, los agentes deben preferir las herramientas MCP de Microsoft Learn y usar la habilidad CLI independiente solo como respaldo.

Pasa --json para obtener 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:

Habilidad	Propósito	Mejor para
`microsoft-docs`	Comprender conceptos, tutoriales, arquitectura, límites	"¿Cómo funciona X?", aprendizaje, guías de configuración
`microsoft-code-reference`	Consultas de API, ejemplos de código, verificación, corrección de errores	Implementar código, encontrar métodos correctos, solucionar problemas
`microsoft-skill-creator`	Meta-habilidad que genera habilidades de agente personalizadas para cualquier tecnología de Microsoft	Crear una habilidad para enseñar a los agentes sobre una nueva biblioteca de Azure, función de .NET u otra tecnología de Microsoft

Configuración rápida

Elige la integración que coincida con cómo deseas que el agente recupere contenido de Microsoft Learn:

Modo	Instalación	Comportamiento del agente
CLI independiente (CLI-first)	Instalar/ejecutar `@microsoft/learn-cli`, luego ejecutar `mslearn setup --cli [agent-target]`	Los agentes detectados o seleccionados invocan `npx @microsoft/learn-cli@latest`; MCP no está configurado
Plugin de repositorio, MCP-first	Instalar el plugin del repositorio para GitHub Copilot, Claude Code o Codex	El plugin proporciona el endpoint MCP de Learn y habilidades orientadas a MCP

El plugin del repositorio también admite Claude Code. Ejecuta el siguiente comando y reinicia Claude Code:

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

Para el plugin CLI de GitHub Copilot con MCP-first, ejecuta:

/plugin install microsoftdocs/mcp

De lo contrario:

Instala primero el servidor MCP — Consulta Instalación a continuación
Copia las carpetas de habilidades al directorio .github/skills/ o .claude/skills/ de tu proyecto:
- microsoft-docs — para conceptos, tutoriales y consultas factuales
- microsoft-code-reference — para consultas de API, ejemplos de código y solución de problemas
- microsoft-skill-creator — meta-habilidad para generar habilidades personalizadas sobre tecnologías de Microsoft

Agentes compatibles

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

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

¿Qué habilidad necesito?

Si deseas...	Instala
Cubrir todos los escenarios de documentos de Microsoft	Las 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 Microsoft	Solo `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:

Cliente	Instalación con un clic	Guía de MCP
VS Code	o busque "@mcp learn" en Extensiones para mostrar el MCP "Microsoft Learn"	Guía oficial de MCP para VS Code
GitHub Copilot CLI	`/plugin install microsoftdocs/mcp`
Claude Desktop	Siga 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 Studio	Actualice a la última versión de VS 2022 o 2026; el MCP "Microsoft Learn" ya está integrado	Guía oficial de MCP para Visual Studio
Cursor IDE		Guía oficial de MCP para Cursor
Codex	`codex mcp add "microsoft-learn" --url "https://learn.microsoft.com/api/mcp"`	Documentación de MCP para Codex
Roo Code	Abra Marketplace de Roo Code, busque `Microsoft Learn` y haga clic en `Install`	Guía oficial de MCP para Roo Code
Cline	Se requiere configuración manual Use `"type": "streamableHttp"`	Guía oficial de MCP para Cline
Gemini CLI	Se requiere configuración manual Ver Configuración Nota: Agregue un objeto `mcpServer` al archivo `.gemini/settings.json` { "Microsoft Learn MCP Server": { "httpUrl": "https://learn.microsoft.com/api/mcp" } }	Cómo configurar su servidor MCP
Qwen Code	Se requiere configuración manual Ver Configuración Nota: Agregue un objeto `mcpServer` al archivo `.qwen/settings.json` { "Microsoft Learn MCP Server": { "httpUrl": "https://learn.microsoft.com/api/mcp" } }	Configurar el servidor MCP en settings.json
GitHub	Se requiere configuración manual Ver Configuración Nota: Navegue a Configuración → Agente de codificación { "mslearn": { "type": "http", "url": "https://learn.microsoft.com/api/mcp", "tools": [ "*" ] } }
ChatGPT	Se requiere configuración manual Ver Instrucciones 1. Abra ChatGPT en el navegador 2. Vaya a Configuración → Conectores → Configuración avanzada → Active el modo Desarrollador 3. Vuelva a los conectores y haga clic en crear 4. Asigne un nombre al conector, ingrese la URL `https://learn.microsoft.com/api/mcp`, configure la autenticación en `No authentication` y confíe en la aplicación 5. Haga clic en crear	Guía oficial de ChatGPT
Windsurf	Se 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 su 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 resiliente que no se rompa cuando se actualice el servicio, debe seguir los siguientes principios:

Descubrir Herramientas Dinámicamente: Su cliente debe obtener las definiciones de herramientas actuales del servidor en tiempo de ejecución (por ejemplo, usando tools/list). No codifique de forma fija los nombres de herramientas ni los parámetros.

Actualizar en Caso de Error: Su 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), su cliente debe asumir que su caché está desactualizada y activar automáticamente una actualización llamando a tools/list.

Manejar Actualizaciones en Vivo: Su cliente debe escuchar las notificaciones del servidor (por ejemplo, listChanged) y actualizar su caché de herramientas en consecuencia.

❓ Solución de Problemas

💻 Prompt del Sistema

Incluso los modelos amigables con herramientas como Claude Sonnet 4 a veces no llaman a las herramientas MCP de forma predeterminada; use prompts del sistema para fomentar su uso.

Aquí hay un ejemplo de una regla de Cursor (un prompt del 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

Problema	Posible Solución
Errores de conexión	Verifique su conexión de red y que la URL del servidor esté ingresada correctamente
No se devuelven resultados	Intente reformular su consulta con términos técnicos más específicos
La herramienta no aparece en VS Code	Reinicie VS Code o verifique que la extensión MCP esté instalada correctamente
Estado HTTP 405	El método no permitido ocurre cuando un navegador intenta conectarse al punto de conexión. Intente usar el servidor MCP a través de VS Code GitHub Copilot o MCP Inspector en su lugar.
El servidor MCP 'Microsoft Learn' aparece como no disponible en Visual Studio (Motivo: Eclipsado)	Visual Studio 2022 (17.13+) incluye "Microsoft Learn" como un servidor MCP integrado en un ámbito de mayor prioridad. "Eclipsado" significa que ya existe una definición de mayor prioridad y la entrada duplicada de menor prioridad se suprime. El eclipse se compara con el nombre del servidor, así que elimine cualquier entrada agregada manualmente con el mismo nombre que el servidor integrado (comúnmente `microsoft-learn` o `Microsoft Learn`) de su `~/.mcp.json` o del espacio de trabajo `.mcp.json`. El servidor integrado se activará automáticamente. No se requiere configuración adicional para los usuarios de Visual Studio.