Sonos MCP 是什么：官方 27mcp、端点与工具 Sonos MCP 是什麼：官方 27mcp、端點與工具 What Sonos MCP is: the official 27mcp, endpoints and tools

一句话：现在有两套 Sonos MCP一句話：現在有兩套 Sonos MCPThe short version: there are two Sonos MCP servers now

MCP（Model Context Protocol）是让 AI 助手调用外部工具的一套标准。AI 本身不会「控制音箱」，它只会按工具说明书去发起调用。所以「Sonos 支持 MCP」的意思是：有人写好了一台服务器，把播放、音量、分组这些动作包成有名字的工具，AI 照着调用。MCP（Model Context Protocol）是讓 AI 助理呼叫外部工具的一套標準。AI 本身不會「控制喇叭」，它只會按工具說明書去發起呼叫。所以「Sonos 支援 MCP」的意思是：有人寫好了一台伺服器，把播放、音量、分組這些動作包成有名字的工具，AI 照著呼叫。MCP (Model Context Protocol) is the standard that lets an AI assistant call outside tools. The model itself can't "control speakers" — it just makes calls according to a tool catalogue. So "Sonos supports MCP" means someone runs a server that wraps play, volume and grouping into named tools the model can call.

目前有两台这样的服务器，都在运行：目前有兩台這樣的伺服器，都在運作：Two such servers exist right now, and both are live:

• Sonos 官方的 Sonos 27mcp，地址 https://mcp.ws.sonos.com/mcp，34 个工具，2026 年 9 月随 Sonos 27 发布。Sonos 官方的 Sonos 27mcp，位址 https://mcp.ws.sonos.com/mcp，34 個工具，2026 年 9 月隨 Sonos 27 發布。Sonos's own Sonos 27mcp at https://mcp.ws.sonos.com/mcp, 34 tools, shipped with Sonos 27 in September 2026.
• ZoneFoundry 的 MCP，地址 https://relay.zonefoundry.dev/mcp，英文 27 个工具、中文 30 个，工具说明是中文的。ZoneFoundry 的 MCP，位址 https://relay.zonefoundry.dev/mcp，英文 27 個工具、中文 30 個，工具說明是中文的。ZoneFoundry's MCP at https://relay.zonefoundry.dev/mcp — 27 tools in English, 30 in Chinese, with Chinese tool descriptions.

两者互不隶属，也互不依赖。你可以在不同助手裡各接一个。兩者互不隸屬，也互不依賴。你可以在不同助理裡各接一個。They are independent: neither one needs the other. You can connect a different one to a different assistant.

Sonos 官方 27mcpSonos 官方 27mcpSonos's official 27mcp

官方把它描述成「第一个可以直接从 AI 助手控制 Sonos 的官方方式」。要点如下：官方把它描述成「第一個可以直接從 AI 助理控制 Sonos 的官方方式」。要點如下：Sonos describes it as the first official way to control Sonos straight from an AI assistant. The essentials:

ZoneFoundry 的 MCPZoneFoundry 的 MCPZoneFoundry's MCP

我们这一台是围绕中文场景做的：工具说明是中文，除了标准 MCP 之外还提供一条用密钥的接入方式，给那些做不到 OAuth 的 App 用。我們這一台是圍繞中文場景做的：工具說明是中文，除了標準 MCP 之外還提供一條用金鑰的接入方式，給那些做不到 OAuth 的 App 用。Ours is built around Chinese-language use: the tool descriptions are in Chinese, and besides standard MCP there is a key-based route for apps that can't do OAuth.

怎么选怎麼選Which one to use

判据是你的 AI 助手和你说什么语言，不是哪个「更好」。判據是你的 AI 助理和你說什麼語言，不是哪個「更好」。The deciding factor is your assistant and your language — not which one is "better".

