Set up the Microsoft Learn MCP Server
Start Set up the Microsoft Learn MCP Server with verified links, minimal permissions, and a safe first test.
- Skill Road
- Set up the Microsoft Learn MCP Server
Published on 22.09.2026
The Microsoft Learn MCP Server connects AI clients like Claude Code, Codex, and Cursor to a semantic search over the complete official Microsoft documentation and code samples — publicly reachable and requiring no sign-in. This guide covers setup and how it differs from the account-bound Microsoft servers in the catalog.
Connect the server
For Claude Code, the official plugin is enough: /plugin install microsoft-docs@claude-plugins-official, then restart Claude Code. For Codex, a single command is enough: codex mcp add "microsoft-learn" --url "https://learn.microsoft.com/api/mcp". In VS Code and Cursor, the one-click install button from the official repository is enough. Other clients can add the standard configuration manually using "type": "http" and the URL https://learn.microsoft.com/api/mcp. No sign-in, API key, or Microsoft account is needed anywhere in this flow.
Ask your first questions
After setup, you can ask the agent concrete development questions directly — about Azure CLI commands, the availability of specific models in individual Azure regions, or the correct usage of .NET APIs. The server searches the currently indexed Microsoft documentation and returns context-aware excerpts along with official code samples instead of general, potentially outdated model knowledge.
Distinction from the Azure MCP Server and Fabric MCP Server
If you also need read or write access to your own Azure resources or Fabric workspaces, you need the separate Azure MCP Server or Fabric MCP Server already listed in the catalog, both requiring Azure sign-in. This Learn server deliberately stays limited to pure documentation and code-sample search, keeping it low-risk and instantly usable.
Frequently asked questions
Why are there product and repository links?
The product link points to the official Microsoft Learn product documentation. The repository verifies source code, license, and the exact GitHub star count for the server.
Are GitHub stars a rating?
No. The number is a point-in-time snapshot of the MicrosoftDocs/mcp repository collected through the GitHub API on 2026-09-22 and does not replace security or quality review.
Do I need a Microsoft or Azure account?
No. The Learn server only accesses public documentation and code samples and requires no authentication.
Can the server change my Azure account?
No. It provides read-only access to documentation and code-sample content. Account access is handled by the separate Azure MCP Server and Fabric MCP Server with Azure sign-in.
Is there also a command-line tool without an MCP client?
Yes. The npm package `@microsoft/learn-cli` (MIT licensed) offers the same search functionality directly in the terminal, for example via `npx @microsoft/learn-cli search "..."`.