Tabbit博客

怎样用 Gemini CLI 和 Chrome DevTools MCP 操作网页

锁定 Gemini CLI 和浏览器 MCP 版本,在项目里登记服务,用网页快照分层核对连接与结果。

本文目录
  1. Gemini CLI 能操作 Chrome 吗?
  2. 要点
  3. 搜索和浏览器操作各能验证什么
  4. 在小项目锁定版本
  5. 从握手检查到网页快照
  6. 原生 Browser Agent 还是继续用 MCP 配置?
  7. 在同一台电脑上用 Tabbit CLI 访问已登录浏览器
  8. 根据失败发生在哪一层排查
  9. 保留最小回执

Gemini CLI 能操作 Chrome 吗?

如果你的 Gemini CLI 账号仍有使用资格,可以。当前文档介绍了基于内置 Chrome DevTools MCP 的实验性 Browser Agent,也仍支持单独配置 MCP 服务。打开网页前,先确认两条路径各自使用哪个 Chrome 资料或会话。Gemini 账号授权与浏览器登录是两回事。部分方案的停服日期已过,先确认账号资格。一位用户曾报告旧版 Gemini CLI 无法连接 DevTools MCP,同一个服务却能在另一个客户端连接。遇到类似情况,可以先查项目配置和传输。 GitHub #178

如果你的 Gemini CLI 账号仍有使用资格,可以。当前文档介绍了基于内置 Chrome DevTools MCP 的实验性 Browser Agent,也仍支持单独配置 MCP 服务。打开网页前,先确认两条路径各自使用哪个 Chrome 资料或会话。Gemini 账号授权与浏览器登录是两回事。部分方案的停服日期已过,先确认账号资格。 一位用户曾报告旧版 Gemini CLI 无法连接 DevTools MCP,同一个服务却能在另一个客户端连接。遇到类似情况,可以先查项目配置和传输。 GitHub #178

官方扩展目录也列出了 Chrome DevTools MCP。本文用显式的项目配置,版本、启动参数和范围都能核对。 Gemini CLI MCP 指南 Chrome DevTools 配置 浏览器中的 Gemini

Google 的生命周期公告会影响哪些用户还能使用旧配置。截至 2026-11-09,面向 Google AI Pro/Ultra 与免费 Gemini Code Assist for individuals 用户的 2026-06-18 停服日期已过。Google 表示,Standard/Enterprise 授权,以及付费 Gemini 或 Gemini Enterprise Agent Platform API key 用户仍可使用 Gemini CLI。请先确认自己的授权,再照本文操作。符合条件的用户仍可使用 Gemini CLI 的浏览器 Agent 和 MCP 配置。Google 迁移公告 Gemini CLI 迁移指南

要点

  • 在项目中登记 Chrome DevTools MCP,先使用独立浏览器资料。

  • 用 gemini mcp list 查连接,再在 Gemini CLI 里用 /mcp desc 查工具。

  • 打开一张已知网页,从工具结果核对最终 URL、主标题和链接。

  • 分别核对模型认证、工作区信任和工具审批。

智能体连接搜索、网页和文档的示意图
智能体连接搜索、网页和文档的示意图。

搜索和浏览器操作各能验证什么

要回答的问题工具证据
最新版本说明在哪网页搜索相关标题和原始链接
当前标签显示什么浏览器 MCP页面 URL 和当前快照
写入改了哪个字段浏览器 MCP 加人工授权具体动作、记录 ID 和读回值
MCP 是否登记成功Gemini CLI MCP 客户端当前项目中的连接状态

搜索结果可找到发布公告,不能说明当前账号或点击后的状态。浏览器快照能确认显示内容,却不会自动判断它是不是最新的官方资料。先明确要验证的事实,再选能返回证据的工具。 搜索与浏览器操作 AI Agent 的职责

在小项目锁定版本

以下是根据官方文档整理的配置示例,固定 Gemini CLI 0.67.0 和 Chrome DevTools MCP 1.12.0,便于对应工具参数。先查服务器对 Node.js 和 Chrome 的要求,保留依赖锁文件。 Chrome DevTools MCP v1.12.0

mkdir browser-mcp-check
cd browser-mcp-check
npm init -y
npm install --save-exact @google/gemini-cli@0.67.0 chrome-devtools-mcp@1.12.0
./node_modules/.bin/gemini --version
./node_modules/.bin/chrome-devtools-mcp --version

