# MCP verbinden | AudioDN Docs

> Gehostetes OAuth, Legacy-API-Key-Header, lokale stdio-Umgebungsvariablen und Client-Konfigurationen für Cursor, Claude Desktop, Claude Code, VS Code und Codex.

Source: https://audiodeliverynetwork.com/de/docs/mcp/connect/

---

# 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](https://mcp.audiodelivery.net/mcp)` setzen.
    
2.  Beim Verbinden bei [account.audiodeliverynetwork.com](https://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).

| Variable | Erforderlich | Standard | Zweck |
| --- | --- | --- | --- |
| `ADN_API_KEY` | Nein | — | API-Access-Schlüssel für Live-API-Tools |
| `ADN_API_BASE_URL` | Nein | `[https://api.audiodelivery.net](https://api.audiodelivery.net)` | API-Host überschreiben |
| `ADN_MCP_LIVE_DOCS` | Nein | aus | Auf `1` setzen, um gebündelte Docs beim Start von der öffentlichen Site zu aktualisieren |
| `ADN_MCP_TIMEOUT_MS` | Nein | `30000` | Timeout 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](/de/explore/ai) — 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](/docs/mcp/tools). Paket: [@audiodn/mcp](https://www.npmjs.com/package/@audiodn/mcp) auf npm.