MCPサーバー: AIアプリで画像・動画・音声を利用

Claude、ChatGPT、Cursor、VS Code などの AI アプリから、Zurelay の画像・動画・音声モデルを使えます。MCP サーバーを一度接続してサインインすれば、チャットで画像、動画クリップ、ナレーションを頼むだけです。Nano Banana、GPT Image、Seedance、Kling、Wan、Gemini TTS で生成され、API と同じ料金が Zurelay の残高から支払われます。

https://api.zurelay.com/mcp

リモートサーバー（Streamable HTTP）なので、インストールは不要です。アプリからサインインするか、APIキーを送信します。公式MCP Registryにはcom.zurelay/mcpとして登録されています。

できること

ここではチャットモデルをツールとして提供していません。モデル上で動くアプリには、すでにモデルがあるためです。Claude Code、CursorなどのアプリでZurelayのチャットモデルを使うには、代わりにベースURLを変更してください（連携を参照）。

アプリを接続する

以下のアプリはすべてサインインに対応しています。zurelay.comで一度承認すれば、キーを貼り付ける必要はありません。サインインできないアプリや、ブラウザを開かない構成（サーバー、CI）では、代わりにAPIキーを送信します。

Claude（Web、デスクトップ、モバイル）

ClaudeにZurelayを追加を押すと、入力済みのフォームが開きます。手動で設定する場合は、次の手順に従ってください。

1. カスタマイズ、コネクタの順に開き、追加、カスタムコネクタを追加を選びます。
2. 名前をZurelayにし、MCPサーバーのURLにhttps://api.zurelay.com/mcpを貼り付けます。OAuthクライアントはClaudeの公開済みIDを使用と自動登録のどちらでも使えます。設定を追加します。
3. 接続を選びます。Zurelayが開いたら、サインインして1日の利用上限を設定し、許可を選びます。
4. チャットで+を開き、コネクタからZurelayをオンにします。あとは「16:9のポスターを作って…」「これを5秒の動画にして」「これを落ち着いた声で読み上げて」のように頼めます。

コネクタはWeb、デスクトップアプリ、スマートフォンで、すべてのプランから利用できます（Freeではカスタムコネクタを1つ使用可能）。TeamとEnterpriseでは、オーナーが組織の設定、コネクタからZurelayを追加します（追加、カスタム、Web）。その後、各メンバーが自分のZurelayアカウントを接続します。

Claude Code

claude mcp add --scope user --transport http zurelay https://api.zurelay.com/mcp

次にClaude Codeで/mcpと入力し、zurelayを選んで、開いたブラウザでサインインします（またはclaude mcp login zurelayを実行します）。APIキーを使う場合は、ブラウザは不要です。

claude mcp add --scope user --transport http zurelay https://api.zurelay.com/mcp \
  --header "Authorization: Bearer $ZURELAY_API_KEY"

--scope userを指定すると、すべてのフォルダで使えます。省略すると、追加時のフォルダでClaude Codeを実行した場合にのみ表示されます。プロジェクトの.mcp.jsonを通じて共有するには、代わりに--scope projectを使います（共有ファイルにキーを含めないでください。.mcp.jsonは環境変数から${ZURELAY_API_KEY}を読み取ります）。コマンドはClaude Code内ではなく通常のターミナルで実行し、Claude Codeを開いていた場合は再起動してください。

ChatGPT

1. 設定、セキュリティとログインで開発者モードをオンにします（Plus、Pro、Business、Enterprise、Eduで利用可能。ワークスペースの管理者による許可が必要な場合があります）。
2. ChatGPT Pluginsを開いて+を押します。名前をZurelayにし、接続URLにhttps://api.zurelay.com/mcpを入力して、OAuthを選びます。
3. Zurelayにサインインして許可を選びます。チャットで+を開き、開発者モードからZurelayを選びます。

ChatGPTはサインインのみ対応しており、APIキーは送信できません。

Cursor

