Microsoft Learn 远程 MCP 服务器 – 官方端点、工具列表与一键连接指南

🛡️ Official✓ VerifiedStreamable HTTPPublic · No Auth🛡️ A+~971 tok3 tools·Online219ms·30 天在线率: 100%·上次拨测 10 分钟前

Microsoft Learn 官方托管的远程 MCP 服务器。微软官方 Learn MCP 服务器,将 Azure、.NET、Microsoft 365 等最新官方文档直接注入代理上下文。公开免鉴权。

本页收录其官方远程端点、传输协议、认证方式、全部工具 Schema、实时可用性拨测与安全审计结果,并为 Cursor、Claude Code、VS Code、ChatGPT 等 10 大客户端提供一键接入指引。

https://learn.microsoft.com/api/mcp
提供方
Microsoft ↗
分类
🔍 搜索与文档
Streamable HTTPhttps://learn.microsoft.com/api/mcp
Install in Cursor →

Or add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "microsoft-learn": {
      "url": "https://learn.microsoft.com/api/mcp"
    }
  }
}

🧰 Microsoft Learn MCP 工具与 Schema(3)

ToolSafetyDescriptionParameters
microsoft_docs_search
~245 tok
🟢 ReadidempotentSearch official Microsoft/Azure documentation to find the most relevant and trustworthy content for a user's query. This tool returns up to 10 high-quality content chunks (each max 500 tokens), extracted from Microsoft Learn and other official sources. Each result includes the article title, URL, and a self-contained content excerpt optimized for fast retrieval and reasoning. Always use this tool to quickly ground your answers in accurate, first-party Microsoft/Azure knowledge. ## Follow-up Pattern To ensure completeness, use microsoft_docs_fetch when high-value pages are identified by search. The fetch tool complements search by providing the full detail. This is a required step for comprehensive results.query: string
microsoft_code_sample_search
~385 tok
🟢 ReadidempotentSearch for code snippets and examples in official Microsoft Learn documentation. This tool retrieves relevant code samples from Microsoft documentation pages providing developers with practical implementation examples and best practices for Microsoft/Azure products and services related coding tasks. This tool will help you use the **LATEST OFFICIAL** code snippets to empower coding capabilities. ## When to Use This Tool - When you are going to provide sample Microsoft/Azure related code snippets in your answers. - When you are **generating any Microsoft/Azure related code**. ## Usage Pattern Input a descriptive query, or SDK/class/method name to retrieve related code samples. The optional parameter `language` can help to filter results. Eligible values for `language` parameter include: csharp javascript typescript python powershell azurecli al sql java kusto cpp go rust ruby phpquery*: stringlanguage: string
microsoft_docs_fetch
~321 tok
🟢 ReadidempotentFetch and convert a Microsoft Learn documentation webpage to markdown format. This tool retrieves the latest complete content of Microsoft documentation webpages including Azure, .NET, Microsoft 365, and other Microsoft technologies. ## When to Use This Tool - When search results provide incomplete information or truncated content - When you need complete step-by-step procedures or tutorials - When you need troubleshooting sections, prerequisites, or detailed explanations - When search results reference a specific page that seems highly relevant - For comprehensive guides that require full context ## Usage Pattern Use this tool AFTER microsoft_docs_search when you identify specific high-value pages that need complete content. The search tool gives you an overview; this tool gives you the complete picture. ## URL Requirements - The URL must be a valid HTML documentation webpage from the microsoft.com domain - Binary files (PDF, DOCX, images, etc.) are not supported ## Output Format markdown with headings, code blocks, tables, and links preserved.url*: string

🛡️ 安全评级、质量与上下文 Token 审计

🛡️ 安全评级 A+上下文 Token 开销: ~971 tokens(该服务端 3 个工具定义注入每次系统提示词)

估算单次调用 Token 成本 →

  • No prompt-injection or hidden-character anomalies detected in tool descriptions
  • Streamable HTTP primary endpoint (current 2025-03-26 transport)
  • Public read-only-friendly endpoint — no credentials stored client-side
  • Official first-party endpoint operated by the vendor
  • Manually verified by RemoteMCP.net

🔐 OAuth 2.1 与安全

认证方式
免密公开
动态客户端注册(DCR)
—
PKCE S256
—
受保护资源元数据
https://learn.microsoft.com/.well-known/oauth-protected-resource
审计 OAuth 2.1 配置 →

📡 官方远程端点与传输协议

