Guía de configuración MCP de Words into Music

Esta guía reúne los ajustes exactos de conexión. Si utilizas ChatGPT o Claude, empieza por sus instrucciones con los menús de cada aplicación.

Ajustes de conexión

Copia la URL completa, incluido /mcp. La página de inicio, un enlace a una canción o localhost no sirven como dirección del conector. Nosotros alojamos el servidor; no tienes que instalar un servidor musical en tu equipo.

Conecta y comprueba antes de generar

1. Añade un servidor HTTP remoto en tu cliente e introduce la URL.
2. Elige OAuth. Si aparece la opción, utiliza la identidad publicada del cliente o el registro automático.
3. Inicia sesión en Words into Music, verifica tu correo si es necesario y revisa los permisos.
4. Vuelve al asistente y activa el conector para la conversación.
5. Pide que consulte tus créditos sin iniciar ninguna canción.

La respuesta debe distinguir créditos disponibles y reservados. Cero créditos reservados significa que no hay saldo retenido para una generación activa, no que las canciones anteriores fueran gratis.

Configuración opcional con Claude Code

Si ya utilizas Claude Code, su comando documentado para registrar un servidor HTTP es:

claude mcp add --transport http words-into-music https://mcp.wordsintomusic.com/mcp

Después abre /mcp dentro de Claude Code y autentica la conexión. Añade --scope user al registrarla para utilizarla en todos tus proyectos. Es una configuración documentada, no una prueba completa nuestra en Claude Code. Consulta su documentación MCP actual si cambia la interfaz de comandos.

Genera una sola grabación

Prepara el tema o la letra, el sonido, el idioma, la duración y la elección entre voz e instrumental. La preparación no descuenta saldo. Revisa la propuesta y aprueba una canción antes de llamar a start_song.

Prepara un instrumental de 60 segundos con piano suave y batería con escobillas para una tarde lluviosa. Consulta mi saldo, muestra la propuesta y el coste de un crédito, y espera mi aprobación. Si hay un tiempo de espera agotado, no crees otra canción.

Un cliente de desarrollo debe conservar un requestId estable, el preparedRequestId y el jobId devuelto. Si el inicio agota el tiempo de espera, repite el mismo identificador preparado. Una preparación nueva puede acabar generando otro cargo.

Consulta get_song_job como máximo una vez cada 15 segundos. Al terminar recibirás el enlace privado. Para trabajar con tu letra, consulta antes la guía de letra a canción.

Soluciona los problemas habituales

El asistente no encuentra las herramientas

Una conexión guardada puede estar desactivada en el chat. En Claude, abre el menú del signo más, entra en Connectors y actívala. En ChatGPT, selecciona el complemento con @ cuando un mensaje necesite una llamada nueva. También puedes actualizar las herramientas o abrir otra conversación.

El acceso se repite o se deniega

Termina OAuth en el mismo flujo del navegador. No copies direcciones de retorno a otro navegador ni códigos al chat. Vuelve a conectar desde la configuración del cliente si la sesión caducó. Tras desconectar en Words into Music, los tokens antiguos deben dejar de funcionar.

No hay créditos o ya hay una canción en curso

Comprueba el saldo compartido en Facturación. MCP no puede comprar un plan. Espera a que termine el trabajo existente; no crees solicitudes para saltarte el límite.

El enlace dice que la grabación es privada

Accede con la misma cuenta que aprobó la conexión. El enlace no concede acceso público ni permite leer canciones de otra cuenta.

Retira el acceso

En Configuración, abre Aplicaciones conectadas y desconecta el cliente. Las llamadas nuevas se bloquean de inmediato. Desconéctalo también en el asistente. En las pruebas reales, tanto ChatGPT como Claude devolvieron MCP_ACCESS tras revocar la conexión.

El resumen MCP detalla herramientas y costes. La guía de Grok separa el conector web de la integración API. La especificación de autorización MCP explica el protocolo.