Documentation Microsoft

Skill de recherche pour l'écosystème de technologie Microsoft. Couvre learn.microsoft.com et la documentation qui existe en dehors (VS Code, GitHub, Aspire, repos Agent Framework).

Par défaut : Microsoft Learn MCP

Utilisez ces outils pour tout sur learn.microsoft.com — Azure, .NET, M365, Power Platform, Agent Framework, Semantic Kernel, Windows, et plus. C'est l'outil principal pour la grande majorité des requêtes de documentation Microsoft.

Outil	Objectif
`microsoft_docs_search`	Rechercher sur learn.microsoft.com — concepts, guides, tutoriels, configuration
`microsoft_code_sample_search`	Trouver des extraits de code fonctionnels depuis la documentation Learn. Passez `language` (`python`, `csharp`, etc.) pour de meilleurs résultats
`microsoft_docs_fetch`	Obtenir le contenu complet d'une page à partir d'une URL spécifique (quand les extraits de recherche ne suffisent pas)

Utilisez microsoft_docs_fetch après une recherche quand vous avez besoin de tutoriels complets, de toutes les options de configuration, ou quand les extraits de recherche sont tronqués.

Alternative CLI

Si le serveur Learn MCP n'est pas disponible, utilisez plutôt la CLI mslearn depuis votre terminal ou shell (par exemple, Bash, PowerShell, ou cmd) :

# Exécuter directement (aucune installation nécessaire)
npx @microsoft/learn-cli search "BlobClient UploadAsync Azure.Storage.Blobs"

# Ou installer globalement, puis exécuter
npm install -g @microsoft/learn-cli
mslearn search "BlobClient UploadAsync Azure.Storage.Blobs"

Outil MCP	Commande CLI
`microsoft_docs_search(query: "...")`	`mslearn search "..."`
`microsoft_code_sample_search(query: "...", language: "...")`	`mslearn code-search "..." --language ...`
`microsoft_docs_fetch(url: "...")`	`mslearn fetch "..."`

Passez --json à search ou code-search pour obtenir la sortie JSON brute en vue d'un traitement ultérieur.

Exceptions : Quand utiliser d'autres outils

Les catégories suivantes se trouvent en dehors de learn.microsoft.com. Utilisez l'outil spécifié à la place.

.NET Aspire — Utilisez Aspire MCP Server (préféré) ou Context7

La documentation Aspire se trouve sur aspire.dev, pas sur Learn. Le meilleur outil dépend de votre version d'Aspire CLI :

CLI 13.2+ (recommandé) — Le serveur Aspire MCP inclut des outils de recherche de documentation intégrés :

Outil MCP	Description
`list_docs`	Liste toute la documentation disponible depuis aspire.dev
`search_docs`	Recherche lexicale pondérée dans le contenu d'aspire.dev
`get_doc`	Récupère un document spécifique par slug

Ceux-ci sont fournis dans Aspire CLI 13.2 (PR #14028). Pour mettre à jour : aspire update --self --channel daily. Réf. : https://davidpine.dev/posts/aspire-docs-mcp-tools/

CLI 13.1 — Le serveur MCP fournit une recherche d'intégration (list_integrations, get_integration_docs) mais pas de recherche de documentation. Utilisez Context7 comme secours :

ID de bibliothèque	À utiliser pour
`/microsoft/aspire.dev`	Principal — guides, intégrations, référence CLI, déploiement
`/dotnet/aspire`	Source du runtime — détails API, implémentation interne
`/communitytoolkit/aspire`	Intégrations communautaires — Go, Java, Node.js, Ollama

VS Code — Utilisez Context7

La documentation VS Code se trouve sur code.visualstudio.com, pas sur Learn.

ID de bibliothèque	À utiliser pour
`/websites/code_visualstudio`	Documentation utilisateur — paramètres, fonctionnalités, débogage, dev à distance
`/websites/code_visualstudio_api`	Extension API — webviews, TreeViews, commandes, points de contribution

GitHub — Utilisez Context7

La documentation GitHub se trouve sur docs.github.com et cli.github.com.

ID de bibliothèque	À utiliser pour
`/websites/github_en`	Actions, API, repos, sécurité, admin, Copilot
`/websites/cli_github`	Commandes et drapeaux GitHub CLI (`gh`)

Agent Framework — Utilisez Learn MCP + Context7

Les tutoriels Agent Framework se trouvent sur learn.microsoft.com (utilisez microsoft_docs_search), mais le repo GitHub contient des détails au niveau API qui sont souvent en avance sur la documentation publiée — particulièrement la référence API REST DevUI, les options CLI, et l'intégration .NET.

ID de bibliothèque	À utiliser pour
`/websites/learn_microsoft_en-us_agent-framework`	Tutoriels — guides DevUI, traçage, orchestration de workflow
`/microsoft/agent-framework`	Détail API — points de terminaison REST DevUI, drapeaux CLI, auth, .NET `AddDevUI`/`MapDevUI`

Conseil DevUI : Interrogez la source du site Learn pour les guides pratiques, puis la source du repo pour les spécificités au niveau API (schémas d'endpoints, configuration proxy, tokens d'authentification).

Configuration de Context7

Pour toute requête Context7, résolvez d'abord l'ID de la bibliothèque (une fois par session) :

Appelez mcp_context7_resolve-library-id avec le nom de la technologie
Appelez mcp_context7_query-docs avec l'ID de bibliothèque retourné et une requête spécifique

Rédiger des requêtes efficaces

Soyez spécifique — incluez la version, l'intention et le langage :

# ❌ Trop large
"Azure Functions"
"agent framework"

# ✅ Spécifique
"Azure Functions Python v2 programming model"
"Cosmos DB partition key design best practices"
"GitHub Actions workflow_dispatch inputs matrix strategy"
"Aspire AddUvicornApp Python FastAPI integration"
"DevUI serve agents tracing OpenTelemetry directory discovery"
"Agent Framework workflow conditional edges branching handoff"

Incluez du contexte :

Version quand pertinent (.NET 8, Aspire 13, VS Code 1.96)
Intention de la tâche (quickstart, tutorial, overview, limits, API reference)
Langage pour les docs polyglotiques (Python, TypeScript, C#)

microsoft-docs