# Guida alla configurazione MCP per Words into Music [llms.txt](https://wordsintomusic.com/it/developers/llms.txt) > Configura una connessione MCP con OAuth, comprendi gli strumenti disponibili e risolvi i problemi comuni di accesso, crediti e generazione. Usa questa guida se hai un client MCP compatibile e desideri le impostazioni di connessione esatte. Se stai configurando [ChatGPT](https://wordsintomusic.com/it/make-songs-in-chatgpt/) o [Claude](https://wordsintomusic.com/it/make-songs-in-claude/), le loro guide mostrano prima i pulsanti e i menu. ## Impostazioni di connessione | Impostazione | Valore | | --- | --- | | Nome | Words into Music | | URL server remoto | `https://mcp.wordsintomusic.com/mcp` | | Trasporto | Streamable HTTP | | Autenticazione | OAuth | | Account | Il tuo account Words into Music verificato | 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 è: ```sh 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](https://code.claude.com/docs/en/mcp) 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](https://wordsintomusic.com/it/blog/how-to-turn-lyrics-into-a-song/) 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](https://wordsintomusic.com/app/billing/) 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](https://wordsintomusic.com/app/settings/), 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](https://wordsintomusic.com/it/mcp/) elenca ogni strumento e il suo costo. La [guida di Grok](https://wordsintomusic.com/it/make-songs-in-grok/) separa il connettore web documentato dalla configurazione API per sviluppatori. Per un background generale sul protocollo, leggi la [specifica di autorizzazione MCP](https://modelcontextprotocol.io/specification/2026-07-28/basic/authorization). 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. ## Domande frequenti ### Devo usare l'URL della homepage o l'URL MCP? Usa https://mcp.wordsintomusic.com/mcp. Mantieni il percorso finale /mcp e seleziona OAuth con Streamable HTTP. ### Devo installare un server locale? No. Words into Music ospita il server remoto. Il tuo assistente o client sviluppatore si connette ad esso tramite HTTPS. ### Cosa succede se riprovo una chiamata di avvio? Ripetere start_song con lo stesso preparedRequestId restituisce il lavoro esistente. Creare una nuova preparazione è una richiesta diversa e può spendere un altro credito. ### Perché il mio client restituisce MCP_ACCESS? La connessione all'account è mancante, revocata, scaduta o non più consentita. Riconnettiti tramite il normale flusso OAuth e rivedi l'account e le autorizzazioni richieste. ### La disconnessione può annullare una canzone? La disconnessione interrompe le nuove chiamate agli strumenti. Una generazione accettata prima della disconnessione continua, quindi potrai trovare la sua registrazione nella tua libreria in seguito.