「Words into Music」のMCPセットアップガイド

互換性のあるMCPクライアントをお持ちで、正確な接続設定が必要な場合は、このガイドを使用してください。ChatGPTまたはClaudeを設定する場合は、まずそれぞれのガイドでボタンとメニューが説明されています。

接続設定

末尾の /mcp を含む完全なURLを使用してください。ホームページ、曲のURL、localhost はコネクタのエンドポイントではありません。サーバーはホストされているため、コンピューターに音楽サーバーをインストールする必要はありません。

生成前に接続と確認を行う

1. クライアントにリモートHTTPサーバーを追加し、上記のURLを入力します。
2. OAuthサインインを選択します。クライアントが提供する公開されたIDまたは自動登録を使用します。
3. Words into Musicにサインインし、必要に応じてメールアドレスを確認し、要求された権限を確認します。
4. アシスタントに戻り、この会話でコネクタを有効にします。
5. 曲を開始せずに、利用可能な曲クレジットを確認するよう依頼します。

最初の確認では、利用可能なクレジット、予約済みクレジット、およびサポートされている言語が返されるはずです。予約済みクレジットがゼロであるということは、現在実行中のジョブのためにクレジットが保持されていないことを意味します。これは、以前のすべての曲が無料だったという意味ではありません。

Claude Codeでのオプションのターミナル設定

すでにClaude Codeを使用している場合、その文書化されたHTTP登録コマンドは次のとおりです。

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

次に、Claude Code内で /mcp を開き、接続を認証します。プロジェクト全体で利用可能にしたい場合は、登録時に --scope user を追加してください。これは文書化されたクライアント設定であり、Claude CodeでClaudeのウェブ受け入れテストを繰り返したという主張ではありません。CLIが変更された場合は、現在のClaude Code MCPドキュメントを参照してください。

1つの録音を安全に作成する

アシスタントに、主題または歌詞、サウンド、言語、長さ、ボーカルの有無を含むブリーフを準備するよう依頼してください。準備ではウォレットは課金されません。アシスタントが start_song を呼び出す前に、ブリーフを確認し、1曲を承認してください。

雨の午後のために、ソフトなピアノとブラシドラムを使った60秒のインストゥルメンタルを1曲準備してください。残高を確認し、ブリーフと1クレジットの費用を表示し、私の承認を待ってください。リクエストがタイムアウトした場合、2曲目を開始しないでください。

開発者クライアントは、準備のために安定した requestId を保持し、その後 preparedRequestId と返された jobId を保存する必要があります。タイムアウトした開始は、同じ準備済みIDで再試行してください。別の準備を作成すると、最初の曲が完了した後に別の曲が課金される可能性があります。

get_song_job を15秒より速い間隔でポーリングしないでください。完了した応答にはプライベートな曲のリンクが含まれています。接続を承認したアカウントで開いてください。開始前に歌詞を準備すると、ボーカルを確認する際のより良い参照になります。

問題が発生した場合

アシスタントがツールを認識できないと言う

保存された接続でも、チャットでは無効になっている場合があります。Claudeでは、プラスメニューを開き、「Connectors」を選択して「Words into Music」をオンにしてください。ChatGPTでは、新しいツール呼び出しが必要なメッセージで@メンションを使ってプラグインを選択してください。クライアントが以前のリストをキャッシュしている場合は、ツールリストを更新するか、新しい会話を開始してください。

サインインループまたはアクセス拒否

開始したのと同じブラウザフローでOAuthを完了してください。コールバックURLを別のブラウザにコピーしたり、認証コードをチャットに貼り付けたりしないでください。接続が期限切れになった場合は、クライアントの設定を通じて再接続してください。Words into Musicで切断した場合、新しい接続を承認するまで古いトークンは失敗します。

クレジットがない、または別のジョブが実行中

共有ウォレットを確認するには、請求を開いてください。MCPはプランを購入できません。別の曲がすでに実行中の場合は、そのジョブを確認するか、「マイソング」に戻ってください。制限を回避するために新しいリクエストを作成しないでください。

ページは開くが録音がプライベートになっている

同意時に使用したのと同じWords into Musicアカウントにサインインしてください。このリンクは公開アクセスを許可しません。アシスタントは、単にIDを推測するだけで別のアカウントの曲を読み取ることはできません。

完了したらアクセスを削除する

設定を開き、「Connected apps」を見つけて、クライアントの「Disconnect」を選択してください。新しい呼び出しはすぐに停止します。アシスタントでも切断して、保存されているセッションを削除してください。当社の本番テストでは、ウェブサイトでの取り消し後、ChatGPTとClaudeの両方が次のアカウント読み取り時に MCP_ACCESS を返しました。

当社のMCP概要には、すべてのツールとその費用が記載されています。Grokのガイドでは、文書化されたウェブコネクタと開発者API設定が区別されています。一般的なプロトコルの背景については、MCP認証仕様をお読みください。

クレジットが必要な場合は、アシスタントに現在のオファーを表示するよう依頼してください。選択後、create_checkout_link は、別のウェブサイトログインなしで、接続済みアカウントのStripeチェックアウトを開きます。Stripeで支払いを完了し、その後アシスタントに残高を確認し、保存された曲のリクエストを再試行するよう依頼してください。アシスタントが自動的に課金したり、既存のサブスクリプションを変更したりすることはありません。