Azure + Roo Code: Complete MCP Integration

Azure is a MCP server that The Azure MCP Server gives MCP Clients access to key Azure services and tools like Azure Storage, Cosmos DB, the Azure CLI, and more..

When integrated with Roo Code, you can:

• Access Azure functionality through Roo Code

This guide provides step-by-step instructions to set up Azure in Roo Code, including configuration, examples, and troubleshooting.

What You'll Achieve

After completing this setup:

• Azure will be fully integrated and operational
• You can use Azure tools directly in Roo Code
• All Azure capabilities will be available for your workflows

Prerequisites

Before starting, ensure you have:

• Roo Code installed and configured
• Compatible operating system (Windows, macOS, Linux)

Installation

Step 1: Install Azure

Configuration

Step 2: Configure Roo Code

1. Locate your configuration file:

   • Windows: %USERPROFILE%\.roo\mcp_settings.json
   • macOS: ~/.roo/mcp_settings.json
   • Linux: ~/.roo/mcp_settings.json

2. Add server configuration:

{
  "mcpServers": {
    "azure": {
      "command": "npx",
      "args": ["-y", "azure"],
      "env": {
        
      }
    }
  }
}

3. Restart Roo Code

Completely quit and restart Roo Code to load the new configuration.

Examples

Once configured, you can use Azure in Roo Code:

Testing Your Setup

1. Start a new conversation in Roo Code
2. Ask Roo Code to list available tools
3. Try using Azure functionality

Test prompts:

• "Type @ and verify Azure appears in the tools list"
• "Ask: "Use Azure to help with my task""
• "Check Roo Code output panel for server connection status"

Troubleshooting

Common Issues

MCP Server Not Connecting

Symptoms: Server not appearing in tools list, Connection timeout, MCP tools unavailable

Cause: Incorrect configuration or server not starting

Solution:

• Verify mcp_settings.json syntax is correct
• Check that Node.js and npx are installed and in PATH
• View Roo Code output panel for error messages
• Test server command manually in terminal: npx -y {server_id}
• Ensure environment variables are properly set

Permission Denied Errors

Symptoms: Cannot execute commands, File access denied, Terminal commands blocked

Cause: Roo Code requires explicit permission for file and command operations

Solution:

• Review and approve permission requests when prompted
• Check VS Code workspace trust settings
• Enable necessary permissions in Roo Code settings
• Verify file and folder permissions on your system

API Key or Model Issues

Symptoms: Authentication failed, Model not responding, No AI completions

Cause: AI model API key not configured or invalid

Solution:

• Verify API key is correctly set in Roo Code settings
• Check API key has sufficient credits/quota
• Test with a different AI model provider
• Review Roo Code output panel for API error details

Custom Mode Not Working with MCP

Symptoms: MCP tools not available in custom mode, Mode cannot access server

Cause: Custom mode configuration does not include MCP tool permissions

Solution:

• Edit custom mode configuration to include MCP tools
• Add "Use MCP" to available tools in mode definition
• Ensure mode has appropriate permissions for external tools
• Test with default mode first to verify MCP server works

Extension Conflicts

Symptoms: Roo Code not responding, VS Code performance issues, Unexpected behavior

Cause: Conflicts with other AI coding extensions

Solution:

• Disable other AI coding extensions (Cline, Continue, etc.)
• Restart VS Code after disabling conflicting extensions
• Check VS Code extension logs for conflict errors
• Use only one AI coding assistant extension at a time

Azure not appearing in Roo Code

Symptoms: Server not listed, Tools not available

Cause: Configuration or installation issue

Solution:

• Verify configuration syntax
• Check Azure installation
• Restart Roo Code
• Check logs for error messages

Next Steps

Now that Azure is integrated with Roo Code:

• Explore all Azure capabilities through Roo Code
• Check out other MCP servers that work with Roo Code
• Join the MCP community for tips and support
• Consider contributing to Azure development

Need Help?

• Search for Azure documentation
• Check the Roo Code MCP guide
• Join the MCP community discussions