From eaa5fdbd8bfb4c5008bf43fda7ec672ae3cd5ccc Mon Sep 17 00:00:00 2001 From: Tianqi Zhang Date: Thu, 25 Dec 2025 17:07:58 +0800 Subject: [PATCH 1/2] Update installation instructions for Claude Code and Codex in README --- README.md | 13 +++---------- 1 file changed, 3 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 98f8bc6b..619bf7ce 100644 --- a/README.md +++ b/README.md @@ -129,10 +129,10 @@ The Microsoft Learn MCP Server supports quick installation across multiple devel |--------|----------------------|-------------------| | **VS Code** | [![Install in VS Code](https://img.shields.io/badge/Install_in-VS_Code-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=microsoft-learn&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Flearn.microsoft.com%2Fapi%2Fmcp%22%7D)
or search "@mcp learn" in Extensions to show "Microsoft Learn" MCP | [VS Code MCP Official Guide](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) | | **Claude Desktop** | Follow "Add custom connector" instructions in official guide. | [Claude Desktop Remote MCP Guide](https://modelcontextprotocol.io/docs/develop/connect-remote-servers) | -| **Claude Code** |
View Instructions1. Open a CLI
2. Type `claude mcp add --transport http microsoft-learn https://learn.microsoft.com/api/mcp` and press enter
3. (optional) Type `--scope user` directly after `claude mcp add` to make this MCP server available in Claude Code for all of your projects
| [Claude Code Remote MCP Guide](https://docs.anthropic.com/en/docs/claude-code/mcp) | +| **Claude Code** | Follow [skills instructions](#-agent-skills) and install plugin | [Claude Code Remote MCP Guide](https://code.claude.com/docs/en/mcp) | | **Visual Studio** | Upgrade to latest VS 2022 or 2026, "Microsoft Learn" MCP is already built-in | [Visual Studio MCP Official Guide](https://learn.microsoft.com/en-us/visualstudio/ide/mcp-servers?view=vs-2022) | | **Cursor IDE** | [![Install in Cursor](https://img.shields.io/badge/Install_in-Cursor-000000?style=flat-square&logoColor=white)](https://cursor.com/en/install-mcp?name=microsoft-learn&config=eyJuYW1lIjoibWljcm9zb2Z0LWxlYXJuIiwidHlwZSI6Imh0dHAiLCJ1cmwiOiJodHRwczovL2xlYXJuLm1pY3Jvc29mdC5jb20vYXBpL21jcCJ9) | [Cursor MCP Official Guide](https://docs.cursor.com/context/model-context-protocol) | -| **Codex** | Manual configuration required
View Instructions Create or edit the configuration file `~/.codex/config.toml` and add: 
[mcp_servers.microsoft-learn] 
url = "https://learn.microsoft.com/api/mcp"
| [Codex MCP documentation](https://github.com/openai/codex/blob/main/codex-rs/config.md#mcp_servers) | +| **Codex** | `codex mcp add "microsoft-learn" --url "https://learn.microsoft.com/api/mcp"`| [Codex MCP documentation](https://github.com/openai/codex/blob/main/codex-rs/config.md#mcp_servers) | | **Roo Code** | Open [Roo Code Marketplace](https://docs.roocode.com/features/marketplace), search for `Microsoft Learn`, and click `Install` | [Roo Code MCP Official Guide](https://docs.roocode.com/features/mcp/using-mcp-in-roo) | | **Cline** | Manual configuration required
Use `"type": "streamableHttp"` | [Cline MCP Official Guide](https://docs.cline.bot/mcp/connecting-to-a-remote-server) | | **Gemini CLI** | Manual configuration required
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)| @@ -140,15 +140,8 @@ The Microsoft Learn MCP Server supports quick installation across multiple devel | **GitHub** | Manual configuration required
View Config**Note**: Navigate to Settings → Coding agent
{
  "mslearn": {
    "type": "http",
    "url": "https://learn.microsoft.com/api/mcp",
    "tools": [
      "*"
    ]
  }
}
| | **ChatGPT** | Manual configuration required
View Instructions1. 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)| | **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) | +| **Kiro** |
View Config
{
  "microsoft-learn": {
    "url": "https://learn.microsoft.com/api/mcp"
    }
}
| [Kiro MCP Guide](https://kiro.dev/docs/mcp/index) | -### Alternative Installation (for legacy clients or local configuration) - -For clients that don't support native remote MCP servers or if you prefer local configuration, you can use `mcp-remote` as a proxy: - -| Client | Manual Configuration | MCP Guide | -|--------|----------------------|-----------| -| **Claude Desktop (legacy config)** |
View Config**Note**: Only use this if Settings → Integrations doesn't work
{
  "microsoft-learn": {
    "command": "npx",
    "args": [
      "-y",
      "mcp-remote",
      "https://learn.microsoft.com/api/mcp"
    ]
  }
}
Add to `claude_desktop_config.json`
| [Claude Desktop MCP Guide](https://modelcontextprotocol.io/quickstart/user) | -| **Kiro** |
View Config
{
  "microsoft-learn": {
    "command": "npx",
    "args": [
      "-y",
      "mcp-remote",
      "https://learn.microsoft.com/api/mcp"
    ]
  }
}
| [Kiro MCP Guide](https://kiro.dev/docs/mcp/index) | ### ▶️ Getting Started From 9eb2b5162d052c38c025711641eb3d48a4da111d Mon Sep 17 00:00:00 2001 From: Tianqi Zhang Date: Fri, 26 Dec 2025 08:58:50 +0800 Subject: [PATCH 2/2] Clarify installation instructions for Claude Code in README --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 619bf7ce..ea1942d1 100644 --- a/README.md +++ b/README.md @@ -94,7 +94,7 @@ https://learn.microsoft.com/api/mcp ### Quick Setup -If you use `claude-code`: +If you use Claude Code, run the following commands and restart Claude Code: ```bash /plugin marketplace add microsoftdocs/mcp /plugin install microsoft-docs@microsoft-docs-marketplace @@ -129,7 +129,7 @@ The Microsoft Learn MCP Server supports quick installation across multiple devel |--------|----------------------|-------------------| | **VS Code** | [![Install in VS Code](https://img.shields.io/badge/Install_in-VS_Code-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=microsoft-learn&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Flearn.microsoft.com%2Fapi%2Fmcp%22%7D)
or search "@mcp learn" in Extensions to show "Microsoft Learn" MCP | [VS Code MCP Official Guide](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) | | **Claude Desktop** | Follow "Add custom connector" instructions in official guide. | [Claude Desktop Remote MCP Guide](https://modelcontextprotocol.io/docs/develop/connect-remote-servers) | -| **Claude Code** | Follow [skills instructions](#-agent-skills) and install plugin | [Claude Code Remote MCP Guide](https://code.claude.com/docs/en/mcp) | +| **Claude Code** | Install via plugin marketplace (includes MCP server + skills) - see [Quick Setup](#-agent-skills) | [Claude Code Remote MCP Guide](https://code.claude.com/docs/en/mcp) | | **Visual Studio** | Upgrade to latest VS 2022 or 2026, "Microsoft Learn" MCP is already built-in | [Visual Studio MCP Official Guide](https://learn.microsoft.com/en-us/visualstudio/ide/mcp-servers?view=vs-2022) | | **Cursor IDE** | [![Install in Cursor](https://img.shields.io/badge/Install_in-Cursor-000000?style=flat-square&logoColor=white)](https://cursor.com/en/install-mcp?name=microsoft-learn&config=eyJuYW1lIjoibWljcm9zb2Z0LWxlYXJuIiwidHlwZSI6Imh0dHAiLCJ1cmwiOiJodHRwczovL2xlYXJuLm1pY3Jvc29mdC5jb20vYXBpL21jcCJ9) | [Cursor MCP Official Guide](https://docs.cursor.com/context/model-context-protocol) | | **Codex** | `codex mcp add "microsoft-learn" --url "https://learn.microsoft.com/api/mcp"`| [Codex MCP documentation](https://github.com/openai/codex/blob/main/codex-rs/config.md#mcp_servers) |