Sonos 接入 Claude：官方连接器与自定义连接器 Sonos 接入 Claude：官方連接器與自訂連接器 Sonos + Claude: the official connector vs a custom one

先选路：一句话判据先選路：一句話判據Pick a route in one line

路 A：Sonos 官方内置连接器路 A：Sonos 官方內建連接器Route A: Sonos's built-in connector

Sonos 在 Sonos 27 里发布了官方 MCP（叫 Sonos 27mcp），Claude 那边把它做成了内置连接器，所以在连接器列表里直接能搜到，不用复制任何地址。官方帮助页写明目前是美式英语的版本。Sonos 在 Sonos 27 裡發布了官方 MCP（叫 Sonos 27mcp），Claude 那邊把它做成了內建連接器，所以在連接器列表裡直接能搜到，不用複製任何位址。官方說明頁寫明目前是美式英語的版本。Sonos shipped an official MCP (Sonos 27mcp) in Sonos 27, and Claude lists it as a built-in connector — so it's searchable in the connector list with no URL to copy. Sonos's support page states it is available in US-English.

1. 在 Claude 打开 设置 → 连接器（Connectors），搜索 Sonos，或者从列表里选它，点 Connect。在 Claude 開啟 設定 → 連接器（Connectors），搜尋 Sonos，或者從列表裡選它，點 Connect。In Claude open Settings → Connectors, search Sonos or pick it from the list, and select Connect.
2. 浏览器会打开授权页，显示由「Sonos Cloud MCP Anthropic」请求控制你的 Sonos 系统。看完权限列表，点 Okay。瀏覽器會開啟授權頁，顯示由「Sonos Cloud MCP Anthropic」請求控制你的 Sonos 系統。看完權限清單，點 Okay。A browser window opens asking you to grant "Sonos Cloud MCP Anthropic" permission to control your Sonos system. Review the list and select Okay.
3. 输入你的 Sonos 账户邮箱和密码，点 Sign In。輸入你的 Sonos 帳戶電子郵件和密碼，點 Sign In。Enter your Sonos account credentials and select Sign In.
4. 再看一遍 Claude 请求的权限，点 Okay。再看一遍 Claude 請求的權限，點 Okay。Review the permissions Claude requests and select Okay.
5. 回到 设置 → 连接器，Sonos 那一行状态应该出现勾。回到 設定 → 連接器，Sonos 那一行狀態應該出現勾。Back in Settings → Connectors you should see a checkmark under Status.
6. 开一个新的对话再问它，旧的对话不会自动带上新接的工具。開一個新的對話再問它，舊的對話不會自動帶上新接的工具。Start a new chat — an existing conversation won't pick up the newly connected tools.

路 B：ZoneFoundry 自定义连接器路 B：ZoneFoundry 自訂連接器Route B: the ZoneFoundry custom connector

这条路不依赖 Claude 的连接器目录，所以不管官方那边有没有放开、你的账号在哪个区，都能用。代价是要多一步：手机上的 6 位授权码。這條路不依賴 Claude 的連接器目錄，所以不管官方那邊有沒有放開、你的帳號在哪個區，都能用。代價是要多一步：手機上的 6 位授權碼。This route doesn't depend on Claude's connector directory, so it works regardless of rollout or region. The cost is one extra step: a 6-digit code on your phone.

1. 在 App 里复制连接器链接1. 在 App 裡複製連接器連結1. Copy the connector link from the app

ZoneFoundry → 设置 →「AI 与聊天」→ AI 接入 → 点 Claude 卡片。「怎么连接」里有连接器链接 https://relay.zonefoundry.dev/mcp，点下面的「复制」。Claude 和 ChatGPT 两张卡片用的是同一个链接，区别只在各自 AI 里添加的位置。ZoneFoundry → 設定 →「AI 與聊天」→ AI 接入 → 點 Claude 卡片。「如何連接」內有連接器連結 https://relay.zonefoundry.dev/mcp，點下面的「複製」。Claude 和 ChatGPT 兩張卡片用的是同一條連結，分別只在於各自 AI 內加入的位置。ZoneFoundry → Settings → AI & Chat → AI access → tap the Claude card. Under How to connect you'll find the connector link https://relay.zonefoundry.dev/mcp; tap Copy below it. Both the Claude and ChatGPT cards use the same link; only where you add it differs.

2. 在 Claude 里添加自定义连接器2. 在 Claude 裡加入自訂連接器2. Add a custom connector in Claude

