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,確認連線狀態與工具清單。
Codex
codex mcp add playwright-mcp -- npx -y @playwright/mcp@0.0.85
codex mcp list
開啟新工作階段,先確認 server 工具可見再操作。
Cursor
將以下內容合併到專案 .cursor/mcp.json,保留其他既有設定;在 Cursor 的 MCP 設定啟用並確認工具清單。
{
"mcpServers": {
"playwright-mcp": {
"command": "npx",
"args": [
"-y",
"@playwright/mcp@0.0.85"
]
}
}
}
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 的正文抽取,再決定是否需要瀏覽器互動。