CursorにZurelayを追加し、CursorのMCP設定でZurelayの横にある接続を選んでサインインします。または、~/.cursor/mcp.json（すべてのプロジェクト）か.cursor/mcp.json（1つのプロジェクト）に追加します。

{
  "mcpServers": {
    "zurelay": {
      "url": "https://api.zurelay.com/mcp"
    }
  }
}

VS Code

VS CodeにZurelayを追加するか、プロジェクトの.vscode/mcp.jsonに追加します（コマンドパレットからMCP: Add Serverを実行し、HTTPを選ぶこともできます）。Copilotのエージェントモードで初めて使用するときに、VS Codeからサインインを求められます。APIキーを使う場合は、一度入力すると暗号化して保存されます。

{
  "servers": {
    "zurelay": {
      "type": "http",
      "url": "https://api.zurelay.com/mcp"
    }
  }
}

AIエージェント

常時稼働型や個人用のエージェントにも、同じ方法でサーバーを追加できます。Grok BotとMeta Museでは追加を依頼するメッセージを貼り付け、OpenAI dotsではChatGPTのプラグインを使います。Gemini Spark、Manus、Perplexityではコネクタ設定から追加します。OpenClawとHermes Agentでも利用できるほか、Zurelayのスキルを使えば、承認したリンクからエージェント専用のキーを取得できます。各エージェントの手順はAIエージェントをご覧ください。

Codex、Gemini CLIなどのアプリ

Streamable HTTP経由のMCPに対応するアプリなら、どれでも利用できます。Codexはcodex mcp login zurelay、Gemini CLIは/mcp auth zurelayでサインインできます。APIキーを使う場合、ほとんどのアプリはAuthorizationヘッダーに対応しています。

# or: codex mcp add zurelay --url 'https://api.zurelay.com/mcp' --bearer-token-env-var ZURELAY_API_KEY
[mcp_servers.zurelay]
url = "https://api.zurelay.com/mcp"
bearer_token_env_var = "ZURELAY_API_KEY"

サインインまたはAPIキー

サインインは簡単で安全な方法です。アプリから zurelay.com が開きます。メールで届いたコードでサインインし、利用料金の支払い元となるワークスペースと1日の利用上限を選んで、接続を許可してください。Zurelay は「Claude (MCP)」のようにアプリ名を付けたキーを、その上限とともにキーのページに追加します。アプリが API キーを見ることはありません。保持するのは有効期間が1時間のトークンと、使用するたびに変わるリフレッシュトークンです。どちらも MCP サーバーでのみ使え、ほかの API では使えません。上限はキーのページで変更でき、キーを取り消せばアプリの接続を解除できます。

API キーは Authorization: Bearer zr_live_… ヘッダーに指定します。キーに設定した予算、レート制限、許可するモデルと IP アドレスがすべて適用されます。エージェントが頻繁に動いても予定以上に使わないよう、アプリ専用のキーを1日の予算付きで作成してください（キーの制限とルールを参照）。Claude や ChatGPT などのアプリは独自のサーバーからリクエストするため、これらに使うキーでは許可する IP アドレスを空欄にしてください。

料金、リンク、待ち時間

• 料金は API と同じです。モデルのページで各モデルを確認するか、AI に list_models を呼び出すよう依頼してください。失敗したリクエストには課金されず、動画は完成した場合にのみ課金されます。
• ツールは約35秒以内に応答します。画像や音声は通常それまでに完成します。時間がかかるもの（ほとんどの動画）は id が返り、AI が get_result を呼び出します。呼び出すたびに、さらに最大45秒待機します。
• 結果は Zurelay のストレージへのリンクで返され、有効期間は24時間です。画像と動画はライブラリに30日間保存され、すべてのリクエストはほかのリクエストと同様にリクエストのページに表示されます。
• 画像には小さなプレビューも付くため、AI は生成結果を見て調整できます。コンテキストを節約したい場合は、プレビューを省くよう依頼してください。

パソコン上のファイル