在 claude.ai 或 Claude 桌面 App 打开 设置 → 连接器 → 点 + Add → Add custom connector，把链接粘进去，点 Connect。在 claude.ai 或 Claude 桌面 App 開啟 設定 → 連接器 → 點 + Add → Add custom connector，把連結貼進去，點 Connect。On claude.ai or the Claude desktop app open Settings → Connectors → + Add → Add custom connector, paste the link and click Connect.

3. 用手机确认（5 分钟内）3. 用手機確認（5 分鐘內）3. Approve on your phone within 5 minutes

电脑上会开一页，显示 6 位数字码。回 ZoneFoundry App，在「输入授权码」里填进去，点 批准。三个细节：電腦上會開一頁，顯示 6 位數字碼。回 ZoneFoundry App，在「輸入授權碼」裡填進去，點 批准。三個細節：A page opens on your computer showing a 6-digit code. Go back to ZoneFoundry, enter it under Enter authorization code and tap Authorize. Three details:

• 5 分钟内有效。超时那一页会显示已过期，回 Claude 重新连一次就有新码。5 分鐘內有效。逾時那一頁會顯示已過期，回 Claude 重新連一次就有新碼。Five minutes. Past that the page says it expired — reconnect in Claude for a fresh code.
• 同一页上也有二维码，用 iPhone 相机扫一下可以直接跳到 App 里批准。同一頁上也有 QR 碼，用 iPhone 相機掃一下可以直接跳到 App 裡批准。The same page shows a QR code — scan it with the iPhone camera to land straight in the app and approve.
• 也可以直接对 ZoneFoundry 助手说「授权 123456」。也可以直接對 ZoneFoundry 助理說「授權 123456」。You can also just tell the ZoneFoundry assistant "authorize 123456".

4. 回 Claude 开新对话4. 回 Claude 開新對話4. Back to Claude, new chat

那一页显示 Approved — returning… 之后，回 Claude 开新对话。App 里的 Claude 卡片这时应该显示「已授权」。那一頁顯示 Approved — returning… 之後，回 Claude 開新對話。App 裡的 Claude 卡片這時應該顯示「已授權」。Once that page shows Approved — returning…, go back to Claude and open a new chat. The Claude card in the app should now read Authorized.

两条路差在哪兩條路差在哪How the two routes differ

Claude Code 和脚本Claude Code 和腳本Claude Code and scripts

Claude Code 走的是密钥，不是连接器。在 App 的 「AI 接入」→「访问密钥」 新建一条，得到 zfagt_ 开头的 token（只显示一次）。然后把 https://relay.zonefoundry.dev/sse/zh 配成 MCP 服务器，请求头带上：Claude Code 走的是金鑰，不是連接器。在 App 的 「AI 接入」→「存取金鑰」 新建一條，得到 zfagt_ 開頭的 token（只顯示一次）。然後把 https://relay.zonefoundry.dev/sse/zh 配成 MCP 伺服器，請求標頭帶上：Claude Code uses a key, not a connector. In the app go to AI access → Access keys and create one; you get a token starting zfagt_ (shown once). Then register https://relay.zonefoundry.dev/sse/zh as an MCP server with this header:

Authorization: Bearer zfagt_你的token你的tokenyour-token

