MCP verbinden

Richten Sie einen kompatiblen MCP-Client auf den gehosteten Endpoint (OAuth) oder starten Sie das lokale stdio-Paket mit einem API-Access-Schlüssel.

Gehostetes OAuth (empfohlen)

Fügen Sie die Remote-MCP-URL ohne API-Schlüssel in der Client-Konfiguration hinzu. Kompatible Clients entdecken OAuth Protected-Resource-Metadaten und schließen Authorization Code + PKCE gegen mcp.audiodelivery.net ab.

  1. Streamable-HTTP-URL auf https://mcp.audiodelivery.net/mcp setzen.

  2. Beim Verbinden bei account.audiodeliverynetwork.com anmelden, Organisation wählen und erlauben.

  3. Die Zustimmung erzeugt einen widerrufbaren API-Access-Schlüssel MCP · … unter Einstellungen → API-Schlüssel. Löschen Sie diesen Key zum Trennen.

{
"mcpServers": {
  "audiodn": {
    "url": "https://mcp.audiodelivery.net/mcp"
  }
}
}

Gehostete Tools erfordern immer Auth

Nicht authentifizierte Anfragen an /mcp liefern 401 mit WWW-Authenticate. Knowledge- und Live-Tools (inkl. Deletes) erfordern OAuth oder einen Legacy-API-Key auf dem gehosteten Endpoint.

Discovery-Endpunkte auf dem MCP-Host umfassen /.well-known/oauth-protected-resource und /.well-known/oauth-authorization-server. Der Authorization-Scope ist account. Clients mit Dynamic Client Registration nutzen POST /register auf demselben Host.

Legacy gehosteter API-Key

Konfigurationen, die weiterhin einen API-Access-Schlüssel senden, funktionieren weiter:

Authorization: Bearer adn_...
# or
X-ADN-API-Key: adn_...

Lokales stdio

Führen Sie npx -y @audiodn/mcp aus. Knowledge-Tools funktionieren ohne Key. Für Live-API-Tools setzen Sie einen serverseitigen API-Access-Schlüssel aus dem Dashboard (Einstellungen → API-Schlüssel).

VariableErforderlichStandardZweck
ADN_API_KEYNein—API-Access-Schlüssel für Live-API-Tools
ADN_API_BASE_URLNeinhttps://api.audiodelivery.netAPI-Host überschreiben
ADN_MCP_LIVE_DOCSNeinausAuf 1 setzen, um gebündelte Docs beim Start von der öffentlichen Site zu aktualisieren
ADN_MCP_TIMEOUT_MSNein30000Timeout pro Anfrage in Millisekunden

Cursor

Settings → Tools & Integrations → MCP, oder ~/.cursor/mcp.json bearbeiten.

Gehostet (OAuth):

{
"mcpServers": {
  "audiodn": {
    "url": "https://mcp.audiodelivery.net/mcp"
  }
}
}

Lokales stdio:

{
"mcpServers": {
  "audiodn": {
    "command": "npx",
    "args": ["-y", "@audiodn/mcp"],
    "env": { "ADN_API_KEY": "adn_..." }
  }
}
}

Geführte Installation? Starten Sie bei Mit KI entwickeln — inkl. Cursor-Deeplinks.

Claude Desktop

Bearbeiten Sie ~/Library/Application Support/Claude/claude_desktop_config.json (oder das Äquivalent Ihres OS), dann neu starten:

{
"mcpServers": {
  "audiodn": {
    "command": "npx",
    "args": ["-y", "@audiodn/mcp"],
    "env": { "ADN_API_KEY": "adn_..." }
  }
}
}

Claude Code

claude mcp add audiodn --env ADN_API_KEY=adn_... -- npx -y @audiodn/mcp

VS Code (Copilot)

In .vscode/mcp.json hinzufügen:

{
"servers": {
  "audiodn": {
    "command": "npx",
    "args": ["-y", "@audiodn/mcp"],
    "env": { "ADN_API_KEY": "adn_..." }
  }
}
}

Codex

In ~/.codex/config.toml:

[mcp_servers.audiodn]
command = "npx"
args = ["-y", "@audiodn/mcp"]
env = { ADN_API_KEY = "adn_..." }

Weiter: Tools & Ressourcen. Paket: @audiodn/mcp auf npm.