# Conectar MCP | Docs de AudioDN

> OAuth alojado, cabeceras de API key heredadas, variables de entorno stdio locales y configs de cliente para Cursor, Claude Desktop, Claude Code, VS Code y Codex.

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

---

# Conectar MCP

Apunta un cliente MCP compatible al endpoint alojado (OAuth) o ejecuta el paquete stdio local con una API Access key.

## OAuth alojado (recomendado)

Añade la URL MCP remota **sin** API key en la configuración del cliente. Los clientes compatibles descubren metadatos de recurso protegido OAuth y completan authorization code + PKCE contra `mcp.audiodelivery.net`.

1.  Establece la URL Streamable HTTP en `[https://mcp.audiodelivery.net/mcp](https://mcp.audiodelivery.net/mcp)`.
    
2.  Al conectar, inicia sesión en [account.audiodeliverynetwork.com](https://account.audiodeliverynetwork.com), elige una organización y permite.
    
3.  El consentimiento crea una API Access key revocable `MCP · …` en Ajustes → Claves API. Elimina esa clave para desconectar.
    

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

#### Las herramientas alojadas siempre requieren auth

Las peticiones no autenticadas a `/mcp` devuelven `401` con `WWW-Authenticate`. Las herramientas de conocimiento y en vivo (incluidos deletes) requieren OAuth o una API key heredada en el endpoint alojado.

Los endpoints de descubrimiento en el host MCP incluyen `/.well-known/oauth-protected-resource` y `/.well-known/oauth-authorization-server`. El scope de autorización es `account`. Los clientes con Dynamic Client Registration usan `POST /register` en el mismo host.

## API key alojada heredada

Las configs que aún envían una API Access key siguen funcionando:

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

## stdio local

Ejecuta `npx -y @audiodn/mcp`. Las herramientas de conocimiento funcionan sin clave. Para herramientas de API en vivo, configura una API Access key de servidor desde el dashboard (Ajustes → Claves API).

| Variable | Requerida | Valor por defecto | Propósito |
| --- | --- | --- | --- |
| `ADN_API_KEY` | No | — | API Access key para herramientas de API en vivo |
| `ADN_API_BASE_URL` | No | `[https://api.audiodelivery.net](https://api.audiodelivery.net)` | Sobrescribir el host de la API |
| `ADN_MCP_LIVE_DOCS` | No | off | Pon `1` para refrescar los docs empaquetados desde el sitio público al arrancar |
| `ADN_MCP_TIMEOUT_MS` | No | `30000` | Timeout por petición en milisegundos |

## Cursor

Settings → Tools & Integrations → MCP, o edita `~/.cursor/mcp.json`.

**Alojado (OAuth):**

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

**stdio local:**

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

¿Instalación guiada? Empieza en [Crear con IA](/es/explore/ai), que incluye deeplinks de Cursor.

## Claude Desktop

Edita `~/Library/Application Support/Claude/claude_desktop_config.json` (o el equivalente en tu SO) y reinicia:

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

Añade a `.vscode/mcp.json`:

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

## Codex

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

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

Siguiente: [Herramientas y recursos](/docs/mcp/tools). Paquete: [@audiodn/mcp](https://www.npmjs.com/package/@audiodn/mcp) en npm.