Azure MCP Server

[!NOTE] Azure MCP Server 2.0 is now generally available.

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.

Table of Contents

• Overview
• Local Setup
• Developer Tools
• VS Code (Recommended)
• Visual Studio 2026
• Visual Studio 2022
• IntelliJ IDEA
• Eclipse IDE
• Google Antigravity
• Claude Code
• Manual Setup
• GitHub Copilot CLI Configuration
• GitHub Copilot SDK Configuration
• Package Manager
• NuGet
• NPM
• PyPI
• Docker
• MCPB
• Remote Setup
• Usage
• Getting Started
• Sovereign Cloud Support
• What can you do with the Azure MCP Server?
• Complete List of Supported Azure Services
• Support and Reference
• Documentation
• Feedback and Support
• Security
• Permissions and Risk
• Data Collection
• Compliance Responsibility
• Third Party Components
• Export Control
• No Warranty / Limitation of Liability
• Contributing
• Code of Conduct

Overview

Azure MCP Server supercharges your agents with Azure context across numerous Azure services.

Local Setup

Install Azure MCP Server using either an IDE extension or package manager. Choose one method below.

[!IMPORTANT] Authenticate to Azure before running the Azure MCP server. See the Authentication guide for authentication methods and instructions.

Developer Tools

Start using Azure MCP with your favorite IDE. We recommend VS Code:

VS Code (Recommended)

Compatible with both the Stable and Insiders builds of VS Code.

1. Install the GitHub Copilot Chat extension.
2. Install the Azure MCP Server extension.
3. Sign in to Azure (Command Palette: Azure: Sign In).

Visual Studio 2026

1. Download Visual Studio 2026 or Visual Studio 2026 Insiders and install using the Visual Studio Installer.

• If Visual Studio 2026 is already installed, open the Visual Studio Installer and select the Modify button, which displays the available workloads.

1. On the Workloads tab, select Azure and AI development and select GitHub Copilot.
2. Click install while downloading to complete the installation.

For more information, visit Install GitHub Copilot for Azure in Visual Studio 2026

Visual Studio 2022

From within Visual Studio 2022 install GitHub Copilot for Azure (VS 2022):

1. Go to Extensions | Manage Extensions...
2. Switch to the Browse tab in Extension Manager
3. Search for Github Copilot for Azure
4. Click Install

IntelliJ IDEA

1. Install either the IntelliJ IDEA Ultimate or IntelliJ IDEA Community edition.
2. Install the GitHub Copilot plugin.
3. Install the Azure Toolkit for Intellij plugin.

Eclipse IDE

1. Install Eclipse IDE.
2. Install the GitHub Copilot plugin.
3. Install the Azure Toolkit for Eclipse plugin.

Google Antigravity

1. Install and open Google Antigravity.
2. In the editor's agent side panel, select ... > MCP Servers > Manage MCP Servers > View raw config.
3. Add Azure MCP Server to the mcpServers object in mcp_config.json:

     {
         "mcpServers": {
             "azure-mcp-server": {
                 "command": "npx",
                 "args": ["-y", "@azure/mcp@latest", "server", "start"]
             }
         }
     }

Antigravity stores global configuration at ~/.gemini/config/mcp_config.json. For workspace-only configuration, use .agents/mcp_config.json. For more information, see the Google Antigravity MCP documentation.

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.
2. Install the Azure plugin from Anthropic's official plugin marketplace by running the following command in Claude Code:

   /plugin install azure@claude-plugins-official

For more information on discovering and installing plugins, see the Claude Code plugins documentation.

Manual Setup

Azure MCP Server can also be configured across other IDEs, CLIs, and MCP clients:

Use one of the following options to configure your mcp.json:

#### Option 1: Configure using .NET tool (dnx)

• To use Azure MCP server from .NET, you must have the latest .NET 10 SDK LTS installed. .NET 10 and later adds a command, dnx, which is used to download, install, and run the MCP server from nuget.org.

To verify the .NET version, run the following command in the terminal: dotnet --info

• Configure the mcp.json file with the following:

    {
        "mcpServers": {
            "azure-mcp-server": {
                "command": "dnx",
                "args": [
                    "Azure.Mcp",
                    "--source",
                    "https://api.nuget.org/v3/index.json",
                    "--yes",
                    "--",
                    "azmcp",
                    "server",
                    "start"
                ],
                "type": "stdio"
            }
        }
    }

#### Option 2: Configure using Node.js (npm/npx)

• To use Azure MCP server from node one must have Node.js (LTS) installed and available on your system PATH — this provides both npm and npx. We recommend the latest Node.js LTS version. To verify your installation run: node --version, npm --version, and npx --version.
• Configure the mcp.json file with the following:

    {
        "mcpServers": {
            "azure-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@azure/mcp@latest",
                "server",
                "start"
                ]
            }
        }
    }