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.

Establece la URL Streamable HTTP en https://mcp.audiodelivery.net/mcp.
Al conectar, inicia sesión en account.audiodeliverynetwork.com, elige una organización y permite.
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`	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, 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. Paquete: @audiodn/mcp en npm.