Gebruik deze gids als je een compatibele MCP-client hebt en de exacte verbindingsinstellingen wilt. Als je ChatGPT of Claude instelt, tonen hun gidsen eerst de knoppen en menu's.

Verbindingsinstellingen

Instelling Waarde
Naam Words into Music
URL externe server https://mcp.wordsintomusic.com/mcp
Transport Streamable HTTP
Authenticatie OAuth
Account Je geverifieerde Words into Music-account

Gebruik de volledige URL, inclusief het laatste /mcp. De homepage, een nummer-URL en localhost zijn geen connectoreindpunten. De server wordt voor je gehost; er is geen muziekserver om op je computer te installeren.

Verbinden en controleren vóór het genereren

  1. Voeg een externe HTTP-server toe in je client en voer de bovenstaande URL in.
  2. Kies OAuth-aanmelding. Gebruik de gepubliceerde identiteit van de client of automatische registratie indien aangeboden.
  3. Meld je aan bij Words into Music, verifieer je e-mail indien nodig en controleer de gevraagde machtigingen.
  4. Keer terug naar de assistent en schakel de connector in voor dit gesprek.
  5. Vraag de assistent om je beschikbare songcredits te controleren zonder een nummer te starten.
ChatGPT's aangepaste MCP-formulier met de openbare Words into Music URL en geselecteerde OAuth

Je eerste controle zou beschikbare credits, gereserveerde credits en ondersteunde talen moeten retourneren. Nul gereserveerde credits betekent dat er momenteel geen credit is gereserveerd voor een lopende taak. Het betekent niet dat elk eerder nummer gratis was.

Optionele terminal-instelling met Claude Code

Als je Claude Code al gebruikt, is het gedocumenteerde HTTP-registratiecommando:

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

Open vervolgens /mcp binnen Claude Code en authenticeer de verbinding. Voeg --scope user toe bij het registreren als je het beschikbaar wilt hebben voor alle projecten. Dit is een gedocumenteerde clientconfiguratie, geen bewering dat we de Claude web acceptatietest in Claude Code hebben herhaald. Raadpleeg de huidige Claude Code MCP-documentatie als de CLI verandert.

Maak veilig één opname

Vraag de assistent om een briefing voor te bereiden met het onderwerp of de songtekst, geluid, taal, duur en of je zang wilt. Voorbereiding brengt geen kosten in rekening. Controleer de briefing en keur één nummer goed voordat de assistent start_song aanroept.

Bereid een instrumentaal nummer van 60 seconden voor met zachte piano en brushed drums voor een regenachtige middag. Controleer mijn saldo, toon de briefing en de kosten van één credit, en wacht op mijn goedkeuring. Start geen tweede nummer als een verzoek een time-out krijgt.

Een ontwikkelaarsclient moet een stabiele requestId behouden voor voorbereiding, en vervolgens de preparedRequestId en de geretourneerde jobId opslaan. Herhaal een start die een time-out heeft gekregen met dezelfde voorbereide ID. Het aanmaken van een andere voorbereiding kan leiden tot een ander betaald nummer nadat het eerste is voltooid.

Poll get_song_job niet sneller dan elke 15 seconden. Een voltooide reactie bevat de privé-songlink. Open deze in het account dat de verbinding heeft goedgekeurd. Songteksten voorbereiden voordat je begint, geeft je een betere referentie bij het controleren van de zang.

Als er iets misgaat

De assistent zegt dat hij de tools niet kan zien

Een opgeslagen verbinding kan nog steeds zijn uitgeschakeld voor een chat. Open in Claude het plusmenu, kies Connectors en schakel Words into Music in. Selecteer in ChatGPT de plugin met een @mention wanneer een bericht een nieuwe tool-aanroep nodig heeft. Ververs de toollijst of start een nieuw gesprek als je client een eerdere lijst in de cache had.

Inloglussen of toegang geweigerd

Voltooi OAuth in dezelfde browserstroom als je bent begonnen. Kopieer geen callback-URL's naar een andere browser en plak geen autorisatiecodes in de chat. Maak opnieuw verbinding via de instellingen van de client als de verbinding is verlopen. Als je de verbinding hebt verbroken in Words into Music, moeten oude tokens mislukken totdat je een nieuwe verbinding goedkeurt.

Geen credits of een andere taak is actief

Open Facturering om de gedeelde wallet te controleren. MCP kan geen abonnement kopen. Als een ander nummer al actief is, controleer die taak of ga terug naar Mijn nummers. Maak geen nieuwe verzoeken aan om de limiet te omzeilen.

De pagina opent, maar de opname is privé

Meld je aan bij hetzelfde Words into Music-account dat is gebruikt tijdens de toestemming. De link geeft geen openbare toegang. Een assistent kan de nummers van een ander account niet lezen door simpelweg een ID te raden.

Toegang verwijderen wanneer je klaar bent

Open Instellingen, zoek Verbonden apps en kies Verbinding verbreken voor de client. Nieuwe aanroepen stoppen onmiddellijk. Verbreek ook de verbinding in de assistent om de opgeslagen sessie te verwijderen. In onze productietests retourneerden zowel ChatGPT als Claude MCP_ACCESS bij hun volgende accountlezing na intrekking van de website.

Ons MCP-overzicht vermeldt elke tool en de kosten ervan. Grok's gids scheidt de gedocumenteerde webconnector van de ontwikkelaars-API-configuratie. Voor algemene protocolachtergrond, lees de MCP-autorisatiespecificatie.

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

Veelgestelde vragen

Moet ik de homepage-URL of de MCP-URL gebruiken?

Gebruik https://mcp.wordsintomusic.com/mcp. Behoud het laatste /mcp-pad en selecteer OAuth met Streamable HTTP.

Moet ik een lokale server installeren?

Nee. Words into Music host de externe server. Je assistent of ontwikkelaarsclient maakt er verbinding mee via HTTPS.

Wat gebeurt er als ik een start-aanroep opnieuw probeer?

Het herhalen van start_song met dezelfde preparedRequestId retourneert de bestaande taak. Het aanmaken van een nieuwe voorbereiding is een ander verzoek en kan een extra credit kosten.

Waarom retourneert mijn client MCP_ACCESS?

De accountverbinding ontbreekt, is ingetrokken, verlopen of niet langer toegestaan. Maak opnieuw verbinding via de normale OAuth-stroom en controleer het gevraagde account en de machtigingen.

Kan het verbreken van de verbinding een nummer annuleren?

Het verbreken van de verbinding stopt nieuwe tool-aanroepen. Een generatie die vóór de verbreking is geaccepteerd, wordt voortgezet, zodat je de opname later in je bibliotheek kunt vinden.