Skip to Content
MCP Documentation

freebeat MCP

freebeat は最大のミュージックビデオジェネレーターです。その MCP サーバーを使えば、AI エージェントが直接利用できます。どんな曲からでもミュージックビデオ、歌詞ビデオ、ダンスビデオを作成でき、作曲、写真が歌う動画、リップシンク、画像、ビデオクリップにも対応します。

  • サーバー URL: https://freebeat.ai/api/mcp (リモート、Streamable HTTP)
  • サインイン: freebeat アカウントによる OAuth。API キーは不要です。
  • 対応: ChatGPT、Codex、Claude、Claude Code、Cursor、そして OAuth でリモート MCP サーバーに接続できるすべてのエージェント。

接続

ChatGPT

  1. Settings → Apps → Advanced settings → Developer mode をオンにします。
  2. Plugins → Browse directory → Add → Add custom MCP server。名前は freebeat、URL は https://freebeat.ai/api/mcp、認証は OAuth にして、Connect をクリックします。
  3. freebeat にサインインして Allow をクリックします。

Codex(CLI、IDE 拡張機能、アプリ)

codex mcp add freebeat --url https://freebeat.ai/api/mcp codex mcp login freebeat

Claude(Web とデスクトップ)

  1. Customize → Connectors → Add → Add custom connector。
  2. 名前に freebeat、URL に https://freebeat.ai/api/mcp を入力し、Add、Connect の順にクリックします。
  3. freebeat にサインインして Allow をクリックします。

Claude Code

claude mcp add --transport http freebeat https://freebeat.ai/api/mcp

その後、Claude Code で /mcp を実行し、freebeat を選んでサインインします。

Cursor

freebeat を Cursor に追加するか、次の内容を ~/.cursor/mcp.json に記述して、Cursor の MCP 設定で Connect をクリックします。

{ "mcpServers": { "freebeat": { "url": "https://freebeat.ai/api/mcp" } } }

その他のエージェント

URL https://freebeat.ai/api/mcp でリモート MCP サーバーを追加します。サーバーは OAuth メタデータ(/.well-known/oauth-protected-resource/api/mcp と /.well-known/oauth-authorization-server)を公開し、PKCE を使った動的クライアント登録に対応しているため、MCP の認可仕様に従うクライアントならサインインできます。

クレジット

動画やその他の生成には freebeat のクレジットを使用します。新規アカウントには 500 クレジットが付与されます。エージェントは消費の前に確認します。有料ツールはすべて max_credits(使ってよい上限)を受け取り、事前に合計額を提示できない場合は accept_unknown_cost を受け取ります。ミュージックビデオ、リリックビデオ、ダンスビデオは段階ごとに課金されるため、合計額は事前にわからず、accept_unknown_cost が必要です。get_credit_balance で残高を確認でき、quote_generation で見積もり可能なツールの料金を確認できます。

ツール

ミュージックビデオ、歌詞ビデオ、ダンスビデオ

ツールできること
generate_music_video曲に合わせてカットされた複数シーンのミュージックビデオ。写真(最大 5 枚)を任意で追加すると、アーティストやキャラクターが登場します。720p または 1080p。
generate_lyric_videoボーカルに同期するアニメーション歌詞。768p または 2K。
generate_dance_video写真の人物が曲に合わせて踊ります(9:16 または 3:4、720p)。
get_video_session進行中のビデオについて、ディレクターのメッセージ、ステージ、メディア。
send_video_agent_messageディレクターにメモを送る、またはセッションを自動に切り替えます。

3 つのビデオツールはいずれも、曲(upload_audio または generate_music から得た music_id)、任意のプロンプトと写真、そして auto_mode を受け取ります。true ならディレクターがすべてを決め、false なら各ステージで一時停止してあなたのメモを待ちます(共同制作)。デフォルトでは曲の最初の 15 秒が使われます。別の部分を使うには start_ms と end_ms を指定します(上限はアカウントによります)。ビデオの作成には通常 15 分から 60 分かかり、freebeat のサーバー上で実行されます。結果にはビデオのリンクと freebeat.ai 上のページが含まれます。

音楽

ツールできること
list_music_models利用できる音楽モデル。
generate_musicプロンプトからオリジナル曲を作成。歌詞を指定すればその歌詞を使います。

歌とリップシンク

ツールできること
generate_singing_video写真、ペット、または 2 人(デュエット)が曲を歌います。
generate_lip_sync_video既存のビデオクリップを音声にリップシンクさせます。

画像、ビデオクリップ、テキスト

ツールできること
list_models, get_model_help利用できる画像・ビデオモデルと、それぞれの使い方。
generate_image, edit_image画像の作成または編集。
generate_video曲なしのビデオクリップ(テキストまたは画像からビデオ)。
generate_text言語モデルによるテキスト。
list_effects, generate_effect曲と画像 1 枚からエフェクトテンプレートのビデオを作成。

入力、進捗、クレジット

ツールできること
upload_audio添付ファイル、HTTPS の音声リンク、または SoundCloud、YouTube、Suno、Udio、TikTok、Stable Audio、Riffusion のページから曲を取り込みます。music_id を返します。
upload_image, upload_video参照用の画像とビデオクリップ。
get_task_status, get_task_resultタスクの進捗と完成した結果。
get_credit_balance, quote_generation残高と生成の料金。

接続解除

お使いのエージェントのコネクターまたは MCP 設定から freebeat を削除します。接続を解除すると、その接続からあなたのアカウントへのアクセスが取り消されます。

Last updated on