Claude · Codex · Gemini CLI
音樂庫 MCP 伺服器
將 Claude 或 Codex 連接到 MyMusik。透過 AI 管理標籤、資料夾和播放清單,控制播放、剪輯音軌,以及匯入或匯出音樂。

從 Insights 連接 Claude 或 Codex
首次連線時,請讓代理列出音樂庫中的三張專輯,再到 MyMusik 的專輯頁面核對結果。
- 開啟 MyMusik,前往 Insights(/insights),找到「連接裝置」。
- 選取盾牌圖示,設定權限和存取時間,再選取「套用」。若想先了解音樂庫,可以從「唯讀」權限開始。
- 選擇「複製代理提示詞」(小螢幕上顯示為「AI 代理」)。每次複製都會建立一個新的單次使用邀請。
- 執行 mymusik-mcp pair,只貼上含有 #grant= 的邀請網址。
- 請助理列出 MyMusik 音樂庫中的三張專輯。
請讓 MyMusik 保持執行。代理需要 MCP 或 HTTP 工具,並且必須能透過網路連線到應用程式。
用 AI 控制音樂應用程式
讓 AI 參與音樂庫管理的完整流程:尋找音軌、整理收藏、編輯音訊和聆聽音樂。MyMusik 的音樂 MCP 伺服器會依照你選擇的權限,讓代理程式存取應用程式操作。描述你想要的結果,代理程式就能組合多項操作來完成任務。
這些只是請求範例,並不代表會自動執行的操作,也不保證選曲結果。如需在變更前確認,請要求先查看建議的修改;連線實際能執行哪些操作取決於權限。
不必逐頁瀏覽即可尋找音樂
「在我的音樂庫中尋找 [artist] 的專輯,並列出音軌。」讓代理程式搜尋歌曲、專輯、藝人、播放清單和應用程式管理的資料夾,再協助你選擇。
一邊工作,一邊聽音樂
「播放 [playlist],等我提出要求時再暫停。」取得播放權限後,代理程式就能在你繼續對話時操作播放器和播放佇列。
透過對話建立播放清單
「從這些藝人的作品中推薦 12 首歌。先讓我查看選擇,等我同意後,再儲存為『工作日』。」讓代理程式收集音軌,並使用音樂庫編輯權限建立播放清單。
管理整個音樂庫的標籤
「為這些歌曲和專輯加上『公路旅行』標籤,並保留現有標籤。」你可以為支援的音樂項目建立、重新命名、指派和移除音樂庫標籤,依自己的分類整理收藏。
建立和整理巢狀資料夾
「建立『公路旅行』資料夾,在其中加入『夏日』子資料夾,再加入這些專輯。」建立、重新命名和移動應用程式資料夾及其中的項目。這些資料夾用來整理音樂庫參照,不會移動原始檔案。
更新音軌和專輯資訊
「列出專輯名稱有誤的音軌,再套用我確認的更正。」編輯支援的音樂庫中繼資料,讓整個收藏中的名稱保持一致。
用 AI 匯入、剪輯和匯出音樂
將一項完整的音樂任務交給代理程式,讓它使用應用程式的匯入、音訊編輯和匯出工具。它能檢查工作進度,並在對話中回報結果。
選擇「自訂存取」,並包含整個任務所需的資源群組。例如,編輯音訊並建立歌曲,可能同時需要「匯入與檔案」和「音樂庫」權限。應用程式與代理程式也必須支援儲存或下載產生的檔案。
匯入音樂並追蹤進度
「匯入這個資料夾中的音訊,檢查結果,並告訴我哪些音軌需要處理。」可使用可讀取的檔案、資料夾或支援的音訊 URL。執行 MyMusik 的裝置必須能存取這些來源;音軌會自動接受還是需要審核,取決於匯入設定。
剪下、修剪或擷取音軌
「將這首歌的 00:30 到 01:00 擷取為一首獨立歌曲,並保留原始檔。」使用精確的時間範圍來移除片段,或據此建立新音軌。音訊編輯需要有效的時間範圍和可編輯的本機音訊。
匯出播放清單和音樂收藏
「將這份播放清單匯出為 M3U8,並把其中的音軌打包成 ZIP。」你可以匯出播放清單參照,或將專輯、播放清單及音樂庫資料夾中的歌曲打包為帶有標籤的 MP3 音訊。ZIP 匯出最多支援 1,000 首音軌,且音訊必須可匯出。M3U8 檔案參照媒體位置,因此在其他地方使用時,仍需能存取這些檔案或 URL。
決定授予多少存取權限
使用連線卡片上的盾牌圖示,為任務選擇合適的存取權限。每次執行操作時,應用程式都會檢查工作階段權限。
變更所選權限不會改變既有的工作階段。請複製新的 AI 提示詞,並使用新邀請重新連線。提示詞能提供對應用程式的私人存取,請只與信任的代理程式分享。
唯讀
在不允許修改的情況下,瀏覽並彙整有權存取的音樂庫資訊。可先用此權限檢查連線並討論計畫。
遠端播放
允許使用管理聆聽所需的播放器和佇列控制功能。此預設也會授予整個公開 API 的讀取權限。
音樂庫編輯器
允許對音軌、專輯、藝人、播放清單、標籤和應用程式資料夾進行支援的修改。用於整理收藏和更新音樂庫資訊。
匯入管理員
允許執行匯入、音訊編輯、封存和檔案操作。如果工作流程也會修改音樂庫項目,可能需要額外的「音樂庫」權限。
自訂存取
組合「播放」「音樂庫」和「匯入與檔案」資源群組,並為任務選擇所需的存取層級,讓單一代理程式能完成跨應用程式功能的工作流程。
透過 MCP 用 AI 管理音樂庫
MCP 是 Model Context Protocol(模型上下文協定)的縮寫。MyMusik 將文件中說明的應用程式操作公開為代理程式可探索和使用的工具。代理程式能查詢與請求相關的控制項,並從應用程式取得結果。
應用程式控制僅涵蓋權限範圍內公開的 API 操作,不提供對電腦滑鼠和鍵盤的一般控制。
減少手動設定
複製的提示詞包含邀請、連線說明、權限和復原步驟,不必為每項音樂任務另外撰寫整合。
為任務留出更多空間
代理程式能只擷取所需的操作詳情和結果欄位,並分頁讀取較大的結果,避免將整個 API 目錄載入對話。
執行前檢查請求
MCP 伺服器能驗證擬定的 API 請求,而不實際執行。驗證會檢查引數和適用的存取規則;真正執行操作時,仍會進行操作本身的檢查。
確保連線能到達應用程式
最簡單的方式,是在執行 MyMusik 的同一台電腦上執行代理程式。遠端代理程式也需要能到達執行中應用程式的網路路徑。
- 若要從區域網路中的另一台裝置連線,請檢查「設定 → Web 伺服器 → 允許遠端存取」。變更連線設定後,請複製新的提示詞。
- 在雲端沙箱中執行的代理程式,無法自動存取你電腦的 localhost。請在本機執行代理程式,或設定可到達的連線;複製的提示詞中包含網路連線指引。
- 如果邀請已過期或已使用,請複製新的 AI 提示詞。如果 MyMusik 已關閉或暫停執行,請重新開啟後再試。
幾個實用細節
AI 代理程式能控制整個應用程式嗎?
它能使用 MyMusik 公開的各項應用程式功能,包括音樂庫整理、標籤、資料夾、播放清單、播放、匯入、音訊編輯和匯出。可用操作取決於已安裝的版本、平台及連線權限。代理程式透過應用程式的 API 完成任務,不必逐個畫面點選。
所有 Codex 或 Claude 環境都能使用嗎?
代理程式需要可用的 MCP 或 HTTP 工具、建立連線的權限,以及對應用程式的網路存取能力。只將提示詞貼到純文字聊天中,無法建立連線。交付音樂任務前,請先讓代理程式驗證存取情況。
可以使用標準 MCP 用戶端嗎?
可以。配對後,請將用戶端設為執行 mymusik-mcp stdio。
這和 MyMusik 內建的 AI 語音功能一樣嗎?
此連線讓你選擇的外部代理程式與 MyMusik 協作。應用程式內的 AI 語音功能有獨立的設定。外部代理程式的帳戶、模型和計費要求仍然適用;由 AI 驅動的應用程式操作也可能需要相應的服務存取權限。
音樂應用程式或代理程式需要一直開著嗎?
MyMusik 的原生伺服器必須持續執行且可存取。結束或暫停應用程式會中斷存取。工作階段有有效期限,重新連線時可能需要新的邀請。中斷連線不一定會取消已在應用程式中啟動的工作。
代理程式能看到哪些資訊?
它能請求工作階段權限允許的應用程式資料。這些資料由你使用的代理程式和模型供應商處理。「唯讀」會阻止寫入,但仍允許讀取資料。請依需要選擇範圍較小的「自訂」權限,並妥善保管邀請和工作階段憑證。


