/ 目錄 / 演練場 / Microsoft Learn MCP
● 官方 MicrosoftDocs ⚡ 即開即用

Microsoft Learn MCP

作者 MicrosoftDocs · MicrosoftDocs/mcp

Microsoft 官方 Learn MCP — 搜尋並取得最新的 Azure/.NET/M365/Windows 文件和程式碼範例,附帶引用來源。

Microsoft Learn MCP 是由 MicrosoftDocs 在 learn.microsoft.com/api/mcp 託管的遠端 MCP 端點。它暴露由 Microsoft Learn 語料庫支援的搜尋 + 取得工具,意味著 Claude 可以取得整個 Microsoft 技術棧的最新文件、API 參考與程式碼範例,並附有適當的引用。無需抓取,無需過時快照。

為什麼要用

核心特性

即時演示

實際使用效果

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 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

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

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "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 使用伺服器物件陣列,而非映射。

~/.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 資源模式

👤 使用 Azure 的雲端工程師 ⏱ ~20 min intermediate

何時使用: Claude 一直用已棄用的屬性名稱寫 Bicep/Terraform;你想讓它使用當前的 API。

步驟
  1. 搜尋文件
    Microsoft Learn MCP:搜尋「Azure Container Apps managed identity」。取得當前文件。✓ 已複製
    → 搜尋回傳帶有 URL 的 Learn 頁面
  2. 取得並引用
    取得指派使用者指派身分的章節。引用當前的 Bicep schema,不要用自己的話說。✓ 已複製
    → 帶有屬性名稱的確切 Bicep 片段
  3. 套用
    現在為我的容器應用程式撰寫 Bicep,使用現有的身分 id-prod-app。符合你引用的 schema。✓ 已複製
    → Bicep 能針對當前的 Microsoft.App API 部署

結果: Bicep 第一次就能成功部署,因為 schema 符合當前 Azure API。

注意事項
  • 透過搜尋找到的文件是舊版 API 的 — 務必確認 URL 中有「latest」或正確的 api-version
搭配使用: filesystem · github

不離開 Claude 即可查詢 .NET API

👤 C#/.NET 開發者 ⏱ ~10 min beginner

何時使用: 你需要 System.Threading.Channels.Channel.CreateBounded 的確切簽章。

步驟
  1. 搜尋
    Microsoft Learn:.NET 9 中 Channel.CreateBounded 的簽章。✓ 已複製
    → 帶有多載的 API 參考頁面
  2. 使用
    撰寫使用 BoundedChannelOptions 的生產者/消費者,容量 100,FullMode=Wait。完全符合文件。✓ 已複製
    → 程式碼符合當前 API 介面

結果: 正確的 C# 程式碼,無需切換文件視窗。

注意事項
  • 混用 .NET Framework 和 .NET(Core)文件 — 務必指定版本;Learn 會同時回傳兩者

撰寫附有引用來源的 Microsoft Graph PowerShell 腳本

👤 M365 管理員 ⏱ ~25 min intermediate

何時使用: 你想批次更新授權指派,並需要當前 Graph cmdlet 語法。

步驟
  1. 找到 cmdlet
    Learn:Microsoft.Graph PowerShell SDK 中 Set-MgUserLicense 的當前語法。✓ 已複製
    → 帶有參數集的 cmdlet 文件
  2. 撰寫腳本
    撰寫一個讀取 users.csv(UPN、SkuPartNumber)並指派授權的腳本。引用你使用的 Learn URL。✓ 已複製
    → 可運作的 PowerShell,並在注解區塊中附有引用

結果: 附有引用來源的可稽核腳本,供審閱使用。

注意事項
  • 使用舊版 AzureAD 模組語法 — AzureAD 已棄用;在提示詞中堅持使用 Microsoft.Graph
搭配使用: filesystem

組合

與其他 MCP 搭配,撬動十倍槓桿

microsoft-learn-mcp + github

在 Learn 找到當前 Azure 模式,然後 PR IaC 變更

Learn:取得 Container Apps + 身分。GitHub:開一個更新我的 Bicep 的 PR。✓ 已複製
microsoft-learn-mcp + filesystem

將引用的片段儲存為 runbook

取得 M365 授權 cmdlet 文件,並將附有引用的 runbook 儲存到 /runbooks/m365-license.md。✓ 已複製
microsoft-learn-mcp + context7

將 Microsoft 文件與更廣泛的函式庫文件交叉比對

比較 Microsoft Learn 推薦的模式與 context7 對同一 SDK 的說法。✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
microsoft_docs_search query: str 第一步 free
microsoft_docs_fetch url: str 取得特定頁面 free

成本與限制

運行它的成本

API 配額
Microsoft 託管;合理的每 IP 公平使用
每次呼叫 Token 數
300–5000
費用
免費
提示
先搜尋,只取得前 1–2 個最相關的 URL

安全

權限、密鑰、影響範圍

憑證儲存: 無 — 公開文件
資料出站: learn.microsoft.com

故障排查

常見錯誤與修復

結果頁面是舊版 API 的

在查詢中附加「api-version=YYYY-MM」或 .NET 版本

搜尋回傳行銷頁面

在查詢中加入「docs」或「reference」;依 URL 包含「/dotnet/api/」或「/azure/」篩選

mcp-remote 連線被拒

檢查網路;端點為 https://learn.microsoft.com/api/mcp

驗證: curl -I https://learn.microsoft.com/api/mcp

替代方案

Microsoft Learn MCP 對比其他方案

替代方案何時用它替代權衡
Context7你想要更廣泛的函式庫涵蓋範圍,不只是 Microsoft對 Microsoft 特定文件的權威性較低
GitMCP你想要原始倉庫原始碼,而非整理過的文件無整理;你得到倉庫中的所有內容

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills