Chrome DevTools MCP 怎麼用、怎麼保留登入態:安裝配置、獨立目錄與遠程調試端口連接

Chrome DevTools MCP 本身免費且無需註冊帳號,大家搜「登入」通常是為了讓 AI 調試需要登入的網頁後台。本文按官方倉庫文檔講清安裝命令,以及用 --userDataDir 持久化獨立配置目錄、用 --browserUrl 掛載已登入瀏覽器的兩種標準做法。

NNathaniel bigo··原創首發·AI 輔助撰寫
10 分鐘讀完
資料核對於 2026-11-18 · 依據官方文檔與公開資料整理 免費帳號 帳號

結論先說

  1. Chrome DevTools MCP 本身不需要註冊任何平台帳號,也不用配 API Key;大家卡住的「登入」,指的是被調試的目標網站(比如本地管理後台、企業內網系統)需要保持登入態。
  2. 最穩妥的做法是加 --userDataDir 指定獨立持久化目錄:首次啟動後在彈出的瀏覽器裏手動登入一次測試帳號,Cookie 和本地存儲就會留在那個文件夾裏,下次會話直接複用,且不碰你日常辦公的主瀏覽器。
  3. 遇到複雜單點登入(SSO)想直接掛載已打開的窗口,用 --browserUrl=http://127.0.0.1:9222:注意新版 Chrome 出於安全限制,開啟 --remote-debugging-port=9222 時必須同時傳入非預設的 --user-data-dir,否則端口不會監聽。
  4. 永遠在瀏覽器窗口裏自己手動輸密碼和驗證碼,不要把帳號密碼貼進大模型對話框讓模型代填。

Chrome DevTools MCP 兩種保留登入方式

圖:本站根據 ChromeDevTools/chrome-devtools-mcp 官方文檔 整理的示意圖

本文根據 Google Chrome 團隊維護的開源倉庫 ChromeDevTools/chrome-devtools-mcp 官方文檔與 Claude Code MCP 文檔整理,核對日期 2026-11-18。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 Google 或 Anthropic 官方網站。

適用於誰

  • 搜「chrome devtools mcp 登入」「chrome devtools mcp 怎麼用」的人;
  • 讓 Claude Code、Codex 或 Cursor 排查前端頁面報錯時,每次拉起的新瀏覽器都停在登入頁、Cookie 留不住的開發者;
  • 想讓編碼助手直接讀取 Chrome 控制檯報錯、接口請求瀑布流(Network)和性能火焰圖(Performance)的人。

一、它能做什麼,和 Playwright MCP 怎麼選

chrome-devtools-mcp 是 Chrome DevTools 團隊官方發佈的本地 MCP 伺服器。裝好之後,AI 編碼助手不光能打開網頁、點擊元素和截屏,還能直接調用 Chrome 開發者工具底層的能力:讀取 Console 報錯堆棧、查看每個 Network 請求的狀態碼與響應體、錄製 Performance 性能追蹤分析卡頓原因,以及檢查 DOM 節點與計算後樣式。

如果你主要是讓 AI 自動點頁面跑端到端(E2E)迴歸測試腳本,選 Playwright MCP 更順手(見 /guides/claude-code-playwright-mcp-browser-testing);如果你是在開發前端或聯調接口時查渲染異常、查慢請求、查內存與性能瓶頸,Chrome DevTools MCP 給出的診斷資訊更深。

二、基礎安裝命令

確保本機已安裝 Node.js(含 npx)與 Chrome 瀏覽器。以 Claude Code 為例,在終端運行一條命令即可註冊:

bash
claude mcp add chrome-devtools -- npx -y chrome-devtools-mcp@latest

如果你用的是 Codex CLI 或 Cursor,同樣把啟動命令指向 npx -y chrome-devtools-mcp@latest 即可,各自客戶端的配置文件位置見 /guides/claude-code-mcp-setup、/guides/codex-mcp-config 與 /guides/cursor-mcp-config-json。

不帶額外參數時,MCP 拉起的瀏覽器環境與你平時的 Chrome 隔離。調公開網頁沒問題,但一碰到需要登入的業務後台,就要用到下面兩種保留登入態的配置。

配置 Chrome DevTools MCP 並完成登入

圖:本站根據 ChromeDevTools/chrome-devtools-mcp 官方文檔 整理的示意圖

三、做法一:用 --userDataDir 建專屬持久化登入目錄(推薦)

官方推薦優先給調試工作單獨建一個配置目錄,讓 MCP 每次啟動都讀寫這個固定目錄。這樣既能跨會話保留目標網站的登入 Cookie,又不會把你主力瀏覽器裏的私人網銀、電郵暴露給調試會話。

在項目 .mcp.json 或用戶級 MCP 配置裏寫入 --userDataDir 參數(Windows 路徑注意轉義反斜槓或改用正斜槓):

json
{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "chrome-devtools-mcp@latest",
        "--userDataDir=C:/temp/mcp-chrome-profile"
      ]
    }
  }
}

配好之後按三步走:

  1. 啟動 Claude Code,發一句「用 chrome-devtools 打開本地 http://localhost:3000」觸發瀏覽器拉起;
  2. 在彈出的專屬 Chrome 窗口裏,自己手動輸入測試帳號完成登入;
  3. 回到終端繼續讓 Claude 讀取頁面快照、檢查網絡請求。只要不清空 C:/temp/mcp-chrome-profile 目錄,以後每次啟動都會保持已登入狀態。

四、做法二:用 --browserUrl 連接已開啟遠程調試端口的 Chrome

如果目標系統登入鏈路很長(比如需要企業單點登入加硬件密鑰),你希望先自己開好瀏覽器把環境準備妥當,再讓 MCP 掛上去檢查,可以走遠程調試端口模式。

第一步:帶調試端口和自定義目錄啟動 Chrome

新版 Chrome 規定:如果只傳 --remote-debugging-port 而不指定非預設數據目錄,瀏覽器會拒絕開啟調試監聽。請先以獨立配置目錄啟動一個調試用 Chrome 實例:

  • macOS:
bash
  /Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222 --user-data-dir="$HOME/.chrome-mcp-debug"
  
  • Windows(PowerShell):
powershell
  & "C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222 --user-data-dir="C:\temp\chrome-mcp-debug"
  

窗口打開後,在裏面正常登入你需要排查的系統頁面。

第二步:讓 MCP 掛載到 127.0.0.1:9222

把 MCP 配置裏的參數改成 --browserUrl(或在新版裏配合瀏覽器側調試開關使用 --autoConnect):

json
{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "chrome-devtools-mcp@latest",
        "--browserUrl=http://127.0.0.1:9222"
      ]
    }
  }
}

連上之後,Claude Code 就能直接接管這個已經處於登入態的實例做網絡抓包與性能診斷。需要注意:拉取大型網頁快照和完整網絡日誌會消耗較多上下文額度,日常高頻聯調若需補充 Claude Code 訂閱額度,可查看 /chongzhi/claude-code 的官方方案說明。

常見問題

Q:配了 --browserUrl=http://127.0.0.1:9222 報連接被拒絕(ECONNREFUSED)是怎麼回事?

九成是因為啟動 Chrome 時漏傳了 --user-data-dir(或者指向了系統預設的 User Data 目錄),或者後台原本已經有 Chrome 進程佔用了窗口導致啟動參數沒有生效。可以先在瀏覽器訪問 http://127.0.0.1:9222/json/version,能返回 JSON 版本資訊才說明端口真正打開了。

Q:在無介面伺服器或不想彈窗時能跑無頭模式嗎?

如果目標頁面不需要人工掃碼或手輸驗證碼(比如本地免登開發環境),可以在 args 裏加上 --headless 參數靜默運行。一旦涉及人工登入,請先去掉 --headless 在可視窗口登完儲存進 --userDataDir,後續再評估是否切無頭模式。

Q:打開調試連接有什麼安全隱患需要注意?

官方倉庫特別提示:調試實例裏打開的所有標籤頁內容、Cookie 與接口返回數據,都能被當前 MCP 客戶端讀取。調試時不要在同一個瀏覽器實例裏同時打開無關的生產後台或私人敏感頁面。

相關教學

參考資料

  • ChromeDevTools/chrome-devtools-mcp 官方 GitHub 倉庫 — https://github.com/ChromeDevTools/chrome-devtools-mcp
  • Claude Code 官方文檔:Connect Claude Code to tools via MCP — https://code.claude.com/docs/en/mcp