远程端点 https://learn.microsoft.com/api/mcp 采用 Streamable HTTP(流式 HTTP,2025-03-26 规范)。Streamable HTTP 在单一 POST 端点上完成 JSON-RPC 双向交互,是当前 MCP 规范推荐的传输方式,可直接被 Claude、Cursor、VS Code 等客户端以 URL 形式接入,无需 npx mcp-remote 桥接。

接入前可将端点粘贴至本站 在线 MCP Inspector 实测 initialize / tools/list 握手,确认真实协议行为。

🔐 认证与权限机制

认证方式为 免密公开(None)。完全免密公开,直接粘贴 URL 即可使用——适合文档检索与公开数据查询类场景。

🛡️ 上下文开销与安全审计

该服务端当前登记 3 个工具,全部定义合计约 971 tokens,会在每次请求时注入模型系统提示词。安全评级为 A+,官方直营来源。工具名与 Schema 越精简,对上下文窗口的"税"越低;可用 feecalculator.app 估算每次调用的边际成本。

🧩 主流客户端快速接入

本站为 Microsoft Learn 生成了 Cursor / Claude Code / VS Code / ChatGPT / Windsurf / Kiro / Codex / Cline / Gemini 等 10 大客户端的专属配置——包括一键 deeplink、claude mcp add 命令与 JSON/TOML 片段。下方选择你的客户端即可查看 1 分钟接入步骤。代表性工具包括 microsoft_docs_search、microsoft_code_sample_search、microsoft_docs_fetch 等。

📖 Microsoft Learn 详解

Microsoft Learn — Remote MCP Server

Microsoft's official Learn MCP server streams trusted, up-to-date documentation for Azure, .NET, Microsoft 365 and the full Microsoft technical catalog directly into agent context. The remote endpoint means there is nothing to install — point your MCP client at the URL and start calling tools right away. Microsoft operates and versions the server themselves, so tool coverage tracks their API surface as it ships.

Official Microsoft Learn Endpoint & Transport Architecture

  • Endpoint URL: https://learn.microsoft.com/api/mcp
  • Transport: Streamable HTTP

Streamable HTTP is the current MCP transport (2025-03-26 spec): a single URL accepts JSON-RPC POSTs and may stream responses over SSE, so one endpoint serves both simple and streaming workloads. Microsoft Learn does not publish a separate legacy SSE endpoint, so your client must speak Streamable HTTP.

Authentication, Scopes & Permission Boundaries

Microsoft Learn is public and unauthenticated — no OAuth, no API key, no headers. Any MCP client can connect and call its tools directly, which also makes it a great endpoint for smoke-testing your own MCP client or proxy.

All 3 cataloged tools are read-only — Microsoft Learn cannot mutate your account data, which makes it safe to connect broadly.

Common Troubleshooting & Connection Tips

  • "Session expired" / stale Mcp-Session-Id — just re-send initialize; stateless clients can ignore session headers entirely.

🚀 如何接入 Microsoft Learn 远程 MCP

  1. 获取远程端点 — 复制官方端点 https://learn.microsoft.com/api/mcp。
  2. 写入客户端配置 — 在 Cursor 的 mcp.json / Claude Code CLI / 其他客户端中添加该 URL(见下方分客户端指南)。
  3. 授权并验证 — 保存配置后,在本站 Inspector 中运行 initialize 与 tools/list 验证连通性。

🔌 Microsoft Learn × 各客户端连接指南

❓ 常见问题

Microsoft Learn 远程 MCP 服务器是官方提供的吗?

本条目标记为「官方直营」。端点由 Microsoft 官方运营,所有收录端点均经过真实 MCP initialize 握手验证。

如何在 Claude / Cursor 中连接 Microsoft Learn?

复制远程端点 https://learn.microsoft.com/api/mcp:Claude Code 执行 claude mcp add --transport http microsoft-learn https://learn.microsoft.com/api/mcp;Cursor 可直接使用本页的一键 deeplink 或在 ~/.cursor/mcp.json 中添加 { "mcpServers": { "microsoft-learn": { "url": "https://learn.microsoft.com/api/mcp" } } }。

连接时返回 401 或需要密钥怎么办?

该端点免密公开;若仍返回 401 请确认 URL 未拼写错误,并在 Inspector 中重试。

本地 stdio MCP 和这个远程 MCP 有什么区别?

本地 MCP 通过 npx/uvx 在你的机器上启动 stdio 子进程,依赖本地运行时且密钥以明文写入配置文件;远程 MCP 是 Microsoft 托管的 HTTPS 端点,免安装、支持 OAuth 2.1 授权流,且同一端点可跨桌面与移动端复用。详见 本地 vs 远程 MCP 对比。

🔗 同类远程 MCP 服务端