/ Каталог / Песочница / Microsoft Learn MCP
● Официальный MicrosoftDocs ⚡ Сразу

Microsoft Learn MCP

автор MicrosoftDocs · MicrosoftDocs/mcp

Официальный Microsoft Learn MCP — поиск и получение актуальной документации Azure / .NET / M365 / Windows и примеров кода с цитированием источников.

Microsoft Learn MCP — это remote MCP endpoint, размещённый MicrosoftDocs по адресу learn.microsoft.com/api/mcp. Предоставляет инструменты поиска и получения данных, основанные на корпусе Microsoft Learn, — то есть Claude получает актуальную документацию, справочник API и примеры кода для всего стека Microsoft с правильным цитированием источников. Без парсинга, без устаревших снапшотов.

Зачем использовать

Ключевые функции

Живое демо

Как выглядит на практике

microsoft-learn-mcp.replay ▶ готово
0/0

Установка

Выберите клиент

~/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"
      ]
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

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

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

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

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

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

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

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

Continue использует массив объектов серверов, а не map.

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

Добавьте в context_servers. Zed перезагружается автоматически.

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

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: Microsoft Learn MCP

Реализовать паттерн ресурса Azure по актуальной документации

👤 Cloud-инженеры на Azure ⏱ ~20 min intermediate

Когда использовать: Claude постоянно пишет Bicep/Terraform с устаревшими именами свойств; нужно использовать актуальный API.

Поток
  1. Найти документ
    Microsoft Learn MCP: поиск «Azure Container Apps managed identity». Получи актуальную документацию.✓ Скопировано
    → Поиск возвращает страницы Learn с URL
  2. Получить и процитировать
    Получи раздел о назначении user-assigned identity. Процитируй актуальную Bicep-схему, не пересказывай.✓ Скопировано
    → Точный Bicep-фрагмент с именами свойств
  3. Применить
    Теперь напиши Bicep для моего container app с использованием существующего identity id-prod-app. Соответствуй процитированной схеме.✓ Скопировано
    → Bicep компилируется против актуального API Microsoft.App

Итог: Bicep разворачивается с первой попытки, потому что схема соответствует актуальному Azure API.

Подводные камни
  • Найденная страница для старой версии API — Всегда проверяй, что URL содержит «latest» или нужный api-version
Сочетать с: filesystem · github

Найти .NET API без выхода из Claude

👤 C# / .NET разработчики ⏱ ~10 min beginner

Когда использовать: Нужна точная сигнатура System.Threading.Channels.Channel.CreateBounded.

Поток
  1. Найти
    Microsoft Learn: сигнатура Channel.CreateBounded в .NET 9.✓ Скопировано
    → Страница справочника API с перегрузками
  2. Использовать
    Напиши producer/consumer с BoundedChannelOptions capacity 100, FullMode=Wait. Точно по документации.✓ Скопировано
    → Код соответствует актуальной поверхности API

Итог: Корректный C# без переключения на документацию.

Подводные камни
  • Смешение документации .NET Framework и .NET (Core) — Всегда указывай версию; Learn возвращает обе

Написать PowerShell-скрипт Microsoft Graph с цитированием

👤 M365 администраторы ⏱ ~25 min intermediate

Когда использовать: Нужно массово обновить назначения лицензий, а синтаксис актуальных Graph-командлетов неизвестен.

Поток
  1. Найти командлет
    Learn: актуальный синтаксис Set-MgUserLicense в Microsoft.Graph PowerShell SDK.✓ Скопировано
    → Документация командлета с набором параметров
  2. Написать скрипт
    Напиши скрипт, который читает users.csv (UPN, SkuPartNumber) и назначает лицензию. Процитируй использованные URLs Learn.✓ Скопировано
    → Рабочий PowerShell с цитированием в блоке комментариев

Итог: Проверяемый скрипт с цитированием для ревью.

Подводные камни
  • Старый синтаксис модуля AzureAD — AzureAD устарел; настаивай на Microsoft.Graph в prompt
Сочетать с: filesystem

Комбинации

Сочетайте с другими MCP — эффект x10

microsoft-learn-mcp + github

Найти актуальный паттерн Azure в Learn, затем оформить изменение IaC как PR

Learn: получи Container Apps + identity. GitHub: открой PR с обновлением Bicep.✓ Скопировано
microsoft-learn-mcp + filesystem

Сохранить процитированные фрагменты как runbook

Получи документацию командлетов лицензий M365 и сохрани runbook в /runbooks/m365-license.md с цитированием.✓ Скопировано
microsoft-learn-mcp + context7

Сопоставить документацию Microsoft с более широкой документацией библиотек

Сравни рекомендованный паттерн Microsoft Learn с тем, что говорит context7 для того же SDK.✓ Скопировано

Инструменты

Что предоставляет этот MCP

ИнструментВходные данныеКогда вызыватьСтоимость
microsoft_docs_search query: str Первый шаг бесплатно
microsoft_docs_fetch url: str Получить конкретную страницу бесплатно

Стоимость и лимиты

Во что обходится

Квота API
Microsoft размещает; разумное fair use на IP
Токенов на вызов
300–5000
Деньги
Бесплатно
Совет
Сначала ищи, потом получай только 1–2 наиболее релевантных URL

Безопасность

Права, секреты, радиус поражения

Хранение учётных данных: Нет — публичная документация
Исходящий трафик: learn.microsoft.com

Устранение неполадок

Частые ошибки и исправления

Результат для старой версии API

Добавь 'api-version=YYYY-MM' или версию .NET в запрос

Поиск возвращает маркетинговые страницы

Добавь 'docs' или 'reference' в запрос; фильтруй по URL, содержащему '/dotnet/api/' или '/azure/'

mcp-remote отказывает в соединении

Проверь сеть; endpoint: https://learn.microsoft.com/api/mcp

Проверить: curl -I https://learn.microsoft.com/api/mcp

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

Microsoft Learn MCP в сравнении

АльтернативаКогда использоватьКомпромисс
Context7Нужен более широкий охват библиотек, а не только MicrosoftМенее авторитетен для Microsoft-специфичной документации
GitMCPНужен сырой исходник репозитория вместо курируемой документацииНет курации; получаешь всё что есть в репозитории

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills