PlugWiki
Azure MCP Server logo

Azure MCP Server: Setup for Claude Code, Cursor and Other Apps

Official · by MicrosoftLocal

Lets your assistant look up and manage resources in your Azure account, from storage and databases to App Service and monitoring.

This is Microsoft's Azure server, covering more than 45 Azure services in one install. It runs on your computer and uses the Azure account you are already signed in with, so it can do what your Azure permissions allow. That includes deleting virtual machines and other resources, so start it in read-only mode and give your account only the roles you need.

Good for

  • Azure developers who want Copilot, Claude or Cursor to find and inspect resources
  • Cloud engineers who check logs, metrics and settings from the chat
  • Teams that want read-only Azure answers without opening the portal

Works in

12 should work

Tap an app to see how to set it up and any known problems.

Install Azure MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the Azure MCP server to Claude Code. Run this command:
    
    claude mcp add azure-mcp-server -- npx -y @azure/mcp@latest server start
    
    Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js, Azure sign-in (az login).

Read-only mode: Add --read-only after "server start" in the command.

The command must end with server start. Without it, the package does not start the MCP server. Sign in with az login first. Add --read-only after start to block changes.

From the project README. Source.

Tools

  • Lists your resource groups

    Lists the resource groups in a subscription.

    Try: “List the resource groups in my subscription.”

    Network · azmcp group list

  • Lists the resources in a group

    Lists everything inside one resource group.

    Try: “What is in the resource group my-rg?”

    Network · azmcp group resource list

  • Lists your storage accounts

    Lists the Azure Storage accounts in a subscription.

    Try: “List my Azure Storage accounts.”

    Network · azmcp storage account list

  • Lists Cosmos DB accounts

    Lists Cosmos DB accounts in a subscription.

    Try: “Which Cosmos DB accounts do I have?”

    Network · azmcp cosmos list

  • Queries items in a Cosmos DB container

    Runs a query against items in a Cosmos DB container.

    Try: “Query the orders container for items from today.”

    Network · azmcp cosmos database container item query

  • Shows App Service web apps

    Gets details of web apps in a subscription or resource group.

    Try: “Show details of my web app.”

    Network · azmcp appservice webapp get

  • Changes web app settings

    Updates app settings on an App Service web app.

    Try: “Add the setting LOG_LEVEL=debug to my web app.”

    Write · azmcp appservice webapp settings update-appsettings

  • Starts, stops or restarts a web app

    Changes the running state of an App Service web app.

    Try: “Restart my web app.”

    Write · azmcp appservice webapp change-state

  • Shows Kubernetes clusters

    Gets details of Azure Kubernetes Service clusters.

    Try: “Show my AKS clusters.”

    Network · azmcp aks cluster get

  • Reads a Key Vault secret

    Gets a secret from an Azure Key Vault.

    Try: “Get the secret db-password from my vault.”

    Network · azmcp keyvault secret get

  • Creates a Key Vault secret

    Stores a new secret in an Azure Key Vault.

    Try: “Create a secret api-key in my vault.”

    Write · azmcp keyvault secret create

  • Reads Azure Monitor metrics

    Queries metrics for a resource.

    Try: “Show CPU usage for my VM over the last 24 hours.”

    Network · azmcp monitor metrics query

From the official docs

Permissions

high risk · 4 things to watch · 1 advisory

High risk

It can create, change and delete real Azure resources, limited only by the roles on your account. Turn on read-only mode and use an account with the least access that gets the job done.

What it can do

Watch out for

  • It can delete VMs, disks and other resources

    The command reference lists delete commands for virtual machines, disks, Event Hubs and more. Use read-only mode unless you need changes.

  • It can read and create Key Vault secrets

    Secret values pass through the assistant. Limit Key Vault access on the account you use.

  • The README warns about destructive actions

    Microsoft says autonomous or misconfigured clients may do destructive things and asks you to apply least-privilege roles first.

  • Telemetry is on by default

    The README says usage data goes to Microsoft unless you turn telemetry off as described there.

Security advisories

Technical details
Turning on read-onlyStart the server with the --read-only flag.
Talks toAzure APIs. Microsoft (telemetry is on by default and can be turned off)
Scopes
  • Your Azure sign-in and its role assignments (RBAC)

Questions

Is the Azure MCP server official?

Yes. Microsoft publishes it in its open-source MCP repository.

Does it need an API key?

No. It uses your Azure sign-in, so run az login first. What it can do depends on your Azure roles.

Can I run it read-only?

Yes. Start the server with the --read-only flag. The README says some safeguards like this are not standard in MCP, so not every app handles them the same way.

Which apps does it work with?

The README gives setup for VS Code, Visual Studio, IntelliJ, Eclipse, Claude Code, GitHub Copilot CLI and others. Any app that can start a local server should work.

Does it run on my computer or in the cloud?

It runs on your computer. You can also host it yourself as a remote server on Azure Container Apps, which the README covers.

Does it support Azure China or US Government?

Yes. Start it with the --cloud option or set the AZURE_CLOUD variable. Sign in to that cloud first.

Does the tool list on this page show every tool?

No. It shows 16 example commands out of the hundreds in Microsoft's command reference, so it is a partial list. The names are command paths such as azmcp storage account list, not the tool names your app shows. The server groups tools by Azure service, so what your assistant sees depends on your version and settings.

Information

updated Nov 2, 2026

Publisher
Microsoft (official)
Package
@azure/mcp
Registry
npm
Transport
stdio
Version
3.0.0-beta.48
License
MIT
Last commit
Oct 30, 2026
Open issues
231
Listed in
Official MCP registry

WebsiteDocsGitHubnpmOfficial MCP RegistryChangelogIssues

Other Microsoft Azure MCP servers

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 2
  1. Azure MCP Server README · github.com
  2. Azure MCP command reference · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.