1. 麒麟系统下 Chrome MCP Server 到底解决什么问题如果你在麒麟 Linux 桌面Kylin OSARM64 或 x86 都算上折腾过浏览器自动化大概率踩过同一个坑Playwright 拉起 Chromium 之后窗口白屏、灰屏进程活着但完全没响应headless 模式也一样卡死。我试过加--no-sandbox、--disable-dev-shm-usage、--disable-gpu装齐 libnss3、libatk、libgbm、libxshmfence换非 root 用户跑升降 Playwright 版本结果都差不多——在 Ubuntu 上能缓解的参数到了麒麟上基本无效。Chrome MCP Server 的思路完全不一样。它不是一个独立浏览器而是一个 Chrome 扩展 本地桥接服务把「你手动打开、已经登录好的那个 Chrome」通过 MCP 协议暴露给 AI 客户端。也就是说它不启动新的 Chromium 二进制不碰沙箱和/dev/shm那套限制直接复用麒麟上已经跑得好好的 Chrome 进程。对 OpenCode 这类支持 MCP 的编码 Agent 来说接上它就能调用 Playwright 级别的页面操作能力——截图、点击、提取正文、切标签页、查历史记录——但底层走的是 Chrome 原生 API不是 Playwright 的进程间通信。这篇要落地的路径很明确麒麟桌面 → 装 Chrome 扩展 → 起 mcp-chrome-bridge → 在 OpenCode 里配 MCP → 用 TaoToken 统一 Key 打通模型通道 → 发一条指令验证 AI 真的接管了浏览器。全程可复制配置骨架直接给。适合谁在信创环境做前端自动化、RPA、AI Agent 落地的开发者手上有麒麟机器但被 Playwright 假死卡住的同学以及想把 OpenCode 的编码能力和真实浏览器操作串起来的人。2. TaoToken 前置统一 Key 与 API 通道准备在配 OpenCode 之前先把模型通道搞定。TaoToken 在这里的角色是「统一 Key 统一 API 入口」——你不需要为每个模型单独申请 Key、记不同的 base_url一个 Key 走一个 API 地址就能切换模型。对 OpenCode 这种要在 config 里写 provider 的工具来说省掉大量重复配置。先拿 Key。打开控制台页面https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentconsole登录后在 API Keys 页面创建一个新 Key复制出来形如sk-开头的一串。这个 Key 后面要写进 OpenCode 的配置里别弄丢。API 通道地址固定用https://taotoken.net/api注意这个地址不加任何 UTM 参数直接作为 base_url 使用。模型名按你实际要用的填比如claude-sonnet-4-20250514、gpt-4o这类TaoToken 会按模型名路由。提示Key 只创建一次就够OpenCode 和后面可能的其他客户端可以共用同一个 Key。如果担心泄露在控制台随时可以吊销重建。如果你还没决定用哪个模型可以先到模型对话页面试一下确认通道通不通https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentmodel-chat在对话框里随便发一句能正常返回就说明 Key 和 API 地址没问题。这一步别跳过后面 OpenCode 报错时能快速排除是模型通道问题还是 MCP 问题。3. 可复制配置Chrome 扩展 Bridge OpenCode这一节是核心按顺序做每步都有可复制的命令或配置。3.1 环境确认先确认 Node 版本必须 ≥18.19.0推荐 v20 LTSnode -v # 期望输出 v20.x.x 或 v18.19.0 以上Chrome 要能在麒麟桌面上正常手动打开并且你已经登录了常用站点CSDN、GitHub 等因为 MCP 复用的就是这个登录态。3.2 安装 Chrome 扩展从 Releases 页面下载扩展包chrome-mcp-server-1.0.0.zip解压到一个固定目录比如/home/你的用户名/chrome-mcp-server。然后Chrome 地址栏输入chrome://extensions/右上角打开「开发者模式」点「加载已解压的扩展程序」选中刚才解压的目录加载后点浏览器右上角插件图标选「连接」能看到 MCP 配置界面就说明扩展起来了3.3 全局安装桥接工具# npm 方式 npm install -g mcp-chrome-bridge # 如果用 pnpm先开启安装脚本pnpm v7 默认禁用 pre/post 脚本 pnpm config set enable-pre-post-scripts true pnpm install -g mcp-chrome-bridge # 若自动注册失败手动注册 mcp-chrome-bridge register3.4 OpenCode 配置骨架OpenCode 的配置文件通常是~/.config/opencode/config.toml或项目内opencode.json看你用的版本。下面给一份完整骨架把 TaoToken 的 provider 和 chrome-mcp-server 都写进去。如果是 JSON 风格配置opencode.json{ provider: { taotoken: { type: openai, baseURL: https://taotoken.net/api, apiKey: sk-你的TaoTokenKey, models: { claude-sonnet-4-20250514: {}, gpt-4o: {} } } }, model: taotoken/claude-sonnet-4-20250514, mcp: { chrome-mcp-server: { type: remote, url: http://127.0.0.1:12306/mcp, enabled: true } } }如果是 TOML 风格config.tomlmodel taotoken/claude-sonnet-4-20250514 [provider.taotoken] type openai baseURL https://taotoken.net/api apiKey sk-你的TaoTokenKey [provider.taotoken.models.claude-sonnet-4-20250514] [mcp.chrome-mcp-server] type remote url http://127.0.0.1:12306/mcp enabled true关键点url固定http://127.0.0.1:12306/mcpenabled必须true。baseURL用 TaoToken 的 API 地址apiKey填你第 2 节拿到的 Key。3.5 启动 Bridge 连接 Chromepkill -f mcp-chrome-bridge sleep 2 \ timeout 5 node /home/你的用户名/.nvm/versions/node/v20.19.0/lib/node_modules/mcp-chrome-bridge/dist/index.js路径里的 node 版本号按你实际的改。终端出现「连接成功」相关日志就说明 Bridge 和 Chrome 扩展握上手了。4. 验证请求让 AI 真的接管浏览器配置写完重启 OpenCode然后发一条指令测试。建议从最简单的开始打开 CSDN 首页提取当前页面的核心内容如果一切正常你会看到 OpenCode 调用 chrome-mcp-serverChrome 里当前标签页跳到 CSDN然后返回正文摘要。再试几个对当前网页截图并保存到 /tmp/screenshot.png 搜索浏览器历史记录里包含 mcp 的条目 切换到第二个标签页点击页面上的登录按钮这些操作都在你正在用的 Chrome 上执行不需要重新登录响应比 Playwright 那套快不少。验证模型通道是否也走通了可以在 OpenCode 里问一句需要模型推理的问题比如「总结刚才提取的 CSDN 页面讲了什么」。如果模型能基于 MCP 返回的内容作答说明 TaoToken 通道 MCP 工具链全通了。注意如果 OpenCode 报「model not found」检查model字段的写法是不是taotoken/模型名以及 TaoToken 控制台里该模型是否可用。5. 本篇常见报错排查报错一Connection refused或ECONNREFUSED 127.0.0.1:12306Bridge 没起来。先pkill -f mcp-chrome-bridge杀掉残留再按 3.5 的命令重启。确认 Chrome 扩展图标是「已连接」状态不是灰色。报错二扩展加载后点「连接」没反应检查 Chrome 是不是用--no-sandbox之类参数启动的某些麒麟安全策略下需要正常启动。另外确认扩展目录没有被移动或删除加载的是解压后的完整目录。报错三OpenCode 里 MCP 工具列表为空config.toml或opencode.json里enabled是不是truetype是不是remote。改完配置必须重启 OpenCode热加载不一定生效。报错四模型返回 401 / 403TaoToken Key 填错或过期。到控制台重新复制一个注意sk-前缀别漏。baseURL 确认是https://taotoken.net/api结尾不要多加斜杠。报错五页面操作超时Chrome 当前标签页可能停在需要交互的弹窗上。手动切到目标标签页关掉遮挡的对话框再重发指令。MCP 操作的是「当前活动标签页」不是后台标签。报错六mcp-chrome-bridge: command not found全局安装没成功或 PATH 没包含 npm 全局 bin。用npm bin -g看路径手动加进 PATH或者直接用完整路径调dist/index.js。6. 后续怎么用Coding Plan 与长期接入跑通之后如果你打算把 OpenCode Chrome MCP 当成日常编码和 Agent 工作流的一部分建议看一下 Coding Plan它更适合长期高频调用https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcoding-plan接入文档在这里遇到 provider 配置细节可以对照https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentdocAPI Keys 管理页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentapi-keys如果你用的是 Claude Code 那套 Anthropic 风格的客户端接入说明在https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentclaude-code-anthropic最后说个实际经验Bridge 进程偶尔会因为 Chrome 更新扩展后掉线表现是 OpenCode 里 MCP 工具突然不可用。这时候不用重装pkill掉 Bridge 再按 3.5 重启一次就行Chrome 扩展不用动。另外麒麟上如果开了系统级安全审计第一次启动 Bridge 可能会弹权限确认允许一次之后就不再拦了。