微软学习文档服务

🌟 Microsoft学习MCP服务器

停止人工智能幻觉。 让你的人工智能助手（Claude、Cursor、Copilot、Codex等）直接访问最新的微软官方文档。

✨ 免费。一键安装。不需要钥匙。

🎯 为什么要安装这个？

停止依赖过时的训练数据或有风险的网络搜索。了解MCP服务器提供对Microsoft官方文档的安全、直接访问。

• 🧠 消除幻觉。 阻止你的AI发明不存在的Azure SDK方法或产生幻觉的库包。获取实际编译的代码。

• 🔌 即插即用（无身份验证）。 无需API密钥，无需登录，无需注册。只需单击安装并立即开始编码。

• 🛡️ 100%可靠和安全。 保护您的供应链。与可能抓取不安全博客或恶意网站的通用网络搜索不同，此工具 仅 访问微软官方第一方文档。

• 💸 完全免费。 为无缝、繁重的编码会话量身定制的高搜索容量。

✨ 示例提示

“给我Azure CLI命令，以创建具有托管标识的Azure容器应用程序。”

“gpt-5.4在Azure欧盟地区可用吗？”

“你确定这是正确的实施方式吗 IHttpClientFactory 在一个。NET 8最低API？"

“向我展示使用Azure AI Foundry评估SDK进行危害评估的可运行Python代码。”

🌐 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 Learn MCP Server提供了正在积极开发的实验功能。这些功能可能会根据用户反馈和使用模式进行更改或改进。

OpenAI兼容端点

对于需要OpenAI Deep Research模型兼容性的应用程序，您可以使用OpenAI兼容端点：

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

此端点 支持OpenAI深度研究模型 并遵循OpenAI MCP规范。

代币预算控制

要管理令牌使用和控制成本，您可以附加 maxTokenBudget MCP端点URL的查询参数。此参数通过截断内容以满足您指定的预算来限制搜索工具响应中的令牌计数。

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

注： 这些实验特征可能会发生变化。我们欢迎通过我们的 GitHub讨论.

🛠️ 当前支持的工具

💻 Microsoft学习CLI preview

这 @microsoft/learn-cli 该包允许您在没有MCP客户端的情况下，通过终端访问相同的工具——搜索文档、获取页面和查找代码示例。

# Run instantly (no install)
npx @microsoft/learn-cli search "azure functions timeout"

# Or install globally
npm install -g @microsoft/learn-cli
# then use `mslearn`
mslearn search "azure functions timeout"

通过 --json 要获得结构化的JSON输出，可用于程序化处理：

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

看 cli/README.md 以获取完整的命令参考。

🤖 代理技能

代理技能 是便携式指令包，可帮助AI代理更有效地使用工具。我们提供三种技能，指导代理何时以及如何使用Microsoft Learn MCP工具：

快速设置

这些代理技能包含在 microsoft-docs 该插件与Learn MCP服务器本身一起使用。如果使用Claude Code，请运行以下命令并重新启动Claude Code：

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

或者，如果您使用GitHub Copilot CLI，请运行以下命令：

/plugin install microsoftdocs/mcp

否则：

1. 先安装MCP服务器 --请参阅 安装 在......下面
2. 复制技能文件夹 到你的项目 .github/skills/ 或 .claude/skills/ 目录：
   • microsoft-docs --用于概念、教程和事实查找
   • microsoft-code-reference -用于API查找、代码示例和故障排除
   • microsoft-skill-creator --用于生成有关Microsoft技术的自定义技能的元技能

支持的代理

Agent技能在多个AI Agent之间工作：

• VS Code （内部人员）--启用 chat.useAgentSkills 设置
• GitHub Copilot 命令行工具 & 复制品编码剂
• 克劳德代码, 光标, OpenAI 代码专家，以及 更多

我需要什么技能？

🔌 安装和入门

Microsoft Learn MCP Server支持跨多个开发环境快速安装。在下面选择您的首选客户端以简化设置：

{
 “Microsoft学习MCP服务器”：{
 “httpUrl”：“https://learn.microsoft.com/api/mcp" 
 }
}

{
 “Microsoft学习MCP服务器”：{
 “httpUrl”：“https://learn.microsoft.com/api/mcp" 
 }
}

{
 “mslearn”：{
 “类型”：“http”，
 “url”：“https://learn.microsoft.com/api/mcp",
 “工具”：[
 "*"
 ]
 }
}

{
 “mcpServers”：{
 “微软学习”：{
 “服务器URL”：https://learn.microsoft.com/api/mcp"
 }
 }
}

{
 “微软学习”：{
 “url”：“https://learn.microsoft.com/api/mcp"
 }
}

⚠️ 构建自定义客户端

如果您的用例需要直接的程序化集成，那么了解MCP是 动态协议，而不是静态API可用的工具及其模式将不断发展。

要构建一个在服务更新时不会崩溃的弹性客户端，您应该遵守以下原则：

1. 动态发现工具： 您的客户端应在运行时从服务器获取当前的工具定义（例如，使用 tools/list). 不要硬编码工具名称或参数。
2. 失败时刷新： 您的客户应在以下过程中处理错误 tool/invoke 电话。如果工具调用失败，并出现错误，表明它丢失或其架构已更改（例如HTTP 404或400错误），您的客户端应假设其缓存已过时，并通过调用自动触发刷新 tools/list.
3. 处理实时更新： 您的客户端应该监听服务器通知（例如。， 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.

⚠️ 常见问题

🆘 获得支持

• 提问，分享想法
• 创建问题

📚 额外资源

• Microsoft学习MCP服务器产品文档
• Microsoft MCP服务器
• 微软学习
• 模型上下文协议规范