• 你在用 Claude 或 ChatGPT 的英文界面、系统是 S2、只想快点连上 —— 用官方 27mcp。它已经内置在连接器列表里，设置里搜 Sonos 就能加，不用复制任何地址。你在用 Claude 或 ChatGPT 的英文介面、系統是 S2、只想快點連上 —— 用官方 27mcp。它已經內建在連接器列表裡，設定裡搜 Sonos 就能加，不用複製任何位址。You use Claude or ChatGPT in English, your system is on S2, and you want it connected in a minute — use the official 27mcp. It's already in the connector list; search Sonos in settings, no URL to copy.
• 你的 AI 是超级小爱、或者任何不会走 OAuth 的 App / 脚本 —— 只能用 ZoneFoundry。官方 27mcp 没有密钥方式。你的 AI 是超級小愛、或者任何不會走 OAuth 的 App / 腳本 —— 只能用 ZoneFoundry。官方 27mcp 沒有金鑰方式。Your AI is Super XiaoAi, or any app or script that can't do OAuth — ZoneFoundry is the only option; the official server has no key route.
• 你希望模型在中文工具名单里选工具 —— 用 ZoneFoundry 的 /mcp/zh。工具描述是中文的，长清单下选错的概率更低。你希望模型在中文工具名單裡選工具 —— 用 ZoneFoundry 的 /mcp/zh。工具描述是中文的，長清單下選錯的機率更低。You want the model choosing from a Chinese tool catalogue — use ZoneFoundry's /mcp/zh. Chinese descriptions cut mis-selection on long tool lists.
• 你要接进 Claude Code 或自己写脚本 —— 用 ZoneFoundry 的访问密钥，直接带 Bearer 头调用。官方那条也能手动注册地址，但只有 OAuth。你要接進 Claude Code 或自己寫腳本 —— 用 ZoneFoundry 的存取金鑰，直接帶 Bearer 標頭呼叫。官方那條也能手動註冊位址，但只有 OAuth。You're wiring it into Claude Code or your own script — use a ZoneFoundry access key and send the Bearer header. The official server can be registered manually too, but it is OAuth only.

ZoneFoundry 的 27 个工具ZoneFoundry 的 27 個工具ZoneFoundry's 27 tools

连上之后 AI 手里就是这张名单。按用途分组：連上之後 AI 手裡就是這張名單。按用途分組：Once connected, this is the list the model gets. Grouped by purpose:

• 看状态：list_rooms · now_playing · list_favorites · list_playlists · play_history · taste_profile · list_reminders看狀態：list_rooms · now_playing · list_favorites · list_playlists · play_history · taste_profile · list_remindersRead state: list_rooms · now_playing · list_favorites · list_playlists · play_history · taste_profile · list_reminders
• 播放：play_music · search_music · toggle_play_pause · next_track · previous_track · seek · set_play_mode播放：play_music · search_music · toggle_play_pause · next_track · previous_track · seek · set_play_modePlayback: play_music · search_music · toggle_play_pause · next_track · previous_track · seek · set_play_mode
• 音量：set_volume · adjust_volume · set_mute音量：set_volume · adjust_volume · set_muteVolume: set_volume · adjust_volume · set_mute
• 房间与分组：group_rooms · ungroup_room · move_music房間與分組：group_rooms · ungroup_room · move_musicRooms and groups: group_rooms · ungroup_room · move_music
• 设备与播报：switch_source · set_home_theater · announce裝置與播報：switch_source · set_home_theater · announceDevices and announcements: switch_source · set_home_theater · announce
• 提醒：set_reminder · cancel_reminder提醒：set_reminder · cancel_reminderReminders: set_reminder · cancel_reminder
• 随口说：ask_zonefoundry（把一句话原样交给助手解析）· undo_last（撤销上一次音量或分组改动）隨口說：ask_zonefoundry（把一句話原樣交給助理解析）· undo_last（復原上一次音量或分組改動）Free-form: ask_zonefoundry (hand a sentence straight to the assistant) · undo_last (revert the last volume or grouping change)

中文版另有 pause、resume、pause_all。这三个是幂等的：pause 只暂停，不会把已经暂停的房间变成播放，比反复用 toggle_play_pause 稳。中文版另有 pause、resume、pause_all。這三個是冪等的：pause 只暫停，不會把已經暫停的房間變成播放，比反覆用 toggle_play_pause 穩。The Chinese catalogue adds pause, resume and pause_all. They're idempotent: pause only pauses and never turns an already-paused room back on, which is steadier than toggling twice.

