🌟 Microsoft学习MCP服务器
Microsoft Learn MCP Server是一个远程MCP服务器，它使GitHub Copilot和其他AI代理等客户端能够直接从Microsoft的官方文档中获取可信和最新的信息。它支持流式http传输，这对客户端来说是轻量级的。
📑 目录
🎯 概述
✨ 示例提示：你的真理之源
您的AI助手应自动将这些工具用于与Microsoft相关的主题。通过搜索和获取功能，您可以获得快速答案或全面的深入了解。为了确保它始终参考官方文件，您可以添加以下短语 search Microsoft Learn, deep dive, fetch full doc.
快速搜索和参考
“给我Azure CLI命令，以创建具有托管标识的Azure容器应用程序。 搜索Microsoft学习"
“欧盟地区是否有gpt-4.1-mini？ 获取完整文档"
代码验证和最佳实践
“你确定这是正确的实施方式吗 IHttpClientFactory 在一个。NET 8最低API？ 搜索Microsoft学习并获取完整文档"“向我展示在ASP.NET Core中实现身份验证的完整指南。 获取完整文档"
“向我展示使用azure ai foundry评估sdk进行危害评估的详细、可运行的python代码示例”
综合学习与深度潜水
“我需要端到端地了解Azure功能。 搜索Microsoft学习和深入了解"
“请为我提供将.NET应用程序部署到Azure App Service的完整分步教程。 搜索Microsoft学习和深入了解"
📊 关键能力
- 高质量内容检索：以markdown格式从Microsoft官方文档中搜索和检索相关内容。
- 代码示例发现：查找具有特定语言过滤的官方Microsoft/AAzure代码片段和示例。
- 语义理解：使用高级矢量搜索为任何查询查找最相关的文档。
- 实时更新：访问最新发布的Microsoft文档。
🌐 Microsoft学习MCP服务器端点
任何支持模型上下文协议（MCP）的IDE、代理或工具都可以访问Microsoft Learn MCP服务器。任何兼容的客户端都可以连接到以下内容 远程MCP端点:
https://learn.microsoft.com/api/mcp注： 此URL用于 在合规的MCP客户端内 通过Streamable HTTP，例如我们推荐的客户端 入门指南 部分。它不支持从web浏览器直接访问，可能会返回 405 Method Not Allowed 手动访问时出错。对于需要构建自己的解决方案的开发人员，请遵循 构建自定义客户端 确保您的实现具有弹性和支持性。标准配置 适用于大多数客户：
{
"servers": {
"microsoft-learn": {
"type": "http",
"url": "https://learn.microsoft.com/api/mcp"
}
}
}🛠️ 当前支持的工具
| 工具名称 | 描述 | 输入参数 |
|---|---|---|
microsoft_docs_search | 对Microsoft官方技术文档执行语义搜索 | query （string）：用于检索的搜索查询 |
microsoft_docs_fetch | 获取Microsoft文档页面并将其转换为markdown格式 | url （string）：要读取的文档页面的URL |
microsoft_code_sample_search | 搜索官方的Microsoft/Azure代码片段和示例 | query （string）：搜索Microsoft/AAzure代码片段的查询 |
language （字符串，可选）：编程语言过滤器。 |
🔌 安装和入门
Microsoft Learn MCP Server支持跨多个开发环境快速安装。在下面选择您的首选客户端以简化设置：
| 客户端 | 一键安装 | MCP指南 |
|---|---|---|
| 克劳德桌面版 | 按照官方指南中的“添加自定义连接器”说明进行操作。 | 克劳德桌面远程MCP指南 |
| 克劳德代码 | 查看说明1.打开CLI |
2.类型 claude mcp add --transport http microsoft-learn https://learn.microsoft.com/api/mcp 然后按enter键 3.（可选）类型 --scope user 直接之后 claude mcp add 使此MCP服务器在Claude Code中可用于您的所有项目 | 克劳德代码远程MCP指南 | | Visual Studio |升级到最新的VS 2022或2026，“Microsoft Learn”MCP已内置| Visual Studio MCP官方指南 | | 法典 |需要手动配置 查看说明 创建或编辑配置文件 ~/.codex/config.toml 并添加： \[mcp_servers.microsoft.com/learn\] url=“https://learn.microsoft.com/api/mcp" | 食品法典委员会MCP文件 | | Roo代码 |打开 Roo代码市场，搜索 Microsoft Learn，然后单击 Install | Roo Code MCP官方指南 | | 克莱恩 |需要手动配置 使用 "type": "streamableHttp" | Cline MCP官方指南 | | Gemini CLI |需要手动配置 查看配置备注：添加一个 mcpServer 反对 .gemini/settings.json 文件
{ “Microsoft学习MCP服务器”：{ “httpUrl”：“https://learn.microsoft.com/api/mcp" } } | 如何设置MCP服务器 | | Qwen代码 |需要手动配置 查看配置备注：添加一个 mcpServer 反对 .qwen/settings.json 文件
{ “Microsoft学习MCP服务器”：{ “httpUrl”：“https://learn.microsoft.com/api/mcp" } } | 在settings.json中配置MCP服务器 | | GitHub |需要手动配置 查看配置备注：导航到“设置”→ 编码代理
{ “mslearn”：{ “类型”：“http”， “url”：“https://learn.microsoft.com/api/mcp", “工具”：\[ "\*" \] } } | | ChatGPT |需要手动配置 查看说明1.在浏览器中打开ChatGPT 2.转到 设置→ 连接器→ 高级设置→ 打开开发人员模式 3.返回连接器并单击 创建 4.给连接器一个 名字，输入 统一资源定位符 https://learn.microsoft.com/api/mcp，set 认证 到 No authentication 和 信任 应用程序 5.点击 创建 | ChatGPT官方指南 | | 帆板运动 |需要手动配置 查看配置 { “mcpServers”：{ “微软学习”：{ “服务器URL”：https://learn.microsoft.com/api/mcp" } } } | 风帆MCP指南 |
🏢 业务中心MCP服务器
如果你正在与 微软Dynamics 365商务中心，我们创建了一个全面的指南，用于设置与Business Central API、管理工具、DevOps工作流和web UI自动化集成的专用MCP服务器。
📖 查看完整的Business Central MCP服务器指南→
本指南包括：
- 商务中心API MCP （Sofia的MCP）-基于Python的OData API集成
- 管理员MCP （Demiliani的YAMPI）-基于Azure AD的管理工具
- AL Go MCP服务器 -DevOps和GitHub Actions集成
- Web UI MCP服务器 （SShadowS）-不列颠哥伦比亚省web客户端的浏览器自动化
- 完整的配置示例和故障排除
替代安装（适用于旧客户端或本地配置）
对于不支持本地远程MCP服务器的客户端，或者如果您更喜欢本地配置，可以使用 mcp-remote 作为代理人：
| 客户端 | 手动配置 | MCP指南 |
|---|---|---|
| 克劳德桌面（旧配置） | 查看配置备注：仅在设置时使用此选项→ 集成不起作用 |
{ “微软学习”：{ “命令”：“npx”， “args”：\[ y “mcp远程”， "https://learn.microsoft.com/api/mcp" \] } } 添加到 claude_desktop_config.json | 克劳德桌面MCP指南 | | 基罗 | 查看配置 { “微软学习”：{ “命令”：“npx”， “args”：\[ y “mcp远程”， "https://learn.microsoft.com/api/mcp" \] } } | Kiro MCP指南 |
▶️ 入门指南
- VS代码：在VS Code中打开GitHub Copilot 切换到代理模式
- 适用于克劳德桌面：添加集成后，您将在聊天界面中看到MCP工具图标
- 您应该在可用工具列表中看到学习MCP服务器
- 尝试告诉代理使用MCP服务器的提示，例如“根据Microsoft Learn官方文档，创建Azure容器应用程序的az-cli命令是什么？”
- 代理应该能够使用MCP服务器工具来完成您的查询
### ⚠️ 构建自定义客户端 如果您的用例需要直接的程序化集成，那么了解MCP是 动态协议，而不是静态API可用的工具及其模式将不断发展。 要构建一个在服务更新时不会崩溃的弹性客户端，您应该遵守以下原则： 1. 动态发现工具： 您的客户端应在运行时从服务器获取当前的工具定义（例如，使用tools/list). 不要硬编码工具名称或参数。 1. 失败时刷新： 您的客户应在以下过程中处理错误tool/invoke电话。如果工具调用失败，并出现错误，表明它丢失或其架构已更改（例如HTTP 404或400错误），您的客户端应假设其缓存已过时，并通过调用自动触发刷新tools/list. 1. 处理实时更新： 您的客户端应该监听服务器通知（例如。，listChanged)并相应地刷新其工具缓存。
❓ 故障排除
💻 系统提示
即使是像Claude Sonnet 4这样的工具友好型模型，有时默认情况下也无法调用MCP工具；使用系统提示来鼓励使用。
这是一个游标规则（系统提示）的示例，它将使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.⚠️ 常见问题
| 问题 | 可能的解决方案 |
|---|---|
| 连接错误 | 请验证您的网络连接以及服务器URL是否正确输入 |
| 未返回结果 | 请尝试用更具体的技术术语重新表述您的查询 |
| 工具未出现在VS代码中 | 重新启动VS代码或检查MCP扩展是否正确安装 |
| HTTP状态405 | 当浏览器尝试连接到端点时，会发生不允许的方法。尝试通过VS Code GitHub Copilot或 MCP检查员 相反。 |
🆘 获得支持
🔮 未来的增强功能
Microsoft Learn MCP Server团队正在进行多项增强：
- 改进了遥测技术，以帮助通知服务器增强功能
- 将覆盖范围扩展到其他Microsoft文档源
- 改进查询理解，获得更精确的结果
📚 额外资源
- Microsoft学习MCP服务器产品文档
- Business Central MCP服务器指南 -Business Central开发MCP服务器的设置指南
- Microsoft MCP服务器
- 微软学习
- 模型上下文协议规范