Microsoft Docs

Исследовательский скилл для экосистемы технологий Microsoft. Покрывает learn.microsoft.com и документацию вне его (VS Code, GitHub, Aspire, репозитории Agent Framework).

По умолчанию: Microsoft Learn MCP

Используйте эти инструменты для всего на learn.microsoft.com — Azure, .NET, M365, Power Platform, Agent Framework, Semantic Kernel, Windows и др. Это основной инструмент для подавляющего большинства запросов к документации Microsoft.

Инструмент	Назначение
microsoft_docs_search	Поиск по learn.microsoft.com — концепции, руководства, туториалы, конфигурация
microsoft_code_sample_search	Найти рабочие фрагменты кода из доков Learn. Передавайте language (python, csharp и т.д.) для лучших результатов
microsoft_docs_fetch	Получить полное содержимое страницы по URL (когда выдержек поиска недостаточно)

Используйте microsoft_docs_fetch после поиска, когда нужны полные туториалы, все опции конфигурации или когда выдержки поиска обрезаны.

Альтернатива CLI

Если MCP-сервер Learn недоступен, используйте CLI mslearn из терминала (Bash, PowerShell, cmd):

# Run directly (no install needed)
npx @microsoft/learn-cli search "BlobClient UploadAsync Azure.Storage.Blobs"

# Or install globally, then run
npm install -g @microsoft/learn-cli
mslearn search "BlobClient UploadAsync Azure.Storage.Blobs"

MCP-инструмент	Команда CLI
microsoft_docs_search(query: "...")	mslearn search "..."
microsoft_code_sample_search(query: "...", language: "...")	mslearn code-search "..." --language ...
microsoft_docs_fetch(url: "...")	mslearn fetch "..."

Передайте --json в search или code-search для сырого JSON-вывода.

Исключения: когда использовать другие инструменты

Следующие категории живут вне learn.microsoft.com. Используйте указанный инструмент.

.NET Aspire — Aspire MCP Server (предпочтительно) или Context7

Доки Aspire живут на aspire.dev, не на Learn. Лучший инструмент зависит от версии Aspire CLI.

CLI 13.2+ (рекомендуется) — MCP-сервер Aspire содержит встроенные инструменты поиска доков:

MCP-инструмент	Описание
list_docs	Список всей доступной документации с aspire.dev
search_docs	Взвешенный лексический поиск по контенту aspire.dev
get_doc	Получить конкретный документ по slug

Они входят в Aspire CLI 13.2 (PR #14028). Обновление: aspire update --self --channel daily. Ref: https://davidpine.dev/posts/aspire-docs-mcp-tools/

CLI 13.1 — MCP-сервер даёт поиск интеграций (list_integrations, get_integration_docs), но не поиск доков. Откат на Context7:

Library ID	Для чего
/microsoft/aspire.dev	Основной — руководства, интеграции, справочник CLI, развёртывание
/dotnet/aspire	Исходники рантайма — внутренности API, детали реализации
/communitytoolkit/aspire	Интеграции сообщества — Go, Java, Node.js, Ollama

VS Code — Context7

Доки VS Code живут на code.visualstudio.com, не на Learn.

Library ID	Для чего
/websites/code_visualstudio	Пользовательские доки — настройки, функции, отладка, удалённая разработка
/websites/code_visualstudio_api	API расширений — webviews, TreeViews, команды, contribution points

GitHub — Context7

Доки GitHub живут на docs.github.com и cli.github.com.

Library ID	Для чего
/websites/github_en	Actions, API, репозитории, безопасность, админ, Copilot
/websites/cli_github	Команды и флаги GitHub CLI (gh)

Agent Framework — Learn MCP + Context7

Туториалы Agent Framework — на learn.microsoft.com (используйте microsoft_docs_search), но репозиторий GitHub содержит детали уровня API, часто опережающие опубликованные доки — особенно справочник DevUI REST API, опции CLI и интеграцию с .NET.

Library ID	Для чего
/websites/learn_microsoft_en-us_agent-framework	Туториалы — руководства DevUI, трассировка, оркестрация воркфлоу
/microsoft/agent-framework	Детали API — REST-эндпойнты DevUI, флаги CLI, auth, .NET AddDevUI/MapDevUI

Совет по DevUI: запрашивайте источник сайта Learn для how-to, затем источник репозитория для специфики уровня API (схемы эндпойнтов, конфиг прокси, токены auth).

Настройка Context7

Для любого запроса Context7 сначала разрешите library ID (один раз за сессию): 1) вызовите mcp_context7_resolve-library-id с именем технологии; 2) вызовите mcp_context7_query-docs с полученным library ID и конкретным запросом.

Эффективные запросы

Будьте конкретны — указывайте версию, намерение и язык:

# ❌ Слишком широко
"Azure Functions"
"agent framework"

# ✅ Конкретно
"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"

Включайте контекст: версию, когда релевантно (.NET 8, Aspire 13, VS Code 1.96); намерение задачи (quickstart, tutorial, overview, limits, API reference); язык для полиглот-доков (Python, TypeScript, C#).