[实战评测]爱情来了！当Claude SubAgent遇上了GLM网页读取MCP：TaoToken统一Key配置与settings.json骨架

1. 当 Claude SubAgent 撞上 GLM 网页读取 MCPKey 到底该放哪Claude 的 SubAgent 机制本质上是一个「任务分发器」主 Agent 负责理解意图、拆解步骤SubAgent 负责执行具体动作。而 GLM 的 web-reader MCP 提供的能力很直接——给一个 URL它把网页内容抓下来、转成 Markdown 或纯文本再交给大模型做后续处理。两者组合起来就是「Claude 负责想GLM 负责读」的链路。问题出在配置层。Claude Code 的 MCP 配置写在settings.json里GLM 的 web-reader 需要Authorization: Bearer api_key头而如果你同时还在用其他模型服务Key 就会散落在环境变量、.env、settings.json、shell profile 好几个地方。改一个 Key 要翻五个文件SubAgent 调用时还可能因为环境变量没继承而报 401。这篇要解决的就是这件事用 TaoToken 的统一 Key 作为入口把 Claude SubAgent 调用 GLM web-reader MCP 的settings.json骨架一次性写清楚再给出触发验证动作和报错排查清单。适合已经在用 Claude Code、想接入网页读取能力、但被多 Key 配置搞烦的开发者。2. TaoToken 前置统一 Key 与 MCP 接入准备TaoToken 在这里的角色是「Key 的统一出口」。你不需要在 Claude 配置里分别填 GLM 的 Key、其他模型的 Key而是通过 TaoToken 拿一个统一 Key再在需要的地方引用。先拿到 Key。访问控制台创建 API Keyhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentconsole创建完成后Key 形如sk-xxxxxxxx。这个 Key 后面会同时用于两处一是 Claude Code 访问模型服务二是 GLM web-reader MCP 的 Authorization 头。如果你还没确认 TaoToken 的 API 入口基础地址是https://taotoken.net/api注意这个地址不加 UTM 参数直接用于代码里的base_url配置。接下来确认 Claude Code 已安装。终端执行claude --version如果返回版本号说明 CLI 就绪。没装的话按官方方式安装后再继续。这一步不展开重点在配置。关于 MCP 的接入文档TaoToken 侧有对应说明页遇到协议层问题时可以对照https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentdoc3. 可复制配置settings.json 骨架与 MCP 注册Claude Code 的 MCP 配置有两种写法一种是用claude mcp add命令注册一种是直接写settings.json。命令注册适合快速试settings.json适合版本管理和团队共享。这里给settings.json骨架因为 SubAgent 场景下配置需要稳定可复现。先看 GLM web-reader MCP 的原始注册命令形态claude mcp add -s user -t http web-reader https://open.bigmodel.cn/api/mcp/web_reader/mcp --header Authorization: Bearer your_api_key这条命令做了三件事作用域设为 user全局可用、传输类型 http、注册一个名为web-reader的 MCP server并带上 Authorization 头。your_api_key替换成你从 TaoToken 拿到的 Key。对应的settings.json骨架如下。文件位置通常在~/.claude/settings.jsonuser 作用域或项目根目录的.claude/settings.json{ mcpServers: { web-reader: { type: http, url: https://open.bigmodel.cn/api/mcp/web_reader/mcp, headers: { Authorization: Bearer sk-你的TaoToken统一Key } } }, env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoToken统一Key } }这里的关键点是mcpServers里的 Authorization 和env里的ANTHROPIC_API_KEY用的是同一个 Key。这就是「统一 Key」的落地方式——一个 Key 同时驱动模型访问和 MCP 鉴权改 Key 只改一处。如果你更习惯用命令注册等价写法是claude mcp add -s user -t http web-reader \ https://open.bigmodel.cn/api/mcp/web_reader/mcp \ --header Authorization: Bearer sk-你的TaoToken统一Key注册后可以用claude mcp list确认web-reader出现在列表里。注意settings.json里的 Key 是明文。如果是团队共享的仓库建议用环境变量引用而不是硬编码例如把 Key 放在 shell 的export TAOTOKEN_KEYsk-xxx然后在配置里写Authorization: Bearer ${TAOTOKEN_KEY}。但要注意 Claude Code 对${}展开的支持情况实测下来部分版本对 MCP headers 里的变量展开不完整稳妥做法是本地文件不提交、用.gitignore排除。4. 验证请求SubAgent 触发 web-reader 的完整动作配置写完先别急着上 SubAgent单独验证 MCP 通不通。第一步确认 MCP server 已加载claude mcp list预期输出里能看到web-reader及其 URL。如果这里就没有说明settings.json路径不对或 JSON 格式有误。第二步在 Claude Code 交互界面里直接调用工具。输入类似用 web-reader 读取 https://github.com/trending 返回 markdown 格式禁用缓存如果 MCP 正常Claude 会调用webReader工具参数大致是{ url: https://github.com/trending, return_format: markdown, no_cache: true }返回结果是一段 Markdown 文本包含 trending 页面的项目列表。这一步通了说明 Key、URL、header 三件套都对。第三步上 SubAgent。SubAgent 的本质是在 prompt 里定义一个角色和任务边界。比如定义一个「GitHub Trending 摘要器」你是一个 GitHub Trending 摘要 SubAgent。 任务调用 web-reader 读取 https://github.com/trending 提取前 10 个项目输出每个项目的仓库名、语言、今日 star 增长、描述。 要求no_cache 设为 truereturn_format 用 markdown。主 Agent 收到这个任务后会把它分发给 SubAgentSubAgent 触发 web-reader 调用拿到内容后做结构化提取。实测下来这条链路跑通后输出是一份带项目名、语言、star 数的清单格式稳定。关于 web-reader 的参数这里整理成对照表方便你在 prompt 里精确控制参数名类型必需默认值说明urlstring是-要读取的网页地址timeoutinteger否20请求超时秒数no_cacheboolean否false是否禁用缓存return_formatstring否markdown返回格式markdown 或 textretain_imagesboolean否true是否保留图片no_gfmboolean否false是否禁用 GitHub 风格 Markdownkeep_img_data_urlboolean否false是否保留图片 data URLwith_images_summaryboolean否false是否包含图片摘要with_links_summaryboolean否false是否包含链接摘要其中no_cache是最容易踩坑的参数。默认false意味着走缓存如果你读的是实时榜单、新闻页、价格页缓存会导致内容过期。在 prompt 里明确写「no cache」或直接传no_cache: true。5. 本篇常见错排查401、超时、缓存与 SubAgent 不触发配置跑不通时按下面清单逐项排查。401 Unauthorized。最常见。原因通常是三个Key 写错、header 格式不对、Key 没有对应权限。检查Authorization头的值是不是Bearer sk-xxx格式Bearer 和 Key 之间有一个空格。如果用的是环境变量引用确认变量在当前 shell 会话里已 export。另外确认这个 Key 是从 TaoToken 控制台创建的、状态正常。MCP server 未出现在 list 里。检查settings.json的路径。user 作用域是~/.claude/settings.json项目作用域是项目根/.claude/settings.json。JSON 格式错误会导致整个文件被忽略用python -m json.tool settings.json验证一下语法。请求超时。web-reader 默认 timeout 是 20 秒。如果目标页面加载慢或体积大会超时。在 prompt 里指定更大的 timeout比如timeout: 60。但注意不要设太大否则 SubAgent 会卡住。读到的内容是旧的。这就是缓存问题。默认no_cache: false读实时页面必须显式禁用。在 prompt 里写「no cache」或在工具参数里传no_cache: true。实测下来GitHub Trending 这类页面不禁用缓存会拿到几小时前的数据。SubAgent 不触发 web-reader。如果主 Agent 没有把任务分发给 SubAgent或者 SubAgent 没有调用工具检查两点一是 SubAgent 的 prompt 里有没有明确写「调用 web-reader」二是 MCP 工具是否对 SubAgent 可见。部分配置下 SubAgent 的工具权限需要单独声明确认settings.json里没有对 SubAgent 做工具白名单限制。返回内容乱码或结构错乱。尝试把return_format从markdown改成text或者调整no_gfm。有些页面本身 HTML 结构不规范转 Markdown 时会出问题换 text 格式更稳。Key 泄露风险。如果settings.json被提交到公开仓库Key 就暴露了。用.gitignore排除或者改用环境变量引用。已经泄露的话去 TaoToken 控制台吊销旧 Key、创建新 Key。6. 把链路固定下来从验证到日常使用链路跑通后建议把 SubAgent 的定义固化成一个可复用的 prompt 模板放在项目里。这样每次需要读网页时不用重新描述任务。对于长期做编码和 Agent 开发的场景如果调用量上来了可以关注 Coding Plan 的额度方案https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcoding-plan日常调试模型行为、验证 web-reader 返回内容是否符合预期时用模型对话页面直接试更快https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentmodel-chat如果 Key 需要重新生成或管理多个环境的 Key回到 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentapi-keys我自己的做法是把settings.json里的 Key 抽成环境变量SubAgent 的 prompt 模板放在项目的.claude/agents/目录下每次新增一个网页读取任务就复制模板改 URL 和提取规则。这样配置只维护一份SubAgent 可以无限扩展。踩过的坑里最值得记住的就是no_cache——读实时数据忘了关缓存排查半天以为是 Key 或网络问题其实是拿了几小时前的旧内容。