最快自检：跟 AI 说「列出我的房间」。能回你真实的 Sonos 房间名，就说明工具调用通了。最快自檢：跟 AI 說「列出我的房間」。能回你真實的 Sonos 房間名，就說明工具呼叫通了。Fastest check: ask the assistant to list your rooms. If real Sonos room names come back, tool calls are working.

常见报错怎么修常見報錯怎麼修Fixing the common errors

405 Method Not Allowed405 Method Not Allowed405 Method Not Allowed

地址对了，但那条路径不收这种请求方法。最常见的是拿 GET / SSE 去连只收 POST 的 /mcp/zh。修法只换路径那一段，?token= 原封不动保留：位址對了，但那條路徑不收這種請求方法。最常見的是拿 GET / SSE 去連只收 POST 的 /mcp/zh。修法只換路徑那一段，?token= 原封不動保留：The URL is right, but that path doesn't accept this method. Most often you're using GET/SSE against /mcp/zh, which is POST-only. Change only the path segment and keep ?token= intact:

改前改前Before: https://relay.zonefoundry.dev/mcp/zh?token=zfagt_xxx
改后改後After: https://relay.zonefoundry.dev/sse/zh?token=zfagt_xxx

只换整段、把 ?token= 丢了，会从 405 变成 401 —— 那不是新问题，是密钥没了。只換整段、把 ?token= 丟了，會從 405 變成 401 —— 那不是新問題，是金鑰沒了。Replace the whole string and drop ?token= and you'll trade the 405 for a 401 — that isn't a new problem, it's a missing key.

401 Unauthorized401 Unauthorized401 Unauthorized

两种 401 含义完全不同，先分清走哪条路：兩種 401 含義完全不同，先分清走哪條路：The two kinds of 401 mean different things — first work out which route you're on:

• OAuth 连接器：401 往往只是正常的鉴权挑战，客户端接下来会拉起授权页。继续走完（拿到 6 位码 → 填回 App → 批准），不要因为看到 401 就改去生成密钥。OAuth 連接器：401 往往只是正常的驗證挑戰，用戶端接下來會拉起授權頁。繼續走完（拿到 6 位碼 → 填回 App → 批准），不要因為看到 401 就改去產生金鑰。OAuth connector: a 401 is often just the normal auth challenge and the client will open the consent page next. Finish the flow (6-digit code → enter it in the app → approve); don't abandon it for a key.
• 密钥：先看 URL 里的 ?token= 有没有被输入框截断（最常见），再看 zfagt_ 后面是不是完整，最后确认密钥没有被撤销。用请求头的，检查有没有漏掉 Bearer 和后面那个空格。金鑰：先看 URL 裡的 ?token= 有沒有被輸入框截斷（最常見），再看 zfagt_ 後面是不是完整，最後確認金鑰沒有被撤銷。用請求標頭的，檢查有沒有漏掉 Bearer 和後面那個空格。Key: check whether ?token= was truncated by the input field (the usual culprit), then whether the zfagt_ string is complete, then whether the key was revoked. With a header, make sure you didn't drop Bearer and the space after it.

连上了但 AI 说没有工具連上了但 AI 說沒有工具Connected, but the assistant sees no tools

先确认它列的是不是你的真实房间；再回 App 的「AI 接入」页看那张卡片是不是显示「已授权」。如果卡片显示「连接」，说明那次授权没有走完 —— 重新连一次，别去怀疑 Sonos。先確認它列的是不是你的真實房間；再回 App 的「AI 接入」頁看那張卡片是不是顯示「已授權」。如果卡片顯示「連接」，說明那次授權沒有走完 —— 重新連一次，別去懷疑 Sonos。First check whether it lists your real rooms, then look at the card under AI access in the app: it should read Authorized. If it still says Connect, that authorisation never completed — connect again rather than blaming Sonos.

常见问题常見問題FAQ

Sonos 有官方 MCP 吗？Sonos 有官方 MCP 嗎？Does Sonos have an official MCP?

