From 4d907415b30ca2c6b0523fadd0a8d61854151320 Mon Sep 17 00:00:00 2001 From: "Tom Meschter (from Dev Box)" Date: Tue, 7 Jul 2026 11:24:08 -0700 Subject: [PATCH 1/6] Add Claude Code plugin installation instructions to Azure MCP Server README Adds instructions for installing the Azure plugin into Claude Code from Anthropic's official claude-plugins-official marketplace, which no longer requires adding a custom marketplace. Updates the top-level README badge, the Client-Specific Configuration table, and the CHANGELOG. Fixes #1579 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- README.md | 2 +- servers/Azure.Mcp.Server/CHANGELOG.md | 1 + servers/Azure.Mcp.Server/README.md | 15 ++++++++++++++- 3 files changed, 16 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 357b17ae7b..3df41f03a4 100644 --- a/README.md +++ b/README.md @@ -44,7 +44,7 @@ This repository contains core libraries, test frameworks, engineering systems, p - **DESCRIPTION**: All Azure MCP tools in a single server. The Azure MCP Server implements the MCP specification to create a seamless connection between AI agents and Azure services. Azure MCP Server can be used alone or with the GitHub Copilot for Azure extension in VS Code. - **CATEGORY**: `CLOUD AND INFRASTRUCTURE` - **TYPE**: `Local` -- **INSTALL**: [![Install Azure MCP in VS Code](https://img.shields.io/badge/VS_Code-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect?url=vscode:extension/ms-azuretools.vscode-azure-mcp-server) [![Install Azure MCP in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect?url=vscode-insiders:extension/ms-azuretools.vscode-azure-mcp-server) [![Install Azure MCP in Visual Studio](https://img.shields.io/badge/Visual_Studio-C16FDE?style=flat-square&logo=visualstudio&logoColor=white)](https://marketplace.visualstudio.com/items?itemName=github-copilot-azure.GitHubCopilotForAzure2022) [![Install Azure MCP in IntelliJ](https://img.shields.io/badge/IntelliJ%20IDEA-1495b1?style=flat-square&logo=intellijidea&logoColor=white)](https://plugins.jetbrains.com/plugin/8053) [![Install Azure MCP in Eclipse](https://img.shields.io/badge/Eclipse-b6ae1d?style=flat-square&logo=eclipse&logoColor=white)](https://marketplace.eclipse.org/content/azure-toolkit-eclipse) +- **INSTALL**: [![Install Azure MCP in VS Code](https://img.shields.io/badge/VS_Code-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect?url=vscode:extension/ms-azuretools.vscode-azure-mcp-server) [![Install Azure MCP in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect?url=vscode-insiders:extension/ms-azuretools.vscode-azure-mcp-server) [![Install Azure MCP in Visual Studio](https://img.shields.io/badge/Visual_Studio-C16FDE?style=flat-square&logo=visualstudio&logoColor=white)](https://marketplace.visualstudio.com/items?itemName=github-copilot-azure.GitHubCopilotForAzure2022) [![Install Azure MCP in IntelliJ](https://img.shields.io/badge/IntelliJ%20IDEA-1495b1?style=flat-square&logo=intellijidea&logoColor=white)](https://plugins.jetbrains.com/plugin/8053) [![Install Azure MCP in Eclipse](https://img.shields.io/badge/Eclipse-b6ae1d?style=flat-square&logo=eclipse&logoColor=white)](https://marketplace.eclipse.org/content/azure-toolkit-eclipse) [![Install Azure MCP in Claude Code](https://img.shields.io/badge/Claude_Code-Install-orange?style=flat-square)](https://github.com/microsoft/mcp/tree/main/servers/Azure.Mcp.Server#claude-code) ### ✨ Azure AI Foundry - **REPOSITORY**: [azure-ai-foundry/mcp-foundry](https://github.com/azure-ai-foundry/mcp-foundry) diff --git a/servers/Azure.Mcp.Server/CHANGELOG.md b/servers/Azure.Mcp.Server/CHANGELOG.md index b4be777647..cbd9c607d9 100644 --- a/servers/Azure.Mcp.Server/CHANGELOG.md +++ b/servers/Azure.Mcp.Server/CHANGELOG.md @@ -12,6 +12,7 @@ The Azure MCP Server updates automatically by default whenever a new release com ### Other Changes +- Added Claude Code installation instructions to the Azure MCP Server README, covering installation of the Azure plugin from Anthropic's official `claude-plugins-official` marketplace. [[#1579](https://github.com/microsoft/mcp/issues/1579)] - Added a `CancellationToken` parameter to async methods to more `I[SomeService]` interfaces. [[#1133](https://github.com/microsoft/mcp/pull/1133)] ## 2.0.0-beta.3 (2025-11-11) diff --git a/servers/Azure.Mcp.Server/README.md b/servers/Azure.Mcp.Server/README.md index 93a18a77ef..f24db05ffa 100644 --- a/servers/Azure.Mcp.Server/README.md +++ b/servers/Azure.Mcp.Server/README.md @@ -26,6 +26,7 @@ All Azure MCP tools in a single server. The Azure MCP Server implements the [MCP - [Visual Studio 2022](#visual-studio-2022) - [IntelliJ IDEA](#intellij-idea) - [Eclipse IDE](#eclipse-ide) + - [Claude Code](#claude-code) - [Manual Setup](#manual-setup) - [Package Manager](#package-manager) - [NuGet](#nuget) @@ -146,6 +147,18 @@ From within Visual Studio 2022 install [GitHub Copilot for Azure (VS 2022)](http 1. Install the [GitHub Copilot](https://marketplace.eclipse.org/content/github-copilot) plugin. 1. Install the [Azure Toolkit for Eclipse](https://marketplace.eclipse.org/content/azure-toolkit-eclipse) plugin. +### Claude Code + +The Azure plugin packages the Azure MCP Server along with Azure-related agents and skills, bringing Azure integration to Claude Code in one installation. + +1. Install [Claude Code](https://code.claude.com/). +1. Install the Azure plugin from Anthropic's official plugin marketplace by running the following command in Claude Code: + ``` + /plugin install azure@claude-plugins-official + ``` + +The `claude-plugins-official` marketplace is available in Claude Code by default, so no additional marketplace setup is required. For more information on discovering and installing plugins, see the [Claude Code plugins documentation](https://code.claude.com/docs/en/discover-plugins). + ### Manual Setup Azure MCP Server can also be configured across other IDEs, CLIs, and MCP clients: @@ -211,7 +224,7 @@ To verify the .NET version, run the following command in the terminal: `dotnet - | IDE | File Location | Documentation Link | |-----|---------------|-------------------| | **Amazon Q Developer** | `~/.aws/amazonq/mcp.json` (global)
`.amazonq/mcp.json` (workspace) | [AWS Q Developer MCP Guide](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/qdev-mcp.html) | -| **Claude Code** | `~/.claude.json` or `.mcp.json` (project) | [Claude Code MCP Configuration](https://scottspence.com/posts/configuring-mcp-tools-in-claude-code) | +| **Claude Code** | Plugin (recommended): see [Claude Code](#claude-code)
Manual: `~/.claude.json` or `.mcp.json` (project) | [Claude Code Installation Instructions](#claude-code) | | **Claude Desktop** | `~/.claude/claude_desktop_config.json` (macOS)
`%APPDATA%\Claude\claude_desktop_config.json` (Windows) | [Claude Desktop MCP Setup](https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop) | | **Cursor** | `~/.cursor/mcp.json` or `.cursor/mcp.json` | [Cursor MCP Documentation](https://docs.cursor.com/context/model-context-protocol) | | **Eclipse IDE** | GitHub Copilot Chat -> Configure Tools -> MCP Servers | [Eclipse MCP Documentation](https://docs.github.com/en/copilot/how-tos/provide-context/use-mcp/extend-copilot-chat-with-mcp#configuring-mcp-servers-in-eclipse) | From 3cfe64a52e6f1083a9483459373ba0b398619ab5 Mon Sep 17 00:00:00 2001 From: "Tom Meschter (from Dev Box)" Date: Tue, 7 Jul 2026 11:34:33 -0700 Subject: [PATCH 2/6] Remove note about default marketplace availability Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- servers/Azure.Mcp.Server/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/servers/Azure.Mcp.Server/README.md b/servers/Azure.Mcp.Server/README.md index f24db05ffa..50e4d874ba 100644 --- a/servers/Azure.Mcp.Server/README.md +++ b/servers/Azure.Mcp.Server/README.md @@ -157,7 +157,7 @@ The Azure plugin packages the Azure MCP Server along with Azure-related agents a /plugin install azure@claude-plugins-official ``` -The `claude-plugins-official` marketplace is available in Claude Code by default, so no additional marketplace setup is required. For more information on discovering and installing plugins, see the [Claude Code plugins documentation](https://code.claude.com/docs/en/discover-plugins). +For more information on discovering and installing plugins, see the [Claude Code plugins documentation](https://code.claude.com/docs/en/discover-plugins). ### Manual Setup Azure MCP Server can also be configured across other IDEs, CLIs, and MCP clients: From 1766788a9d5a5daed303190a9c9a8350005e04ac Mon Sep 17 00:00:00 2001 From: "Tom Meschter (from Dev Box)" Date: Tue, 7 Jul 2026 11:41:33 -0700 Subject: [PATCH 3/6] Link Claude Code manual config to official MCP quickstart docs Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- servers/Azure.Mcp.Server/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/servers/Azure.Mcp.Server/README.md b/servers/Azure.Mcp.Server/README.md index 50e4d874ba..d45890046e 100644 --- a/servers/Azure.Mcp.Server/README.md +++ b/servers/Azure.Mcp.Server/README.md @@ -224,7 +224,7 @@ To verify the .NET version, run the following command in the terminal: `dotnet - | IDE | File Location | Documentation Link | |-----|---------------|-------------------| | **Amazon Q Developer** | `~/.aws/amazonq/mcp.json` (global)
`.amazonq/mcp.json` (workspace) | [AWS Q Developer MCP Guide](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/qdev-mcp.html) | -| **Claude Code** | Plugin (recommended): see [Claude Code](#claude-code)
Manual: `~/.claude.json` or `.mcp.json` (project) | [Claude Code Installation Instructions](#claude-code) | +| **Claude Code** | Plugin (recommended): see [Claude Code](#claude-code)
Manual: `~/.claude.json` or `.mcp.json` (project) | [Claude Code MCP Configuration](https://code.claude.com/docs/en/mcp-quickstart#add-a-local-server) | | **Claude Desktop** | `~/.claude/claude_desktop_config.json` (macOS)
`%APPDATA%\Claude\claude_desktop_config.json` (Windows) | [Claude Desktop MCP Setup](https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop) | | **Cursor** | `~/.cursor/mcp.json` or `.cursor/mcp.json` | [Cursor MCP Documentation](https://docs.cursor.com/context/model-context-protocol) | | **Eclipse IDE** | GitHub Copilot Chat -> Configure Tools -> MCP Servers | [Eclipse MCP Documentation](https://docs.github.com/en/copilot/how-tos/provide-context/use-mcp/extend-copilot-chat-with-mcp#configuring-mcp-servers-in-eclipse) | From 0e457f9ebaacaaa863dcc07e46a7d87badc4753a Mon Sep 17 00:00:00 2001 From: "Tom Meschter (from Dev Box)" Date: Tue, 7 Jul 2026 11:43:57 -0700 Subject: [PATCH 4/6] Remove plugin reference from Claude Code manual config table entry Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- servers/Azure.Mcp.Server/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/servers/Azure.Mcp.Server/README.md b/servers/Azure.Mcp.Server/README.md index d45890046e..a7f8d996ca 100644 --- a/servers/Azure.Mcp.Server/README.md +++ b/servers/Azure.Mcp.Server/README.md @@ -224,7 +224,7 @@ To verify the .NET version, run the following command in the terminal: `dotnet - | IDE | File Location | Documentation Link | |-----|---------------|-------------------| | **Amazon Q Developer** | `~/.aws/amazonq/mcp.json` (global)
`.amazonq/mcp.json` (workspace) | [AWS Q Developer MCP Guide](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/qdev-mcp.html) | -| **Claude Code** | Plugin (recommended): see [Claude Code](#claude-code)
Manual: `~/.claude.json` or `.mcp.json` (project) | [Claude Code MCP Configuration](https://code.claude.com/docs/en/mcp-quickstart#add-a-local-server) | +| **Claude Code** | `~/.claude.json` or `.mcp.json` (project) | [Claude Code MCP Configuration](https://code.claude.com/docs/en/mcp-quickstart#add-a-local-server) | | **Claude Desktop** | `~/.claude/claude_desktop_config.json` (macOS)
`%APPDATA%\Claude\claude_desktop_config.json` (Windows) | [Claude Desktop MCP Setup](https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop) | | **Cursor** | `~/.cursor/mcp.json` or `.cursor/mcp.json` | [Cursor MCP Documentation](https://docs.cursor.com/context/model-context-protocol) | | **Eclipse IDE** | GitHub Copilot Chat -> Configure Tools -> MCP Servers | [Eclipse MCP Documentation](https://docs.github.com/en/copilot/how-tos/provide-context/use-mcp/extend-copilot-chat-with-mcp#configuring-mcp-servers-in-eclipse) | From e329379639f43ddb4b1a0436948abcd26da0530e Mon Sep 17 00:00:00 2001 From: "Tom Meschter (from Dev Box)" Date: Tue, 7 Jul 2026 11:58:50 -0700 Subject: [PATCH 5/6] Reference PR number in CHANGELOG entry Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- servers/Azure.Mcp.Server/CHANGELOG.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/servers/Azure.Mcp.Server/CHANGELOG.md b/servers/Azure.Mcp.Server/CHANGELOG.md index cbd9c607d9..e1d593e977 100644 --- a/servers/Azure.Mcp.Server/CHANGELOG.md +++ b/servers/Azure.Mcp.Server/CHANGELOG.md @@ -12,7 +12,7 @@ The Azure MCP Server updates automatically by default whenever a new release com ### Other Changes -- Added Claude Code installation instructions to the Azure MCP Server README, covering installation of the Azure plugin from Anthropic's official `claude-plugins-official` marketplace. [[#1579](https://github.com/microsoft/mcp/issues/1579)] +- Added Claude Code installation instructions to the Azure MCP Server README. [[#3003](https://github.com/microsoft/mcp/pull/3003)] - Added a `CancellationToken` parameter to async methods to more `I[SomeService]` interfaces. [[#1133](https://github.com/microsoft/mcp/pull/1133)] ## 2.0.0-beta.3 (2025-11-11) From 921b8efe8437933d46c2a53b980bac9a0fbd4b94 Mon Sep 17 00:00:00 2001 From: "Tom Meschter (from Dev Box)" Date: Tue, 7 Jul 2026 13:04:48 -0700 Subject: [PATCH 6/6] Use changelog-entries YAML instead of editing CHANGELOG.md directly Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- servers/Azure.Mcp.Server/CHANGELOG.md | 1 - .../tmeschter-claude-code-install-instructions.yaml | 3 +++ 2 files changed, 3 insertions(+), 1 deletion(-) create mode 100644 servers/Azure.Mcp.Server/changelog-entries/tmeschter-claude-code-install-instructions.yaml diff --git a/servers/Azure.Mcp.Server/CHANGELOG.md b/servers/Azure.Mcp.Server/CHANGELOG.md index e1d593e977..b4be777647 100644 --- a/servers/Azure.Mcp.Server/CHANGELOG.md +++ b/servers/Azure.Mcp.Server/CHANGELOG.md @@ -12,7 +12,6 @@ The Azure MCP Server updates automatically by default whenever a new release com ### Other Changes -- Added Claude Code installation instructions to the Azure MCP Server README. [[#3003](https://github.com/microsoft/mcp/pull/3003)] - Added a `CancellationToken` parameter to async methods to more `I[SomeService]` interfaces. [[#1133](https://github.com/microsoft/mcp/pull/1133)] ## 2.0.0-beta.3 (2025-11-11) diff --git a/servers/Azure.Mcp.Server/changelog-entries/tmeschter-claude-code-install-instructions.yaml b/servers/Azure.Mcp.Server/changelog-entries/tmeschter-claude-code-install-instructions.yaml new file mode 100644 index 0000000000..7015e90ec5 --- /dev/null +++ b/servers/Azure.Mcp.Server/changelog-entries/tmeschter-claude-code-install-instructions.yaml @@ -0,0 +1,3 @@ +changes: + - section: "Other Changes" + description: "Added Claude Code installation instructions to the Azure MCP Server README, covering installation of the Azure plugin from Anthropic's official plugin marketplace."