/ Annuaire / Playground / Microsoft Learn MCP
● Officiel MicrosoftDocs ⚡ Instantané

Microsoft Learn MCP

par MicrosoftDocs · MicrosoftDocs/mcp

Le MCP officiel Microsoft Learn — recherchez et récupérez la documentation actuelle Azure / .NET / M365 / Windows et des exemples de code, avec citations.

Microsoft Learn MCP est un endpoint MCP distant hébergé par MicrosoftDocs sur learn.microsoft.com/api/mcp. Il expose des outils de recherche + récupération alimentés par le corpus Microsoft Learn — ce qui signifie que Claude obtient la documentation actuelle, les références API et les exemples de code pour l'ensemble du stack Microsoft avec des citations appropriées. Pas de scraping, pas de snapshots obsolètes.

Pourquoi l'utiliser

Fonctionnalités clés

Démo en direct

Aperçu en pratique

microsoft-learn-mcp.replay ▶ prêt
0/0

Installer

Choisissez votre client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "microsoft-learn-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://learn.microsoft.com/api/mcp"
      ]
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "microsoft-learn-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://learn.microsoft.com/api/mcp"
      ]
    }
  }
}

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "microsoft-learn-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://learn.microsoft.com/api/mcp"
      ]
    }
  }
}

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "microsoft-learn-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://learn.microsoft.com/api/mcp"
      ]
    }
  }
}

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "microsoft-learn-mcp",
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://learn.microsoft.com/api/mcp"
      ]
    }
  ]
}

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json
{
  "context_servers": {
    "microsoft-learn-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "https://learn.microsoft.com/api/mcp"
        ]
      }
    }
  }
}

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

claude mcp add microsoft-learn-mcp -- npx -y mcp-remote https://learn.microsoft.com/api/mcp

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : Microsoft Learn MCP

Implémenter un pattern de ressource Azure depuis la documentation actuelle

👤 Ingénieurs cloud sur Azure ⏱ ~20 min intermediate

Quand l'utiliser : Claude continue d'écrire du Bicep/Terraform avec des noms de propriétés dépréciées ; vous voulez qu'il utilise l'API actuelle.

Déroulement
  1. Rechercher la documentation
    MCP Microsoft Learn : recherche 'Azure Container Apps managed identity'. Récupère la documentation actuelle.✓ Copié
    → La recherche retourne des pages Learn avec des URLs
  2. Récupérer et citer
    Récupère la section sur l'assignation d'une identité user-assigned. Cite le schéma Bicep actuel, sans paraphraser.✓ Copié
    → Extrait Bicep exact avec les noms de propriétés
  3. Appliquer
    Maintenant écris le Bicep pour que mon application conteneur utilise une identité existante id-prod-app. Correspondez au schéma que vous avez cité.✓ Copié
    → Bicep compilant contre l'API Microsoft.App actuelle

Résultat : Bicep qui se déploie proprement du premier coup car le schéma correspond à l'API Azure actuelle.

Pièges
  • La doc remontée par la recherche concerne une ancienne version d'API — Vérifiez toujours que l'URL contient 'latest' ou la bonne api-version
Combiner avec : filesystem · github

Consulter une API .NET sans quitter Claude

👤 Développeurs C# / .NET ⏱ ~10 min beginner

Quand l'utiliser : Vous avez besoin de la signature exacte de System.Threading.Channels.Channel.CreateBounded.

Déroulement
  1. Rechercher
    Microsoft Learn : signature de Channel.CreateBounded dans .NET 9.✓ Copié
    → Page de référence API avec surcharges
  2. Utiliser
    Écris un producer/consumer utilisant BoundedChannelOptions avec capacity 100, FullMode=Wait. Correspondez exactement aux docs.✓ Copié
    → Code correspondant à la surface API actuelle

Résultat : C# correct sans changer de fenêtre pour les docs.

Pièges
  • Mélanger les docs .NET Framework et .NET (Core) — Spécifiez toujours la version ; Learn retourne les deux

Écrire un script PowerShell Microsoft Graph avec citations

👤 Administrateurs M365 ⏱ ~25 min intermediate

Quand l'utiliser : Vous voulez mettre à jour en masse les affectations de licences et avez besoin de la syntaxe de cmdlet Graph actuelle.

Déroulement
  1. Trouver le cmdlet
    Learn : syntaxe actuelle de Set-MgUserLicense dans le SDK PowerShell Microsoft.Graph.✓ Copié
    → Documentation du cmdlet avec les jeux de paramètres
  2. Composer le script
    Écris un script qui lit users.csv (UPN, SkuPartNumber) et assigne la licence. Cite les URLs Learn utilisées.✓ Copié
    → PowerShell fonctionnel avec citations en bloc de commentaires

Résultat : Script auditable avec citations pour la revue.

Pièges
  • Ancienne syntaxe du module AzureAD — AzureAD est déprécié ; insistez sur Microsoft.Graph dans le prompt
Combiner avec : filesystem

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

microsoft-learn-mcp + github

Trouver un pattern Azure actuel dans Learn, puis PR le changement IaC

Learn : récupère Container Apps + identité. GitHub : ouvre une PR mettant à jour mon Bicep.✓ Copié
microsoft-learn-mcp + filesystem

Sauvegarder les extraits cités comme runbook

Récupère la documentation des cmdlets de licence M365 et sauvegarde un runbook sous /runbooks/m365-license.md avec citations.✓ Copié
microsoft-learn-mcp + context7

Comparer les docs Microsoft avec une documentation de bibliothèque plus large

Comparez le pattern recommandé par Microsoft Learn avec ce que context7 indique pour le même SDK.✓ Copié

Outils

Ce que ce MCP expose

OutilEntréesQuand appelerCoût
microsoft_docs_search query: str Première étape gratuit
microsoft_docs_fetch url: str Récupérer une page spécifique gratuit

Coût et limites

Coût d'exécution

Quota d'API
Hébergé par Microsoft ; utilisation équitable raisonnable par IP
Tokens par appel
300–5000
Monétaire
Gratuit
Astuce
Recherchez d'abord, récupérez uniquement les 1–2 URLs les plus pertinentes

Sécurité

Permissions, secrets, portée

Stockage des identifiants : Aucun — docs publiques
Sortie de données : learn.microsoft.com

Dépannage

Erreurs courantes et correctifs

La page de résultat concerne une ancienne version d'API

Ajoutez 'api-version=AAAA-MM' ou la version .NET à la requête

La recherche retourne des pages marketing

Ajoutez 'docs' ou 'reference' à la requête ; filtrez par URL contenant '/dotnet/api/' ou '/azure/'

Connexion mcp-remote refusée

Vérifiez le réseau ; l'endpoint est https://learn.microsoft.com/api/mcp

Vérifier : curl -I https://learn.microsoft.com/api/mcp

Alternatives

Microsoft Learn MCP vs autres

AlternativeQuand l'utiliserCompromis
Context7Vous voulez une couverture de bibliothèques plus large, pas uniquement MicrosoftMoins autoritatif pour les docs spécifiques Microsoft
GitMCPVous voulez la source brute du dépôt plutôt que les docs curatoréesPas de curation ; vous obtenez ce qui est dans le dépôt

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills