1. 先分清两条认证链Hermes 的模型 Key 与 Google Home MCP 授权给 Hermes 挂 Google Home MCPKey 填 TaoToken模型 Base URL 填 https://taotoken.net/api先在 TaoToken 官网 拿 Key。Google Home 近期开放 MCP 集成后Hermes、Claude、Open Claw 这类支持 Model Context Protocol 的智能体可以用统一工具协议读取和控制 Google Home 设备与事件历史。但很多人第一次配置时会卡在同一个点把 Google Home 的 OAuth 授权和 Hermes 的模型供应商 Key 混在一起。结果就是 Hermes 能启动却查询设备时报 401或者设备列表能出来模型回答却提示认证失败。这里先把三条链路拆开Google Home MCP负责把设备列表、设备控制、事件历史包装成 MCP 工具。它需要 Google Home 账号授权通常走 OAuth不是 TaoToken Key。Hermes作为 MCP 客户端和智能体运行时负责发现 MCP 工具、把用户指令交给模型推理、再调用对应工具。Hermes 的模型请求需要供应商 Key 和 Base URL。TaoToken提供模型推理 API。你在 Hermes 的模型供应商设置里填 TaoToken KeyBase URL 使用 https://taotoken.net/api。真正消耗 Token 的是 Hermes 发起的一次次模型推理包括理解用户意图、选择工具、总结 MCP 返回结果。因此正确姿势是Hermes 的模型供应商 Key 字段填YOUR_API_KEY这个 Key 来自 TaoToken。Hermes 的模型 Base URL 字段填https://taotoken.net/api。Google Home MCP 的授权字段填 Google Home 授权流程拿到的 access token 或 OAuth 配置不要填 TaoToken Key。设备查询命令由你在 Hermes 对话框里输入Hermes 会先调用 TaoToken 上的模型推理再通过 MCP 调用 Google Home 工具。返回结果对照如果模型回答“客厅灯已打开”说明模型链路和 MCP 链路都通了如果只报模型 401先查 TaoToken Key如果只报设备无权限先查 Google Home MCP 授权。这也是为什么本文标题强调“Key 填 TaoToken”。不是让你把 TaoToken Key 填到 Google Home MCP 里而是填到 Hermes 的模型供应商字段里。Google Home MCP 仍然使用 Google Home 自己的授权体系。两条链各管各的混淆之后排障会非常痛苦。2. 在 TaoToken 官网拿 Key并固定 Base URL 口径第一步不是改 Hermes而是先拿到可用的 TaoToken Key。打开 TaoToken 官网完成登录后进入控制台创建 API Key。创建时建议按用途命名例如hermes-google-home-mcp方便以后区分是 Hermes 在用还是 Claude Code、Codex、CC Switch 在用。拿到 Key 后不要直接写死到公开仓库。先在本地环境变量里验证export TAOTOKEN_API_KEYYOUR_API_KEY export TAOTOKEN_BASE_URLhttps://taotoken.net/api然后在 Hermes 的模型供应商配置中按下面口径填写字段建议值说明Provider 类型OpenAI Compatible / 自定义兼容以 Hermes 当前版本为准Base URLhttps://taotoken.net/api不要带 UTM不要带控制台路径API KeyYOUR_API_KEY来自 TaoToken 控制台Model你的模型名从 TaoToken 可用模型中选择用途模型推理设备控制仍由 Google Home MCP 执行有些客户端会把 Base URL 和具体路径分开填。比如 UI 上写“API Endpoint”你就填https://taotoken.net/api如果它要求 OpenAI 兼容根路径也仍然以 TaoToken 控制台或文档说明为准。不要在 Base URL 后面拼?utm_source...那是官网统计参数不是 API 路径。工具配置只认https://taotoken.net/api。这里还要提醒一点TaoToken Key 是模型推理凭证不是 Google Home 设备授权凭证。你可以在 Hermes 里同时存在两个凭证TAOTOKEN_API_KEYYOUR_API_KEY给 Hermes 调模型用。GOOGLE_HOME_ACCESS_TOKEN...给 Google Home MCP 调设备用。它们可以放在同一个 Hermes 配置环境里但字段位置不能混。模型供应商节点只放 TaoToken KeyMCP server 节点只放 Google Home 授权。这样后面出现 401、403 时你能一眼判断是哪条链断了。3. Hermes 客户端配置模型供应商字段与 Google Home MCP 字段Hermes 不同版本的配置文件路径和字段名可能不同但核心映射是固定的一个节点描述模型供应商一个节点描述 MCP server。下面给出一份 JSON 映射示例字段名以你本机 Hermes 版本为准。重点看字段含义不要盲目复制路径。{ modelProvider: { name: taotoken, type: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: YOUR_API_KEY, model: 你的模型名 }, mcpServers: { google-home: { transport: http, url: https://GOOGLE_HOME_MCP_ENDPOINT/mcp, headers: { Authorization: Bearer GOOGLE_HOME_ACCESS_TOKEN } } } }如果你的 Hermes 使用 YAML可以是类似结构model_provider: name: taotoken type: openai-compatible base_url: https://taotoken.net/api api_key: YOUR_API_KEY model: your-model-name mcp_servers: google-home: transport: http url: https://GOOGLE_HOME_MCP_ENDPOINT/mcp auth: type: oauth2 access_token: GOOGLE_HOME_ACCESS_TOKEN几个关键点base_url或baseUrl填https://taotoken.net/api不要填官网首页也不要填控制台页面。api_key或apiKey填YOUR_API_KEY这是 TaoToken Key。mcp_servers.google-home.url填 Google Home 侧提供的 MCP 端点。这个端点不要在本文里猜必须以 Google Home 授权页、开发者配置或你的 MCP 网关给出的地址为准。Authorization里放 Google Home 的 OAuth access token。不要把YOUR_API_KEY放进去。如果 Hermes 有单独的“启用的 MCP 工具”列表确保设备查询、设备控制、事件历史三类工具没有被禁用。配置完成后重启 Hermes。重启后先不要急着控制灯先让 Hermes 做一次“工具发现”。你可以在对话框输入请列出当前 Google Home MCP 暴露的工具只列出工具名称和用途不要调用设备控制。如果 Hermes 返回了工具列表说明 MCP server 至少已经连上如果返回“没有可用工具”先查 MCP server 是否启动、传输协议是否匹配、Google Home 授权是否完成。如果 Hermes 直接报模型请求失败先查 TaoToken Key 和 Base URL。4. 设备查询命令与返回结果对照从自然语言到 MCP 工具调用Hermes 挂上 Google Home MCP 后最直观的验证方式不是一上来就控制设备而是先查询。查询类操作风险低也更容易观察返回结构。下面给出一组可跟做的自然语言命令以及预期返回对照。4.1 先列设备不要先控制在 Hermes 里输入先不要控制任何设备。请通过 Google Home MCP 列出我账号下的所有设备只返回设备名称、房间、类型、在线状态。预期 Hermes 的行为是把你的指令发给 TaoToken 上的模型进行推理。模型判断需要调用 Google Home MCP 的设备列表工具。Hermes 执行工具调用拿到设备列表。模型把工具返回结果整理成表格或列表。这次推理和总结会消耗 Token。返回结果示意如下格式仅用于对照不代表 Google Home 官方固定字段{ devices: [ { name: 客厅主灯, room: 客厅, type: light, online: true, traits: [OnOff, Brightness] }, { name: 前门摄像头, room: 玄关, type: camera, online: true, traits: [CameraStream, MotionDetection] } ] }如果 Hermes 最终回答类似“你账号下有客厅主灯、前门摄像头均在线”说明模型链路和 MCP 查询链路都通了。4.2 查询单个设备状态输入请查询“客厅主灯”的当前状态只告诉我是否开启、亮度是多少。不要修改状态。返回结果对照用户命令Hermes 动作MCP 返回示意最终回答排障点查询客厅主灯调设备状态工具{on: true, brightness: 70}客厅主灯已开启亮度 70%无权限则查 Google Home 授权查询前门摄像头调设备状态工具{online: true, motion: false}前门摄像头在线当前无运动设备离线则查 Google Home 网络查最近事件调事件历史工具{events: [...]}最近 1 小时有 2 条运动事件报 401 先查 TaoToken Key4.3 控制设备时要求二次确认设备控制类命令风险更高。建议在 Hermes 里养成二次确认习惯请把“客厅主灯”打开亮度设为 30%。执行前先告诉我你准备调用哪个设备等我确认后再执行。确认后Hermes 会先做模型推理再调 Google Home MCP 的控制工具。返回示意{ device: 客厅主灯, action: setBrightness, result: accepted, brightness: 30 }如果最终回答是“已把客厅主灯打开亮度 30%”说明控制链路也通了。如果出现“模型请求失败”查 TaoToken如果出现“设备不存在”或“没有权限”查 Google Home 侧设备名称和授权范围。4.4 查询事件历史输入请读取前门摄像头最近 6 小时的运动事件最多返回 10 条按时间倒序最后用一句话总结。返回示意{ events: [ { device: 前门摄像头, event: motion, timestamp: 2025-01-01T08:30:00Z }, { device: 前门摄像头, event: motion, timestamp: 2025-01-01T07:12:00Z } ], nextPageToken: null }这里要注意 Token 消耗。事件历史如果一次性拉取太多原始 JSON 会进入模型上下文导致推理 Token 增加。所以命令里最好限制时间窗口和条数例如“最近 6 小时”“最多 10 条”“按时间倒序”“只用一句话总结”。5. 报错排查401、403、工具列表为空、设备超时配置完成后常见问题基本集中在四类。按下面顺序排查不要一上来就重装 Hermes。5.1 Hermes 报模型 401现象Hermes 对话框提示模型请求失败、unauthorized、invalid api key。排查echo $TAOTOKEN_API_KEY确认环境变量是否真的加载。然后检查 Hermes 模型供应商字段{ baseUrl: https://taotoken.net/api, apiKey: YOUR_API_KEY }注意三个常见错误把官网首页或控制台页面填进了 Base URL。把 Google Home access token 填进了模型 API Key。复制 Key 时带了空格或换行。5.2 Google Home MCP 报 403现象设备列表能发现但查询设备或事件历史时提示 forbidden、insufficient scope。这通常不是 TaoToken 的问题而是 Google Home 授权范围不够。重新走 Google Home 授权确保勾选设备读取、设备控制、事件历史相关权限。然后把新的 access token 更新到 Hermes 的 MCP server 配置里。5.3 Hermes 看不到 Google Home 工具现象Hermes 能正常聊天但让它列设备时回答“没有可用工具”。排查顺序MCP server 是否启动。Hermes 里mcpServers.google-home是否启用。url或command是否与 Google Home 侧给出的配置一致。传输协议是http、sse还是stdio是否填错。Hermes 是否被允许加载外部 MCP。如果 MCP server 有日志先看它有没有收到tools/list请求。如果没收到问题在 Hermes如果收到了但返回空列表问题在 Google Home MCP 或授权。5.4 设备查询超时现象模型正常回答但设备状态一直转圈最后 timeout。这通常是设备离线、Google Home 云端响应慢、MCP server 网络不通或者查询范围太大。先缩小范围只查询“客厅主灯”的在线状态超时时间 10 秒不要查询其他设备。如果单个设备正常全屋设备超时说明你需要分批查询而不是一次拉全量。另外不要把 Google Home MCP、Hermes 或任何 Agent 直连生产库、Oracle 或线上核心系统。设备控制命令和任何 SQL 都应由读者在本地执行并二次确认。MCP 是工具调用协议不是绕过权限和安全边界的通道。6. 同一套 TaoToken Key 在 Claude Code、Codex、CC Switch 里怎么放虽然本文主线是 Hermes 挂 Google Home MCP但很多人会同时用 Claude Code、Codex 或 CC Switch。它们可以共用 TaoToken Key但配置文件写法不同不能混用。6.1 Claude Codesettings.json 与 ANTHROPIC_*Claude Code 使用 Anthropic 兼容配置时可以放在settings.json里{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: YOUR_API_KEY, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }如果客户端要求 API Key 字段也可以用环境变量export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKENYOUR_API_KEY export ANTHROPIC_MODELclaude-sonnet-4-20250514注意这套ANTHROPIC_*只适用于 Claude Code 或 Anthropic 兼容客户端不要套到 Codex。6.2 Codexconfig.toml 与自定义 providerCodex 用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 版本要求responses协议就把wire_api改为responses具体以 Codex 版本和 TaoToken 控制台说明为准。关键是Codex 里不要写ANTHROPIC_*。6.3 CC Switch 三件套CC Switch 通常围绕 Base URL、API Key、Model 三项切换。可以按下面三件套填Base URL: https://taotoken.net/api API Key: YOUR_API_KEY Model: claude-sonnet-4-20250514如果 CC Switch 支持环境变量导入也可以对应ANTHROPIC_BASE_URLhttps://taotoken.net/api ANTHROPIC_AUTH_TOKENYOUR_API_KEY ANTHROPIC_MODELclaude-sonnet-4-20250514再次强调Claude Code、CC Switch 可以走ANTHROPIC_*Codex 走config.toml和自定义 provider。两者不要互相复制。7. 控制事件历史的 Token 消耗Hermes 里的上下文裁剪与查询策略Google Home MCP 让 Hermes 能查设备、控设备、读事件历史但每一次工具返回结果都会进入模型上下文。事件历史越多Token 消耗越明显。所以配置完成后真正影响使用成本的不是 MCP 本身而是你怎么让 Hermes 查询和总结。建议采用“先定位、再查询、后总结”的三段式。第一段先列设备先列出所有设备只返回名称、房间、类型、在线状态。不要返回原始 JSON。第二段只查目标设备只查询“客厅温湿度传感器”最近 6 小时的事件最多 20 条按时间倒序。第三段要求总结不要复述请用表格总结事件趋势不要复述原始 JSON不要给出无关设备信息。如果 Hermes 支持工具结果长度限制可以配置类似参数{ context: { maxToolResultChars: 8000, historyWindow: 6h, summarizeToolResult: true, maxEventsPerQuery: 20 } }字段名以 Hermes 当前版本为准。核心策略是事件历史查询默认限制时间窗口例如 1 小时、6 小时、24 小时。默认限制条数例如 10 条、20 条。要求 Hermes 总结不要原样复述 JSON。不要把全屋全年事件一次性拉进上下文。对高频查询做分页避免单次工具返回过大。另外如果你在 Hermes 里同时挂了多个 MCP例如 Google Home、文件系统、浏览器工具建议给 Google Home MCP 单独设置较严格的上下文预算。设备事件历史通常比普通工具返回更冗长容易把 Token 吃掉。8. 生产可用前的检查清单与 CTA在把 Hermes Google Home MCP 用于日常自动化之前按下面清单过一遍Hermes 模型供应商 Base URL 是否为https://taotoken.net/api且没有带 UTM 参数。Hermes 模型 API Key 是否为 TaoToken 的YOUR_API_KEY。Google Home MCP 的 Authorization 是否为 Google Home OAuth token而不是 TaoToken Key。Hermes 是否能成功执行tools/list并看到设备查询、设备控制、事件历史相关工具。设备查询命令是否先查列表再查单个设备。事件历史是否限制了时间窗口和条数。日志中是否脱敏了 TaoToken Key 和 Google Home access token。设备控制类命令是否要求二次确认。是否避免让 MCP/Agent 直连生产库、Oracle 或线上核心系统。是否在 TaoToken 官网 确认了当前可用模型和 Key 状态。如果以上都通过Hermes 挂 Google Home MCP 的基本链路就已经跑通。剩下的是根据你的设备数量和事件频率调整查询策略与上下文预算。需要继续配置或切换工具时可以按下面路径走模型对话https://taotoken.net/models/detail/chat?utm_sourcetaotoken_aicg_blog_endutm_contenthermes_google_home_mcp_chatCoding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contenthermes_google_home_mcp_coding创建 API Keyhttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contenthermes_google_home_mcp_keysClaude Code 文档https://taotoken.net/doc/ClaudeCodeAnthropic?utm_sourcetaotoken_aicg_blog_endutm_contenthermes_google_home_mcp_claudecode最后再回到本文标题给 Hermes 挂 Google Home MCPKey 填 TaoToken。更准确地说是把 TaoToken Key 填到 Hermes 的模型供应商字段把 Google Home 授权留给 MCP server。Base URL 固定为 https://taotoken.net/api设备查询先用自然语言验证返回结果对照模型推理和 MCP 工具调用两条链路。这样排障时401 查 TaoToken403 查 Google Home工具为空查 MCP 加载超时查设备和查询范围整个链路就清楚了。