開始前你需要
- 小米 17 / K90 / 小米平板 8,已升級澎湃OS 4,超級小愛 8.2.3.1619 或更新。版本在超級小愛的「關於超級小愛」頁面查看,那裡有「檢查更新」。其他機型小米會陸續推送。
- iPhone 或 iPad 上已安裝 ZoneFoundry 1.0.14 或更新(舊版請先在 App Store 更新;1.0.11–1.0.13 亦可使用,步驟見文末「舊版本 App」),並已登入 Sonos 帳戶(ZoneFoundry 目前只有 iOS 版,連結要在這裡產生)。
- 小愛音箱暫時不行,只限手機、平板上的超級小愛。
在 iPhone 上產生專用連結
ZoneFoundry →「設定」(首頁右上角齒輪)→「AI 接入」→ 在「AI 應用程式」點「超級小愛」卡片 →「如何連接」第 1 步「產生超級小愛專用連結:」下點「產生連結」。
連結內已帶有密鑰(https://relay.zonefoundry.dev/mcp/zh?token=zfagt_…),毋須再自行組合網址。畫面上只顯示遮蔽版本;點「複製網址」或「分享」得到的才是完整連結。

連結只顯示這一次:離開這一頁後便無法再查看。不小心關掉了也沒關係,再點一次「產生連結」產生一條新的即可(舊的可以在卡片的「已連線」列表撤銷)。
把連結傳到小米手機
點「分享」直接發送,或者點「複製網址」後發到微信「文件傳輸助手」,在小米手機上打開,複製整條連結(以 https://relay.zonefoundry.dev/mcp/zh?token= 開頭)。
取得這條連結的人就能控制你家的 Sonos,不要發到群組或公開的地方。
在超級小愛裡加入 MCP 服務
超級小愛 →「MCP 服務」→ 右上角「+」,打開「添加 MCP 服務」,按下面填寫:
- 名稱:zonefoundry
- 伺服器 URL:貼上第 2 步的整條連結(中間不要有空格)
- Auth Token:留空
點「添加」。如果連不上,換另一種填法:伺服器 URL 只填下面這條,Auth Token 填 Bearer 加一個空格,再加連結內 token= 後面那一串(zfagt_…,這就是你的密鑰):
https://relay.zonefoundry.dev/mcp/zh
Bearer 这里换成你的密钥
⚠️ 伺服器 URL 只填網址,不要貼整段設定;網址是 /mcp/zh 結尾(帶密鑰時是 /mcp/zh?token=…)。加好之後,頂部會顯示「1 個伺服器已連接、29 個 MCP 工具可用」;如果顯示「已失效」,多半是網址或密鑰填錯了。
切到「專家」模式,對小愛說一句話
在小愛對話頁面,點輸入框上方最左邊的「快速 >」,換成「專家」。「快速」模式只用小愛自己的功能,不會調用 Sonos。
然後說(或打字)下面這些,句子前面帶上「用 sonos」:
- 「用 sonos 查一下我家有哪些房間」
- 「用 sonos 在客廳放周杰倫」
- 「用 sonos 全屋暫停」
- 「用 sonos 客廳大聲一點」
- 「用 sonos 十分鐘後在客廳提醒我關火」
房間名換成你家 Sonos 裡的名稱。不帶「用 sonos」直接說「播放 XX」,小愛會用它自己的音樂,不會交給 Sonos。
命令速查:這些說法都經過實測
每句都以「用 sonos」開頭;「客廳」「臥室」換成你家 Sonos 裡的房間名稱。
播放
- 用 sonos 在客廳放周杰倫
- 用 sonos 在客廳播新聞
暫停、繼續、切歌
- 用 sonos 客廳暫停
- 用 sonos 客廳繼續播放
- 用 sonos 全屋暫停
- 用 sonos 下一首 / 上一首
- 用 sonos 客廳單曲循環
音量
- 用 sonos 客廳大聲一點
- 用 sonos 把客廳音量調到 20
- 用 sonos 客廳靜音
- 用 sonos 撤銷剛才的音量改動
房間
- 用 sonos 查有哪些房間
- 用 sonos 把客廳的音樂轉到臥室
- 用 sonos 讓客廳和臥室一起播放
播報和提醒
- 用 sonos 在客廳播報:晚飯好了
- 用 sonos 十分鐘後在客廳提醒我關火
收藏和歌單
- 用 sonos 我收藏了哪些
- 用 sonos 我有哪些歌單
說「放周杰倫」這類沒有指定音樂服務的話,會使用你在 ZoneFoundry App 裡設定的預設服務(QQ 音樂、網易雲音樂或 Apple Music)。
舊版本 App(1.0.11–1.0.13):自行組合網址
舊版本沒有超級小愛卡片,要先產生存取密鑰再自行組合網址。可以更新的話,建議直接更新到 1.0.14。
- 「AI 接入」→ 拉到頁面最底部,點「進階」下面的「存取密鑰」→ 在「產生密鑰」下名稱填「小愛」→ 點名稱欄旁邊的「產生」→「複製整段」。
- 把整段傳到小米手機,找到「Authorization 標頭:Bearer zfagt_…」那一行,只複製
zfagt_開頭的那一串。 - 伺服器 URL 填下面這一整條,把「这里换成你的密钥」換成你的
zfagt_…(中間不要有空格),其餘按第 3 步:
https://relay.zonefoundry.dev/mcp/zh?token=这里换成你的密钥
遇到問題?請把這些截圖發到群組
- 超級小愛版本號、手機型號、澎湃OS 版本
- MCP 入口在哪裡,有沒有要求開啟甚麼模式或付費
- 用的是哪種填法(Auth Token / 網址帶密鑰),顯示幾個工具
- 說完指令後小愛怎樣回應,喇叭有沒有聲
截圖裡如果露出了 zfagt_ 密鑰,先打碼再發。
常見問題
MCP 服務顯示「已失效」?
多半是連結沒有完整複製,或者網址、密鑰填錯了。使用卡片產生的連結時,確認整條都已貼上、中間沒有空格或換行;手動填寫時,檢查伺服器 URL 是否以 /mcp/zh 結尾(帶密鑰時是 /mcp/zh?token=…),密鑰是否完整、以 zfagt_ 開頭。仍然不行就換另一種填法(見第 3 步),或在卡片內重新產生一條連結。
說了沒反應,或者小愛播放了它自己的音樂?
最常見有兩個原因:對話頁左下角仍是「快速」,沒有切到「專家」;或者句子前面沒有帶「用 sonos」。兩樣都改好再說一次。
提示某個房間暫時連不上?
通常是那部喇叭在休眠或 Wi-Fi 不穩定,稍等一會再試。
找不到 MCP 入口?
多半是超級小愛版本太舊或機型仍未推送。先到「關於超級小愛」點「檢查更新」,確認是 8.2.3.1619 或更新。
連結或密鑰不小心發出去了?
在 ZoneFoundry「AI 接入」→「超級小愛」卡片的「已連線」列表點選那一條 →「撤銷此鑰匙」(亦可在「進階」→「存取密鑰」內撤銷),即時失效。然後在卡片內點「產生連結」產生一條新的,重新填入超級小愛。
沒有 iPhone 可以用嗎?
暫時不行。專用連結要在 ZoneFoundry App 裡產生,App 目前只有 iPhone / iPad 版。