为什么用 /sse/zh：它同时接受 SSE 长连接和普通 POST，不用赌你的客户端用哪种。只有在它明确不接受 /sse/* 时，才改成 /mcp/zh（那一条只收 POST）。為什麼用 /sse/zh：它同時接受 SSE 長連接和普通 POST，不用賭你的用戶端用哪種。只有在它明確不接受 /sse/* 時，才改成 /mcp/zh（那一條只收 POST）。Why /sse/zh: it accepts both long-lived SSE and plain POST, so you don't have to guess which your client uses. Only switch to /mcp/zh (POST-only) if it clearly rejects /sse/*.

用密钥接进来的 Claude Code 不会让 Claude 卡片变成「已授权」—— 那类连接只记在「访问密钥」下面。这是设计如此，不是没连上。用金鑰接進來的 Claude Code 不會讓 Claude 卡片變成「已授權」—— 那類連接只記在「存取金鑰」下面。這是設計如此，不是沒連上。A Claude Code connection made with a key won't flip the Claude card to Authorized — key connections are listed under Access keys instead. That's by design, not a failed connection.

接上之后怎么问接上之後怎麼問What to actually ask

Claude 拿到工具名单后，正常说话就行，不用背命令。几句可以直接用的：Claude 拿到工具名單後，正常說話就行，不用背指令。幾句可以直接用的：Once Claude has the tool list, just talk normally — no commands to memorise. A few that work as written:

• 「列出我的房间」—— 最快的自检，能说出真实房间名就说明通了。「列出我的房間」—— 最快的自檢，能說出真實房間名就說明通了。"List my rooms" — the fastest check; real room names mean it works.
• 「客厅放周杰伦，音量 25」「客廳放周杰倫，音量 25」"Play Jay Chou in the living room at volume 25."
• 「除了卧室，其他房间都放同一首歌」「除了臥室，其他房間都放同一首歌」"Play the same song everywhere except the bedroom."
• 「十分钟后在厨房提醒我关火」—— 走的是音箱播报。「十分鐘後在廚房提醒我關火」—— 走的是喇叭播報。"Remind me in ten minutes in the kitchen to turn off the stove" — spoken through the speaker.

如果它答得像模像样但音箱没反应，先怀疑工具调用没通（回 App 看卡片状态），别急着怪音箱。如果它答得像模像樣但喇叭沒反應，先懷疑工具呼叫沒通（回 App 看卡片狀態），別急著怪喇叭。If it answers plausibly but nothing happens, suspect the tool call rather than the speakers — check the card status in the app first.

常见问题常見問題FAQ

Sonos 官方连接器和自定义连接器可以同时装吗？Sonos 官方連接器和自訂連接器可以同時裝嗎？Can I install both the official and the custom connector?

技术上可以，但同一个 Claude 会话里挂两个 Sonos 相关的 MCP 服务器时，「暂停」「下一首」这类通用指令可能被路由到另一个，表现成点了没反应。要对比就把其中一个关掉。技術上可以，但同一個 Claude 對話裡掛兩個 Sonos 相關的 MCP 伺服器時，「暫停」「下一首」這類通用指令可能被路由到另一個，表現成點了沒反應。要對比就把其中一個關掉。Technically yes, but with two Sonos-related MCP servers in one Claude session, generic commands like "pause" or "next" can be routed to the other one and appear to do nothing. If you want to compare, disable one.

为什么 Claude 卡片一直显示「连接」而不是「已授权」？為什麼 Claude 卡片一直顯示「連接」而不是「已授權」？Why does the Claude card stay on Connect instead of Authorized?

说明那次授权没有走完。6 位授权码 5 分钟内有效，超时会显示已过期；还有一种常见情况是用访问密钥接的 Claude Code，那类连接只记在「访问密钥」里，不会让 Claude 卡片变成已授权。說明那次授權沒有走完。6 位授權碼 5 分鐘內有效，逾時會顯示已過期；還有一種常見情況是用存取金鑰接的 Claude Code，那類連接只記在「存取金鑰」裡，不會讓 Claude 卡片變成已授權。That authorisation never completed. The 6-digit code is valid for five minutes and shows as expired after that. The other common case is Claude Code connected with an access key — those are listed under Access keys and won't flip the Claude card.

Claude Code 也能控制 Sonos 吗？Claude Code 也能控制 Sonos 嗎？Can Claude Code control Sonos too?

能，但走的是访问密钥而不是连接器。在 App 里新建一条 zfagt_ 开头的密钥，然后在 Claude Code 里把 https://relay.zonefoundry.dev/sse/zh 配成 MCP 服务器，带上 Authorization: Bearer 头。能，但走的是存取金鑰而不是連接器。在 App 裡新建一條 zfagt_ 開頭的金鑰，然後在 Claude Code 裡把 https://relay.zonefoundry.dev/sse/zh 配成 MCP 伺服器，帶上 Authorization: Bearer 標頭。Yes, via an access key rather than a connector. Create a zfagt_ key in the app, register https://relay.zonefoundry.dev/sse/zh as an MCP server in Claude Code, and send the Authorization: Bearer header.

授权码过期了怎么办？授權碼過期了怎麼辦？What if the code expires?

回 Claude 里重新点一次连接，会生成新的授权码。旧的那个不会再用，也不用去撤销什么。回 Claude 裡重新點一次連接，會產生新的授權碼。舊的那個不會再用，也不用去撤銷什麼。Click connect again in Claude and a fresh code is issued. The old one is dead — there's nothing to revoke.

Claude 说找不到 Sonos 连接器？Claude 說找不到 Sonos 連接器？Claude can't find the Sonos connector?

官方的那个连接器在 Claude 设置 → 连接器里搜索 Sonos 应该能看到；如果搜不到，可能是账号或地区还没放开，改用自定义连接器那条路，它不依赖官方目录。官方的那個連接器在 Claude 設定 → 連接器裡搜尋 Sonos 應該能看到；如果搜不到，可能是帳號或地區還沒放開，改用自訂連接器那條路，它不依賴官方目錄。The official connector should appear when you search Sonos under Settings → Connectors. If it doesn't, the rollout may not have reached your account or region — use the custom connector route instead, which doesn't depend on that directory.