# Connecter MCP | Docs AudioDN

> OAuth hébergé, en-têtes de clé API hérités, variables d’environnement stdio locales et configs client pour Cursor, Claude Desktop, Claude Code, VS Code et Codex.

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

---

# Connecter MCP

Pointez un client MCP compatible vers l’endpoint hébergé (OAuth) ou lancez le package stdio local avec une clé API Access.

## OAuth hébergé (recommandé)

Ajoutez l’URL MCP distante **sans** clé API dans la config client. Les clients compatibles découvrent les métadonnées de ressource protégée OAuth et terminent authorization code + PKCE contre `mcp.audiodelivery.net`.

1.  Définissez l’URL Streamable HTTP sur `[https://mcp.audiodelivery.net/mcp](https://mcp.audiodelivery.net/mcp)`.
    
2.  À la connexion, connectez-vous sur [account.audiodeliverynetwork.com](https://account.audiodeliverynetwork.com), choisissez une organisation et autorisez.
    
3.  Le consentement crée une clé API Access révocable `MCP · …` sous Paramètres → Clés API. Supprimez cette clé pour déconnecter.
    

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

#### Les outils hébergés exigent toujours l’auth

Les requêtes non authentifiées vers `/mcp` renvoient `401` avec `WWW-Authenticate`. Les outils de connaissances et en direct (y compris les deletes) exigent OAuth ou une clé API héritée sur l’endpoint hébergé.

Les endpoints de découverte sur l’hôte MCP incluent `/.well-known/oauth-protected-resource` et `/.well-known/oauth-authorization-server`. Le scope d’autorisation est `account`. Les clients avec Dynamic Client Registration utilisent `POST /register` sur le même hôte.

## Clé API hébergée héritée

Les configs qui envoient encore une clé API Access continuent de fonctionner :

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

## stdio local

Lancez `npx -y @audiodn/mcp`. Les outils de connaissances fonctionnent sans clé. Pour les outils d’API en direct, définissez une clé API Access côté serveur depuis le tableau de bord (Paramètres → Clés API).

| Variable | Requise | Défaut | Rôle |
| --- | --- | --- | --- |
| `ADN_API_KEY` | Non | — | Clé API Access pour les outils d’API en direct |
| `ADN_API_BASE_URL` | Non | `[https://api.audiodelivery.net](https://api.audiodelivery.net)` | Remplacer l’hôte API |
| `ADN_MCP_LIVE_DOCS` | Non | off | Mettre `1` pour rafraîchir les docs regroupés depuis le site public au démarrage |
| `ADN_MCP_TIMEOUT_MS` | Non | `30000` | Délai par requête en millisecondes |

## Cursor

Settings → Tools & Integrations → MCP, ou éditez `~/.cursor/mcp.json`.

**Hébergé (OAuth) :**

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

**stdio local :**

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

Installation guidée ? Commencez sur [Développer avec l’IA](/fr/explore/ai), qui inclut des deeplinks Cursor.

## Claude Desktop

Éditez `~/Library/Application Support/Claude/claude_desktop_config.json` (ou l’équivalent sur votre OS), puis redémarrez :

```
{
"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)

Ajoutez à `.vscode/mcp.json` :

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

## Codex

Dans `~/.codex/config.toml` :

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

Suite : [Outils et ressources](/docs/mcp/tools). Package : [@audiodn/mcp](https://www.npmjs.com/package/@audiodn/mcp) sur npm.