Nathaniel 的更多內容

  1. 01

    LangGraph 流式輸出(Streaming)詳解:逐字 Token 流、節點進度與自定義事件寫法

    多步智能體如果等全部節點跑完才返回,網頁前端就會白屏乾等十幾秒。本文按 LangGraph 官方文檔講清 updates、messages、custom 與 values 四種 stream_mode 的區別,以及組合訂閱逐字打字機輸出加工具內部實時進度的完整代碼。

    其他 AI 工具0
  2. 02

    LangGraph 持久化與長期記憶怎麼配:Checkpointer、Store 與 PostgreSQL 實戰

    在生產環境跑 LangGraph,單靠 InMemorySaver 一重啟就會丟失全部對話。本文按官方文檔講清線程內短期檢查點(Checkpointer)與跨線程長期記憶(Store)的分工,以及用 langgraph-checkpoint-postgres 對接 PostgreSQL 的完整步驟。

    其他 AI 工具0
  3. 03

    LangGraph 多智能體怎麼寫:Supervisor 主管包與 Subgraph 隔離子圖實戰

    在 LangGraph 裏把單個圖擴展成多智能體協作有兩條官方路線:快速原型用預置包 langgraph-supervisor,大型生產系統用原生子圖(Subgraph)嵌套。本文講清兩種寫法的完整代碼、私有狀態隔離防 Token 膨脹技巧以及檢查點傳播規則。

    其他 AI 工具0
  4. 04

    LangGraph 人工介入審批怎麼寫:interrupt 暫停圖運行與 Command 恢復實戰

    企業之所以選 LangGraph,很大程度看中它能安全掛起等待人工審批(Human-in-the-Loop)。本文按官方最新規範講清 interrupt() 動態暫停、Checkpointer 必備條件、Command(resume=...) 恢復執行,以及防止副作用重複運行的重入規則。

    其他 AI 工具0
  5. 05

    多 Agent 協作平台怎麼選:Dify、釦子(Coze)、n8n 與 LangGraph 多智能體機制對比

    搜「多agent協作平台」時,Dify、釦子、n8n 和 LangGraph 都宣稱支持多智能體,但底層的調度方式完全不同。本文跳過基礎安裝,專門從多 Agent 角色跳轉、子代理工具調用、上下文隔離與私有化部署四個維度幫你一次選準。

    其他 AI 工具0
  6. 06

    企業微信有官方 MCP 和 CLI 嗎:@wecom/cli 安裝初始化、長連接機器人與接入教學

    搜「企業 微信 有 mcp 嗎」不用再東拼西湊民間群機器人腳本了:企業微信官方已推出 @wecom/cli 命令行工具並內置 stdio 模式的 MCP Server。本文按官方開發者文檔講清安裝、智能機器人長連接初始化、業務命令與接入 Claude Code 步驟。

    Claude其他 AI 工具0

同產品的其他教學

  1. 01

    MCP 收費嗎:開源協議免費邊界、第三方 API 帳單與隱形 Token 開銷說明

    搜「mcp 收費 嗎」的人常擔心裝多了插件會被扣費。MCP(模型上下文協議)本身和官方 SDK 採用 MIT 協議完全免費;實際使用中可能產生費用的只有兩處:掛載過多工具佔用的大模型上下文 Token,以及部分外部商業數據源自帶的 API 套餐。

    Claude其他 AI 工具0
  2. 02

    MCP 協議最新版本更新了什麼:無狀態架構、OAuth 2.1、結構化輸出與異步 Tasks 詳解

    搜「mcp 重大 更新」「mcp 協議 更新」想補齊規範演進脈絡?本文對照 modelcontextprotocol.io 官方規範更新日誌,梳理從 Streamable HTTP 到無狀態優先架構、OAuth 2.1 資源伺服器、Elicitation 交互補參與異步 Tasks 擴展的核心變化。

    Claude其他 AI 工具0
  3. 03

    A2A 和 MCP 有什麼區別:工具連接協議與智能體通信協議的邊界和配合

    很多人問「有了 MCP 為什麼還要出 A2A,兩者是不是二選一的競爭關係」。兩份官方規範都明確寫明它們是上下互補關係:MCP 負責給單個智能體掛載工具與數據源,A2A 負責讓多個獨立黑盒智能體跨團隊、跨框架互相派單協作。

    Claude其他 AI 工具0
  4. 04

    LangGraph 怎麼使用 MCP:用 langchain-mcp-adapters 接入本地與遠程工具

    想讓自建的 LangGraph 狀態圖直接調用現成的 MCP 伺服器,官方標準方案是安裝 langchain-mcp-adapters 並使用 MultiServerMCPClient。本文講清 stdio 與 streamable_http 兩種配置寫法、異步圖運行及按節點分工具技巧。

    Claude其他 AI 工具0
  5. 05

    LangGraph 入門教學:Python 安裝、核心概念與跑通第一個狀態圖智能體

    面向搜「python 安裝 langgraph」和「langgraph 中文 文檔」的初學者:本文按 LangChain 官方最新 Graph API 規範,講清安裝步驟、State/Node/Edge 四大概念,並從零寫出第一個帶工具調用循環的 StateGraph。

    Claude其他 AI 工具0
  6. 06

    Claude Agent SDK 子代理怎麼寫:AgentDefinition 配置、權限收斂與 Python/TS 示例

    在 Python 或 TypeScript 裏用 Claude Agent SDK 編排多角色協作,核心是配置 ClaudeAgentOptions 的 agents 字段與 AgentDefinition。本文講清必開的 Agent 委派權限、工具收斂、模型分級與完整代碼示例。

    Claude0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~