🌟 Microsoft Learn MCP Server

Остановите галлюцинации ИИ. Предоставьте вашему ИИ-ассистенту (Claude, Cursor, Copilot, Codex, ...) прямой доступ к последней официальной документации Microsoft.

✨ Бесплатно. Установка в один клик. Ключи не требуются.

🎯 Зачем устанавливать MCP Server?

Не полагайтесь на устаревшие данные обучения или рискованные веб-поиски. Learn MCP Server обеспечивает безопасный, прямой доступ к официальной документации Microsoft.

🧠 Устраняйте галлюцинации. Остановите, чтобы ваш ИИ не придумывал несуществующие методы Azure SDK или пакеты библиотек. Получайте код, который действительно компилируется.
🔌 Plug & Play (Без аутентификации). Никаких API-ключей, логинов и регистрации. Установите одним кликом и начинайте кодировать немедленно.
🛡️ На 100% надежно и безопасно. Защитите вашу цепочку поставок. В отличие от общих веб-поисков, которые могут тянуться к небезопасным блогам или вредоносным сайтам, этот инструмент обращается только к официальной документации Microsoft от первого лица.
💸 Полностью бесплатно. Высокий объём поиска, оптимизированный под удобную, насыщенную кодированием работу.

✨ Примеры подсказок

"Дайте мне команды Azure CLI для создания Azure Container App с управляемой идентификацией."

"Доступна ли gpt-5.4 в регионах Azure EU?"

"Вы уверены, что это правильный способ реализации IHttpClientFactory в минимальном API на .NET 8?"

"Покажите исполняемый код на Python для выполнения harms eval с использованием Azure AI Foundry evaluation SDK."

🌐 The Microsoft Learn MCP Server Endpoint

The Microsoft Learn MCP Server доступен для любого IDE, агента или инструмента, поддерживающего Model Context Protocol (MCP). Любой совместимый клиент может подключиться к следующему удалённому MCP-эндпоинту:

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

Примечание: Этот URL предназначен для использования в рамках совместимого MCP-клиента через Streamable HTTP, например, в рекомендуемых клиентах, перечисленных в разделе Начало работы. Он не поддерживает прямой доступ через веб-браузер и может вернуть ошибку 405 Method Not Allowed при ручном доступе. Разработчикам, которым нужно создать своё решение, следует следовать обязательным руководствам в разделе Создание собственного клиента, чтобы обеспечить надёжность и поддержку.

Стандартная конфигурация работает во многих клиентах:

{
  "servers": {
    "microsoft-learn": {
      "type": "http",
      "url": "https://learn.microsoft.com/api/mcp"
    }
  }
}

Для экспериментальных возможностей смотрите раздел Experimental Features ниже.

🧪 Experimental Features

Microsoft Learn MCP Server предлагает экспериментальные функции, находящиеся в активной разработке. Эти функции могут изменяться или дополняться по отзывам пользователей и паттернам использования.

OpenAI-Compatible Endpoint

Для приложений, которым нужна совместимость с моделями OpenAI Deep Research, можно использовать совместимый с OpenAI endpoint:

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

Этот эндпоинт поддерживает модели OpenAI Deep Research и следует спецификации OpenAI MCP.

Token Budget Control

Чтобы управлять использованием токенов и контролировать стоимость, можно добавить параметр запроса maxTokenBudget к URL MCP-эндпоинта. Этот параметр ограничивает количество токенов в ответах инструмента поиска, обрезая контент под заданный бюджет.

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

Примечание: Эти экспериментальные функции могут изменяться. Мы приветствуем отзывы через наши Discussions на GitHub.

🛠️ Currently Supported Tools

Tool Name	Description	Input Parameters
microsoft_docs_search	Выполняет семантический поиск по официальной технической документации Microsoft	query (string): строка запроса для извлечения
microsoft_docs_fetch	Получает и конвертирует страницу документации Microsoft в формат Markdown	url (string): URL страницы документации для чтения
microsoft_code_sample_search	Поиск официальных кодовых примеров Microsoft/Azure	query (string): поисковый запрос для примеров кода Microsoft/Azure; language (string, optional): фильтр по языку программирования

💻 Microsoft Learn CLI `preview`

