Configurer le MCP de Words into Music

Ce guide rassemble les réglages exacts pour un client MCP compatible. Les guides ChatGPT et Claude présentent d'abord les menus propres à chaque application.

Réglages de connexion

Copiez l'URL complète avec /mcp à la fin. La page d'accueil, un lien de chanson et localhost ne sont pas des adresses de connecteur. Nous hébergeons le serveur, vous n'avez pas à installer de serveur musical sur votre ordinateur.

Connectez-vous, puis vérifiez

1. Ajoutez un serveur HTTP distant dans votre client et saisissez l'URL.
2. Choisissez OAuth. Utilisez l'identité publiée du client ou l'enregistrement automatique si proposé.
3. Connectez-vous à Words into Music, vérifiez votre e-mail si nécessaire et examinez les autorisations.
4. Revenez dans l'assistant et activez le connecteur pour cette conversation.
5. Demandez vos crédits sans démarrer de chanson.

La réponse distingue les crédits disponibles et réservés. Zéro crédit réservé signifie qu'aucun crédit n'est actuellement retenu pour une tâche en cours, pas que toutes les chansons précédentes étaient gratuites.

Option en terminal avec Claude Code

Si vous utilisez déjà Claude Code, la commande HTTP documentée est :

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

Ouvrez ensuite /mcp dans Claude Code pour vous authentifier. Ajoutez --scope user lors de l'enregistrement pour utiliser la connexion dans tous les projets. Cette configuration est documentée, mais nous n'avons pas répété notre test complet dans Claude Code. Consultez la documentation MCP actuelle si les commandes évoluent.

Créez un seul enregistrement

Préparez le sujet ou les paroles, le son, la langue, la durée et le choix entre chant et instrumental. La préparation ne débite pas votre solde. Vérifiez la proposition et autorisez une chanson avant l'appel de start_song.

Prépare un instrumental de 60 secondes avec piano doux et batterie aux balais pour un après-midi pluvieux. Vérifie mon solde, montre la proposition et le coût d'un crédit, puis attends mon accord. Ne crée pas une autre chanson si un appel expire.

Un client développé sur mesure doit conserver un requestId stable, le preparedRequestId et le jobId reçu. Si le démarrage expire, répétez-le avec le même identifiant préparé. Une nouvelle préparation peut entraîner une autre chanson payante.

Interrogez get_song_job au maximum toutes les 15 secondes. La réponse finale contient le lien privé. Notre guide des paroles à la chanson aide à préparer le texte et à vérifier le chant.

Résoudre les problèmes courants

Les outils sont introuvables

Une connexion enregistrée peut être désactivée dans le chat. Dans Claude, ouvrez le menu plus, choisissez Connectors et activez Words into Music. Dans ChatGPT, sélectionnez le plugin avec @ lorsqu'un message demande un nouvel appel. Actualisez la liste des outils ou ouvrez une nouvelle conversation si nécessaire.

La connexion tourne en boucle ou l'accès est refusé

Terminez OAuth dans le même parcours du navigateur. Ne copiez pas les URL de retour dans un autre navigateur ni les codes dans le chat. Reconnectez-vous dans les paramètres du client si la session a expiré. Après révocation dans Words into Music, les anciens jetons doivent échouer.

Aucun crédit ou une autre tâche en cours

Vérifiez le solde partagé dans Facturation. MCP ne peut pas acheter d'abonnement. Attendez la tâche existante au lieu de multiplier les demandes pour contourner la limite.

L'enregistrement est privé

Connectez-vous au compte qui a approuvé la connexion. Le lien n'accorde pas d'accès public et ne permet pas de lire les chansons d'un autre compte.

Retirer l'accès

Dans les paramètres, ouvrez Applications connectées et déconnectez le client. Les nouveaux appels sont immédiatement bloqués. Déconnectez-le également dans l'assistant. Nos tests ont obtenu MCP_ACCESS lors de l'appel suivant dans ChatGPT et Claude après révocation.

La présentation MCP détaille les outils et leurs coûts. Le guide Grok distingue le connecteur web de l'API. La spécification d'autorisation MCP explique le protocole.