Tabbit部落格

Playwright MCP 入門:安裝、操作和驗證

註冊固定版本的 Playwright MCP,在本機練習頁執行任務,再從新快照確認結果。

本文目錄
  1. 請求如何從 Agent 到網頁
  2. 固定版本並註冊服務
  3. 開啟練習頁並讀初始狀態
  4. 只點一次,再讀新結果
  5. 真實任務前選瀏覽器模式
  6. 實測與社群回報的範圍
  7. 看到 Playwright 工具就代表瀏覽器可用嗎?

Playwright MCP 向相容的 Agent 用戶端提供瀏覽器工具。設定成功需要三步驗證:用戶端找到工具、服務開啟預期瀏覽器、網頁在操作後回傳預期狀態。先在本機模擬頁走完三步,再用到會修改真實資料的網站。

請求如何從 Agent 到網頁

Agent 請 MCP 用戶端呼叫工具。使用 stdio 時,用戶端把 JSON-RPC 訊息送給 Playwright MCP 程序。Playwright 驅動設定的瀏覽器並回傳回執,可包含網址、無障礙快照和操作資訊。工具探索只代表用戶端和服務可通訊,還沒證明瀏覽器能啟動或動作成功。

Microsoft · Playwright MCP

固定版本並註冊服務

在用戶端 MCP 設定加入本機 stdio 服務。本例固定 @playwright/mcp 0.0.84,指向 macOS 上既有的 Tabbit Browser Dev 執行檔。請使用自己的可用路徑。自訂執行檔是獨立的執行選擇。移除參數後會使用設定中的預設瀏覽器。測試為 Node.js 22.23.1,MCP 交握回報 Playwright 1.65.0-alpha-2026-10-30。儲存後依需要重新載入用戶端。

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": [
        "-y",
        "@playwright/mcp@0.0.84",
        "--executable-path",
        "/Applications/Tabbit Browser Dev.app/Contents/MacOS/Tabbit Browser Dev",
        "--isolated",
        "--headless",
        "--viewport-size",
        "1000x565"
      ]
    }
  }
}

Playwright MCP · Configuration

開啟練習頁並讀初始狀態

將練習 HTML 下載到獨立空目錄,用迴路位址提供。請 Agent 開啟正確網址並查看快照。預期標記為 F01-FIXTURE,初始為 State: OFF。在目前快照找 Enable demo 按鈕的引用。我們看到 e5,你的編號可能不同。

下載練習 HTML

python3 -m http.server 8765 --bind 127.0.0.1

http://127.0.0.1:8765/fixture.html

只點一次,再讀新結果

點擊該引用後取得新快照。本次回傳 State: ON、相同標記和停用的 Demo enabled 按鈕。這些都是頁面狀態斷言。即使工具說已點擊,也要確認頁面有變化。引用過期就重新觀察再選,避免跨頁重用或隨意再點一次。

步驟工具預期結果
1browser_navigate + browser_snapshotF01-FIXTURE · State: OFF
2browser_click · target: e5Demo enabled
3browser_snapshotF01-FIXTURE · State: ON

Tabbit 截圖顯示 State: ON 和 F01-FIXTURE

Playwright MCP · Snapshots

真實任務前選瀏覽器模式

本次隔離模式從空白工作階段啟動,不讀取既有登入設定檔。有介面模式可看過程,無介面模式適合無人值守測試。授權測試要保留登入時,可用專用持久設定檔。官方擴充功能可連相容的既有瀏覽器,CDP 可連獲准的端點。先確認設定檔、可存取範圍和程序生命週期。

模式用途
--isolated空白工作階段
Headed人工檢視
Extension / CDP既有工作階段

Playwright MCP · Extension

實測與社群回報的範圍

真實 stdio 用戶端初始化、列出工具、導覽、擷取快照、點 e5、讀取新快照、存圖並關閉隔離 Tabbit。頁面沒有帳號、真實提交或模型參與。r/Playwright 有使用者回報依位置選同名按鈕容易錯,r/mcp 有公開工具作者回報大快照占用上下文。兩者都支持縮小範圍並核對結果,不能用來替工具排名。

r/Playwright r/mcp

看到 Playwright 工具就代表瀏覽器可用嗎?

工具探索只驗證註冊。開啟預期頁面並核對可見標記,再用操作回執確認瀏覽器路徑。

常見問題

看到 Playwright 工具就代表瀏覽器可用嗎?

工具探索只驗證註冊。開啟預期頁面並核對可見標記,再用操作回執確認瀏覽器路徑。

Playwright MCP 如何運作?

Agent 請 MCP 用戶端呼叫工具。使用 stdio 時,用戶端把 JSON-RPC 訊息送給 Playwright MCP 程序。Playwright 驅動設定的瀏覽器並回傳回執,可包含網址、無障礙快照和操作資訊。工具探索只代表用戶端和服務可通訊,還沒證明瀏覽器能啟動或動作成功。

如何註冊固定版本?

在用戶端 MCP 設定加入本機 stdio 服務。本例固定 @playwright/mcp 0.0.84,指向 macOS 上既有的 Tabbit Browser Dev 執行檔。請使用自己的可用路徑。自訂執行檔是獨立的執行選擇。移除參數後會使用設定中的預設瀏覽器。測試為 Node.js 22.23.1,MCP 交握回報 Playwright 1.65.0-alpha-2026-10-30。儲存後依需要重新載入用戶端。

快照引用失效怎麼辦?

點擊該引用後取得新快照。本次回傳 State: ON、相同標記和停用的 Demo enabled 按鈕。這些都是頁面狀態斷言。即使工具說已點擊,也要確認頁面有變化。引用過期就重新觀察再選,避免跨頁重用或隨意再點一次。

應該選哪個瀏覽器模式?

本次隔離模式從空白工作階段啟動,不讀取既有登入設定檔。有介面模式可看過程,無介面模式適合無人值守測試。授權測試要保留登入時,可用專用持久設定檔。官方擴充功能可連相容的既有瀏覽器,CDP 可連獲准的端點。先確認設定檔、可存取範圍和程序生命週期。

下一步

讓 Tabbit 與你並肩工作。

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