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

[llms.txt](https://wordsintomusic.com/ja/developers/llms.txt)

> OAuthで音楽MCP接続を設定し、利用可能なツールを理解し、一般的なサインイン、クレジット、生成の問題を解決します。

互換性のあるMCPクライアントをお持ちで、正確な接続設定が必要な場合は、このガイドを使用してください。[ChatGPT](https://wordsintomusic.com/ja/make-songs-in-chatgpt/)または[Claude](https://wordsintomusic.com/ja/make-songs-in-claude/)を設定する場合は、まずそれぞれのガイドでボタンとメニューが説明されています。

## 接続設定

| 設定 | 値 |
| --- | --- |
| 名前 | Words into Music |
| リモートサーバーURL | `https://mcp.wordsintomusic.com/mcp` |
| トランスポート | ストリーマブルHTTP |
| 認証 | OAuth |
| アカウント | あなたの認証済みWords into Musicアカウント |

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

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

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



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

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

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

```sh
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ドキュメント](https://code.claude.com/docs/en/mcp)を参照してください。

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

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

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

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

`get_song_job` を15秒より速い間隔でポーリングしないでください。完了した応答にはプライベートな曲のリンクが含まれています。接続を承認したアカウントで開いてください。開始前に[歌詞を準備する](https://wordsintomusic.com/ja/blog/how-to-turn-lyrics-into-a-song/)と、ボーカルを確認する際のより良い参照になります。

## 問題が発生した場合

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

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

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

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

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

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

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

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

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

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

当社の[MCP概要](https://wordsintomusic.com/ja/mcp/)には、すべてのツールとその費用が記載されています。[Grokのガイド](https://wordsintomusic.com/ja/make-songs-in-grok/)では、文書化されたウェブコネクタと開発者API設定が区別されています。一般的なプロトコルの背景については、[MCP認証仕様](https://modelcontextprotocol.io/specification/2026-07-28/basic/authorization)をお読みください。


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


## よくある質問

### ホームページのURLとMCPのURL、どちらを使うべきですか？

`https://mcp.wordsintomusic.com/mcp` を使用してください。末尾の `/mcp` パスを保持し、ストリーマブルHTTPでOAuthを選択してください。

### ローカルサーバーをインストールする必要がありますか？

いいえ。「Words into Music」がリモートサーバーをホストしています。あなたのアシスタントまたは開発者クライアントはHTTPS経由で接続します。

### start_songの呼び出しを再試行するとどうなりますか？

同じ `preparedRequestId` で `start_song` を繰り返すと、既存のジョブが返されます。新しい準備を作成することは別のリクエストであり、追加のクレジットを消費する可能性があります。

### クライアントがMCP_ACCESSを返すのはなぜですか？

アカウント接続が見つからない、取り消された、期限切れ、または許可されなくなっています。通常のOAuthフローを通じて再接続し、要求されたアカウントと権限を確認してください。

### 接続を切断すると曲はキャンセルされますか？

接続を切断すると、新しいツール呼び出しは停止します。切断前に承認された生成は続行されるため、後でライブラリでその録音を見つけることができます。