开始前你需要開始前你需要Before you start
- 一个 ChatGPT 账号。自定义 MCP 服务器需要你的版本能打开插件 / 应用设置。一個 ChatGPT 帳號。自訂 MCP 伺服器需要你的版本能開啟外掛 / 應用程式設定。A ChatGPT account. The custom MCP route needs a version that exposes plugin or app settings.
- 你的 Sonos 账户邮箱和密码。你的 Sonos 帳戶電子郵件和密碼。Your Sonos account email and password.
- 走自定义那条路的话,还需要装 ZoneFoundry 并已连上你的音箱。走自訂那條路的話,還需要裝 ZoneFoundry 並已連上你的喇叭。For the custom route you also need ZoneFoundry installed with your speakers connected.
先选路先選路Pick a route
| 你的情况你的情況Your situation | 走哪条走哪條Route |
|---|---|
| 英文界面、S2、想少几步英文介面、S2、想少幾步English UI, S2, want fewer steps | Sonos 官方插件Sonos 官方外掛Official Sonos plugin |
| 插件列表里搜不到 Sonos,或在中文环境用外掛清單裡搜不到 Sonos,或在中文環境用The plugin list has no Sonos, or you work in Chinese | ZoneFoundry 自定义 MCPZoneFoundry 自訂 MCPZoneFoundry custom MCP |
路 A:Sonos 官方插件路 A:Sonos 官方外掛Route A: the official Sonos plugin
Sonos 27 里的官方 MCP 叫 Sonos 27mcp,ChatGPT 那边把它做成了插件,所以在插件目录里直接能装,不用你填任何地址。官方帮助页写明目前是美式英语的版本。Sonos 27 裡的官方 MCP 叫 Sonos 27mcp,ChatGPT 那邊把它做成了外掛,所以在外掛目錄裡直接能裝,不用你填任何位址。官方說明頁寫明目前是美式英語的版本。Sonos 27's official MCP is called Sonos 27mcp; ChatGPT exposes it as a plugin, so you install it from the directory without typing a URL. Sonos's support page states it is available in US-English.
- 在 ChatGPT 打开 设置 → 插件(Plugins),在公开插件里浏览或搜索 Sonos,选 Install plugin。在 ChatGPT 開啟 設定 → 外掛(Plugins),在公開外掛裡瀏覽或搜尋 Sonos,選 Install plugin。In ChatGPT open Settings → Plugins, browse or search Public plugins for Sonos, and choose Install plugin.
- 授权窗口会请求 ChatGPT 控制你的 Sonos 系统。看完点 Okay。授權視窗會請求 ChatGPT 控制你的 Sonos 系統。看完點 Okay。The consent window asks for ChatGPT to control your Sonos system. Review it and select Okay.
- 点 Continue,然后登录你的 Sonos 账户。點 Continue,然後登入你的 Sonos 帳戶。Select Continue, then sign in to your Sonos account.
- 看一遍 ChatGPT 请求的权限,点 Okay。看一遍 ChatGPT 請求的權限,點 Okay。Review the permissions ChatGPT requests and select Okay.
- 开新对话,在输入框里打 Sonos,或者从插件菜单里选它。開新對話,在輸入框裡打 Sonos,或者從外掛選單裡選它。Start a new chat and type Sonos in the composer, or pick it from the Plugins menu.
路 B:ZoneFoundry 自定义 MCP路 B:ZoneFoundry 自訂 MCPRoute B: the ZoneFoundry custom MCP server
这条路不依赖官方插件目录,所以插件还没对你开放、或者你要中文工具说明时都能用。這條路不依賴官方外掛目錄,所以外掛還沒對你開放、或者你要中文工具說明時都能用。This route doesn't depend on the official plugin directory, so it works before the plugin reaches you — and when you want Chinese tool descriptions.
1. 复制连接器链接1. 複製連接器連結1. Copy the connector link
ZoneFoundry → 设置 →「AI 与聊天」→ AI 接入 → 点 ChatGPT 卡片 → 复制链接 https://relay.zonefoundry.dev/mcp。它和 Claude 卡片用的是同一个地址。ZoneFoundry → 設定 →「AI 與聊天」→ AI 接入 → 點 ChatGPT 卡片 → 複製連結 https://relay.zonefoundry.dev/mcp。它和 Claude 卡片用的是同一個位址。ZoneFoundry → Settings → AI & Chat → AI access → tap the ChatGPT card → copy the link https://relay.zonefoundry.dev/mcp. It's the same address the Claude card uses.
2. 在 ChatGPT 里添加自定义 MCP2. 在 ChatGPT 裡加入自訂 MCP2. Add a custom MCP server in ChatGPT
ChatGPT 这块界面改过几版,两种走法都能通。看你的版本长哪样:ChatGPT 這塊介面改過幾版,兩種走法都能通。看你的版本長哪樣:This part of ChatGPT's UI has changed across versions; both paths below work. Use whichever matches what you see:
- 新界面:打开
chatgpt.com/plugins→ 点 + → Add custom MCP server → 填名称和描述,在 Connection 里粘上 MCP 服务器地址,按页面配好认证。新介面:開啟chatgpt.com/plugins→ 點 + → Add custom MCP server → 填名稱和描述,在 Connection 裡貼上 MCP 伺服器位址,按頁面配好驗證。Newer UI: openchatgpt.com/plugins→ + → Add custom MCP server → name and description, paste the MCP server URL under Connection, and follow the page for authentication. - 旧界面:设置 → 应用(Apps)→ 高级设置,先开启开发者模式;回到应用点创建,MCP 服务器 URL 填这个链接,认证方式选 OAuth,创建后点连接。舊介面:設定 → 應用程式(Apps)→ 進階設定,先開啟開發者模式;回到應用程式點建立,MCP 伺服器 URL 填這條連結,驗證方式選 OAuth,建立後點連接。Older UI: Settings → Apps → Advanced settings, turn on Developer mode; back in Apps choose Create, paste the link as the MCP server URL, set Authentication to OAuth, create it and connect.
最后会有一个风险提示,勾选「我了解并继续」,然后 Create as a plugin。最後會有一個風險提示,勾選「我了解並繼續」,然後 Create as a plugin。You'll be asked to acknowledge a risk notice — accept it, then choose Create as a plugin.
3. 回手机填 6 位码3. 回手機填 6 位碼3. Enter the 6-digit code on your phone
连接过程中会出现 6 位数字码。回 ZoneFoundry App,在「输入授权码」里填进去并批准。码 5 分钟内有效;超时了回 ChatGPT 重新连一次就有新码。用 iPhone 相机扫那一页的二维码也能直接跳到 App 批准。連接過程中會出現 6 位數字碼。回 ZoneFoundry App,在「輸入授權碼」裡填進去並批准。碼 5 分鐘內有效;逾時了回 ChatGPT 重新連一次就有新碼。用 iPhone 相機掃那一頁的 QR 碼也能直接跳到 App 批准。A 6-digit code appears during the connection. Enter it in ZoneFoundry under Enter authorization code and approve. The code lasts five minutes; if it expires, reconnect in ChatGPT for a new one. Scanning the QR code on that page with the iPhone camera also jumps straight to the app.
两条路差在哪兩條路差在哪How the two routes differ
| 项目項目Item | Sonos 官方插件Sonos 官方外掛Official plugin | ZoneFoundryZoneFoundryZoneFoundry |
|---|---|---|
| 怎么装怎麼裝How to install | 插件目录里搜 Sonos外掛目錄裡搜 SonosSearch Sonos in the plugin directory | Add custom MCP server,粘贴地址Add custom MCP server,貼上位址Add custom MCP server, paste a URL |
| 确认方式確認方式Approval | 浏览器登录 Sonos 账户瀏覽器登入 Sonos 帳戶Sign in to Sonos in the browser | 手机上填 6 位授权码手機上填 6 位授權碼6-digit code on your phone |
| 工具说明语言工具說明語言Tool descriptions | 英文,34 个工具英文,34 個工具English, 34 tools | 中文 30 个 / 英文 27 个中文 30 個 / 英文 27 個30 in Chinese / 27 in English |
| 能不能挑工具能不能挑工具Can you scope tools | 官方工具名和参数会随时变化,不应当成稳定 API官方工具名和參數會隨時變化,不應當成穩定 APISonos says tool names and schemas evolve without notice — not a stable API | 中文端点另提供精简版工具集中文端點另提供精簡版工具集The Chinese endpoint also has a lite tool set |
| 系统要求系統要求System requirement | S2 软件 + Sonos 账户S2 軟體 + Sonos 帳戶S2 software + Sonos account | Sonos 账户(桥接可选)Sonos 帳戶(橋接可選)Sonos account (bridge optional) |
别把两个 Sonos 相关的 MCP 同时留在同一个 ChatGPT 会话里。Sonos 自己的文档就提醒:同一个助手挂多个 MCP 服务器时,「暂停」这种通用指令可能被路由到另一边,表现成没反应。別把兩個 Sonos 相關的 MCP 同時留在同一個 ChatGPT 對話裡。Sonos 自己的文件就提醒:同一個助理掛多個 MCP 伺服器時,「暫停」這種通用指令可能被路由到另一邊,表現成沒反應。Don't keep both Sonos-related MCP servers in one ChatGPT session. Sonos's own docs warn that with several MCP servers attached, a generic command like "pause" can be routed to the other one and appear to do nothing.
可以直接说的句子可以直接說的句子Things you can just say
接上之后不用背命令,正常说话就行。几句验证过的:接上之後不用背指令,正常說話就行。幾句驗證過的:No commands to memorise — talk normally. A few that work:
- 「列出我的房间」—— 最快自检,回真实房间名就通了。「列出我的房間」—— 最快自檢,回真實房間名就通了。"List my rooms" — the fastest check; real room names mean it works.
- 「客厅放周杰伦,音量 25」「客廳放周杰倫,音量 25」"Play Jay Chou in the living room at volume 25."
- 「把卧室音量调到 15」「把臥室音量調到 15」"Set the bedroom volume to 15."
- 「除了卧室,其他房间都放同一首歌」「除了臥室,其他房間都放同一首歌」"Play the same song everywhere except the bedroom."
如果它讲得像模像样但音箱没动,先怀疑工具调用没通 —— 回 App 看卡片是不是「已授权」,别急着怀疑音箱或网络。如果它講得像模像樣但喇叭沒動,先懷疑工具呼叫沒通 —— 回 App 看卡片是不是「已授權」,別急著懷疑喇叭或網路。If it talks a good game but nothing happens, suspect the tool call, not the speakers — check whether the card reads Authorized before blaming hardware or Wi-Fi.
常见报错常見報錯Common errors
401 Unauthorized401 Unauthorized401 Unauthorized
走 OAuth 时,401 往往只是正常的鉴权挑战,ChatGPT 接下来会拉起授权流程 —— 继续走完拿到 6 位码,不要因为看到 401 就放弃、改去生成密钥。用密钥接的情况才需要检查 token 是否完整。走 OAuth 時,401 往往只是正常的驗證挑戰,ChatGPT 接下來會拉起授權流程 —— 繼續走完拿到 6 位碼,不要因為看到 401 就放棄、改去產生金鑰。用金鑰接的情況才需要檢查 token 是否完整。On OAuth a 401 is often just the normal challenge and ChatGPT opens the consent flow next — finish it and get the 6-digit code. Don't abandon it for a key. Only key-based connections need a token completeness check.
405 Method Not Allowed405 Method Not Allowed405 Method Not Allowed
地址对了但请求方法不对。多半是拿 GET / SSE 去连只收 POST 的 /mcp/zh。把路径换成 /sse/zh,?token= 那一段原封不动保留。位址對了但請求方法不對。多半是拿 GET / SSE 去連只收 POST 的 /mcp/zh。把路徑換成 /sse/zh,?token= 那一段原封不動保留。The address is right but the method isn't. Usually GET or SSE against the POST-only /mcp/zh: change the path to /sse/zh and keep ?token= exactly as it was.
装好了但 ChatGPT 不调工具裝好了但 ChatGPT 不呼叫工具Installed, but ChatGPT won't call the tools
开新对话再试 —— 已经在进行的对话不会自动带上新接的工具。新对话里先让它「列出我的房间」,能回房间名就说明链路是通的,问题在措辞。開新對話再試 —— 已經在進行的對話不會自動帶上新接的工具。新對話裡先讓它「列出我的房間」,能回房間名就說明鏈路是通的,問題在措辭。Start a new chat — an existing one won't pick up newly connected tools. In the new chat ask it to list your rooms; if room names come back the link works and the problem is phrasing.
常见问题常見問題FAQ
ChatGPT 能直接控制 Sonos 吗?ChatGPT 能直接控制 Sonos 嗎?Can ChatGPT control Sonos directly?
能,但要通过 MCP。Sonos 在 Sonos 27 里提供了官方 MCP 服务器 27mcp,ChatGPT 那边以插件形式内置;也可以用 ZoneFoundry 的自定义 MCP 服务器。ChatGPT 本身不能直接连音箱。能,但要透過 MCP。Sonos 在 Sonos 27 裡提供了官方 MCP 伺服器 27mcp,ChatGPT 那邊以外掛形式內建;也可以用 ZoneFoundry 的自訂 MCP 伺服器。ChatGPT 本身不能直接連喇叭。Yes, but through MCP. Sonos ships an official MCP server (27mcp) in Sonos 27 that ChatGPT exposes as a plugin, or you can use ZoneFoundry's custom MCP server. ChatGPT cannot talk to the speakers directly.
找不到 Sonos 插件怎么办?找不到 Sonos 外掛怎麼辦?The Sonos plugin isn't there — now what?
官方的 Sonos 插件目前是美式英语的早期版本,不一定对所有账号或地区开放。找不到就走自定义 MCP 那条路,在 chatgpt.com/plugins 里选 Add custom MCP server,粘贴 https://relay.zonefoundry.dev/mcp。官方的 Sonos 外掛目前是美式英語的早期版本,不一定對所有帳號或地區開放。找不到就走自訂 MCP 那條路,在 chatgpt.com/plugins 裡選 Add custom MCP server,貼上 https://relay.zonefoundry.dev/mcp。The official Sonos plugin is an early US-English release and isn't necessarily open to every account or region. If it's missing, take the custom MCP route: on chatgpt.com/plugins choose Add custom MCP server and paste https://relay.zonefoundry.dev/mcp.
中文提问可以吗?中文提問可以嗎?Can I ask in Chinese?
可以。官方 27mcp 的安装和可用范围是美式英语,但连上之后指令可以用任何语言说。如果要让模型在中文工具名单里选工具,用 ZoneFoundry 的中文端点,工具名和说明都是中文的。可以。官方 27mcp 的安裝和可用範圍是美式英語,但連上之後指令可以用任何語言說。如果要讓模型在中文工具名單裡選工具,用 ZoneFoundry 的中文端點,工具名和說明都是中文的。Yes. The official 27mcp is US-English for setup and availability, but once connected you can phrase commands in any language. If you want the model choosing from a Chinese tool catalogue, use ZoneFoundry's Chinese endpoint — tool names and descriptions are in Chinese.
一定要开开发者模式吗?一定要開開發者模式嗎?Do I need developer mode?
取决于你的 ChatGPT 版本。有的版本要用 设置 → 应用 → 高级设置 → 开发者模式,再在应用里点创建;有的版本直接在 chatgpt.com/plugins 点 + 选 Add custom MCP server。判据是要能走到填 MCP 服务器 URL 那一步。取決於你的 ChatGPT 版本。有的版本要用 設定 → 應用程式 → 進階設定 → 開發者模式,再在應用程式裡點建立;有的版本直接在 chatgpt.com/plugins 點 + 選 Add custom MCP server。判據是要能走到填 MCP 伺服器 URL 那一步。It depends on your ChatGPT version. Some require Settings → Apps → Advanced settings → Developer mode, then Create under Apps; others let you go to chatgpt.com/plugins, hit + and pick Add custom MCP server. The test is reaching the field where you enter the MCP server URL.
连接时出现 401 要放弃吗?連接時出現 401 要放棄嗎?Should I give up when I see a 401?
不要。走 OAuth 连接器时,401 往往只是正常的鉴权挑战,ChatGPT 接下来会拉起授权流程,继续走完拿到 6 位码即可。只有用密钥时才需要检查 token 是否完整。不要。走 OAuth 連接器時,401 往往只是正常的驗證挑戰,ChatGPT 接下來會拉起授權流程,繼續走完拿到 6 位碼即可。只有用金鑰時才需要檢查 token 是否完整。Don't. On the OAuth connector a 401 is usually just the normal challenge and the consent flow follows — finish it and collect the 6-digit code. Only key-based connections need a token check.
接着看接著看Next
- Sonos MCP 是什么:官方 27mcp、端点与工具Sonos MCP 是什麼:官方 27mcp、端點與工具What Sonos MCP is: the official 27mcp, endpoints and tools
- Sonos 接入 Claude:官方连接器与自定义连接器Sonos 接入 Claude:官方連接器與自訂連接器Sonos + Claude: the official connector vs a custom one
- 四平台完整接入:Claude、ChatGPT、超级小爱、Muse四平台完整接入:Claude、ChatGPT、超級小愛、MuseAll four platforms: Claude, ChatGPT, Super XiaoAi, Muse