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 是 MCP 客戶端,Chrome DevTools MCP 啓動或連接瀏覽器,負責打開 URL 和讀無障礙快照。模型登入與瀏覽器連接是兩件事。終端顯示 Connected 之後,還要用一張已知頁面核對結果。 一位使用者曾回報舊版 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、主標題和連結。

  • 分別確認模型驗證、工作區信任與工具核准。

AI 代理連接搜索、網頁和文檔的示意圖
代理程式連接搜尋、網頁與文件的示意圖。

搜索和瀏覽器操作各能驗證什麼

要回答的問題工具證據
最新版本說明在哪網頁搜索相關標題和原始連結
當前標籤顯示什麼瀏覽器 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 的整合。只有確認本機 runtime 和帳號後才採用這條路徑。遷移步驟請見 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 與你並肩工作。

跨分頁調研、自動化重複的瀏覽器工作,讓每一處上下文都觸手可及。