第三方工具更新 2026.11.16

Playwright MCP 教學:安裝、Claude Code/Codex/Cursor 設定

Playwright MCP 是什麼、怎麼安裝與接入 AI 工作流程?整理三個實際用途、可複製指令、版本實測、常見錯誤修正、限制費用及替代工具。

Playwright MCP 讓支援 MCP 的 AI 工具透過瀏覽器快照讀取網頁、點擊與填表,適合網站測試及重複網頁任務;它需要瀏覽器環境,並不會讓每次自動操作都保證成功。

安裝與執行環境

工具版本 0.0.85;官方文件查閱日 2026-11-16。套件版本與官方文件快照分別固定,不把文件 commit 宣稱為套件發行 commit。

node --version
npx -y @playwright/mcp@0.0.85 --help

以下依官方 stdio 設定格式整理,未在三個客戶端內本地實測。工具版本:0.0.85;客戶端文件查閱日:2026-11-16(滾動文件,不宣稱固定客戶端版本)。

Claude Code

claude mcp add --transport stdio playwright-mcp -- npx -y @playwright/mcp@0.0.85
claude mcp get playwright-mcp

進入 Claude Code 的 /mcp,確認連線狀態與工具清單。

Claude Code 官方 MCP 設定

Codex

codex mcp add playwright-mcp -- npx -y @playwright/mcp@0.0.85
codex mcp list

開啟新工作階段,先確認 server 工具可見再操作。

Codex 官方 MCP 設定

Cursor

將以下內容合併到專案 .cursor/mcp.json,保留其他既有設定;在 Cursor 的 MCP 設定啟用並確認工具清單。

{
  "mcpServers": {
    "playwright-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@playwright/mcp@0.0.85"
      ]
    }
  }
}

Cursor 官方 MCP 設定

Windows 若客戶端無法啟動 npx,依官方範例把 command 改為 cmd,args 最前方加 /c、npx,其後保留原參數;CLI 的啟動部分相應改成 -- cmd /c npx -y 加上原固定版套件。先排查啟動方式,不要同時換版本。

三個實際用途

1. 先讀網頁再摘要

開啟 https://example.com/,取得最新瀏覽器快照,回報頁面標題、主要標題與可見連結。只讀取,不登入或送出表單。

預期結果:應看到來自實際快照的標題與連結。

2. 驗證站內導覽

在我的本機測試網站,先取得快照,再點「文件」連結;回報點擊後的 URL、標題與文件主標題。每次換頁後重新取得快照。

預期結果:應確認目的網址與內容都正確,而非只有點擊工具成功。

3. 檢查表單錯誤

只在本機測試表單操作:留空必填欄位並送出,記錄畫面上的錯誤訊息,再填入測試資料重試;不要操作正式帳戶。

預期結果:應得到可見錯誤與修正後結果。

實測發現:哪些已確認,哪些還沒測

既有 0.0.85 隔離測試讀到五列資料,點擊指定連結後再核對目的 URL、標題與內容;無效 ref 與錯誤參數均有失敗回應。這證明該測試頁的操作可用,沒有驗證任意網站、登入流程或三個客戶端的實際整合。

測試由 Codex 以合成資料執行,不宣稱站長親測或審稿。上方新增操作若未落在上述範圍,均為依官方文件整理、未本地實測。

常見錯誤與解法

ref 失效或找不到元素

換頁或動態更新後先取新快照,再使用新 ref,不重試舊 ref。

工具參數驗證失敗

0.0.85 實測的點擊工具使用 target;以客戶端顯示的 schema 為準,不套舊版 element/ref 參數。

瀏覽器無法啟動

查看官方瀏覽器安裝指引與 --help,確認使用者可啟動 Chromium;Linux 補齊系統函式庫,無畫面環境選 headless。

限制、費用與授權

Apache-2.0。套件本身不另收使用費,AI 客戶端或模型方案可能計費。網站的登入、驗證碼、服務條款與動態版面仍會限制操作;重複回歸測試應考慮直接寫 Playwright 測試。

何時改用其他工具

  • 需要大量擷取正文而非互動操作:Crawl4AI。

  • 只需靜態 HTML 正文:Trafilatura。

常見問答

Claude Code 怎麼接 Playwright MCP?

使用下方 stdio 指令,重開工作階段並在 /mcp 確認連線,再要求一次快照。

它是瀏覽器還是 MCP server?

它是提供瀏覽器操作工具的 MCP server;瀏覽器由伺服器啟動或依設定連接。

需要 Claude 才能用嗎?

不需要;也可用支援相應 MCP transport 的 Codex、Cursor 等客戶端。

官方來源

若任務重點是擷取內容,可比較 Crawl4AI 的網頁擷取;只要文章正文時,可先看 Trafilatura 的正文抽取,再決定是否需要瀏覽器互動。

訂閱 AI 工具精選與使用建議

有值得推薦的新工具、實測發現或重要更新時,寄到你的信箱。

訂閱後先寄給你一份每月更新的 AI 工具與 Skill 清單。有值得推薦的工具、實測發現或重要更新時才寄信,隨時可以退訂。隱私權說明

快完成了,請到信箱收確認信點信裡的按鈕確認訂閱,就會收到工具清單的下載連結。沒看到的話,看一下垃圾郵件或「促銷內容」分頁。

也可以在這些平台追蹤: