Skip to main content

Command Palette

Search for a command to run...

Replace your Azure DevOps with Claude

Updated
6 min readView as Markdown
Replace your Azure DevOps with Claude

Introduction

Claude and cloud goes together like peanut butter and jelly. As of July 2026, the easiest way to use Claude for DevOps work on Azure is the two official Microsoft Azure MCP servers. Microsoft separates its MCP Server into two implementations: the Azure Learn MCP Server for documentation and Azure Developer MCP Server for transactions.

Once you complete this setup, Claude will be your Azure subject matter expert on Azure Well-Architected best practices.

Setup: Learn MCP Server

  1. Add Azure MCP plugin
    Start claude and enter the commands below to install the Azure Learn MCP server plugin
/plugin marketplace add microsoftdocs/mcp
/plugin install microsoft-docs@microsoft-docs-marketplace
  1. Connect the plugin
    Type the command below to start using the Azure Learn MCP server in Claude
/reload-plugins

The Learn MCP server is free to the public and does not require authentication.

Alternatively, if you choose to manually configure the Claude JSON configuration file, below is the mcpServers block.

{
  "mcpServers": {
    "microsoft-learn": {
      "type": "http",
      "url": "https://learn.microsoft.com/api/mcp"
    }
  }
}

Setup: Developer MCP Server

  1. Create Entra Accounts for AI
    For infrastructure safety, do not use your regular Azure login for your AI agents. Create separate read-only and read-write Azure Entra IDs for each of your subscriptions. For this example, I created 2 IDs: ai-readonly and ai-readwrite.

    For the read-only ID, I assign it the Reader built-in Azure role. For the read-write ID, I assign it the Owner role because for any realistic scenario, Claude will need to create and assign IAM. To prevent accidental infrastructure deletions, you can lock your resources or use Azure denyAction policies.

  2. Install npx
    npx is the Node.js Package Executor. It runs Node.js packages without installing it locally. The best way to install npx is via nvm (Node.js Version Manager)

    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.5/install.sh | bash
    source ~/.zshrc
    nvm install 24
    npx --version
    
  3. Configure Claude to use the Azure Developer MCP Server
    Run the command below to add the Azure Developer MCP Server to Claude AI.

    claude mcp add azure-mcp --scope user -- npx -y @azure/mcp@2.0.3 server start
    

    Confirm the Azure MCP was successfully added

    claude mcp list
    
  4. Sign into the Azure CLI
    The Azure Developer MCP Server uses the local Azure CLI (az), the Azure Developer CLI (azd), and the Azure Core Tools (func) to access and modify your Azure resources. Install or upgrade these CLI tools as needed.

    Sign in via az login to the correct Azure subscription with the proper Entra ID created on step one.

Behind the Scene

The Azure Model Context Protocol (MCP) Server acts as a translator between Claude and Azure. The Learn MCP Server searches the latest Microsoft Learn documentation for the most current answers. The Developer MCP Server configures the Azure CLI commands and executes it locally from your computer.

The Learn MCP server requires no authentication while the Developer MCP server uses the local az login Entra account.

Reduce Hallucinations

Claude's knowledge ends on the training date cutoff of the AI model. For example, Sonnet 4.6 training date cutoff was May 2025. If you ask Sonnet 4.6 about Azure HorizonDB](https://azure.microsoft.com/en-us/products/horizondb), it will think it is a fake product since it was first previewed in November 2025.

If you use the Azure Learn MCP server, Claude will use the most current Azure documentation and give you the correct answer about HorizonDB. (I do appreciate the little apology Claude gave me for the first wrong answer).

Claude for Observability

Claude can use your read-only Azure credentials to analyze your Azure infrastructure. As a simple example, I asked Claude to list all my storage accounts buckets. As other examples, you can ask Claude:

  • "Search Application Insights for errors from the Azure Function my-message-broker"

  • "Find all VMs using more than 90% CPU"

Claude as Azure Well-Architected Expert

Microsoft published an official set of AI Skills for Azure. The Azure MCP Servers automatically load these skills without you having to do any additional complicated setup.

Using Claude and the azure-functions skill, I was able to create and deploy an Azure Function coded with Node.js with full Azure Bicep infrastructure-as-code in about 8 minutes. If I did this by hand before AI, it would have taken me much longer than 8 minutes with equivalent results.

How expensive is this setup?

Good news, it's free (mostly).

The Azure MCP servers are free to use. Of course, you still pay for Claude token usage and any Azure resources created. You can estimate Azure cost via the official pricing calculator.

How secure is this setup?

This setup passed rigorous review by the Microsoft security team. In summary, the communication is end-to-end encrypted and uses your Entra ID permission setup. In addition, no information is permanently stored on Microsoft servers.

Monitoring your AI

Commands executed by the Azure MCP servers on your Azure subscription are auditable in Activity Monitor.

The Downsides

  • As an official Microsoft service, this AI setup uses azd and Azure Bicep as the infrastructure-as-code language. Like 97% of the DevOps community, you most likely use Terraform/OpenTofu. Additional steps are required to convert the answer into Terraform HCL

  • You may not like the answers if you disagree with the Azure Well-Architected framework.

  • Claude and most AI systems still offer questionable advice about Day 2 infrastructure operations such as upgrades and maintenance of existing resources. It will sometimes advise to delete infrastructure like databases instead of attempting to modify it.

What about GCP and AWS?

Check out our DevOps AI section for information how to set up MCP servers for GCP and AWS.

Conclusion

By powering up Claude with the Azure MCP Servers, it feels like having an Azure DevOps expert sit next to you and offer knowledgeable answers. On top of that, Claude can do the mundane task of creating, deploying, and monitoring Azure infrastructure. This frees you to concentrate on the important stuff, like creative ideas and business strategies.