Azure Recovery Backup - BMS Claude Desktop Integration
This guide explains how to configure Claude Desktop (Mac and Windows) to use the Azure Recovery Backup - BMS API through the Model Context Protocol (MCP). The integration exposes 10 API endpointsas callable tools inside Claude's chat interface, including BackupEngines_List, BackupEngines_Get, ProtectionContainerRefreshOperationResults_Get, and more. No API keys or credentials are needed — setup takes approximately 30 seconds. The server runs locally via npx and communicates over STDIO transport. Paste the JSON configuration below into your claude_desktop_config.json file to get started.
Integration Specs
Setup Instructions
Open Claude Settings
Launch Claude Desktop, open Settings (click your profile) → Developer → click 'Edit Config'.
Locate configuration file
This opens your local 'claude_desktop_config.json' file in your system editor.
Insert Server Config JSON
Paste the JSON configuration schema block (provided below) into the 'mcpServers' object.
Add authentication credentials
No credentials needed; leave the 'env' mapping empty.
Restart Claude app
Save the config file and restart Claude Desktop to load your new tools.
Configuration JSON
claude_desktop_config.jsonCopy and paste this config snippet inside your local configuration file.
{
"mcpServers": {
"azure-com-recoveryservicesbackup-bms": {
"command": "npx",
"args": [
"-y",
"@mcp/azure-com-recoveryservicesbackup-bms"
],
"env": {
"RECOVERYSERVICESBACKUPCLIENT_API_KEY": "your_recoveryservicesbackupclient_api_key"
}
}
}
}Required Environment Keys
Provide these variable keys in your local environment section:
RECOVERYSERVICESBACKUPCLIENT_API_KEYReplace your_recoveryservicesbackupclient_api_key with your secret key credentials.
Available Tools (10)
These endpoints are parsed from the OpenAPI schema and converted to Claude-compatible tools:
/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupEngines/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupEngines/{backupEngineName}/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/operationResults/{operationId}/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectableContainers/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/inquire/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/items/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/operationResults/{operationId}