Пакет @microsoft/learn-cli предоставляет доступ в терминале к тем же инструментам — поиск документации, получение страниц и поиск примеров кода — без MCP-клиента.

# Запуск мигом (без установки)
npx @microsoft/learn-cli search "azure functions timeout"

# Или установка глобально
npm install -g @microsoft/learn-cli
# затем используйте `mslearn`
mslearn search "azure functions timeout"

Передайте --json для структурированного JSON-выхода, полезного для программной обработки:

mslearn search "azure openai" --json | jq '.results[].title'

См. cli/README.md для полного справочника по командам.

🤖 Agent Skills

Agent Skills — переносимые наборы инструкций, помогающие агентам использовать инструменты более эффективно. Мы предлагаем три навыка, которые направляют агентов на использование инструментов Microsoft Learn MCP:

Skill	Purpose	Best For
microsoft-docs	Понимание концепций, руководств, архитектуры, ограничений	"Как работает X?", обучение, конфигурационные руководства
microsoft-code-reference	Поиски API, примеры кода, верификация, исправление ошибок	Реализация кода, поиск правильных методов, устранение неполадок
microsoft-skill-creator	Мета-навык, создающий пользовательские навыки для любой технологии Microsoft	Создание навыка, чтобы обучить агентов работе с новой библиотекой Azure,.NET-фичей и т. д.

Быстрая настройка

Эти агентские навыки упакованы в плагин microsoft-docs вместе с самим сервером Learn MCP. Если вы используете Claude Code, выполните команду ниже и перезапустите Claude Code:

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

Или если вы используете GitHub Copilot CLI, запустите эту команду:

/plugin install microsoftdocs/mcp

Иначе:

Сначала установите MCP Server — см. раздел Installation ниже
Скопируйте папки навыков в директорию вашего проекта .github/skills/ или .claude/skills/:

microsoft-docs — для концепций, руководств и фактологических запросов

microsoft-code-reference — для API-lookup, примеров кода и устранения ошибок
microsoft-skill-creator — мета-навык для создания пользовательских навыков по Microsoft-технологиям

Supported Agents

Навыки агентов работают во множестве агентов ИИ:

VS Code (Inviters) — включите настройку chat.useAgentSkills
GitHub Copilot CLI и Copilot coding agent
Claude Code, Cursor, OpenAI Codex и ещё

Which Skill Do I Need?

If you want to...	Install
Покрыть все сценарии Microsoft docs	Все три навыка
Фокус на кодинг (API, примеры, ошибки)	только microsoft-code-reference
Фокус на факты и концепции (лимиты, конфигурации, руководства)	только microsoft-docs
Создать пользовательский навык для конкретной Microsoft-технологии	только microsoft-skill-creator

🔌 Installation & Getting Started

Microsoft Learn MCP Server поддерживает быструю установку в разных средах разработки. Выберите предпочитаемого клиента ниже для упрощённой настройки:

