View Config

**Note**: Add an `mcpServer` object to `.gemini/settings.json` file

{
  \"Microsoft Learn MCP Server\": {
     \"httpUrl\": \"https://learn.microsoft.com/api/mcp\" 
   }
}

| [How to set up your MCP server](https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md#how-to-set-up-your-mcp-server)|\n| **Qwen Code** | Manual configuration required

View Config

**Note**: Add an `mcpServer` object to `.qwen/settings.json` file

{
  \"Microsoft Learn MCP Server\": {
     \"httpUrl\": \"https://learn.microsoft.com/api/mcp\" 
   }
}

| [Configure the MCP server in settings.json](https://qwenlm.github.io/qwen-code-docs/en/cli/tutorials/#configure-the-mcp-server-in-settingsjson)|\n| **GitHub** | Manual configuration required

View Config

**Note**: Navigate to Settings → Coding agent

{
  \"mslearn\": {
    \"type\": \"http\",
    \"url\": \"https://learn.microsoft.com/api/mcp\",
    \"tools\": [
      \"*\"
    ]
  }
}

|\n| **ChatGPT** | Manual configuration required

View Instructions

1. Open ChatGPT in the browser
2. Go to **Settings → Connectors → Advanced settings → Turn Developer mode on**
3. Go back to connectors and click **create**
4. Give the connector a **name**, enter **URL** `https://learn.microsoft.com/api/mcp`, set **authentication** to `No authentication` and **trust** the application
5. Click **create**

| [ChatGPT Official Guide](https://platform.openai.com/docs/guides/developer-mode)|\n| **Windsurf** | Manual configuration required

View Config

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

| [Windsurf MCP Guide](https://docs.windsurf.com/windsurf/cascade/mcp) |\n| **Kiro** |

View Config

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

| [Kiro MCP Guide](https://kiro.dev/docs/mcp/index) |\n\n\n> ### ⚠️ Building a Custom Client\n>\n> If your use case requires a direct, programmatic integration, it is essential to understand that MCP is a **dynamic protocol, not a static API**. The available tools and their schemas will evolve.\n>\n> To build a resilient client that will not break as the service is updated, you should adhere to the following principles:\n>\n> 1. **Discover Tools Dynamically:** Your client should fetch current tool definitions from the server at runtime (e.g., using `tools/list`). **Do not hard-code tool names or parameters.**\n> 2. **Refresh on Failure:** Your client should handle errors during `tool/invoke` calls. If a tool call fails with an error indicating it is missing or its schema has changed (e.g., an HTTP 404 or 400 error), your client should assume its cache is stale and automatically trigger a refresh by calling `tools/list`.\n> 3. **Handle Live Updates:** Your client should listen for server notifications (e.g., `listChanged`) and refresh its tool cache accordingly.\n\n## ❓ Troubleshooting\n\n### 💻 System Prompt\n\nEven tool-friendly models like Claude Sonnet 4 sometimes fail to call MCP tools by default; use system prompts to encourage usage.\n\nHere's an example of a Cursor rule (a system prompt) that will cause the LLM to utilize `microsoft-learn` more frequently:\n\n```md\n## Querying Microsoft Documentation\n\nYou 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.\n\nWhen 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.\n```\n\n### ⚠️ Common Issues\n\n| Issue | Possible Solution |\n|-------|-------------------|\n| Connection errors | Verify your network connection and that the server URL is correctly entered |\n| No results returned | Try rephrasing your query with more specific technical terms |\n| Tool not appearing in VS Code | Restart VS Code or check that the MCP extension is properly installed |\n| HTTP status 405 | Method not allowed happens when a browser tries to connect to the endpoint. Try using the MCP Server through VS Code GitHub Copilot or [MCP Inspector](https://modelcontextprotocol.io/docs/tools/inspector) instead. |\n| MCP server 'Microsoft Learn' marked as unavailable in Visual Studio (Reason: Eclipsed) | Visual Studio 2022 (17.13+) ships \"Microsoft Learn\" as a built-in MCP server at a higher-priority scope. \"Eclipsed\" means a higher-priority definition already exists and the duplicate lower-priority entry is suppressed. Eclipsing is matched on the server name, so remove any manually added entry with the same name as the built-in server (commonly `microsoft-learn` or `Microsoft Learn`) from your `~/.mcp.json` or workspace `.mcp.json`. The built-in server will then become active automatically. No additional configuration is required for Visual Studio users. |\n\n### 🆘 Getting Support\n\n- [Ask questions, share ideas](https://github.com/MicrosoftDocs/mcp/discussions)\n- [Create an issue](https://github.com/MicrosoftDocs/mcp/issues)\n\n## 📚 Additional Resources\n\n- [Microsoft Learn MCP Server product documentation](https://learn.microsoft.com/training/support/mcp)\n- [Microsoft MCP Servers](https://github.com/microsoft/mcp)\n- [Microsoft Learn](https://learn.microsoft.com)\n- [Model Context Protocol Specification](https://modelcontextprotocol.io)\n- [Microsoft Learn Terms of Use](https://learn.microsoft.com/legal/termsofuse)\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"upstream",{"_109":110,"_111":112,"_113":114,"_115":116,"_117":70,"_118":119},"requiredSecrets",[],"tags",[98,99,100,101,102,103,104,105,106,107,108],"assets",[],"stats",{"_96":85,"_97":85},"ratingAvg","reviewCount","ai","ai-agents","cli","copilot","documentation","learn-cli","llm","microsoft","microsoft-learn","rag","skills","topics",[98,99,100,101,102,103,104,21,105,106,107,108],"license","CC-BY-4.0","language","TypeScript","registryName","com.microsoft/microsoft-learn-mcp","homepage","packages",[],"ENV",{"_122":123,"_124":125,"_126":127},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]