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. This project is in Public Preview and implementation may significantly change prior to our General Availability.
✅ VS Code Install Guide (Recommended)refresh on the tools list
List my Azure Storage containers
The Azure MCP Server supercharges your agents with Azure context. Here are some cool prompts you can try:
Agents and models can discover and learn best practices and usage guidelines for the azd MCP tool. For more information, see AZD Best Practices.
For detailed command documentation and examples, see Azure MCP Commands.
🔄️ Upgrading Existing Installs to the Latest Version How to stay current with releases of Azure MCP ServerIf you use the default package spec of @azure/mcp@latest, npx will look for a new version on each server start. If you use just @azure/mcp, npx will continue to use its cached version until its cache is cleared.
If you globally install the cli via npm install -g @azure/mcp it will use the installed version until you manually update it with npm update -g @azure/mcp.
There is no version update built into the docker image. To update, just pull the latest from the repo and repeat the docker installation instructions.
Installation in VS Code should be in one of the previous forms and the update instructions are the same. If you installed the mcp server with the npx command and -y @azure/mcp@latest args, npx will check for package updates each time VS Code starts the server. Using a docker container in VS Code has the same no-update limitation described above.
Microsoft publishes an official Azure MCP Server Docker container on the Microsoft Artifact Registry.
For a step-by-step Docker installation, follow these instructions:
Create an .env file with environment variables that match one of the EnvironmentCredential sets. For example, a .env file using a service principal could look like:
AZURE_TENANT_ID={YOUR_AZURE_TENANT_ID}
AZURE_CLIENT_ID={YOUR_AZURE_CLIENT_ID}
AZURE_CLIENT_SECRET={YOUR_AZURE_CLIENT_SECRET}Add .vscode/mcp.json or update existing MCP configuration. Replace /full/path/to/.env with a path to your .env file.
{
"servers": {
"Azure MCP Server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"--env-file",
"/full/path/to/.env"
"mcr.microsoft.com/azure-sdk/azure-mcp:latest",
]
}
}
}Optionally, use --env or --volume to pass authentication values.
You can easily configure your MCP client to use the Azure MCP Server. Have your client run the following command and access it via standard IO.
npx -y @azure/mcp@latest server start🔧 Manual Install Steps (Optional)
For a step-by-step installation, follow these instructions:
Add .vscode/mcp.json:
{
"servers": {
"Azure MCP Server": {
"command": "npx",
"args": [
"-y",
"@azure/mcp@latest",
"server",
"start"
]
}
}
}
You can optionally set the --namespace <namespace> flag to install tools for the specified Azure product or service.
Add .vscode/mcp.json:
{
"servers": {
"Azure Best Practices": {
"command": "npx",
"args": [
"-y",
"@azure/mcp@latest",
"server",
"start",
"--namespace",
"bestpractices" // Any of the available MCP servers can be referenced here.
]
}
}
}More end-to-end MCP client/agent guides are coming soon!
The software may collect information about you and your use of the software and send it to Microsoft. Microsoft may use this information to provide services and improve our products and services. You may turn off the telemetry as described in the repository. There are also some features in the software that may enable you and Microsoft to collect data from users of your applications. If you use these features, you must comply with applicable law, including providing appropriate notices to users of your applications together with a copy of Microsoft's privacy statement. You can learn more about data collection and use in the help documentation and our privacy statement. Your use of the software operates as your consent to these practices.
Telemetry collection is on by default.
To opt out, set the environment variable AZURE_MCP_COLLECT_TELEMETRY to false in your environment.
See Troubleshooting guide for help with common issues and logging.
Authentication options including DefaultAzureCredential flow, RBAC permissions, troubleshooting, and production credentialsThe Azure MCP Server uses the Azure Identity library for .NET to authenticate to Microsoft Entra ID. For detailed information, see Authentication Fundamentals.
If you're running into any issues with authentication, visit our troubleshooting guide.
For enterprise authentication scenarios, including network restrictions, security policies, and protected resources, see Authentication Scenarios in Enterprise Environments.
Your credentials are always handled securely through the official Azure Identity SDK - we never store or manage tokens directly.
MCP as a phenomenon is very novel and cutting-edge. As with all new technology standards, consider doing a security review to ensure any systems that integrate with MCP servers follow all regulations and standards your system is expected to adhere to. This includes not only the Azure MCP Server, but any MCP client/agent that you choose to implement down to the model provider.
We welcome contributions to the Azure MCP Server! Whether you're fixing bugs, adding new features, or improving documentation, your contributions are welcome.
Please read our Contributing Guide for guidelines on:
This project has adopted the Microsoft Open Source Code of Conduct. For more information, see the Code of Conduct FAQ or contact open@microsoft.com with any additional questions or comments.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4