将下列条目放进项目的 .gemini/settings.json。将路径替换为本机项目内可执行文件绝对路径;如已有配置,合并服务条目。

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "/absolute/path/browser-mcp-check/node_modules/.bin/chrome-devtools-mcp",
      "args": ["--headless", "--isolated", "--no-usage-statistics"],
      "includeTools": ["new_page", "take_snapshot", "list_pages", "close_page"],
      "trust": false
    }
  }
}

includeTools 限定 Gemini CLI 暴露的工具,不限制域名。--isolated 使用临时浏览器资料。先访问自己控制或获准查看的页面。需要复用登录时,单独确认连接方式和会话账号。Google 的 Codelab 使用完整测试应用,初次核对只需已知标题和链接的小页面。 连接现有浏览器 Google UI 测试实验

工作区信任允许 Gemini 加载项目配置。trust: false 让服务器的工具调用仍受当前策略约束。先进入交互模式,收到审批提示时查看服务器名、动作和 URL。ask_user 规则在非交互模式下会拒绝调用。如果环境要求限制可访问网址,在 Chrome DevTools MCP 中单独配置。--allowed-url-pattern 需要 Chrome 149 或更新版本。 Gemini CLI 审批策略 Chrome DevTools MCP 配置

从握手检查到网页快照

在项目目录运行 ./node_modules/.bin/gemini mcp list。受信任工作区可加载项目内的服务器配置。进入 Gemini CLI 交互会话后,运行 /mcp desc 查看可用工具及参数。模型访问单独配置。 Gemini CLI 认证方法

看到的结果可以确认下一步
服务缺失或断开登记或传输仍需排查查目录、工作区信任、程序路径和启动参数
已连接但看不到工具服务器已连通查工具发现、includeTools 和策略
工具可见但无法调用发现工具成功查模型认证、审批模式和工具规则
有页 ID 且快照符合预期Chrome 到达预期网页对照最终 URL、主标题和预期链接

要重复验证,可以在第二个终端进入测试项目并启动一个本地页面。预期主标题为 “MCP browser check”,链接指向 #details。用工具返回的结果核对这两项。

mkdir -p fixture
cat > fixture/index.html <<'HTML'
<!doctype html>
<meta charset="utf-8">
<title>MCP browser check</title>
<h1>MCP browser check</h1>
<a href="#details">Details</a>
<p id="details">Local fixture</p>
HTML
python3 -m http.server 8765 --bind 127.0.0.1 --directory fixture

示例固定的版本要求把 new_page 返回的页 ID 作为 pageId 传给 take_snapshot。网页可能重定向,判断前看实际返回的 URL 和标题。 v1.12.0 工具文档

用 chrome-devtools MCP 打开 http://127.0.0.1:8765/。返回页 ID、最终 URL、主标题和一条预期链接。按打开结果的页 ID 取快照。访问失败时返回工具错误。不要输入凭证、提交表单或修改内容。

原生 Browser Agent 还是继续用 MCP 配置?

Gemini CLI 当前文档介绍了实验性的 browser_agent,它会启动随 CLI 提供的 Chrome DevTools MCP。此功能默认关闭,需要 Chrome 144 或更新版本,并在首次使用时请求授权。persistent 使用 Gemini CLI 自己的资料目录,isolated 每次创建临时资料,existing 则连接已启用远程调试的现有 Chrome。这是比单独安装 MCP 服务更简便的新入口,但仍是 Chrome 路径,不会自动选中 Tabbit 资料。请核对 Browser Agent 文档 和当前发布记录。

路径使用对象适合场景开始前检查
内置 Browser AgentGemini CLI 自带的 Chrome DevTools MCP 与已配置 Chrome 会话仍有 Gemini CLI 使用资格,且需要官方浏览器工具Chrome 版本、功能开关、授权、会话模式、实际登录账号
下文的项目 MCP 配置显式安装的 Chrome DevTools MCP 包和项目设置需要固定工具集或项目级 MCP 服务当前包兼容性、项目可信状态、审批策略和服务状态
本机 Agent 调用 Tabbit CLITabbit Skill 说明和本地安装的 Tabbit CLI 启动器需要同一台电脑上的 Tabbit 已登录会话Skill 是否发现、shell 权限、启动器可达、Tabbit 网站登录

