Playwright MCP：在用戶端裡完成第一次瀏覽器導覽

適合誰

這份指南面向已經在使用 MCP 用戶端、並準備在本機拉起瀏覽器來完成頁面自動化的人。你要判斷的是應不應該現在就把 Playwright MCP 接到目前的用戶端，而不是先把它當成長篇介紹來讀。最硬的前提是本機 Node.js 為 18 或更新；版本不夠就不要繼續寫設定。倉庫說明它是一個提供瀏覽器自動化能力的 MCP 伺服器，並且走無障礙快照，而不是靠截圖理解頁面。你必須能接受兩件事：本機會出現瀏覽器相關行程，以及會對你指定的位址發起真實造訪。如果你只想瀏覽倉庫、不打算讓用戶端執行任何瀏覽器動作，這條路徑不適合。證據沒有寫適用產業、崗位或團隊規模，這裡也不補充想像中的使用者畫像。

3 分鐘完成第一次嘗試

只使用官方標準 MCP 設定這一條路徑。打開你目前正在用的 MCP 用戶端自己的伺服器設定位置——證據沒有給出具體檔名，所以按該用戶端的 MCP 設定入口打開即可——新增名為 playwright 的服務，命令為 npx，參數為 @playwright/mcp@latest。不要再並列第二條主安裝方式。

先確認本機已滿足 Node.js 18 或更新，再把下面這段 JSON 原樣寫入設定，保持位元組一致，不要改鍵名、不要改空白：

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest"]
    }
  }
}

儲存後重啟或重載該用戶端。成功訊號是工具清單裡出現 browser_navigate 和 browser_navigate_back 這兩個名字；名字露出來才算接通，不要把瀏覽器視窗是否跳出、頁面是否開啟當成安裝完成。

接通之後只做一次試探性呼叫：使用 browser_navigate。證據只記錄了工具名，沒有參數表、沒有範例網址、也沒有還原路徑，因此填寫內容只能以用戶端當時展示的工具說明為準，不要自行發明參數或端點。這次呼叫會讓本機瀏覽器造訪你給出的位址，產生網路請求和頁面載入，並在本機留下瀏覽器相關行程；它不是唯讀操作，也不是零風險。呼叫前必須確認位址由你本人指定、且該位址可以接受被造訪；呼叫後以這次呼叫是否返回作為確認點。如果接著使用 browser_navigate_back，同樣會改變瀏覽器目前頁，同樣可能再次產生網路請求，呼叫前先確認目前工作階段裡已經有可以回退的瀏覽紀錄。

使用案例

案例一：用 browser_navigate 開啟一個你明確指定的頁面。時機是兩個工具名已經出現，並且你手裡有一個可以接受被造訪的位址。證據能夠對應到的只有這個工具名，沒有示範 URL，也沒有寫出參數欄位。副作用是真實導覽和網路存取；呼叫前再次核對位址，呼叫後看這次呼叫是否結束。不要把它理解成本地離線預覽，也不要假設不會讀取頁面內容。

案例二：用 browser_navigate_back 回到上一頁。時機是同一次瀏覽工作階段裡剛剛完成過導覽。證據同樣只給出這個工具名，沒有歷史清單介面，也沒有還原或 undo 路徑。如果還沒有成功的前向導覽，回退可能失敗，或落到你並不預期的頁面，證據沒有描述失敗後的狀態。該呼叫同樣會改變目前頁，並可能再次請求網路；呼叫前確認你確實已經導覽過，確認點仍然是這次呼叫是否返回。

使用邊界

執行下限是 Node.js 18 或更新，低版本不要硬跑。能力停在瀏覽器自動化，並且說明使用無障礙快照而不是截圖；證據沒有出現截圖類工具，也沒有關閉瀏覽器、清理工作階段、解除安裝或 undo 命令。不要假設無網路、無本機讀取或沒有隱私邊界：一旦導覽，目標站會被造訪，頁面內容可能進入用戶端脈絡，本機也會出現瀏覽器行程。第一次嘗試失敗時，先核對 Node 版本以及 JSON 是否與官方片段位元組一致，再看兩個工具名有沒有出現；不要改用證據中沒有出現的安裝方式。未在證據裡點名的能力不要當成已支援。