有。Sonos 在 2026 年 9 月的 Sonos 27 里发布了官方 MCP 服务器 Sonos 27mcp，地址是 https://mcp.ws.sonos.com/mcp，提供 34 个工具，免费，要求系统跑 S2 软件。官方页面写明目前只提供美式英语。有。Sonos 在 2026 年 9 月的 Sonos 27 裡發布了官方 MCP 伺服器 Sonos 27mcp，位址是 https://mcp.ws.sonos.com/mcp，提供 34 個工具，免費，要求系統跑 S2 軟體。官方頁面寫明目前只提供美式英語。Yes. Sonos shipped an official MCP server, Sonos 27mcp, with Sonos 27 in September 2026: https://mcp.ws.sonos.com/mcp, 34 tools, free, requires the S2 software. Its support page states it is available in US-English.

官方 27mcp 和 ZoneFoundry 的 MCP 能同时接吗？官方 27mcp 和 ZoneFoundry 的 MCP 能同時接嗎？Can I connect both the official 27mcp and ZoneFoundry's MCP?

能，但不建议接在同一个 AI 会话里。Sonos 自己的文档就提醒：同一个助手挂多个 MCP 服务器时，像「暂停」这种通用指令可能被路由到错误的一方。要对比着试，一次只留一个。能，但不建議接在同一個 AI 對話裡。Sonos 自己的文件就提醒：同一個助理掛多個 MCP 伺服器時，像「暫停」這種通用指令可能被路由到錯誤的一方。要對比著試，一次只留一個。You can, but don't keep both in the same AI session. Sonos's own docs warn that with several MCP servers attached to one assistant, generic commands like "pause" can be routed to the wrong one. If you want to compare, keep only one at a time.

接上之后 AI 说找不到工具 / 401 怎么办？接上之後 AI 說找不到工具 / 401 怎麼辦？After connecting, the assistant says it can't find tools, or I get a 401?

401 表示鉴权没过，先分清走的是哪条路。走 OAuth 连接器的，401 往往只是正常的鉴权挑战，继续走完授权流程即可；用密钥的，检查地址里的 token 有没有被输入框截断，或者用 Authorization: Bearer 头时有没有漏掉 Bearer 和空格。401 表示驗證沒過，先分清走的是哪條路。走 OAuth 連接器的，401 往往只是正常的驗證挑戰，繼續走完授權流程即可；用金鑰的，檢查位址裡的 token 有沒有被輸入框截斷，或者用 Authorization: Bearer 標頭時有沒有漏掉 Bearer 和空格。A 401 means authentication failed, so first identify the route. On the OAuth connector it is often just the normal challenge — finish the flow. On a key, check whether the token was truncated in the URL, or whether you dropped Bearer and the space in the Authorization header.

405 Method Not Allowed 是什么原因？405 Method Not Allowed 是什麼原因？What causes 405 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 path rejects that HTTP method — usually GET or SSE against the POST-only /mcp/zh. Switch the path to /sse/zh and keep the ?token= part untouched.

中文 AI 能用吗？中文 AI 能用嗎？Does it work with Chinese AI assistants?

官方 27mcp 目前只提供美式英语。要用中文 AI，例如超级小爱，需要接 ZoneFoundry 自己的 MCP 地址，它的工具名和说明都是中文的。官方 27mcp 目前只提供美式英語。要用中文 AI，例如超級小愛，需要接 ZoneFoundry 自己的 MCP 位址，它的工具名和說明都是中文的。The official 27mcp is currently US-English only. To drive Sonos from a Chinese assistant such as Super XiaoAi, connect ZoneFoundry's MCP — its tool names and descriptions are in Chinese.

需要装家庭桥接才能用 MCP 吗？需要裝家庭橋接才能用 MCP 嗎？Do I need the home bridge for MCP?

不需要。只要已经登录 Sonos 账户。桥接只决定 AI 点的歌会不会直接进播放队列。不需要。只要已經登入 Sonos 帳戶。橋接只決定 AI 點的歌會不會直接進播放佇列。No — a Sonos account sign-in is enough. The bridge only decides whether songs an AI requests go straight into the play queue.