Servidor MCP

El servidor MCP de VocalLab permite que herramientas de IA —Claude Desktop, Claude Code, Cursor, VS Code y otras— generen voz con tu cuenta a través del Model Context Protocol.

Ver el tutorial completo · en inglés

Requiere un plan Pro o superior. No necesitas una clave de API de antemano: la configuración crea una por ti.

Configuración más rápida (un clic)

En la página Desarrollador, abre Usar en herramientas de IA (MCP). Elige tu cliente y pulsa el único botón: genera una clave de API por ti y la conecta en un solo paso. No hay nada que copiar ni pegar.

Cliente	Botón	Qué ocurre
Cursor	Añadir a Cursor	Abre Cursor e instala el servidor de VocalLab directamente.
VS Code	Añadir a VS Code	Abre VS Code e instala el servidor directamente.
Claude Code	Copiar comando de instalación	Copia un comando `claude mcp add …`; pégalo en tu terminal o en un chat de Claude Code.
Claude Desktop	Descargar archivo de configuración	Guarda un `claude_desktop_config.json` listo para usar que puedes colocar en tu carpeta de configuración de Claude.

Tu nueva clave se muestra una sola vez en el aviso de la parte superior de la sección. Cópiala en un lugar seguro antes de salir de la página; por seguridad no podemos volver a mostrarla.

¿Prefieres configurarlo a mano? Cada cliente también tiene botones Copiar y Descargar en la vista previa de la configuración, para que pegues el fragmento donde quieras.

Usar VocalLab Studio

En VocalLab Studio, abre API y MCP en la barra lateral y cambia a la pestaña MCP — misma idea: genera una clave, elige tu cliente y conéctate. También admite Windsurf y cualquier otro cliente MCP mediante una configuración genérica.

Herramientas

get_balance — tu saldo de puntos
list_voices — voces que puedes usar
list_models — los modelos de voz (VocalLab Studio / Studio Flash / Pro / Lite)
generate_speech — texto → voz, devuelve una URL de audio. Acepta un model opcional (v-studio, v-flash, v-pro o v-lite)
get_speech — consultar una generación por id: estado + enlaces de descarga/streaming
get_captions — subtítulos SRT de una generación (líneas phrase o word palabra por palabra)
delete_speech — eliminar de forma permanente una generación de tu propiedad
design_voice — describe una voz con palabras y obtén hasta 3 previsualizaciones para escuchar
save_designed_voice — conserva una previsualización como voz permanente con la que generar
clone_voice — clona una voz a partir de una grabación breve (en base64)
list_voice_languages — idiomas y límites de grabación para clonar y diseñar
delete_voice — elimina definitivamente una de tus voces clonadas o diseñadas

Una vez conectado, pídele a tu asistente que "liste las voces de VocalLab", "genere voz con VocalLab" o "genere eso con el modelo VocalLab Studio". Consulta Modelos de voz para saber qué hace cada modelo.

Servidor alojado

Todas las opciones de un clic apuntan al servidor alojado; no hay nada que instalar ni ejecutar:

URL: https://mcp.vocallab.ai/mcp
Cabecera: Authorization: Bearer vl_live_...

Configuración manual (Claude Desktop y otros)

Esto es exactamente lo que produce el botón Descargar archivo de configuración. Añádelo a la configuración MCP de tu cliente:

{
  "mcpServers": {
    "vocallab": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.vocallab.ai/mcp", "--header", "Authorization: Bearer vl_live_..."]
    }
  }
}

El archivo de configuración de Claude Desktop se encuentra en:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Si el archivo ya existe, combina la entrada vocallab bajo mcpServers en lugar de reemplazarlo y, después, reinicia Claude Desktop.