Skip to content
Cloud InfrastructureClaude Desktop Guide

Azure Media - Mediagraphs Claude Desktop Integration

This guide explains how to configure Claude Desktop (Mac and Windows) to use the Azure Media - Mediagraphs API through the Model Context Protocol (MCP). The integration exposes 8 API endpointsas callable tools inside Claude's chat interface, including List Media Graphs, Get a Media Graph, Create or update a Media Graph, 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

ClientClaude Desktop
Runtimenpx
AuthenticationNone
Setup Time~30 sec

Setup Instructions

1

Open Claude Settings

Launch Claude Desktop, open Settings (click your profile) → Developer → click 'Edit Config'.

2

Locate configuration file

This opens your local 'claude_desktop_config.json' file in your system editor.

3

Insert Server Config JSON

Paste the JSON configuration schema block (provided below) into the 'mcpServers' object.

4

Add authentication credentials

No credentials needed; leave the 'env' mapping empty.

5

Restart Claude app

Save the config file and restart Claude Desktop to load your new tools.

Configuration JSON

claude_desktop_config.json

Copy and paste this config snippet inside your local configuration file.

{
  "mcpServers": {
    "azure-com-mediaservices-mediagraphs": {
      "command": "npx",
      "args": [
        "-y",
        "@mcp/azure-com-mediaservices-mediagraphs"
      ],
      "env": {
        "AZURE_MEDIA_SERVICES_API_KEY": "your_azure_media_services_api_key"
      }
    }
  }
}

Required Environment Keys

Provide these variable keys in your local environment section:

AZURE_MEDIA_SERVICES_API_KEY

Replace your_azure_media_services_api_key with your secret key credentials.

Available Tools (8)

These endpoints are parsed from the OpenAPI schema and converted to Claude-compatible tools:

GET/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/mediaGraphs
List Media Graphs
GET/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/mediaGraphs/{mediaGraphName}
Get a Media Graph
PUT/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/mediaGraphs/{mediaGraphName}
Create or update a Media Graph
DELETE/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/mediaGraphs/{mediaGraphName}
Delete a Media Graph
GET/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/mediaGraphs/{mediaGraphName}/operationResults/{operationId}
Get the operation result
GET/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/mediaGraphs/{mediaGraphName}/operationsStatus/{operationId}
Get the operation status
POST/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/mediaGraphs/{mediaGraphName}/start
Start a Media Graph
POST/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/mediaGraphs/{mediaGraphName}/stop
Stop a Media Graph