Guida alla configurazione MCP per Words into Music

Usa questa guida se hai un client MCP compatibile e desideri le impostazioni di connessione esatte. Se stai configurando ChatGPT o Claude, le loro guide mostrano prima i pulsanti e i menu.

Impostazioni di connessione

Usa l'URL completo, incluso il /mcp finale. La homepage, un URL di una canzone e localhost non sono endpoint del connettore. Il server è ospitato per te; non c'è nessun server musicale da installare sul tuo computer.

Connetti e verifica prima di generare

1. Aggiungi un server HTTP remoto nel tuo client e inserisci l'URL sopra.
2. Scegli l'accesso OAuth. Usa l'identità pubblicata del client o la registrazione automatica se offerta.
3. Accedi a Words into Music, verifica la tua email se necessario e rivedi le autorizzazioni richieste.
4. Torna all'assistente e abilita il connettore per questa conversazione.
5. Chiedigli di controllare i tuoi crediti canzone disponibili senza avviare una canzone.

Il tuo primo controllo dovrebbe restituire i crediti disponibili, i crediti riservati e le lingue supportate. Zero crediti riservati significa che nessun credito è attualmente in sospeso per un lavoro in corso. Non significa che ogni canzone precedente fosse gratuita.

Configurazione terminale opzionale con Claude Code

Se usi già Claude Code, il suo comando di registrazione HTTP documentato è:

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

Quindi apri /mcp all'interno di Claude Code e autentica la connessione. Aggiungi --scope user durante la registrazione se vuoi che sia disponibile tra i progetti. Questa è una configurazione client documentata, non un'affermazione che abbiamo ripetuto il test di accettazione web di Claude in Claude Code. Fai riferimento alla documentazione MCP attuale di Claude Code se la CLI cambia.

Realizza una registrazione in sicurezza

Chiedi all'assistente di preparare un brief con il soggetto o i testi, il suono, la lingua, la durata e se desideri le voci. La preparazione non addebita il tuo portafoglio. Rivedi il brief e approva una canzone prima che l'assistente chiami start_song.

Prepara un brano strumentale di 60 secondi con pianoforte morbido e batteria spazzolata per un pomeriggio piovoso. Controlla il mio saldo, mostra il brief e il costo di un credito, e attendi la mia approvazione. Non avviare una seconda canzone se una richiesta va in timeout.

Un client sviluppatore dovrebbe mantenere un requestId stabile per la preparazione, quindi salvare il preparedRequestId e il jobId restituito. Ripeti un avvio in timeout con lo stesso ID preparato. Creare un'altra preparazione può portare a un'altra canzone a pagamento dopo che la prima è terminata.

Interroga get_song_job non più velocemente di ogni 15 secondi. Una risposta completata contiene il link privato della canzone. Aprilo nell'account che ha approvato la connessione. Preparare i testi prima di iniziare ti offre un riferimento migliore quando controlli la voce.

Se qualcosa va storto

L'assistente dice di non riuscire a vedere gli strumenti

Una connessione salvata può comunque essere disabilitata per una chat. In Claude, apri il menu con il simbolo '+', scegli Connettori e attiva Words into Music. In ChatGPT, seleziona il plugin con una @menzione quando un messaggio richiede una nuova chiamata a uno strumento. Aggiorna l'elenco degli strumenti o avvia una nuova conversazione se il tuo client ha memorizzato una lista precedente.

Loop di accesso o accesso negato

Completa OAuth nello stesso flusso del browser che hai avviato. Non copiare URL di callback in un altro browser o incollare codici di autorizzazione nella chat. Riconnettiti tramite le impostazioni del client se la connessione è scaduta. Se ti sei disconnesso da Words into Music, i vecchi token devono fallire finché non approvi una nuova connessione.

Nessun credito o un altro lavoro è in corso

Apri Fatturazione per controllare il portafoglio condiviso. MCP non può acquistare un piano. Se un'altra canzone è già in esecuzione, controlla quel lavoro o torna a Le mie canzoni. Non creare nuove richieste per aggirare il limite.

La pagina si apre ma la registrazione è privata

Accedi allo stesso account Words into Music utilizzato durante il consenso. Il link non concede l'accesso pubblico. Un assistente non può leggere le canzoni di un altro account semplicemente indovinando un ID.

Rimuovi l'accesso quando hai finito

Apri Impostazioni, trova App connesse e scegli Disconnetti per il client. Le nuove chiamate si interrompono immediatamente. Disconnettiti anche nell'assistente per rimuovere la sua sessione memorizzata. Nei nostri test di produzione, sia ChatGPT che Claude hanno restituito MCP_ACCESS alla loro successiva lettura dell'account dopo la revoca del sito web.

La nostra panoramica MCP elenca ogni strumento e il suo costo. La guida di Grok separa il connettore web documentato dalla configurazione API per sviluppatori. Per un background generale sul protocollo, leggi la specifica di autorizzazione MCP.

Se hai bisogno di crediti, chiedi all'assistente di mostrarti le offerte attuali. Dopo aver scelto, create_checkout_link apre il checkout di Stripe per il tuo account connesso senza un altro accesso al sito web. Completa il pagamento su Stripe, quindi chiedi all'assistente di controllare il tuo saldo e riprovare la richiesta di canzone salvata. L'assistente non può addebitarti automaticamente o modificare il tuo abbonamento esistente.