Grok documente des connecteurs MCP personnalisés pour utiliser des services externes dans une conversation. Words into Music propose un serveur distant avec OAuth pour créer des chansons. Ce guide présente le parcours documenté et les vérifications à faire avant de dépenser un crédit.
Nos tests complets en production avec ChatGPT et Claude sont terminés. Le test complet de Words into Music dans Grok reste à effectuer. Les étapes suivantes reposent sur la documentation xAI actuelle, pas sur un enregistrement Grok que nous aurions vérifié.
Ajouter le connecteur web
Selon la documentation xAI, ouvrez Grok Connectors, choisissez New Connector puis Custom. Entrez l'URL publique :
https://mcp.wordsintomusic.com/mcp
Choisissez OAuth pour l'authentification. Connectez-vous sur Words into Music et vérifiez le compte, le domaine de retour et les autorisations. Ne collez pas de mot de passe, cookie ou clé du fournisseur musical dans la conversation.
Dans Business et Enterprise, un administrateur peut devoir configurer le connecteur dans la console cloud avant les membres. Si Custom manque, consultez les indications xAI. Ne mettez pas cette URL dans un champ de clé API sans rapport.
Vérifier sans créer de chanson
Activez le connecteur dans la conversation si un sélecteur d'outils est proposé. Demandez :
Utilise Words into Music pour consulter mes crédits disponibles et les langues prises en charge. Ne prépare et ne démarre aucune chanson.
Attendez une vraie réponse d'outil. Dire que Grok peut écrire des paroles ne prouve pas que le service musical est connecté. Les outils comprennent get_account_usage, prepare_song, start_song et get_song_job. La présentation MCP les liste tous.
Si la connexion ou la détection échoue, ne multipliez pas les connecteurs et n'approuvez pas d'autorisations inattendues. Déconnectez-vous et envoyez au support le message d'erreur sans jeton ni code de retour.
Préparer, relire et générer
Prépare un instrumental de 60 secondes avec piano calme et batterie douce pour lire un soir de pluie. Vérifie mon solde, montre la proposition et le coût d'un crédit, puis attends mon accord pour un seul enregistrement.
La durée acceptée va de 60 à 180 secondes. Pour le chant, précisez anglais, espagnol, allemand, français ou portugais du Brésil. La langue du chat et celle du morceau peuvent différer.
La préparation n'utilise pas de crédit de chanson. Le démarrage en dépense un. Un compte gratuit dispose d'une chanson au total sur le site et tous les assistants. Abonnements et packs utilisent le même solde. Grok ne peut pas acheter de forfait ni ajouter de crédits avec ces outils.
Après accord, démarrez la même proposition et espacez les consultations d'au moins 15 secondes. En cas d'expiration d'un appel, réutilisez l'identifiant préparé. Une tâche acceptée continue après fermeture du chat. Écoutez le résultat via le lien privé Words into Music.
Pour les développeurs utilisant l'API xAI
L'API constitue une intégration distincte. Il faut une clé API xAI et un jeton OAuth Words into Music obtenu par le propre parcours autorisé de votre application. Nos paramètres ne proposent pas de générateur de jetons personnels. N'extrayez pas de jeton de votre session de navigateur.
La référence MCP distante décrit l'URL, l'autorisation et les outils autorisés. Commencez en lecture seule. Exemple illustratif avec l'API compatible OpenAI :
import os
from openai import OpenAI
client = OpenAI(api_key=os.environ["XAI_API_KEY"], base_url="https://api.x.ai/v1")
response = client.responses.create(
model=os.environ["XAI_MODEL"],
input="Consulte seulement mes crédits Words into Music.",
tools=[{
"type": "mcp",
"server_label": "words_into_music",
"server_url": "https://mcp.wordsintomusic.com/mcp",
"authorization": "Bearer " + os.environ["WIM_ACCESS_TOKEN"],
"allowed_tools": ["get_account_usage"],
}],
)
print(response.output_text)
Choisissez un modèle disponible compatible MCP. Gardez les identifiants côté serveur et implémentez renouvellement et révocation. Les frais API xAI sont distincts des crédits de chanson. Nous n'avons pas exécuté cet exemple avec un compte développeur xAI approvisionné.
N'exposez pas start_song à un modèle autonome sans validation dans votre application. Pour un parcours web vérifié, utilisez Claude ou ChatGPT. Le guide MCP explique les erreurs et la déconnexion.
Foire aux questions
La création complète dans Grok a-t-elle été testée ?
Pas encore. Les étapes suivent la documentation xAI actuelle. Nous avons vérifié la création complète en production avec ChatGPT et Claude, tandis que le test Grok reste à faire.
L'API et le connecteur web sont-ils identiques ?
Non. Le site gère la connexion du connecteur. Une application API a besoin d'une clé xAI et de son propre parcours OAuth Words into Music, avec stockage et renouvellement sécurisés.
Connecter Grok donne-t-il une autre chanson gratuite ?
Non. Votre limite existante est partagée entre le site et tous les assistants connectés.
Grok lit-il le morceau dans le chat ?
Notre serveur renvoie les détails et un lien privé. Ouvrez-le dans Words into Music avec votre compte pour écouter. Il ne fournit pas de lecteur intégré.
Puis-je révoquer l'accès ?
Oui. Déconnectez le client dans Applications connectées de Words into Music et dans Grok également. Une tâche déjà acceptée peut encore se terminer.