Клиент	Установка в один клик	Руководство MCP
VS Code	или найдите в Extensions "@mcp learn" чтобы показать MCP "Microsoft Learn"	VS Code MCP Official Guide
GitHub Copilot CLI	/plugin install microsoftdocs/mcp
Claude Desktop	Следуйте инструкциям по добавлению пользовательного коннектора в официальном руководстве.	Claude Desktop Remote MCP Guide
Claude Code	/plugin install microsoft-docs@claude-plugins-official (включает MCP сервер + навыки)	Claude Code Remote MCP Guide
Visual Studio	Обновитесь до последней VS 2022 или 2026, MCP "Microsoft Learn" встроен	Visual Studio MCP Official Guide
Cursor IDE		Cursor MCP Official Guide
Codex	codex mcp add "microsoft-learn" --url "https://learn.microsoft.com/api/mcp"	Codex MCP documentation
Roo Code	Откройте Roo Code Marketplace, найдите Microsoft Learn и нажмите Install	Roo Code MCP Official Guide
Cline	Требуется ручная настройка. Используйте `type`: `streamableHttp`	Cline MCP Official Guide
Gemini CLI	Требуется ручная настройка. См. Настройки. Примечание: добавьте mcpServer в .gemini/settings.json```
{ "Microsoft Learn MCP Server": { "httpUrl": "https://learn.microsoft.com/api/mcp" }}

| Qwen Code | Требуется ручная настройка. См. Настройки. Примечание: добавьте mcpServer в .qwen/settings.json```
{  "Microsoft Learn MCP Server": {     "httpUrl": "https://learn.microsoft.com/api/mcp"    }}
``` | Qwen Code MCP Guide |
| GitHub | Требуется ручная настройка. См. Настройки → Coding agent```
{  "mslearn": {    "type": "http",    "url": "https://learn.microsoft.com/api/mcp",    "tools": [      "*"    ]  }}
``` | GitHub MCP Official Guide |
| ChatGPT | Требуется ручная настройка. Инструкция: 1) Откройте ChatGPT в браузере 2) В Settings → Connectors → Advanced settings → Turn Developer mode on 3) Вернитесь к коннекторам и создайте 4) Дайте коннектору имя, введите URL https://learn.microsoft.com/api/mcp, установите аутентификацию на No authentication и доверьтесь приложению 5) Нажмите создать | ChatGPT Official Guide |
| Windsurf | Требуется ручная настройка. См. Настройки```
{  "mcpServers": {    "microsoft-learn": {      "serverUrl": "https://learn.microsoft.com/api/mcp"    }  }}
``` | Windsurf MCP Guide |
| Kiro | См. Настройки```
{  "microsoft-learn": {    "url": "https://learn.microsoft.com/api/mcp"    }}
``` | Kiro MCP Guide |

> ### ⚠️ Building a Custom Client
>
> Если ваш сценарий требует прямой программной интеграции, важно понимать, что MCP — это динамичный протокол, а не статический API. Доступные инструменты и их схемы будут развиваться.
>
> Чтобы построить устойчивый клиент, который не сломается при обновлениях сервиса, придерживайтесь следующих принципов:
>
> - **Динамическое обнаружение инструментов:** ваш клиент должен получать текущие определения инструментов с сервера во время выполнения (например, через `tools/list`). Ни в коем случае не хардкодьте названия инструментов или параметры.
> - **Обновление по неудаче:** ваш клиент должен обрабатывать ошибки во время вызовов `tool/invoke`. Если вызов инструмента завершается ошибкой, указывающей на отсутствие или изменение схемы (например, HTTP 404 или 400), клиент должен считать кеш устаревшим и автоматически запрашивать обновление через `tools/list`.
> - **Обновления в режиме реального времени:** ваш клиент должен следить за уведомлениями сервера (например, `listChanged`) и обновлять кеш инструментов.

## ❓ Troubleshooting

### 💻 System Prompt

Даже модели, ориентированные на инструменты, такие как Claude Sonnet 4, иногда не вызывают MCP-инструменты по умолчанию; используйте системные подсказки, чтобы поощрять использование.

Пример правила Cursor (системная подсказка), которое заставит LLM чаще использовать `microsoft-learn`:

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.


### ⚠️ Common Issues

| Проблема | Возможное решение |
| --- | --- |
| Ошибки подключения | Проверьте сетевое соединение и корректность URL сервера |
| Нет результатов | Попробуйте переформулировать запрос с более конкретными техническими терминами |
| Инструмент не появляется в VS Code | Перезапустите VS Code или проверьте, корректно ли установлен MCP-расширение |
| HTTP статус 405 | Метод не разрешён — возникает, когда браузер пытается подключиться к эндпоинту. Попробуйте использовать MCP Server через VS Code, GitHub Copilot или MCP Inspector. |

### 🆘 Getting Support

- [Задавайте вопросы, делитесь идеями](https://github.com/MicrosoftDocs/mcp/discussions)

- [Создайте issue](https://github.com/MicrosoftDocs/mcp/issues)

## 📚 Additional Resources

- [Microsoft Learn MCP Server product documentation](https://learn.microsoft.com/training/support/mcp)

- [Microsoft MCP Servers](https://github.com/microsoft/mcp)

- [Microsoft Learn](https://learn.microsoft.com)

- [Model Context Protocol Specification](https://modelcontextprotocol.io)

- [Microsoft Learn Terms of Use](https://learn.microsoft.com/legal/termsofuse)