1. 为什么大模型操控浏览器总卡在“最后一公里”Puppeteer MCP 是一套基于 Model Context Protocol 的浏览器自动化服务它把 Puppeteer 的导航、点击、填表、截图、执行 JavaScript 等能力封装成标准工具接口让大模型用自然语言就能远程操控浏览器。它适合做动态页面数据采集、自动化测试、页面监控以及把大模型接入真实网页交互流程的开发者。我试过把 Puppeteer MCP 单独跑起来浏览器确实能开、页面确实能跳但一旦要让大模型稳定调用问题就集中爆发在“模型侧怎么连、Key 怎么管、请求怎么发”这三件事上。传统做法是每个模型客户端各配一套 KeyOpenAI 一套、Claude 一套、本地模型又一套配置文件散落在不同目录换台机器就得重新翻文档。更麻烦的是Puppeteer MCP 本身只负责浏览器那一端它不解决大模型 API 的统一接入问题。你等于要同时维护两条链路一条是 MCP Server 到浏览器另一条是模型客户端到模型 API。任何一条断了整个自动化采集就停在半路。这篇要解决的就是第二条链路。我会用 TaoToken 作为统一的大模型 API 通道把 Puppeteer MCP 的浏览器能力和大模型的推理能力接在一起给出一份可以直接复制的config.toml与settings.json骨架再演示一次真实的浏览器自动化采集验证动作。目标很明确让你在半小时内跑通“大模型下指令 → MCP 调浏览器 → 抓回数据”的完整闭环而不是卡在配置环节反复试错。TaoToken 在这里的角色是统一 Key 和 API 入口。你不需要为不同模型分别申请账号、分别记 Base URL而是用同一个 Key 走同一个通道模型切换只改一个模型名参数。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 注意 API 地址不带 UTM 参数配置里填这个就行。2. TaoToken 前置Key、通道与 MCP 的关系在动手改配置之前先把三个概念理清楚不然后面看到config.toml和settings.json会混。第一个是 TaoToken 的 API Key。它相当于你进出模型服务的通行证所有模型请求都靠它鉴权。你需要在控制台里创建一个 Key创建入口在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content Key 的管理和查看在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。创建完先复制保存后面两处配置都要用到。第二个是 API 通道地址。TaoToken 的 API 根地址是 https://taotoken.net/api 它兼容常见的 OpenAI 风格调用格式。也就是说任何支持自定义 Base URL 的模型客户端把地址指向这里、把 Key 填进去就能走通。这一点很关键因为 Puppeteer MCP 生态里很多客户端比如 Claude Code、各类支持 MCP 的编辑器插件都允许你覆盖模型端点。第三个是 MCP 的定位。Puppeteer MCP 是“工具提供方”它向大模型暴露puppeteer_navigate、puppeteer_screenshot、puppeteer_click、puppeteer_evaluate这类工具。大模型是“决策方”它根据你的自然语言指令决定调哪个工具、传什么参数。TaoToken 是“模型接入方”负责让大模型能收到这些工具定义并返回工具调用。三者关系是你 → 大模型经 TaoToken→ MCP 工具 → 浏览器。如果你只是想让模型对话验证链路可以直接用模型对话页面 https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 试一句“帮我打开某页面并读取标题”确认模型侧通了再配 MCP。如果是长期做编码和 Agent 任务建议看 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 它的额度模型更适合高频工具调用。接入细节和字段说明统一看文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。注意API Key 不要写进会提交到 Git 的配置文件里。下面骨架里我用占位符sk-你的Key你实际使用时用环境变量注入或者放在本地不纳入版本管理的文件里。3. 可复制配置config.toml 与 settings.json 骨架这一节是全文的核心直接给可复制的配置。不同客户端的配置文件名不一样我按最常见的两类来给一类用config.toml常见于 Claude Code 及部分 CLI 工具一类用settings.json常见于编辑器插件和 MCP 客户端。你按自己用的客户端选对应的那份。3.1 config.toml 骨架先看config.toml。这份配置同时声明了模型通道和 MCP Server 启动方式。模型部分指向 TaoTokenMCP 部分用 NPX 拉起 Puppeteer MCP。# ~/.claude/config.toml 或项目根目录 config.toml # 模型通道统一走 TaoToken [model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的Key model claude-sonnet-4-20250514 # MCP ServerPuppeteer 浏览器自动化 [mcp_servers.puppeteer] command npx args [-y, modelcontextprotocol/server-puppeteer] [mcp_servers.puppeteer.env] PUPPETEER_LAUNCH_OPTIONS {headless: true, args: [--no-sandbox]}几个字段说明一下。base_url填https://taotoken.net/api不要带末尾斜杠也不要加 UTM 参数。model字段填你要用的模型名TaoToken 支持多种模型具体可用名称在文档里查。PUPPETEER_LAUNCH_OPTIONS里headless: true表示无头模式服务器上跑采集建议开无头本地调试想看到浏览器窗口就改成false。--no-sandbox在容器环境里通常需要本地如果报沙箱相关错误也可以加上。3.2 settings.json 骨架再看settings.json。这份适合编辑器类 MCP 客户端结构是 JSON字段含义和上面一致。{ model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的Key, modelName: claude-sonnet-4-20250514 }, mcpServers: { puppeteer: { command: npx, args: [-y, modelcontextprotocol/server-puppeteer], env: { PUPPETEER_LAUNCH_OPTIONS: {\headless\: true, \args\: [\--no-sandbox\]} } } } }注意 JSON 里PUPPETEER_LAUNCH_OPTIONS的值是一个被转义的字符串不是嵌套对象。这是很多客户端解析环境变量时的要求写成对象反而会报错。如果你用的客户端支持直接写对象那按它的文档来。3.3 用环境变量替代明文 Key不想把 Key 写死在文件里可以改成引用环境变量。以config.toml为例[model] provider openai-compatible base_url https://taotoken.net/api api_key ${TAOTOKEN_API_KEY} model claude-sonnet-4-20250514然后在 shell 里导出export TAOTOKEN_API_KEYsk-你的KeyWindows PowerShell 用$env:TAOTOKEN_API_KEYsk-你的Key这样配置文件可以安全地放进版本库Key 只存在本地环境里。实测下来这个做法在团队协作时最省心换人只需要重新导出环境变量不用改任何配置文件。4. 验证请求跑通一次浏览器自动化采集配置写完别急着上复杂任务先用一个最小采集动作验证整条链路。我选一个结构简单的公开页面做演示目标是让大模型通过 Puppeteer MCP 打开页面、读取标题、抓取指定元素文本。4.1 启动与工具发现先确认 MCP Server 能被拉起。在终端里手动跑一次npx -y modelcontextprotocol/server-puppeteer如果它正常启动并等待输入说明 Puppeteer MCP 本身没问题。接着启动你的模型客户端让它加载配置。客户端启动后通常会列出可用的 MCP 工具。你应该能看到类似puppeteer_navigate、puppeteer_screenshot、puppeteer_click、puppeteer_evaluate这些工具名。如果看不到说明 MCP Server 没被正确加载回到第 5 节排查。4.2 用自然语言下采集指令工具出现后直接在对话里下指令。比如打开 https://example.com 读取页面标题然后用 puppeteer_evaluate 执行document.querySelector(h1).innerText把结果返回给我。大模型收到后会先调用puppeteer_navigate传入 URL等页面加载完再调用puppeteer_evaluate执行你给的脚本。整个过程你不需要手写 Puppeteer 代码模型负责编排工具调用顺序。如果你想更精确地控制也可以直接给结构化参数。比如导航这一步模型实际发出的工具调用大致是{ name: puppeteer_navigate, arguments: { url: https://example.com, launchOptions: { headless: true } } }截图指定元素则是{ name: puppeteer_screenshot, arguments: { name: main_content, selector: h1, width: 1280, height: 720 } }执行 JavaScript 取数据{ name: puppeteer_evaluate, arguments: { script: document.querySelector(h1).innerText } }4.3 成功结果长什么样链路通的情况下你会看到三段反馈。第一段是导航成功返回页面加载状态第二段是截图或求值结果比如Example Domain这样的标题文本第三段是模型用自然语言把结果复述给你。如果开了可视化模式headless: false你还能亲眼看到浏览器窗口自动打开、跳转、执行脚本。采集场景里更实用的是批量抓取。你可以让模型循环操作导航到列表页 → 执行脚本提取所有条目 → 点击下一页 → 重复。Puppeteer MCP 的puppeteer_click配合puppeteer_evaluate就能完成翻页采集。下面是一个提取列表项文本的脚本示例// 在 puppeteer_evaluate 的 script 参数里传入 Array.from(document.querySelectorAll(.item-title)) .map(el el.innerText.trim()) .filter(Boolean)模型拿到数组后可以直接整理成表格返回。这一步跑通说明 TaoToken 通道、MCP 工具、浏览器三层全部打通。5. 本篇常见错排查配置和验证过程中报错基本集中在下面几类。我按出现频率排一下你对照着查。第一类模型请求 401 或鉴权失败。最常见的原因是 Key 没填对或者base_url写成了带 UTM 的完整链接。记住 API 地址就是https://taotoken.net/api不要加?utm_source...那串。另外检查 Key 有没有多余空格复制时容易带上换行。如果用的是环境变量方式确认导出命令在当前 shell 会话里生效了换个终端窗口就要重新导出。第二类MCP Server 启动失败或工具列表为空。先单独跑npx -y modelcontextprotocol/server-puppeteer看能不能起来。如果报 Node 版本相关错误升级 Node 到 18 以上。如果客户端里看不到工具检查配置文件路径对不对——不同客户端读取配置的位置不一样有的读用户目录有的读项目根目录。还有一点config.toml和settings.json别同时放客户端可能只认其中一种。第三类无头模式截图空白。这是 Puppeteer 的经典问题。多数情况是沙箱限制导致的在PUPPETEER_LAUNCH_OPTIONS的args里加上--no-sandbox和--disable-setuid-sandbox通常能解决。如果还不行检查页面是不是需要等异步渲染完成可以在执行脚本前加一个等待或者让模型先调puppeteer_evaluate执行await new Promise(r setTimeout(r, 2000))。第四类元素定位失败。报错通常是选择器找不到元素。先确认 CSS 选择器在浏览器开发者工具里能选中目标。动态页面要注意元素可能在 iframe 里Puppeteer 需要先切换 frame。另外页面加载时机也关键导航后立刻求值可能拿到空结果让模型在导航和求值之间加一步等待更稳。第五类模型不调用工具只回文字。这说明模型没把 MCP 工具当成可用能力。检查客户端是否真的加载了 MCP Server以及当前模型是否支持工具调用。有些轻量模型对工具调用的支持不稳定换一个工具调用能力强的模型再试。TaoToken 通道本身不影响工具调用它只负责转发请求工具定义是客户端注入的。排障时如果拿不准是通道问题还是 MCP 问题可以先用模型对话页面单独发一条普通消息确认模型侧通再单独跑 MCP Server确认浏览器侧通。两边都通合起来还不通那就是配置字段的问题逐项对照第 3 节的骨架检查。6. 把链路固定下来接入与长期使用建议链路跑通一次之后下一步是让它稳定可复用。我的做法是把配置拆成两层模型通道配置和 MCP 配置分开管理。模型通道那份只放base_url、api_key引用和模型名MCP 那份只放启动命令和浏览器参数。这样换模型时只动第一份换浏览器行为时只动第二份互不干扰。Key 的管理建议走控制台统一维护创建和轮换都在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你要长期跑采集任务注意控制请求频率给浏览器操作留出加载时间避免因为页面没渲染完就求值导致空数据。采集脚本里加等待和重试比事后补数据省事得多。接入文档里对字段和错误码有更完整的说明遇到骨架里没覆盖的客户端去 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 对照着改。需要长期跑编码和 Agent 类任务的话Coding Plan 的额度模型比按次调用更适合高频工具调用场景入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后提醒一句浏览器自动化采集要遵守目标站点的 robots 协议和使用条款别对同一站点高频轰炸。技术上跑通是一回事用得合规是另一回事。配置骨架给你了剩下的就是按自己的采集目标去调选择器和流程。
Puppeteer MCP 配 TaoToken：让大模型操控浏览器的自动化采集配置骨架
1. 为什么大模型操控浏览器总卡在“最后一公里”Puppeteer MCP 是一套基于 Model Context Protocol 的浏览器自动化服务它把 Puppeteer 的导航、点击、填表、截图、执行 JavaScript 等能力封装成标准工具接口让大模型用自然语言就能远程操控浏览器。它适合做动态页面数据采集、自动化测试、页面监控以及把大模型接入真实网页交互流程的开发者。我试过把 Puppeteer MCP 单独跑起来浏览器确实能开、页面确实能跳但一旦要让大模型稳定调用问题就集中爆发在“模型侧怎么连、Key 怎么管、请求怎么发”这三件事上。传统做法是每个模型客户端各配一套 KeyOpenAI 一套、Claude 一套、本地模型又一套配置文件散落在不同目录换台机器就得重新翻文档。更麻烦的是Puppeteer MCP 本身只负责浏览器那一端它不解决大模型 API 的统一接入问题。你等于要同时维护两条链路一条是 MCP Server 到浏览器另一条是模型客户端到模型 API。任何一条断了整个自动化采集就停在半路。这篇要解决的就是第二条链路。我会用 TaoToken 作为统一的大模型 API 通道把 Puppeteer MCP 的浏览器能力和大模型的推理能力接在一起给出一份可以直接复制的config.toml与settings.json骨架再演示一次真实的浏览器自动化采集验证动作。目标很明确让你在半小时内跑通“大模型下指令 → MCP 调浏览器 → 抓回数据”的完整闭环而不是卡在配置环节反复试错。TaoToken 在这里的角色是统一 Key 和 API 入口。你不需要为不同模型分别申请账号、分别记 Base URL而是用同一个 Key 走同一个通道模型切换只改一个模型名参数。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 注意 API 地址不带 UTM 参数配置里填这个就行。2. TaoToken 前置Key、通道与 MCP 的关系在动手改配置之前先把三个概念理清楚不然后面看到config.toml和settings.json会混。第一个是 TaoToken 的 API Key。它相当于你进出模型服务的通行证所有模型请求都靠它鉴权。你需要在控制台里创建一个 Key创建入口在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content Key 的管理和查看在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。创建完先复制保存后面两处配置都要用到。第二个是 API 通道地址。TaoToken 的 API 根地址是 https://taotoken.net/api 它兼容常见的 OpenAI 风格调用格式。也就是说任何支持自定义 Base URL 的模型客户端把地址指向这里、把 Key 填进去就能走通。这一点很关键因为 Puppeteer MCP 生态里很多客户端比如 Claude Code、各类支持 MCP 的编辑器插件都允许你覆盖模型端点。第三个是 MCP 的定位。Puppeteer MCP 是“工具提供方”它向大模型暴露puppeteer_navigate、puppeteer_screenshot、puppeteer_click、puppeteer_evaluate这类工具。大模型是“决策方”它根据你的自然语言指令决定调哪个工具、传什么参数。TaoToken 是“模型接入方”负责让大模型能收到这些工具定义并返回工具调用。三者关系是你 → 大模型经 TaoToken→ MCP 工具 → 浏览器。如果你只是想让模型对话验证链路可以直接用模型对话页面 https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 试一句“帮我打开某页面并读取标题”确认模型侧通了再配 MCP。如果是长期做编码和 Agent 任务建议看 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 它的额度模型更适合高频工具调用。接入细节和字段说明统一看文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。注意API Key 不要写进会提交到 Git 的配置文件里。下面骨架里我用占位符sk-你的Key你实际使用时用环境变量注入或者放在本地不纳入版本管理的文件里。3. 可复制配置config.toml 与 settings.json 骨架这一节是全文的核心直接给可复制的配置。不同客户端的配置文件名不一样我按最常见的两类来给一类用config.toml常见于 Claude Code 及部分 CLI 工具一类用settings.json常见于编辑器插件和 MCP 客户端。你按自己用的客户端选对应的那份。3.1 config.toml 骨架先看config.toml。这份配置同时声明了模型通道和 MCP Server 启动方式。模型部分指向 TaoTokenMCP 部分用 NPX 拉起 Puppeteer MCP。# ~/.claude/config.toml 或项目根目录 config.toml # 模型通道统一走 TaoToken [model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的Key model claude-sonnet-4-20250514 # MCP ServerPuppeteer 浏览器自动化 [mcp_servers.puppeteer] command npx args [-y, modelcontextprotocol/server-puppeteer] [mcp_servers.puppeteer.env] PUPPETEER_LAUNCH_OPTIONS {headless: true, args: [--no-sandbox]}几个字段说明一下。base_url填https://taotoken.net/api不要带末尾斜杠也不要加 UTM 参数。model字段填你要用的模型名TaoToken 支持多种模型具体可用名称在文档里查。PUPPETEER_LAUNCH_OPTIONS里headless: true表示无头模式服务器上跑采集建议开无头本地调试想看到浏览器窗口就改成false。--no-sandbox在容器环境里通常需要本地如果报沙箱相关错误也可以加上。3.2 settings.json 骨架再看settings.json。这份适合编辑器类 MCP 客户端结构是 JSON字段含义和上面一致。{ model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的Key, modelName: claude-sonnet-4-20250514 }, mcpServers: { puppeteer: { command: npx, args: [-y, modelcontextprotocol/server-puppeteer], env: { PUPPETEER_LAUNCH_OPTIONS: {\headless\: true, \args\: [\--no-sandbox\]} } } } }注意 JSON 里PUPPETEER_LAUNCH_OPTIONS的值是一个被转义的字符串不是嵌套对象。这是很多客户端解析环境变量时的要求写成对象反而会报错。如果你用的客户端支持直接写对象那按它的文档来。3.3 用环境变量替代明文 Key不想把 Key 写死在文件里可以改成引用环境变量。以config.toml为例[model] provider openai-compatible base_url https://taotoken.net/api api_key ${TAOTOKEN_API_KEY} model claude-sonnet-4-20250514然后在 shell 里导出export TAOTOKEN_API_KEYsk-你的KeyWindows PowerShell 用$env:TAOTOKEN_API_KEYsk-你的Key这样配置文件可以安全地放进版本库Key 只存在本地环境里。实测下来这个做法在团队协作时最省心换人只需要重新导出环境变量不用改任何配置文件。4. 验证请求跑通一次浏览器自动化采集配置写完别急着上复杂任务先用一个最小采集动作验证整条链路。我选一个结构简单的公开页面做演示目标是让大模型通过 Puppeteer MCP 打开页面、读取标题、抓取指定元素文本。4.1 启动与工具发现先确认 MCP Server 能被拉起。在终端里手动跑一次npx -y modelcontextprotocol/server-puppeteer如果它正常启动并等待输入说明 Puppeteer MCP 本身没问题。接着启动你的模型客户端让它加载配置。客户端启动后通常会列出可用的 MCP 工具。你应该能看到类似puppeteer_navigate、puppeteer_screenshot、puppeteer_click、puppeteer_evaluate这些工具名。如果看不到说明 MCP Server 没被正确加载回到第 5 节排查。4.2 用自然语言下采集指令工具出现后直接在对话里下指令。比如打开 https://example.com 读取页面标题然后用 puppeteer_evaluate 执行document.querySelector(h1).innerText把结果返回给我。大模型收到后会先调用puppeteer_navigate传入 URL等页面加载完再调用puppeteer_evaluate执行你给的脚本。整个过程你不需要手写 Puppeteer 代码模型负责编排工具调用顺序。如果你想更精确地控制也可以直接给结构化参数。比如导航这一步模型实际发出的工具调用大致是{ name: puppeteer_navigate, arguments: { url: https://example.com, launchOptions: { headless: true } } }截图指定元素则是{ name: puppeteer_screenshot, arguments: { name: main_content, selector: h1, width: 1280, height: 720 } }执行 JavaScript 取数据{ name: puppeteer_evaluate, arguments: { script: document.querySelector(h1).innerText } }4.3 成功结果长什么样链路通的情况下你会看到三段反馈。第一段是导航成功返回页面加载状态第二段是截图或求值结果比如Example Domain这样的标题文本第三段是模型用自然语言把结果复述给你。如果开了可视化模式headless: false你还能亲眼看到浏览器窗口自动打开、跳转、执行脚本。采集场景里更实用的是批量抓取。你可以让模型循环操作导航到列表页 → 执行脚本提取所有条目 → 点击下一页 → 重复。Puppeteer MCP 的puppeteer_click配合puppeteer_evaluate就能完成翻页采集。下面是一个提取列表项文本的脚本示例// 在 puppeteer_evaluate 的 script 参数里传入 Array.from(document.querySelectorAll(.item-title)) .map(el el.innerText.trim()) .filter(Boolean)模型拿到数组后可以直接整理成表格返回。这一步跑通说明 TaoToken 通道、MCP 工具、浏览器三层全部打通。5. 本篇常见错排查配置和验证过程中报错基本集中在下面几类。我按出现频率排一下你对照着查。第一类模型请求 401 或鉴权失败。最常见的原因是 Key 没填对或者base_url写成了带 UTM 的完整链接。记住 API 地址就是https://taotoken.net/api不要加?utm_source...那串。另外检查 Key 有没有多余空格复制时容易带上换行。如果用的是环境变量方式确认导出命令在当前 shell 会话里生效了换个终端窗口就要重新导出。第二类MCP Server 启动失败或工具列表为空。先单独跑npx -y modelcontextprotocol/server-puppeteer看能不能起来。如果报 Node 版本相关错误升级 Node 到 18 以上。如果客户端里看不到工具检查配置文件路径对不对——不同客户端读取配置的位置不一样有的读用户目录有的读项目根目录。还有一点config.toml和settings.json别同时放客户端可能只认其中一种。第三类无头模式截图空白。这是 Puppeteer 的经典问题。多数情况是沙箱限制导致的在PUPPETEER_LAUNCH_OPTIONS的args里加上--no-sandbox和--disable-setuid-sandbox通常能解决。如果还不行检查页面是不是需要等异步渲染完成可以在执行脚本前加一个等待或者让模型先调puppeteer_evaluate执行await new Promise(r setTimeout(r, 2000))。第四类元素定位失败。报错通常是选择器找不到元素。先确认 CSS 选择器在浏览器开发者工具里能选中目标。动态页面要注意元素可能在 iframe 里Puppeteer 需要先切换 frame。另外页面加载时机也关键导航后立刻求值可能拿到空结果让模型在导航和求值之间加一步等待更稳。第五类模型不调用工具只回文字。这说明模型没把 MCP 工具当成可用能力。检查客户端是否真的加载了 MCP Server以及当前模型是否支持工具调用。有些轻量模型对工具调用的支持不稳定换一个工具调用能力强的模型再试。TaoToken 通道本身不影响工具调用它只负责转发请求工具定义是客户端注入的。排障时如果拿不准是通道问题还是 MCP 问题可以先用模型对话页面单独发一条普通消息确认模型侧通再单独跑 MCP Server确认浏览器侧通。两边都通合起来还不通那就是配置字段的问题逐项对照第 3 节的骨架检查。6. 把链路固定下来接入与长期使用建议链路跑通一次之后下一步是让它稳定可复用。我的做法是把配置拆成两层模型通道配置和 MCP 配置分开管理。模型通道那份只放base_url、api_key引用和模型名MCP 那份只放启动命令和浏览器参数。这样换模型时只动第一份换浏览器行为时只动第二份互不干扰。Key 的管理建议走控制台统一维护创建和轮换都在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你要长期跑采集任务注意控制请求频率给浏览器操作留出加载时间避免因为页面没渲染完就求值导致空数据。采集脚本里加等待和重试比事后补数据省事得多。接入文档里对字段和错误码有更完整的说明遇到骨架里没覆盖的客户端去 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 对照着改。需要长期跑编码和 Agent 类任务的话Coding Plan 的额度模型比按次调用更适合高频工具调用场景入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后提醒一句浏览器自动化采集要遵守目标站点的 robots 协议和使用条款别对同一站点高频轰炸。技术上跑通是一回事用得合规是另一回事。配置骨架给你了剩下的就是按自己的采集目标去调选择器和流程。