# グロックで楽曲を作成する

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

> グロックでWords into Music MCP接続を設定し、アカウント権限を理解し、ウェブ設定と開発者APIアクセスを区別します。

グロックは、外部ツールを会話に接続するためのカスタムMCPコネクタ経路を文書化しています。Words into Musicは、楽曲生成用のリモートOAuth MCPエンドポイントを公開しています。このガイドでは、文書化された設定方法と、楽曲クレジットを消費する前に行うべき確認事項を説明します。

ChatGPTとClaudeでは、本番環境での楽曲テストを完了しています。グロックでのWords into Music楽曲の完全なテストはまだ保留中です。以下のグロックの手順はxAIの現在のドキュメントに準拠しており、テスト済みのレコーディングセッションとして提示されているわけではありません。

## ウェブでカスタムコネクタを追加する

[xAIのコネクタドキュメント](https://docs.x.ai/grok/connectors)によると、[Grok Connectors](https://grok.com/connectors)を開き、「New Connector」を選択し、次に「Custom」を選択します。以下の公開サーバーURLを入力してください。

```text
https://mcp.wordsintomusic.com/mcp
```

グロックが認証方法を尋ねてきたら、OAuthを使用してください。Words into Musicにサインインし、アカウント、コールバックホスト、権限を確認してください。当社のプロバイダーキー、ブラウザのCookie、またはWords into Musicのパスワードをチャットに貼り付ける必要はありません。

Grok BusinessおよびEnterpriseでは、メンバーがコネクタを使用する前に、管理者がクラウドコンソールでコネクタをプロビジョニングする必要がある場合があります。利用可能性やラベルは変更されることがあります。アカウントに「Custom」オプションがない場合は、無関係なAPIキーフィールドにエンドポイントを入力するのではなく、xAIのドキュメントを確認してください。



## 楽曲を作成せずに接続を確認する

グロックがツールセレクタを提供している場合は、会話でコネクタを有効にしてから、次のように尋ねてください。

> Words into Musicを使って、利用可能な楽曲クレジットとサポートされている楽曲言語を確認してください。楽曲の準備や開始はしないでください。

実際のツール応答を探してください。歌詞を書けるという会話の返答は、音楽接続が機能している証拠ではありません。期待されるツール名には、`get_account_usage`、`prepare_song`、`start_song`、`get_song_job`が含まれます。[MCP概要](https://wordsintomusic.com/ja/mcp/)で利用可能なツールについて説明しています。

サインインまたは検出に失敗した場合は、新しいコネクタを作成し続けたり、予期しない権限を承認したりしないでください。不完全な接続を切断し、トークンやコールバックコードを含まないエラーテキストを[サポート](mailto:contact@wordsintomusic.com)に送信してください。

## 準備、確認、そして生成

読み取り専用の確認が機能したら、限定的な指示を試してください。

> 雨の夜に読書をするための、メロウなピアノとソフトなドラムを使った60秒のインストゥルメンタルを準備してください。残高を確認し、指示内容と1クレジットの費用を表示してください。正確に1つのレコーディングを開始する前に、私の承認を待ってください。

楽曲は60秒から180秒の長さで作成できます。ボーカル言語は、英語、スペイン語、ドイツ語、フランス語、ブラジルポルトガル語、イタリア語、オランダ語、ポーランド語、スウェーデン語、日本語、韓国語です。ボーカルが必要な場合は言語を明示的に指定してください。会話の言語と楽曲の言語は異なっていても構いません。

*   指示の準備には楽曲クレジットはかかりません。
*   開始すると、既存のクレジットが1つ消費されます。
*   プランと楽曲パックは同じウォレットを使用します。

承認後、グロックに同じ準備済みリクエストを開始させ、15秒より速い間隔で進捗を確認しないでください。呼び出しがタイムアウトした場合は、2回目のリクエストを行うのではなく、その準備済みIDを再試行してください。承認されたジョブはチャットを離れても続行されます。準備ができたら、プライベートなWords into Musicリンクから聴いてください。

## xAI APIを使用する開発者向け

APIはグロックのウェブサイトとは別の設定です。xAI用のxAI APIキーと、アプリケーション独自の承認済みOAuthフローによって取得されたWords into Music OAuthアクセストークンが必要です。当社の設定ページには個人トークンジェネレーターはありません。ブラウザセッションからトークンを抽出しないでください。

xAIの[リモートMCP APIリファレンス](https://docs.x.ai/developers/tools/remote-mcp)は、サーバーURL、認証、ツール許可リストをサポートしています。読み取り専用アクセスから始めてください。このOpenAI互換の例は、生成ツールを公開せずに接続を確認します。

```python
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)
```

xAIアカウントから現在利用可能なMCP対応モデルを使用してください。両方の認証情報をサーバー側に保持し、リフレッシュと取り消しを実装してください。xAI APIの料金は楽曲クレジットとは別です。この例は、資金提供されたxAI開発者アカウントに対して実行されたものではありません。

アプリケーションレベルの承認ステップなしに、`start_song`を無人モデルに公開しないでください。APIの承認動作はウェブコネクタとは異なります。今日、最も簡単に検証できるブラウザ設定については、[Claude](https://wordsintomusic.com/ja/make-songs-in-claude/)または[ChatGPT](https://wordsintomusic.com/ja/make-songs-in-chatgpt/)を参照してください。[一般的な設定ガイド](https://wordsintomusic.com/ja/blog/mcp-setup-guide/)では、切断と一般的なエラーについて説明しています。


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


## よくある質問

### グロックでの楽曲生成はテスト済みですか？

まだです。これらの手順はxAIの現在のコネクタドキュメントに準拠しています。ChatGPTとClaudeでは完全な楽曲制作が検証済みですが、グロックについてはエンドツーエンドのテストを待っている状態です。

### グロックAPIはグロックのウェブサイトコネクタと同じですか？

違います。ウェブサイトはコネクタのサインインを管理します。APIアプリケーションには、xAI APIキーと、セキュアなトークンストレージとリフレッシュを備えた独自の承認済みWords into Music OAuthトークンフローが必要です。

### グロックを接続すると、別の無料楽曲がもらえますか？

いいえ。既存の楽曲利用枠は、ウェブサイトと接続されているすべてのアシスタントで共有されます。

### グロックはチャット内で直接楽曲を再生しますか？

当社のMCPサーバーは、プライベートな楽曲リンクと詳細を返します。サインインした状態でWords into Musicでリンクを開いて聴いてください。チャット内に埋め込みプレイヤーは提供されません。

### アクセスを取り消すことはできますか？

はい、可能です。Words into Musicの設定にある「接続済みアプリ」でクライアントを切断し、グロックでも切断してください。以前に承認された生成は完了する場合があります。