Maak liedjes in Grok

Grok documenteert een aangepaste MCP-connectorroute voor het verbinden van externe tools met een gesprek. Words into Music biedt een extern OAuth MCP-eindpunt aan voor het genereren van liedjes. Deze handleiding toont de gedocumenteerde installatie en de controles die je moet doen voordat je een liedjestegoed verbruikt.

We hebben tests voor het aanmaken van liedjes voltooid in ChatGPT en Claude. Een volledige Words into Music-liedjestest in Grok is nog in afwachting. De onderstaande Grok-stappen volgen de huidige documentatie van xAI; ze worden niet gepresenteerd als een geteste opnamesessie.

Voeg de aangepaste connector toe op het web

Volgens de connectordocumentatie van xAI open je Grok Connectors, kies je 'Nieuwe connector' en vervolgens 'Aangepast'. Voer deze openbare server-URL in:

https://mcp.wordsintomusic.com/mcp

Gebruik OAuth wanneer Grok vraagt hoe je wilt authenticeren. Meld je aan bij Words into Music en controleer het account, de callback-host en de machtigingen. Je zou onze provider-sleutels, je browsercookies of een Words into Music-wachtwoord niet in de chat hoeven te plakken.

Op Grok Business en Enterprise moet een beheerder de connector mogelijk in de cloudconsole provisioneren voordat leden deze kunnen gebruiken. Beschikbaarheid en labels kunnen veranderen. Als je account geen 'Aangepast'-optie heeft, raadpleeg dan de documentatie van xAI in plaats van het eindpunt in een niet-gerelateerd API-sleutelveld in te voeren.

Controleer de verbinding zonder een liedje te maken

Schakel de connector in voor je gesprek als Grok een toolselector aanbiedt, en vraag dan:

Gebruik Words into Music om mijn beschikbare liedjestegoeden en ondersteunde liedtalen te controleren. Bereid geen liedje voor en start er geen.

Zoek naar een daadwerkelijke toolrespons. Een antwoord in de conversatie dat zegt dat het teksten kan schrijven, is geen bewijs van een werkende muziekverbinding. Verwachte toolnamen zijn onder andere get_account_usage, prepare_song, start_song en get_song_job. Het MCP-overzicht legt de beschikbare tools uit.

Als aanmelding of detectie mislukt, blijf dan geen nieuwe connectors maken of onverwachte machtigingen goedkeuren. Verbreek de onvolledige verbinding en stuur de fouttekst, zonder tokens of callback-codes, naar support.

Voorbereiden, controleren, dan genereren

Zodra de alleen-lezen controle werkt, probeer dan een specifieke opdracht:

Bereid een instrumentaal nummer van 60 seconden voor met zachte piano en lichte drums, geschikt om te lezen op een regenachtige avond. Controleer mijn saldo en toon de opdracht en de kosten van één tegoed. Wacht op mijn goedkeuring voordat je precies één opname start.

Het liedje kan 60 tot 180 seconden lang zijn. Ondersteunde talen voor zang zijn Engels, Spaans, Duits, Frans, Braziliaans Portugees, Italiaans, Nederlands, Pools, Zweeds, Japans en Koreaans. Vermeld de taal expliciet als je zang wilt; de gesprekstaal en de liedjestaal kunnen verschillen.

Het voorbereiden van de opdracht kost geen liedjestegoeden. Het starten ervan verbruikt één bestaand tegoed. Abonnementen en liedjespakketten gebruiken dezelfde portemonnee.

Na goedkeuring vraag je Grok om dezelfde voorbereide aanvraag te starten en controleer je de voortgang niet sneller dan elke 15 seconden. Als een oproep een time-out krijgt, probeer dan die voorbereide ID opnieuw in plaats van een tweede aanvraag te doen. Een geaccepteerde taak gaat door nadat je de chat hebt verlaten. Luister via de privé Words into Music-link wanneer deze klaar is.

Voor ontwikkelaars die de xAI API gebruiken

De API is een aparte installatie van de Grok-website. Je hebt een xAI API-sleutel voor xAI en een Words into Music OAuth-toegangstoken nodig, verkregen via de eigen geautoriseerde OAuth-stroom van je applicatie. Er is geen persoonlijke token-generator op onze instellingenpagina. Haal geen token uit je browsersessie.

De externe MCP API-referentie van xAI ondersteunt een server-URL, autorisatie en een tool-allowlist. Begin met alleen-lezen toegang. Dit illustratieve OpenAI-compatibele voorbeeld controleert de verbinding zonder generatietools bloot te stellen:

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="Check my Words into Music song credits only.",
    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)

Gebruik een momenteel beschikbaar MCP-compatibel model van je xAI-account. Bewaar beide referenties server-side en implementeer vernieuwing en intrekking. xAI API-kosten staan los van liedjestegoeden. Dit voorbeeld is niet uitgevoerd op een gefinancierd xAI-ontwikkelaarsaccount.

Stel start_song niet bloot aan een onbeheerd model zonder een goedkeuringsstap op applicatieniveau. Het goedkeuringsgedrag van de API verschilt van de webconnector. Voor de eenvoudigste geverifieerde browserinstallatie van vandaag, volg Claude of ChatGPT. De algemene installatiehandleiding behandelt het verbreken van de verbinding en veelvoorkomende fouten.

Als je tegoeden nodig hebt, vraag de assistent dan om de huidige aanbiedingen te tonen. Nadat je hebt gekozen, opent create_checkout_link de Stripe-kassa voor je verbonden account zonder een nieuwe website-login. Voltooi de betaling op Stripe en vraag de assistent vervolgens om je saldo te controleren en de opgeslagen liedjesaanvraag opnieuw te proberen. De assistent kan je niet automatisch kosten in rekening brengen of je bestaande abonnement wijzigen.