手把手：Claude 连 Google Home MCP，TaoToken 给 Key

1. 先分清两套 KeyTaoToken 给模型Google Home MCP 给设备授权如果你正在 Claude Code 里执行claude mcp add google-home ...结果模型侧返回401MCP 侧又提示disconnected这篇手把手把两条链路拆开TaoToken Key 负责模型调用Google Home MCP Token 负责智能家居授权。先到 TaoToken 官网领取 Key并把 Base URL 记为https://taotoken.net/api后面所有配置都围绕这两个值展开。Google Home 这条线最近开始开放 MCP 早期访问Claude、ChatGPT、Google Antigravity 这类支持 MCP 的客户端可以读取设备状态和事件记录但真正落地时大多数人不是卡在“有没有 MCP”而是卡在“模型网关的 Key 和设备授权的 Token 混在一起了”。先把边界说清楚TaoToken Key给 Claude Code、Codex、CC Switch 这类模型客户端使用用来访问 TaoToken 提供的模型网关。本文统一写成YOUR_API_KEY。TaoToken Base URLhttps://taotoken.net/api这是工具配置项不加 UTM 参数。Google Home MCP Token给 MCP 服务器使用用来授权访问 Google Home 设备、房间、事件历史。它不是YOUR_API_KEY不要混填。Google Home MCP URL以你拿到的早期访问邮件、控制台或接入文档为准。本文用https://你的-google-home-mcp-服务器/mcp占位。所以正确路径是先去 TaoToken 官网拿到模型侧 Key再把 Base URL 写进 Claude Code 的settings.json或环境变量最后把 Google Home MCP 的 URL 和 Token 加到 Claude Code 的 MCP 配置里。两条链路都通claude mcp list才会显示已连接。如果你还没有 TaoToken Key建议先在浏览器里完成登录和创建 Key再回到终端配置。入口在 TaoToken 官网创建后复制 Key不要只截图保存后面要多次粘贴到本地环境变量和配置文件中。注意所有命令都在你自己的本地终端执行不要把 MCP 或智能体直接接到生产库、生产自动化或高风险设备上先用测试房间、测试灯或只读事件历史验证。2. Claude Code 侧配置settings.json 里写 ANTHROPIC_BASE_URL 与 YOUR_API_KEYClaude Code 的模型侧配置通常走ANTHROPIC_*环境变量也可以写进settings.json。这里最容易犯的错是把 TaoToken 的 Base URL 写成https://taotoken.net/api/v1或https://taotoken.net/api/v1/messages。当前只需要写https://taotoken.net/api不要自己追加/v1。如果你的客户端或 SDK 内部会自动拼路径那是客户端的事用户在配置项里填的就是这个 Base URL。先给出全局~/.claude/settings.json或项目级.claude/settings.json的写法{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: YOUR_API_KEY, ANTHROPIC_MODEL: claude-sonnet-4 } }说明几个点ANTHROPIC_BASE_URL固定填 TaoToken 的 Base URL不带 UTM。ANTHROPIC_AUTH_TOKEN填你在 TaoToken 控制台创建的 Key也就是YOUR_API_KEY。ANTHROPIC_MODEL填 TaoToken 控制台当前可用的模型 ID。上面的claude-sonnet-4只是示例真正使用时请从控制台复制避免invalid model。如果你的 Claude Code 版本读取的是ANTHROPIC_API_KEY那就把同一个YOUR_API_KEY填到ANTHROPIC_API_KEY不要同时乱填多个不同 Key。不要把ANTHROPIC_*写进 Codex 的config.toml。Codex 不读这套变量后面会单独讲。也可以先用 shell 环境变量做快速验证export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKENYOUR_API_KEY export ANTHROPIC_MODELclaude-sonnet-4 claude --version如果claude --version能正常输出说明 Claude Code 本体已经可用。接下来不要急着加 Google Home MCP先确认模型侧请求不报 401。你可以在 Claude Code 里发一句普通对话例如用一句话说明当前会话是否正常。如果模型侧仍然 401优先检查三件事YOUR_API_KEY是否已经替换成真实 Key而不是保留占位符。ANTHROPIC_BASE_URL是否是https://taotoken.net/api。当前终端是否真的读取到了你修改的settings.json必要时重启终端或 Claude Code。模型侧通了才有必要继续折腾 Google Home MCP。否则你会在 MCP 配置里反复排查最后发现是模型网关的 Key 没生效。需要重新领取或管理 Key可以回到 TaoToken 官网 的 API Keys 页面处理。3. 添加 Google Home MCP.mcp.json、claude mcp add 与 HTTP/SSE 选择Google Home MCP 早期访问通常会给你两类信息MCP 服务器地址以及授权用的 Token 或 OAuth 流程。不同批次可能不同所以本文不编造具体域名只给出可替换的配置骨架。你需要把https://你的-google-home-mcp-服务器/mcp替换成实际地址把你的-google-home-mcp-token替换成实际 Token。Claude Code 支持项目级.mcp.json推荐用文件方式稳定且容易提交给团队复现。在项目根目录创建.mcp.json{ mcpServers: { google-home: { type: http, url: https://你的-google-home-mcp-服务器/mcp, headers: { Authorization: Bearer 你的-google-home-mcp-token } } } }如果你的 Google Home MCP 早期访问入口给的是 SSE 地址而不是 HTTP stream则把type改成sse{ mcpServers: { google-home: { type: sse, url: https://你的-google-home-mcp-服务器/sse, headers: { Authorization: Bearer 你的-google-home-mcp-token } } } }也可以尝试 CLI 添加。不同 Claude Code 版本参数可能略有差异如果 CLI 报参数错误就回到.mcp.jsonclaude mcp add google-home \ --transport http \ --url https://你的-google-home-mcp-服务器/mcp \ --header Authorization: Bearer 你的-google-home-mcp-token加完后检查claude mcp list claude mcp get google-homeclaude mcp list里应该能看到google-home。如果是disconnected先看type是否选错HTTP 用httpSSE 用sse。再看 URL 是否需要/mcp或/sse后缀。很多早期访问服务会把完整路径写在控制台里不要凭感觉补路径。这里再次强调Authorization: Bearer 你的-google-home-mcp-token里的 Token 不是 TaoToken 的YOUR_API_KEY。一个负责让 Claude 调模型一个负责让 MCP 访问 Google Home。混填的典型现象是模型能聊天但 MCP 工具调用一直 401 或授权失败。4. 完整命令序列从领 TaoToken Key 到 claude mcp list 成功下面给出一条可复现路径。你先把占位符替换成真实值然后在本地终端执行。注意不要直接把智能体接到生产库、生产自动化或高风险设备先用测试设备或只读事件历史验证。第一步设置 TaoToken 模型侧环境变量export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKENYOUR_API_KEY export ANTHROPIC_MODELclaude-sonnet-4 claude --version第二步设置 Google Home MCP 侧参数export GOOGLE_HOME_MCP_URLhttps://你的-google-home-mcp-服务器/mcp export GOOGLE_HOME_MCP_TOKEN你的-google-home-mcp-token第三步添加 MCP 服务器claude mcp add google-home \ --transport http \ --url $GOOGLE_HOME_MCP_URL \ --header Authorization: Bearer $GOOGLE_HOME_MCP_TOKEN如果 CLI 添加失败就改用项目.mcp.json{ mcpServers: { google-home: { type: http, url: https://你的-google-home-mcp-服务器/mcp, headers: { Authorization: Bearer 你的-google-home-mcp-token } } } }第四步检查连接claude mcp list claude mcp get google-home第五步进入 Claude Code 做一次只读验证。不要一上来就控制门锁、插座或安防设备先问设备列表或事件历史请调用 google-home MCP列出当前可见的房间和设备不要执行任何控制指令。如果 Claude 能列出设备或房间说明 MCP 链路已经基本打通。如果 Claude 一直说找不到工具就检查claude mcp list是否显示已连接以及当前项目目录是否读取到了.mcp.json。第六步再做一次只读事件历史验证请通过 google-home MCP 读取最近一条事件历史只读不要修改任何设备状态。这一步通过后再考虑小范围控制测试。测试对象最好是无关紧要的灯或测试插座不要直接接生产环境。5. Codex 侧单独配置config.toml 接 TaoToken不要把 ANTHROPIC_* 套进去有些团队会同时用 Claude Code 和 Codex。Claude Code 走ANTHROPIC_*Codex 走config.toml。这两套配置不要互相复制粘贴。尤其是 Codex通常不读ANTHROPIC_BASE_URL或ANTHROPIC_AUTH_TOKEN。你如果只设置了ANTHROPIC_*然后启动 Codex发现它仍然连默认端点或报 401这不是 TaoToken Key 无效而是配置放错文件了。Codex 的config.toml可以这样写model gpt-5-codex model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY wire_api chat然后设置环境变量export TAOTOKEN_API_KEYYOUR_API_KEY codex --version注意base_url仍然是https://taotoken.net/api不加 UTM也不要自己拼/v1。env_key TAOTOKEN_API_KEY表示 Codex 去读这个环境变量环境变量的值才是YOUR_API_KEY。wire_api根据你的 Codex 版本和 TaoToken 模型说明选择。如果当前版本要求 Responses API就把wire_api改成responses如果要求 Chat Completions就用chat。不要靠猜优先看 TaoToken 控制台的模型说明。不要把ANTHROPIC_AUTH_TOKEN写进这里Codex 不认。如果你同时使用 Claude Code 和 Codex建议在 shell 里把变量分开export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKENYOUR_API_KEY export TAOTOKEN_API_KEYYOUR_API_KEY两边都用同一个 TaoToken Key 可以但变量名和配置文件不要混。Claude Code 管 Claude CodeCodex 管 Codex。这样排障时才能快速判断是模型网关问题还是客户端配置问题。6. CC Switch 三件套Base URL、API Key、模型名切换 TaoToken如果你用 CC Switch 管理多个模型供应商核心就是三件套Base URL、API Key、模型名。切换到 TaoToken 时填写如下供应商名称TaoToken Base URLhttps://taotoken.net/api API KeyYOUR_API_KEY 模型从 TaoToken 控制台复制当前可用模型 ID这里的 Base URL 依然不带 UTM。API Key 填YOUR_API_KEY对应的真实值。模型名不要凭记忆写尤其是 Claude、GPT、Codex 这类名称在不同供应商、不同时间可能不同。最稳妥的方式是打开 TaoToken 控制台复制模型 ID再粘贴到 CC Switch。CC Switch 的好处是可以在多个配置之间切换。建议至少保留两组默认组你原本正常使用的供应商。TaoToken 组Base URL 为https://taotoken.net/apiKey 为YOUR_API_KEY模型为 TaoToken 控制台模型 ID。切换后先做一次最小验证打开 Claude Code发一句普通对话确认模型侧正常。再检查claude mcp list确认 Google Home MCP 仍然处于连接状态。因为 CC Switch 主要影响模型供应商MCP 配置本身在 Claude Code 或项目.mcp.json中两边是独立层。不要把 MCP Token 填进 CC Switch也不要把 TaoToken Key 填进 Google Home MCP 授权。如果你还没有创建 TaoToken Key可以到 TaoToken 官网 的控制台创建然后再回到 CC Switch 填写三件套。创建后建议先在一个临时项目里验证不要直接在主力项目上切换。7. 401/404/disconnected 排障Claude 连 Google Home MCP 的高频坑下面这些报错是 Claude 连 Google Home MCP 时最常见的几类。先按表格定位再回到对应章节修改。现象常见原因修复401 UnauthorizedTaoToken Key 未替换、Base URL 写错、Key 已删除检查ANTHROPIC_AUTH_TOKENYOUR_API_KEY是否替换ANTHROPIC_BASE_URLhttps://taotoken.net/api404 Not FoundBase URL 多写了/v1、/v1/messages只填https://taotoken.net/api不要自行追加路径MCP server disconnectedtransport 选错、URL 后缀不对、Token 无效HTTP 用httpSSE 用sse检查/mcp或/sse检查 MCP Tokeninvalid model模型名不在 TaoToken 当前可用列表从 TaoToken 控制台复制模型 IDCodex 报 401只设置了ANTHROPIC_*改config.toml设置TAOTOKEN_API_KEYClaude 找不到 MCP 工具.mcp.json不在当前项目、MCP 未启动执行claude mcp list确认项目目录和配置路径MCP 授权失败把 TaoToken Key 填到了 Google Home MCP换成 Google Home MCP Token两套凭据分开更具体的排查顺序先验证模型侧。运行claude --version再发普通对话。如果普通对话都 401先不要看 MCP。再验证 MCP 注册。运行claude mcp list确认google-home存在。再验证 MCP 连接。运行claude mcp get google-home看 URL、transport、header 是否符合早期访问说明。最后验证工具调用。让 Claude 列设备或读事件历史不要一上来就执行控制。如果还是不行把.mcp.json里的type在http和sse之间切换测试。很多 disconnected 都是 transport 不匹配。如果 Codex 同时报错单独检查config.toml。不要把 Claude Code 的ANTHROPIC_*复制过去。还有一个容易忽略的点环境变量只在当前终端会话有效。你在 A 终端设置了ANTHROPIC_AUTH_TOKEN在 B 终端启动 Claude CodeB 终端可能读不到。长期使用建议写进settings.json或者写进 shell 的启动文件。写完以后新开终端再测避免旧环境影响判断。8. 安全验收与最小权限智能家居事件历史只读测试Google Home MCP 能控制设备也能读取事件历史这意味着权限边界比普通聊天更重要。接入时建议遵循最小权限原则先用只读工具验证列房间、列设备、读事件历史。控制测试只选无关紧要的设备例如测试灯、测试插座。不要一开始就接入门锁、摄像头、安防、生产自动化。不要把 MCP 或智能体直接接到生产库、生产系统或高风险设备。所有命令由你在本地终端执行不要让智能体自行扩大权限。事件历史可能包含家庭活动信息注意测试数据的隐私边界。如果团队共用 Key建议区分 TaoToken Key 和 Google Home MCP Token 的管理人。验收清单可以这样写[ ] TaoToken Key 已创建YOUR_API_KEY 已替换 [ ] ANTHROPIC_BASE_URL 为 https://taotoken.net/api [ ] Claude Code 普通对话正常无 401 [ ] claude mcp list 能看到 google-home [ ] claude mcp get google-home 显示 transport 与 URL 正确 [ ] Claude 能列出房间或设备 [ ] Claude 能读取最近事件历史 [ ] 控制测试仅限测试设备 [ ] Codex 未混用 ANTHROPIC_*config.toml 独立配置 [ ] CC Switch 三件套已填写 TaoToken 的 Base URL、API Key、模型名如果你在验收时发现模型侧正常、MCP 侧也显示连接但 Claude 仍然不调用工具可以在对话里明确要求它使用google-homeMCP。例如请使用 google-home MCP 的只读能力列出当前可见设备。不要执行控制。有时模型不会主动调用工具明确点名 MCP 名称会更容易触发。但前提仍然是claude mcp list中工具已经注册成功。安全验收完成后再考虑把它写进团队文档。团队文档里建议只写占位符和配置路径不要把真实 Key 写进 Markdown。Key 放在个人环境变量、密钥管理工具或 TaoToken 控制台中。需要新建或轮换 Key可以回到 TaoToken 官网 的 API Keys 页面处理。9. 文末路径模型对话、Coding Plan、创建 Key、Claude Code 文档到这里Claude 连 Google Home MCP 的完整链路已经拆成四层TaoToken Key 管模型网关Base URL 固定为https://taotoken.net/apiGoogle Home MCP Token 管设备授权Claude Code 的.mcp.json或claude mcp add管 MCP 注册。先让模型侧普通对话跑通再让claude mcp list显示连接最后用只读设备列表和事件历史做验收。Codex 和 CC Switch 各自独立配置不要把ANTHROPIC_*套到 Codex。如果你还没有开始可以按这个顺序操作先到 模型对话 验证当前模型是否可用。需要长期在 Claude Code、Codex 里使用时查看 Coding Plan。然后到 创建 API Key 生成YOUR_API_KEY。最后对照 Claude Code 文档 写入settings.json再添加 Google Home MCP。把真实 Key 替换进YOUR_API_KEY把 Google Home MCP URL 和 Token 换成你早期访问控制台里的实际值运行claude mcp list看到google-home已连接后再做只读事件历史验证。这样从领 Key 到 MCP 连接成功的路径就完整了。