在同一台电脑上用 Tabbit CLI 访问已登录浏览器

若 Gemini CLI 运行在安装 Tabbit 的同一台电脑,它可以从用户级 ~/.agents/skills/ 目录发现 Agent Skills。用 /skills list 检查,再让 Gemini CLI 激活 Tabbit Skill,并在出现提示时批准读取。发现 Skill 只说明指令可见。CLI 进程还必须获准运行本地 Tabbit 启动器,且启动器能访问已经登录目标网站的 Tabbit 实例。三项分别验证。远程 Gemini CLI 不会自动连接桌面上的 Tabbit,除非已配置受支持的本地交接。Gemini CLI Skill 发现规则 Tabbit CLI 设置指南

例如,让 Gemini CLI 只读一篇公开版本说明并留下待审草稿。此提示不依赖 Gemini 自带的 /tabbit 命令:

在这个本机 Gemini CLI 会话中使用已安装的 Tabbit Skill 和 Tabbit CLI。在独立任务标签页打开版本说明,只读取当前版本可见的日期和功能条目。返回名为“Release notes review — draft 01”的草稿,包含版本、日期、功能、来源链接,以及一条需要人工确认的内容。不要编辑原页面或发布草稿。完成后展示草稿和来源链接供我审核。如果找不到 Skill、shell 无法运行 Tabbit 启动器或页面未登录,指出失败的检查并停止。

任务标签页与日常 Tabbit 窗口分开,你可以继续正常浏览。本环境曾用本地测试页验证 Tabbit CLI 能复用已登录会话,但测试未通过 Gemini CLI 运行,不能证明 Gemini 到 Tabbit 的集成。只有确认本地运行环境和账号之后,才采用这条路径。迁移步骤请看 Antigravity CLI 指南,其浏览器功能与 Tabbit CLI 路径不同。

根据失败发生在哪一层排查

如果服务无法注册,先核对配置范围、版本和传输。GitHub 上有用户报告旧版 Gemini CLI 连接失败,同一任务在另一客户端可连接。它是历史环境问题,先检查本地参数再判断。另有 Apple Silicon 用户发现 MCP 进程通过 PATH 用了 Intel Node,修正 PATH 后自己的问题解决。先核对真正使用的 Node 和架构。 GitHub 原 issue Reddit 原帖

如果能打开网页但快照报错,检查该版本的工具参数,从打开结果获取页 ID。如果跳到登录页,则暂停并记录需要人工接管。 核对登录会话

保留最小回执

保存 CLI、MCP 和浏览器版本,配置范围、浏览器模式、工具列表、最终 URL、页 ID 和预期结果。记录在哪一步发生了权限批准或失败。再跑时可以定位是哪一层不同。 第一个浏览器任务 按任务选浏览器连接 什么是 Agent 浏览器

如果要在 Gemini CLI 会话中读取 Chrome 的当前状态,先登记项目级服务,再用一张已知网页查通这条路径。之后每多开一项工具,都为它设定可核对的预期结果。

常见问题

Gemini CLI 能操作 Chrome 吗?

仍有 Gemini CLI 使用资格的用户可以选择实验性的内置 Browser Agent,也可以配置浏览器 MCP 服务。内置 Agent 需要 Chrome 144 或更新版本,并在首次使用时授权;MCP 服务仍可单独配置。

网页搜索等于操控标签页吗?

搜索检索信息。操控需要浏览器工具、可达网页和适当的会话。

Connected 代表已经打开网站吗?

只确认 MCP 传输握手。打开网页并读取快照才能确认浏览器到达目标。

可以复用已登录的 Chrome 吗?

内置 Browser Agent 可在启用远程调试后用 `existing` 模式连接运行中的 Chrome。本机 Gemini CLI 也可通过获准的 Skill 和 shell 调用 Tabbit CLI,再核对 Tabbit 中已登录的页面。这是另一条连接路径。

Gemini CLI 报认证错误怎么办?

先确认当前账号授权,因为 Google 的迁移影响了部分个人方案。随后配置 Gemini CLI 支持的认证方式。模型服务授权与浏览器工具连接需要分别检查。

下一步

让 Tabbit 与你并肩工作。

跨标签页调研、自动化重复的浏览器工作,让每一处上下文都触手可及。