RaoMusic 外掛:讓你的 Agent 來做音樂
在 Claude Code、Codex、Cursor 等工具中生成完整歌曲與音效。 了解運作方式
將 RaoMusic 新增為連接器
不需要 API 金鑰,用你的 RaoMusic 帳號登入即可。
1. 開啟 Claude(桌面應用程式或 claude.ai)→ Settings → Connectors。
2. 點選 "Add custom connector"。名稱:RaoMusic。URL:https://www.raomusic.com/api/mcp
3. 點選 Connect,登入 RaoMusic 後點選「允許」。
4. 在對話中從工具選單開啟 RaoMusic,然後請它寫一首歌。1. 開啟 Claude(桌面應用程式或 claude.ai)→ Settings → Connectors。
2. 點選 "Add custom connector"。名稱:RaoMusic。URL:https://www.raomusic.com/api/mcp
3. 點選 Connect,登入 RaoMusic 後點選「允許」。
4. 在對話中從工具選單開啟 RaoMusic,然後請它寫一首歌。1. 開啟 ChatGPT → Settings → Apps → Advanced settings,開啟 Developer mode。
2. 點選 "Create app"。名稱:RaoMusic。MCP server URL:https://www.raomusic.com/api/mcp。Authentication:OAuth。
3. 點選 Create,登入 RaoMusic 後點選「允許」。
4. 在對話中從工具選單選擇 RaoMusic,然後請它寫一首歌。1. 開啟 ChatGPT → Settings → Apps → Advanced settings,開啟 Developer mode。
2. 點選 "Create app"。名稱:RaoMusic。MCP server URL:https://www.raomusic.com/api/mcp。Authentication:OAuth。
3. 點選 Create,登入 RaoMusic 後點選「允許」。
4. 在對話中從工具選單選擇 RaoMusic,然後請它寫一首歌。幫我安裝 RaoMusic(不需要 API 金鑰):
1. 執行:
claude plugin marketplace add raomusic/raomusic-plugin
claude plugin install raomusic@raomusic
2. 重新啟動 Claude Code,執行 /mcp,選擇 raomusic 並登入 RaoMusic。
3. 如有需要請重新啟動,然後呼叫 check_account 工具確認連線成功,並告訴我目前的點數餘額。claude plugin marketplace add raomusic/raomusic-plugin
claude plugin install raomusic@raomusic幫我安裝 RaoMusic(不需要 API 金鑰):
1. 執行:
codex mcp add raomusic --url https://www.raomusic.com/api/mcp
codex mcp login raomusic
2. login 指令會在瀏覽器開啟 RaoMusic,登入後點選「允許」即可。
3. 如有需要請重新啟動,然後呼叫 check_account 工具確認連線成功,並告訴我目前的點數餘額。codex mcp add raomusic --url https://www.raomusic.com/api/mcp
codex mcp login raomusic幫我設定 RaoMusic MCP server:
1. 向我索取 RaoMusic API 金鑰(我可以在 https://www.raomusic.com/zh-TW/plugin/keys 建立),並將它儲存為環境變數 RAOMUSIC_API_KEY。
2. 將以下內容加入 ~/.cursor/mcp.json(與現有的 MCP server 設定合併):
{
"mcpServers": {
"raomusic": {
"url": "https://www.raomusic.com/api/mcp",
"headers": {
"Authorization": "Bearer ${env:RAOMUSIC_API_KEY}"
}
}
}
}
3. 如有需要請重新啟動,然後呼叫 check_account 工具確認連線成功,並告訴我目前的點數餘額。{
"mcpServers": {
"raomusic": {
"url": "https://www.raomusic.com/api/mcp",
"headers": {
"Authorization": "Bearer ${env:RAOMUSIC_API_KEY}"
}
}
}
}幫我設定 RaoMusic MCP server:
1. VS Code 會在伺服器首次啟動時向我索取 RaoMusic API 金鑰(我可以在 https://www.raomusic.com/zh-TW/plugin/keys 建立)。
2. 將以下內容加入 .vscode/mcp.json(與現有的 MCP server 設定合併):
{
"inputs": [
{
"type": "promptString",
"id": "raomusic-key",
"description": "RaoMusic API key",
"password": true
}
],
"servers": {
"raomusic": {
"type": "http",
"url": "https://www.raomusic.com/api/mcp",
"headers": {
"Authorization": "Bearer ${input:raomusic-key}"
}
}
}
}
3. 如有需要請重新啟動,然後呼叫 check_account 工具確認連線成功,並告訴我目前的點數餘額。{
"inputs": [
{
"type": "promptString",
"id": "raomusic-key",
"description": "RaoMusic API key",
"password": true
}
],
"servers": {
"raomusic": {
"type": "http",
"url": "https://www.raomusic.com/api/mcp",
"headers": {
"Authorization": "Bearer ${input:raomusic-key}"
}
}
}
}幫我設定 RaoMusic MCP server:
1. 向我索取 RaoMusic API 金鑰(我可以在 https://www.raomusic.com/zh-TW/plugin/keys 建立),並將它儲存為環境變數 RAOMUSIC_API_KEY。
2. 將以下內容加入 ~/.config/devin/mcp_config.json(與現有的 MCP server 設定合併):
{
"mcpServers": {
"raomusic": {
"serverUrl": "https://www.raomusic.com/api/mcp",
"headers": {
"Authorization": "Bearer ${env:RAOMUSIC_API_KEY}"
}
}
}
}
3. 如有需要請重新啟動,然後呼叫 check_account 工具確認連線成功,並告訴我目前的點數餘額。{
"mcpServers": {
"raomusic": {
"serverUrl": "https://www.raomusic.com/api/mcp",
"headers": {
"Authorization": "Bearer ${env:RAOMUSIC_API_KEY}"
}
}
}
}幫我設定 RaoMusic MCP server:
1. 向我索取 RaoMusic API 金鑰(我可以在 https://www.raomusic.com/zh-TW/plugin/keys 建立),並將它儲存為環境變數 RAOMUSIC_API_KEY。
2. 將以下內容加入 ~/.gemini/settings.json(與現有的 MCP server 設定合併):
{
"mcpServers": {
"raomusic": {
"httpUrl": "https://www.raomusic.com/api/mcp",
"headers": {
"Authorization": "Bearer $RAOMUSIC_API_KEY"
}
}
}
}
3. 如有需要請重新啟動,然後呼叫 check_account 工具確認連線成功,並告訴我目前的點數餘額。{
"mcpServers": {
"raomusic": {
"httpUrl": "https://www.raomusic.com/api/mcp",
"headers": {
"Authorization": "Bearer $RAOMUSIC_API_KEY"
}
}
}
}看看 RaoMusic 外掛能做什麼
我來用 RaoMusic 外掛。ACE-Step 很適合純音樂 lo-fi,而且按秒計費,所以我會先取得精確報價再開始生成。
- estimate_credits:ACE-Step,90 秒,純音樂,15 點數。你已確認。
- generate_music:已開始生成,並帶上固定的冪等鍵,重試也不會重複扣款。
- get_generation:完成。這是你的曲子,可以直接下載。
結果
讀書 vlog lo-fi
ACE-Step 1.5 · 1:30
我用 Rao/Suno 的簡單模式來生成,它會幫你寫好歌詞。每次生成兩個版本讓你挑選,使用 20 點數。
- generate_music:Rao v1.0,簡單模式,20 點數。
- get_generation:兩個版本都好了,附上歌詞和封面。
結果

Write It, Run It
Rao v1.0 · 2:30
Write it, run it, let it go We're making something out of code One small spark, then watch it grow

Write It, Run It
Rao v1.0 · 2:37
Write it, run it, let it go We're making something out of code One small spark, then watch it grow
短的純音樂片頭,選 ACE-Step 並關閉 thinking 最便宜:30 秒只要 10 點數。
- estimate_credits:ACE-Step,30 秒,關閉 thinking,10 點數。
- generate_music → get_generation:你的片頭小曲好了。
結果
Podcast 片頭小曲
ACE-Step 1.5 · 0:30
所有引擎,一個錢包
Agent 使用與 RaoMusic 網站相同的點數與價格,生成的歌曲一樣會進入你的音樂庫。
Rao / Suno
20 點數 · 每次 2 首 · 部分版本需要訂閱
Google Lyria 3.5
20 點數 · 每次 1 首
Mureka
30 點數 · 每次 2 首 · 部分版本需要訂閱
MiniMax
40 點數 · 每次 1 首
ACE-Step 1.5
最低 10 點數 · 每次 1 首
YuE 2
最低 30 點數 · 每次 1 首
ElevenLabs
40 點數/分鐘 · 每次 1 首 · 部分版本需要訂閱
大家都請 Agent 做什麼
連上伺服器後,複製一段提示詞貼給你的 Agent。
幫這支產品影片做一段 30 秒的輕快純音樂。先告訴我價格。
寫一首關於深夜寫程式的歌詞,並做成女聲 lo-fi 歌曲。
用 ACE-Step 為我的 Podcast 生成三段不同的片頭音樂,並給我下載連結。
為這支遊戲預告片配樂:暗黑 synthwave,90 秒,不要人聲。
交給 Agent,也不會亂花你的點數
先報價再花費
Agent 可使用免費的估價工具,並被要求在生成前先與你確認費用。
可選的每日上限
為任一金鑰或連線設定 24 小時點數上限,即使金鑰外洩也不會耗光你的餘額。
不會重複扣款
每次生成都帶有冪等鍵,逾時後重試也絕不會重複扣款。
隨時撤銷
撤銷金鑰後立即失效,還能看到每把金鑰的最近使用時間。
常見問題
MCP(Model Context Protocol)是 AI Agent 呼叫外部工具的開放標準。Claude Code、Codex、Cursor、Windsurf 等都支援,所以同一個 RaoMusic 伺服器在這些工具中都能使用。
不需要。Agent 生成使用的是你一般的 RaoMusic 點數,價格與網站相同,沒有另外的 API 方案。
與網站相同:Rao/Suno、Google Lyria、Mureka、MiniMax、ACE-Step、YuE 和 ElevenLabs。Agent 可以列出它們及目前價格。
可以。透過 Agent 生成的歌曲與在網站上生成的歌曲適用相同的商用授權。
歌曲會在你的音樂庫中保留至目前方案的儲存期限。想長期保存的請記得下載。
為你的 Agent 配上音樂
建立金鑰、貼上一行指令,然後請它寫首歌。