INTEGRACIONES / MCP

MCP para clonación de voz y texto a voz

Lleva tus voces a tu flujo de trabajo con IA. El servidor MCP de Vocloner permite consultar tu biblioteca, generar locuciones y clonar voces autorizadas desde un cliente compatible.

El acceso depende de la activación del servicio. Si no ves Conexiones MCP en tu cuenta, consulta con soporte antes de configurar un cliente.

Conecta tu cliente, conserva el control

MCP (Model Context Protocol) conecta un asistente con herramientas de otros servicios. En Vocloner, esas herramientas trabajan con tu cuenta y tus cuotas; la integración no requiere entregar claves de otros proveedores de IA.

Abre Cuenta → Conexiones MCP y usa la URL del servicio indicada allí. El cliente debe admitir Streamable HTTP y OAuth o un token Bearer. La compatibilidad depende del cliente y su versión.

  • OAuth: revisa el destino y los permisos en el navegador antes de autorizar. El nombre declarado por el cliente no verifica su identidad.
  • API key: crea una clave con los permisos necesarios y guárdala cuando se muestra. Las claves creadas desde la cuenta duran 30 días y se pueden revocar.
  • Guarda el secreto en el entorno o gestor de secretos del cliente. No lo pegues en chats ni en archivos públicos.

De la biblioteca a la locución

Las herramientas disponibles dependen de los permisos que concedas. Puedes empezar con lectura y habilitar generación o clonación solo cuando las necesites.

  • list_voices · Consulta tus voces y las voces públicas disponibles.
  • get_usage · Revisa plan, caracteres y espacios de voz disponibles.
  • clone_voice · Crea una voz privada con confirmación humana de autorización.
  • generate_speech · Convierte un guion en audio MP3 o WAV con una voz permitida.
  • get_audio · Obtén una URL de descarga que exige tu credencial.
  • get_operation · Consulta el resultado de una operación existente.

Un flujo concreto para tus guiones

Pedile al asistente que consulte las voces disponibles y la cuota antes de generar. Elige una voz, revisa el texto y autoriza la locución. Después, descarga el resultado desde un cliente que pueda enviar tu credencial en la cabecera Authorization.

Cada generación o clonación usa un operationId único. Si hay un timeout, consulta get_operation con ese mismo identificador antes de volver a intentar: crear otro identificador puede repetir el trabajo y consumir cuota.

1. list_voices + get_usage
2. generate_speech (voiceId, text, format, operationId)
3. get_operation (operationId)
4. get_audio (generationId)

Límites claros, las mismas reglas de uso

La generación conserva los límites del plan, la moderación y las comprobaciones de acceso a la voz. La integración no ofrece administración, facturación, borrado ni publicación de voces.

Para clonar por MCP, la muestra debe tener entre 5 y 270 segundos y un máximo de 2 MiB decodificados. La herramienta recibe audio en base64, no URLs remotas ni rutas de archivos. Para muestras mayores, usa la carga web.

  • El consentimiento para clonar debe venir de la persona autorizada; un archivo adjunto no constituye permiso.
  • Las descargas de audio requieren autenticación y verifican la propiedad.
  • Las credenciales vencidas o revocadas dejan de dar acceso a las herramientas y al audio.
FAQ

Antes de empezar

¿MCP tiene una cuota de voz independiente?

No. Las herramientas usan la cuenta y los límites de tu plan de Vocloner. Consulta get_usage o la página de precios antes de generar.

¿Funciona con cualquier asistente de IA?

Necesitas un cliente con Streamable HTTP y autenticación compatible. Los clientes que solo admiten stdio o SSE antiguo no bastan. Comprueba la conexión en tu versión del cliente.

¿Puedo publicar una voz desde MCP?

No. clone_voice crea voces privadas. La publicación se gestiona en la web y mantiene los requisitos de autorización y revisión.