画像の編集やフレームのアニメーション化には、モデルがアクセスできるファイルのリンクが必要です。すでにオンラインにあるファイルは、その https リンクを渡せます。パソコン上のファイルには、コマンドを実行できるアプリ（Claude Code、Cursor、Codex）で create_upload_link を使います。PNG、JPEG、WebP、MP4、MOV、MP3、WAV のいずれかのファイル1つ（最大20 MB）を15分以内にアップロードできます。返されたリンクは2時間有効で、ファイルは2日後に削除されます。アップロードリンクの利用には、アカウントにクレジットが必要です。

# 1. The agent calls create_upload_link and gets a one-time URL.
# 2. It uploads the file with curl:
curl -sS -T ./product-photo.png 'https://api.zurelay.com/mcp/uploads/…'
# {"url":"https://…/inputs/2026-10-05/….png","type":"image/png","bytes":482113,…}
# 3. It passes that url to generate_image's reference_images or generate_video's first_frame.

セキュリティ

• サインインは MCP 仕様に準拠しています。OAuth 2.1 と PKCE（S256 のみ）を使用し、登録済みのリダイレクト先のみを許可します。使い捨てコードの有効期間は5分です。コードが2回使用されると、そのコードとの交換で得たものは無効になります。
• トークンはランダムに生成され、SHA-256 ハッシュとしてのみ保存されます。アクセストークンは1時間有効で、MCP サーバーでのみ使えます。リフレッシュトークンは使用するたびに変わります。使用済みのトークンが1分以上経って再び使われた場合はコピーされたものと判断し、接続を終了してキーを取り消します。
• 接続ごとに独立した1日の上限を持つキーがキーのページに作成され、ワークスペースのメンバーに表示されます。キーを取り消すか、ワークスペースから抜けると、アプリの接続は解除されます。
• 同意ページはほかのサイト内には表示できません。また、Zurelay が認識していないアプリの場合はその旨と、認証後の戻り先を表示します。
• アップロードリンクには署名が付いており、受け付けるファイルは1つ、有効期間は15分です。アップロードしたファイルは2日後に削除されます。
• MCP 呼び出しにはキーとワークスペースごとにレート制限があり、バッチ内の各呼び出しもそれぞれカウントされます。

開発者向け

サーバーは Streamable HTTP を介して MCP 2025-11-25（および 2025-06-18、2025-03-26、2024-11-05）に対応しています。https://api.zurelay.com/mcp に JSON-RPC を POST すると、JSON が返ります。セッションは保持しないため、サーバー送信イベントはなく、GET は 405 を返します。トークンがない場合は、https://api.zurelay.com/.well-known/oauth-protected-resource/mcp を指す WWW-Authenticate とともに 401 を返します。認可サーバーのメタデータは https://api.zurelay.com/.well-known/oauth-authorization-server にあり、動的クライアント登録に対応しています。

curl https://api.zurelay.com/mcp \
  -H "Authorization: Bearer $ZURELAY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "generate_image",
      "arguments": { "prompt": "A lighthouse at dusk, oil painting", "model": "nano-banana-pro" }
    }
  }'

トラブルシューティング

• Claude Code の /mcp に zurelay が表示されない場合：別のフォルダーに追加されたか、Claude Code がすでに起動していた可能性があります。Claude Code を終了し、通常のターミナルで上記のコマンドを（--scope user を付けて）実行してから、再起動してください。claude mcp list では、サインインするまで認証が必要と表示されます。
• アプリで何度もサインインを求められる場合：アプリが作成したキーが取り消されたか、サインインが1年間使われなかった可能性があります。再接続してください。
• 「Your Zurelay balance is empty」または「reached its daily budget」と表示される場合：請求のページでクレジットを追加するか、キーのページで上限を引き上げてください。
• 「This token belongs～an app connected through Zurelay’s MCP server」と表示される場合：アプリのトークンを API に送信しています。API キーを使用してください。
• 動画が止まっているように見える場合：AI に get_result をもう一度呼び出すよう依頼してください。動画の生成には1〜5分かかり、モデルが混み合っている場合はさらに時間がかかることがあります。