企业官网建设流程全解析

1. 先分清两套 Key：TaoToken 给模型，Google Home MCP 给设备授权

如果你正在 Claude Code 里执行claude mcp add google-home ...，结果模型侧返回401，MCP 侧又提示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 URL：https://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_KEY

Claude 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" } }

说明几个点：

1. ANTHROPIC_BASE_URL固定填 TaoToken 的 Base URL，不带 UTM。
2. ANTHROPIC_AUTH_TOKEN填你在 TaoToken 控制台创建的 Key，也就是YOUR_API_KEY。
3. ANTHROPIC_MODEL填 TaoToken 控制台当前可用的模型 ID。上面的claude-sonnet-4只是示例，真正使用时请从控制台复制，避免invalid model。
4. 如果你的 Claude Code 版本读取的是ANTHROPIC_API_KEY，那就把同一个YOUR_API_KEY填到ANTHROPIC_API_KEY，不要同时乱填多个不同 Key。
5. 不要把ANTHROPIC_*写进 Codex 的config.toml。Codex 不读这套变量，后面会单独讲。

也可以先用 shell 环境变量做快速验证：

export ANTHROPIC_BASE_URL="https://taotoken.net/api" export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY" export ANTHROPIC_MODEL="claude-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.json：

claude 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-home

claude mcp list里应该能看到google-home。如果是disconnected，先看type是否选错：HTTP 用http，SSE 用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_URL="https://taotoken.net/api" export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY" export ANTHROPIC_MODEL="claude-sonnet-4" claude --version

第二步，设置 Google Home MCP 侧参数：

export GOOGLE_HOME_MCP_URL="https://<你的-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_KEY="YOUR_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_URL="https://taotoken.net/api" export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY" export TAOTOKEN_API_KEY="YOUR_API_KEY"

两边都用同一个 TaoToken Key 可以，但变量名和配置文件不要混。Claude Code 管 Claude Code，Codex 管 Codex。这样排障时才能快速判断是模型网关问题，还是客户端配置问题。

6. CC Switch 三件套：Base URL、API Key、模型名切换 TaoToken

如果你用 CC Switch 管理多个模型供应商，核心就是三件套：Base URL、API Key、模型名。切换到 TaoToken 时，填写如下：

供应商名称：TaoToken Base URL：https://taotoken.net/api API Key：YOUR_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/api，Key 为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 时最常见的几类。先按表格定位，再回到对应章节修改。

更具体的排查顺序：

1. 先验证模型侧。运行claude --version，再发普通对话。如果普通对话都 401，先不要看 MCP。
2. 再验证 MCP 注册。运行claude mcp list，确认google-home存在。
3. 再验证 MCP 连接。运行claude mcp get google-home，看 URL、transport、header 是否符合早期访问说明。
4. 最后验证工具调用。让 Claude 列设备或读事件历史，不要一上来就执行控制。
5. 如果还是不行，把.mcp.json里的type在http和sse之间切换测试。很多 disconnected 都是 transport 不匹配。
6. 如果 Codex 同时报错，单独检查config.toml。不要把 Claude Code 的ANTHROPIC_*复制过去。

还有一个容易忽略的点：环境变量只在当前终端会话有效。你在 A 终端设置了ANTHROPIC_AUTH_TOKEN，在 B 终端启动 Claude Code，B 终端可能读不到。长期使用建议写进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/api，Google Home MCP Token 管设备授权，Claude Code 的.mcp.json或claude mcp add管 MCP 注册。先让模型侧普通对话跑通，再让claude mcp list显示连接，最后用只读设备列表和事件历史做验收。Codex 和 CC Switch 各自独立配置，不要把ANTHROPIC_*套到 Codex。

如果你还没有开始，可以按这个顺序操作：

1. 先到 模型对话 验证当前模型是否可用。
2. 需要长期在 Claude Code、Codex 里使用时，查看 Coding Plan。
3. 然后到 创建 API Key 生成YOUR_API_KEY。
4. 最后对照 Claude Code 文档 写入settings.json，再添加 Google Home MCP。

把真实 Key 替换进YOUR_API_KEY，把 Google Home MCP URL 和 Token 换成你早期访问控制台里的实际值，运行claude mcp list，看到google-home已连接后，再做只读事件历史验证。这样从领 Key 到 MCP 连接成功的路径就完整了。