1
打開 Claude Desktop 配置
啟動 Claude Desktop，打開本地 MCP 伺服器配置。
價格方案
低至7折
登入
將
Claude變成音樂影片引擎
將 freebeat 連接到 Claude、Cursor、Windsurf 和 Claude Code，直接在對話中生成音樂影片和 AI 影片特效。
Claude Desktop
2
新增 freebeat MCP 伺服器
命名為 freebeat，並新增本地 MCP 伺服器命令：
3
設定 FREEBEAT_API_KEY
在 freebeat 建立 API Key，新增到 MCP 環境變數，然後讓 Claude 啟動音樂影片任務。
命令集
auth
在本地保存和查看 freebeat API Key，也可以按單條命令傳入 --api-key。
set-api-keyshow--api-key
assets
從本地檔案或來源連結上傳音訊，並上傳一到兩張參考圖片。
upload-audioupload-imagemusic_id
effects
列出可用影片特效，查看 effect_id、預覽素材、預設音樂和畫面比例。
listeffect_idpreview
mv
基於已上傳歌曲、提示詞、參考圖片和畫面比例提交或執行 AI 音樂影片生成。
submitrun--json
effect
透過 effect_id、music_id、圖片 URL 和提示詞生成特效範本短片。
submitruneffect_id
task
查詢狀態、等待完成，並從已完成任務中取得 video_url 和 cover_url。
statuswaitresult
Claude 裡的完整音樂影片工作室
音樂影片生成、AI 特效、媒體上傳和任務管理，都在同一個連線裡完成
終端機
> 為這首歌生成霓虹城市風格音樂影片
--aspect 9:16
--reference cover.png
● freebeat
正在上傳音訊...
正在建立音樂影片任務...
→ ./output/neon_mv.mp4
生成媒體
音樂影片生成
從一首歌、一段提示詞或一個音樂連結開始，讓 Agent 調用 freebeat 生成完整 MV，支援比例、參考素材、特效和非同步渲染結果。
特效引擎
一句提示詞生成音樂短片
讓 Agent 查找合適的影片特效，自動填入音樂、參考圖片和提示詞，生成適合行銷和社群發布的短片。
Agent
> 查找適合產品發布預熱的影片特效
● freebeat
找到 8 個匹配特效。
正在生成 3 個影片版本...
✓ 直式預熱影片
✓ 方形社群短片
模式
upload_audio 匯入音訊或來源連結
upload_image 新增一到兩張參考圖
list_effects 查看 effect_id 選項
generate_music_video 啟動 MV 任務
generate_effect 啟動特效任務
get_task_status 輪詢任務狀態
get_task_result 取得 video_url + cover_url
模式
選擇特效，跳過複雜配置
從 effect_id、預設音樂、推薦參考圖和範本說明開始。Agent 可以先比較範本，再選擇最適合的生成方式。
自動化
從歌曲資料夾到影片流水線
CLI 和 MCP 使用同一套任務模型。你可以讓 Claude 規劃創意，也可以用終端機腳本批量上傳、生成、等待並保存 JSON。
終端機
> 從 ./songs 批量生成 5 個音樂影片
● freebeat
正在讀取資料夾...
正在提交任務...
✓ 已保存 5 個任務 ID
✓ results.json 已準備好
你的 Agent 裡的完整音樂影片工作室
音訊上傳、參考圖片、特效範本和渲染結果，都在一個 MCP 連線裡完成
從創意到內容，一次對話完成
告訴 Claude 你要製作什麼，它會選擇合適的 freebeat MCP 工具並交付可用的音樂影片結果
音樂人發布
上傳完成的歌曲，選擇視覺方向，生成適合發布的直式或橫式影片。
社群內容創作
把一首歌拆成多條短影片、開場 hook、視覺循環和基於範本的特效短片。
行銷團隊
透過歌曲、參考圖和簡短 brief 生成產品預熱影片和 campaign 變體。
自動化腳本
使用 CLI 進行可重複批量任務、本地資料夾處理、JSON 輸出和定時內容流水線。
從想法到音樂影片，一次對話完成
可以從一次生成開始，也可以深入到特效發現、參考素材、批量任務和輪詢狀態。Claude 會處理整個流程
幾秒提交一個音樂影片任務
描述氛圍、比例和音樂來源。Claude 會選擇 freebeat MCP 工具並返回 task_id。
為這首歌生成 9:16 賽博龐克風格 MV
在對話中建構發布素材包
建立主 MV、方形裁切和短影片變體，同時保持統一視覺方向。
製作三個社群版本並保存所有影片連結
比較特效並發布最佳結果
列出 freebeat 特效、生成多個版本、等待完成，並選擇最強輸出。
試用 4 個特效，並展示完成的影片
還有問題嗎？
這裡是最常見的問題
freebeat 如何連接到 AI Agent？
在相容 MCP 的用戶端裡新增 freebeat MCP 伺服器。命令是 npx -y freebeat-mcp，並透過 FREEBEAT_API_KEY 環境變數授權。
在哪裡建立 API Key？
登入 freebeat 後打開 /music-video-generator/profile，在 API Keys 區域建立。此頁面的 API Keys 入口也會指向那裡。
支援哪些 Agent？
Claude Desktop、Cursor、Windsurf、Claude Code 以及其他相容 MCP 的用戶端都可以使用同一套配置。
MCP 和 CLI 有什麼區別？
MCP 面向 Agent 對話調用，CLI 面向終端機和腳本。兩者都支援上傳、特效、生成、輪詢和結果讀取。
為什麼生成任務需要輪詢？
音樂影片渲染需要時間。freebeat 會先返回 task_id，然後 Agent 或 CLI 查詢狀態，完成後取得 video_url。
可以建立什麼內容？
可以建立音樂影片、範本特效短片、直式社群影片、橫式 MV，以及使用參考圖控制風格的版本。
需要把 API Key 寫進提示詞嗎？
不需要。Key 應該保存在 MCP 環境配置或 CLI 憑據中。提示詞只需要描述創作任務。
結果可以用於自動化流程嗎？
可以。完成後的任務會返回結構化連結和狀態欄位，適合寫入 JSON、表格、內容日曆和腳本。
