乐鑫 EchoEar 的 MCP 401？TaoToken 这样填 Claude Code 的 Base URL

EchoEar喵伴本地联调 MCP 时冒出 401很多人第一反应是乐鑫开发板固件又出问题但在 Claude Code 里写代码、读日志的那条链路模型请求 401 更常见。先把 TaoToken 作为 Claude Code 的兼容通道打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentechoear_mcp401_intro 创建YOUR_API_KEY再把 Base URL 填成https://taotoken.net/api。它不碰 EchoEar 的 MCP 逻辑只保证 Claude Code 能发模型请求。这样你才能让它对照 MCP 接口文档检查握手参数把 401 拆成模型服务 401 和板子 MCP 401 两件事。EchoEar 是乐鑫和火山引擎扣子团队联名的 AI 智能体开发板主控 ESP32-S3-WROOM-1-N32R8带 8 MB PSRAM、32 MB Flash、圆形触摸屏、双麦克风阵列支持离线唤醒、声源定位也支持 MCP 协议与 Function Call。板子本身没问题问题常出在外围开发环境Claude Code 的ANTHROPIC_BASE_URL写成了https://taotoken.net/api/v1或者ANTHROPIC_AUTH_TOKEN用了 EchoEar 端的 MCP Token。下面按排障顺序走不刷固件先修通道再对照 MCP 握手。1. EchoEar 联调报 MCP 401先分清 Claude Code 模型请求和板子 MCP 请求1.1 401 拦在哪一层两个 Authorization 不要混EchoEar 作为 AI 智能体开发板板子侧会通过 MCP 协议暴露工具也可能用 Function Call 去驱动本地能力。你在本地开发时通常会开一个 Claude Code 会话让它读接口文档、解释 JSON-RPC 字段、生成请求样例。此时链路其实有两段Claude Code 到模型服务的请求以及本地客户端到 EchoEar MCP Server 的请求。两段都可能返回 401但含义完全不同。如果 Claude Code 启动后第一句话就报authentication_error、invalid x-api-key那 401 来自模型服务不是 EchoEar。反过来如果 Claude Code 本身能正常回答只是它生成的 MCP 请求发到板子后被拒那才去看 EchoEar 端的 MCP Token、握手版本和工具权限。很多“EchoEar MCP 401”的误判是把模型通道的 Key 错误算到了乐鑫开发板头上。所以排障第一步不是抓包而是看报错上下文错误发生在 Claude Code 的模型调用阶段还是发生在本地 curl / MCP Client 访问 EchoEar 的阶段。把这两段分开后面的动作才不会乱。1.2 Base URL 写不完整Claude Code 会先失败Claude Code 默认按 Anthropic 官方接口发请求。你把 Base URL 换成 TaoToken 的兼容通道时正确写法是https://taotoken.net/api末尾不要加/v1。有些人看到文档里出现/v1顺手拼成https://taotoken.net/api/v1结果请求路径对不上返回 401 或 404然后误以为 MCP 协议不兼容。还有一种情况是只写了域名比如把https://taotoken.net/api写成https://taotoken.net或者写成带 UTM 参数的官网地址。官网地址是给人注册、看模型、建 Key 用的不是填进ANTHROPIC_BASE_URL的接口地址。两件事混在一起Claude Code 连模型服务都进不去自然无法继续帮你查 EchoEar 的 MCP 问题。记住这条边界注册、创建 Key、看模型广场、看用量去https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentechoear_mcp401_prepare填进 Claude Code 的 Base URL只用https://taotoken.net/api。1.3 扣子智能体、ESP-Brookesia 与 Claude Code 的分工EchoEar 的语音对话、表情互动、长记忆、离线唤醒、声源定位、电机方向跟踪主要跑在板子和扣子平台侧。ESP-Brookesia 负责 UI 构建与渲染ESP-GMF 参与音视频框架MCP 协议与 Function Call 用来连接外部工具或家庭设备控制。这些都不是 Claude Code 的职责。Claude Code 更适合做开发助手读 EchoEar 的 MCP 接口文档帮你对照initialize、tools/list、tools/call的字段生成可复制的 curl 或 JSON 片段。它不能替代固件也不应该被写成“直接连上 EchoEar 去控制设备”。正确做法是Claude Code 生成或解释请求你在本地执行再把 EchoEar 返回的报错贴回对话。这条桥搭好401 才有定位的可能。2. 在 TaoToken 创建 Key把 Claude Code 的 ANTHROPIC_BASE_URL 填成 https://taotoken.net/api2.1 注册、创建 Key、复制模型 ID 的入口先解决 Claude Code 的模型请求通道。打开https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentechoear_mcp401_create_key注册登录后进入控制台在 API Keys 页面创建一把新 Key。这串值就是后面要填进ANTHROPIC_AUTH_TOKEN的YOUR_API_KEY。不要拿 EchoEar 的 MCP Token 来填也不要拿扣子平台的其他凭证来试。创建完 Key 后顺手去模型广场看当前可用的模型 ID。ANTHROPIC_MODEL必须填模型广场里真实存在的 ID不要自己拼日期后缀也不要猜一个不存在的型号。模型列表会变以页面当时显示为准。把 Key 和模型 ID 分开复制后面配置时不容易混。这一步对应原文里“模板复用 插件组装”的开发思路你不用从零搭模型通道先把 Claude Code 的请求接到可用模型上再让它辅助你处理 EchoEar 的 MCP 联调。通道和板子逻辑解耦排障才清晰。2.2 ~/.claude/settings.json 的 env 配置示例Claude Code 可以通过~/.claude/settings.json的env字段读取环境变量。把下面这段按你的实际 Key 和模型 ID 替换后保存{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: YOUR_API_KEY, ANTHROPIC_MODEL: YOUR_MODEL_ID } }注意三个点。第一ANTHROPIC_BASE_URL末尾没有/v1就是https://taotoken.net/api。第二ANTHROPIC_AUTH_TOKEN填的是刚创建的YOUR_API_KEY不是 EchoEar 的 MCP Token。第三ANTHROPIC_MODEL从模型广场复制不能凭记忆写。如果你的机器上已经有一份settings.json不要整份覆盖只把env里对应字段改掉。改完后退出 Claude Code再重新打开一个新会话。旧进程可能还拿着旧环境变量继续报 401 会让你误判。2.3 环境变量方式与生效检查有些团队喜欢用 shell 环境变量启动 Claude Code也可以但要确保当前终端会话生效export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKENYOUR_API_KEY export ANTHROPIC_MODELYOUR_MODEL_ID执行完可以在同一个终端里检查echo $ANTHROPIC_BASE_URL echo $ANTHROPIC_MODEL如果输出里出现了/v1或者模型 ID 明显是猜的就改回正确值。若你同时使用settings.json和 shell 环境变量确认哪个优先级更高。最稳妥的办法是只保留一套来源避免一个会话读到两套配置。验证通道时不要一上来就让 Claude Code 分析整个 EchoEar 工程。先让它回答一句“你好”确认模型请求不再 401。模型通道通了再进入 MCP 排障。3. 用 Claude Code 对照 EchoEar MCP 文档定位 401 的握手参数3.1 先让 Claude Code 只读文档、列字段、生成 curlClaude Code 恢复工作后不要让它直接连 EchoEar 执行设备操作。先给它三类材料EchoEar 的 MCP 接口文档片段、你本地执行后拿到的 401 响应、以及当前 MCP Client 的配置。让它做三件事解释initialize握手字段、列出tools/list需要哪些权限、生成一段可以本地执行的 curl 样例。提示词可以这样写“这是 EchoEar MCP 的接口文档和 401 返回。请只解释 JSON-RPC 字段判断 401 来自模型通道还是 MCP Server并生成一段本地 curl 检查样例。不要执行任何设备控制命令不要假设能直连板子。”这样 Claude Code 的角色是分析和生成实际请求仍由你在本地发出。这一步能快速区分问题如果 Claude Code 自己都发不出模型请求先回第 2 节修 Base URL如果它能正常分析说明模型通道已通401 更可能落在 EchoEar 端。3.2 本地执行 MCP initialize再把响应贴回对话把 EchoEar 文档里的 MCP 端点、端口和 Token 替换进下面的 curl在本地终端执行。注意这里的地址是 EchoEar 的 MCP 地址不是 TaoToken 的 Base URLcurl -i -X POST http://echoear-ip:port/mcp \ -H Content-Type: application/json \ -H Authorization: Bearer ECHOEAR_MCP_TOKEN \ -d {jsonrpc:2.0,id:1,method:initialize,params:{protocolVersion:2024-11-05,capabilities:{},clientInfo:{name:local-check,version:0.1.0}}}观察返回。如果 HTTP 状态是 401并且 body 是 MCP Server 风格那和 Claude Code 的模型 Key 无关去查 EchoEar 端 MCP Token、协议版本、工具权限。如果 Claude Code 刚才自己报authentication_error而你本地 curl 反而能通说明问题在 Claude Code 的ANTHROPIC_BASE_URL或ANTHROPIC_AUTH_TOKEN。把返回的 JSON 或报错原文贴回 Claude Code让它对照文档判断字段。不要只说“还是 401”要给出完整响应头、状态码和 body。401 的原因常常藏在WWW-Authenticate或错误消息里。3.3 EchoEar MCP Token 与 TaoToken Key 不要混用这是最常见的混用点。TaoToken Key 只用于 Claude Code 发模型请求填在ANTHROPIC_AUTH_TOKEN。EchoEar MCP Token 是本地客户端访问板子 MCP Server 时用的按乐鑫和扣子的接口文档配置。两者不是一把钥匙不能互换。如果你把YOUR_API_KEY填进 EchoEar 的 MCP Client 配置板子端当然会拒绝如果你把 EchoEar 的 MCP Token 填进ANTHROPIC_AUTH_TOKENClaude Code 连模型服务也会 401。排障时先看当前报错发生在哪条链路再决定用哪把凭证。3.4 401、403、404 对照表现象更可能的位置处理动作Claude Code 启动即报authentication_error模型通道检查ANTHROPIC_BASE_URL是否为https://taotoken.net/apiANTHROPIC_AUTH_TOKEN是否为YOUR_API_KEY本地 curl EchoEar 返回 401EchoEar MCP Server检查 MCP Token、Authorization头格式、协议版本返回 404 或路径错误Base URL 或 MCP 路径确认模型 Base URL 没加/v1MCP 端点按 EchoEar 文档填写返回 403权限或模型未开看 Key 权限、模型广场里该模型是否可用连接被拒绝网络或端口确认 EchoEar 与本地在同一网络端口、IP 正确提示表格里的 401 要结合报错来源看。模型通道的 401 和 MCP Server 的 401修法完全不同。4. 配完后的验证模型对话、Claude Code、EchoEar MCP 工具清单三步走4.1 先用模型对话测同一把 Key配置保存后先在 模型对话 里用同一把 Key 发一条测试消息。这样能排除 Key 本身、模型 ID、账户状态的问题。如果模型对话也报错先回控制台看 Key 是否复制完整模型 ID 是否从模型广场复制。模型对话通但 Claude Code 不通多半是 Claude Code 的配置文件或环境变量没生效。比如改了settings.json却没重启或者 shell 里残留了旧的ANTHROPIC_BASE_URL。这种时候不要继续折腾 EchoEar先让 Claude Code 自己恢复。4.2 在 Claude Code 里发一条只解释不执行的消息让 Claude Code 做一次低风险验证贴一段 EchoEar MCP 的接口文档让它只解释字段不执行任何设备命令。比如问“请解释这段 EchoEar MCP initialize 请求中每个字段的作用并指出可能触发 401 的字段。不要连接设备不要生成控制指令。”如果它能正常回答说明 Claude Code 到模型的请求已经稳定。接下来才让它参与 MCP 排障读文档、列工具、生成 curl、对照报错。它的输出仍然只是建议实际请求由你在本地执行。4.3 本地跑 MCP initialize 后回贴按照 3.2 的 curl在本地对 EchoEar MCP Server 执行一次initialize。把完整响应贴回 Claude Code让它对照文档判断是 Token 没带对是协议版本不匹配还是工具权限不够。如果返回 200 但tools/list为空那就不是 401 问题而是工具注册或权限问题方向要换。这种“Claude Code 解释、本地执行、回贴结果”的循环比让 Claude Code 直接连板子可靠得多。板子端的状态、日志、返回头都在你手里排障不会丢上下文。4.4 去控制台对一下这次调用回到https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentechoear_mcp401_usage看用量和调用记录。如果模型对话里有这次测试但 Claude Code 里没有对应记录说明 Claude Code 还在走旧配置或者根本没重启。用量面板能帮你确认请求到底有没有走到你创建的 Key 上。如果记录正常Claude Code 也能回答再回到 EchoEar MCP 的 401。此时你已经有能力让 Claude Code 对照文档检查握手参数而不是盲目刷固件。5. 仍然 401 时的回查顺序与下一步入口5.1 四个高频错位第一Base URL 多写了/v1。填进 Claude Code 的必须是https://taotoken.net/api末尾不要加版本路径。第二Key 拿错。ANTHROPIC_AUTH_TOKEN用YOUR_API_KEYEchoEar MCP Client 用ECHOEAR_MCP_TOKEN两者不要互换。第三模型 ID 靠猜。ANTHROPIC_MODEL要从模型广场复制不要写不存在的型号或自己拼日期。第四环境变量没生效。改完~/.claude/settings.json或 shell 变量后退出旧会话再开新会话否则旧进程继续用旧值。如果这四项都确认过仍然在 EchoEar MCP 侧报 401就回到 MCP Server 本身检查Authorization头是不是 Bearer检查协议版本检查工具权限。Claude Code 可以帮你读文档、解释返回但本地执行和贴回结果这步不能省。5.2 下一步从模型对话到 Coding Plan如果你还没建 Key先回https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentechoear_mcp401_keys创建。想快速确认模型通道用 模型对话 发一条消息即可。要长期用 Claude Code 写 EchoEar 的 MCP 调试代码可以看 Coding Plan 是否够用Key 在 控制台 API Keys 管理Claude Code 环境变量细节对照 接入文档。把 Claude Code 的模型请求稳住再拿它去读 EchoEar 的 MCP 文档401 就不再是一团乱麻。