Playwright MCP: cho AI tự điều khiển trình duyệt web — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về microsoft/playwright-mcp — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: microsoft/playwright-mcp: tự động hoá trình duyệt bằng AI — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
Playwright MCP là một máy chủ MCP do Microsoft phát triển, cho phép trợ lý AI điều khiển trình duyệt (mở trang, bấm, gõ, đọc nội dung) thông qua Playwright. Nó đọc trang bằng cây truy cập (accessibility tree) thay vì ảnh chụp. Cài khá dễ: cần Node.js 18 trở lên và thêm một đoạn cấu hình vào phần mềm AI của bạn.
Playwright MCP là một máy chủ MCP (Model Context Protocol) của Microsoft, cho phép trợ lý AI điều khiển trình duyệt web như người thật: mở trang, bấm nút, điền form, đọc nội dung. Nó chạy trên Playwright, bộ công cụ tự động hoá trình duyệt khá quen thuộc với dân lập trình.
Điểm khác biệt là cách AI "nhìn" trang web. Thay vì chụp ảnh màn hình rồi nhờ mô hình thị giác đoán chỗ cần bấm, Playwright MCP đưa cho AI một bản mô tả có cấu trúc của trang (accessibility snapshot). Nhờ vậy AI không cần mô hình xem ảnh, và thao tác ít bị nhầm hơn.
Bạn nên đọc bài này nếu đang dùng một công cụ AI hỗ trợ MCP (VS Code, Cursor, Windsurf, Claude Desktop, Claude Code, Codex…) và muốn AI tự làm việc trên web. Hiện repo có khoảng 39.570 sao và 3.427 fork, giấy phép Apache-2.0, và vẫn được cập nhật trong 3 tháng gần đây.
microsoft/playwright-mcp
Máy chủ MCP của Microsoft giúp AI mở trang web, bấm nút, điền form qua Playwright mà không cần xem ảnh chụp màn hình.
I.Playwright MCP làm được gì
A.Điều khiển trình duyệt bằng dữ liệu có cấu trúc
Theo README, repo dùng cây truy cập của Playwright chứ không dùng đầu vào dạng điểm ảnh. Lợi ích thực tế: AI nhận một danh sách các phần tử trên trang (nút, ô nhập, liên kết) và thao tác đúng phần tử đó. Cách này nhanh, nhẹ, và tránh sự mơ hồ thường gặp khi dựa vào ảnh chụp.
B.Không cần mô hình xem ảnh
Máy chủ chỉ làm việc với dữ liệu có cấu trúc, nên mô hình ngôn ngữ thường là đủ. Nếu bạn vẫn cần khả năng nhìn ảnh, README có tuỳ chọn --caps để bật thêm các khả năng như vision, pdf, devtools.
C.Chọn trình duyệt và giả lập thiết bị
Bạn có thể chọn trình duyệt bằng --browser (chrome, firefox, webkit, msedge). Có thể giả lập thiết bị bằng --device (ví dụ "iPhone 15") hoặc --mobile. README ghi chú trang bản di động thường nhẹ hơn nên tiết kiệm token.
D.Chạy ẩn hoặc chạy có cửa sổ
Mặc định trình duyệt hiện cửa sổ để bạn xem AI làm gì. Thêm --headless nếu muốn chạy ẩn. Có thêm --isolated để giữ hồ sơ trình duyệt trong bộ nhớ, không lưu xuống đĩa.
E.Kết nối vào trình duyệt đang mở
Với Edge hoặc Chrome, tuỳ chọn --extension cho phép nối vào một trình duyệt đang chạy. Cách này cần cài thêm "Playwright Extension". Ngoài ra còn có --cdp-endpoint để nối qua CDP.
F.Giới hạn quyền truy cập
Mặc định, truy cập tệp bị giới hạn trong thư mục làm việc và việc mở địa chỉ file:// bị chặn. Bạn có thể nới ra bằng --allow-unrestricted-file-access, nhưng chỉ nên làm khi hiểu rõ rủi ro.
G.Sinh mã kiểm thử
Tuỳ chọn --codegen cho phép chọn ngôn ngữ sinh mã: typescript (mặc định), python, java, csharp hoặc none.
II.Cần chuẩn bị gì
Theo tư liệu, bạn cần:
- Node.js 18 trở lên (package.json cũng yêu cầu Node >=18).
- Một phần mềm khách MCP, ví dụ VS Code, Cursor, Windsurf, Claude Desktop, Goose, Grok, Junie hoặc công cụ khác hỗ trợ MCP.
README không nói cần API key riêng cho Playwright MCP, cũng không nói cần GPU. Tuy nhiên phần mềm AI bạn dùng có thể có tài khoản và chi phí riêng, cái đó tuỳ từng công cụ.
Để kiểm tra Node.js, mở terminal (PowerShell trên Windows, Terminal trên macOS) và gõ:
node --versionNếu số hiện ra nhỏ hơn 18, bạn cần cập nhật Node.js trước.
III.Cài đặt từng bước
- Kiểm tra Node.jsChắc chắn máy có Node.js 18 trở lên
- Chọn phần mềm AIXác định bạn dùng Claude Code, VS Code, Cursor, Codex…
- Thêm máy chủ MCPDán cấu hình chuẩn hoặc chạy lệnh thêm MCP của công cụ đó
- Khởi động lại công cụĐể phần mềm nạp máy chủ playwright
- Tuỳ chỉnhThêm cờ như --headless nếu cần
A.Kiểm tra Node.js
Chạy lại lệnh dưới đây. Kết quả phải là phiên bản 18 trở lên.
node --versionB.Thêm vào công cụ AI của bạn
README gọi đây là "standard config" (cấu hình chuẩn), dùng được với hầu hết công cụ. Bạn dán đoạn này vào tệp cấu hình MCP của phần mềm. Lệnh npx sẽ tự tải và chạy gói @playwright/mcp mỗi khi cần, bạn không phải cài riêng.
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": [
"@playwright/mcp@latest"
]
}
}
}Chỗ người mới hay vấp: mỗi phần mềm lưu tệp cấu hình ở một nơi khác nhau. Nếu không biết tệp nằm đâu, hãy dùng cách bên dưới theo đúng công cụ của bạn.
C.Nếu bạn dùng Claude Code
Mở terminal bất kỳ và chạy lệnh sau. Lệnh này đăng ký máy chủ tên playwright chạy bằng npx.
claude mcp add playwright npx @playwright/mcp@latestD.Nếu bạn dùng Codex
Dùng lệnh của Codex CLI:
codex mcp add playwright npx "@playwright/mcp@latest"Hoặc sửa tệp ~/.codex/config.toml, thêm đoạn:
[mcp_servers.playwright]
command = "npx"
args = ["@playwright/mcp@latest"]E.Nếu bạn dùng VS Code
README có nút cài nhanh, hoặc bạn làm theo hướng dẫn MCP của VS Code với cấu hình chuẩn ở trên. Có thể dùng dòng lệnh của VS Code:
# For VS Code
code --add-mcp '{"name":"playwright","command":"npx","args":["@playwright/mcp@latest"]}'Sau đó máy chủ sẽ dùng được với agent GitHub Copilot trong VS Code.
F.Nếu bạn dùng Cursor, Claude Desktop, Windsurf hoặc công cụ khác
Với Cursor, README hướng dẫn vào Cursor Settings -> MCP -> Add new MCP Server, chọn kiểu command và nhập npx @playwright/mcp@latest. Với Claude Desktop và Windsurf, README bảo làm theo hướng dẫn MCP của họ và dùng cấu hình chuẩn ở trên. Các công cụ còn lại (Amp, Cline, Copilot, Factory, Gemini CLI, Goose, Grok, Junie, Kiro, LM Studio, opencode, Qodo Gen, Warp) đều có hướng dẫn riêng trong README của repo.
G.Thêm tuỳ chọn khi cần
Các cờ như --headless được đặt trong danh sách args. Ví dụ chạy ẩn trình duyệt:
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": [
"@playwright/mcp@latest",
"--headless"
]
}
}
}Mỗi cờ trong README cũng có biến môi trường tương ứng, ví dụ PLAYWRIGHT_MCP_BROWSER. Danh sách đầy đủ nằm trong phần Configuration của README. Phần README mình có chỉ dừng giữa chừng, nên hãy mở README gốc trong repo để xem đủ các tuỳ chọn.
IV.Kiểm tra đã chạy được chưa
README không ghi một lệnh kiểm tra riêng. Cách đơn giản nhất là thử trực tiếp:
- Khởi động lại phần mềm AI của bạn.
- Mở danh sách MCP / công cụ của phần mềm (thường nằm trong phần cài đặt MCP) và xem có mục
playwrightkhông. - Gõ yêu cầu thử, ví dụ: "Dùng trình duyệt mở trang example.com và cho mình biết tiêu đề trang".
Nếu một cửa sổ trình duyệt bật lên (khi không dùng --headless) và AI trả lời đúng nội dung trang, bạn đã cài thành công. Lần đầu có thể hơi chậm vì npx cần tải gói về.
V.Dùng vào việc thật
Các tình huống dưới đây bám theo khả năng điều khiển trình duyệt của repo. Câu lệnh mẫu chỉ là gợi ý, bạn đổi nội dung cho hợp việc của mình.
A.Chủ shop theo dõi giá đối thủ
Bạn bán hàng online và muốn biết đối thủ đang bán một mặt hàng giá bao nhiêu. Thay vì mở từng trang, bạn nhờ AI làm.
Dùng trình duyệt mở trang sản phẩm này: <địa chỉ trang>.
Đọc tên sản phẩm, giá hiện tại và tình trạng còn hàng, rồi lập thành bảng.Kết quả: AI mở trang, đọc cấu trúc trang và trả về bảng gọn. Bạn chỉ cần dán thêm địa chỉ các trang khác để so sánh. Lưu ý một số trang có thể hạn chế truy cập tự động, hãy tôn trọng điều khoản của trang đó.
B.Nhân viên văn phòng điền biểu mẫu lặp đi lặp lại
Bạn phải nhập cùng một kiểu thông tin vào một cổng web nội bộ hoặc form nhiều lần mỗi tuần.
Mở trang form này, điền các ô theo dữ liệu mình đưa bên dưới,
nhưng DỪNG lại trước khi bấm nút Gửi để mình kiểm tra.Kết quả: AI điền từng ô, bạn xem lại rồi tự bấm gửi. Cách dặn "dừng trước khi gửi" giúp bạn giữ quyền quyết định ở bước quan trọng.
Cho AI đọc cấu trúc trang thay vì nhìn ảnh, nên nó bấm đúng chỗ hơn và đỡ phải đoán.
Ông T
C.Lập trình viên kiểm thử giao diện trên điện thoại
Bạn vừa sửa giao diện website và muốn xem nó hiển thị thế nào trên điện thoại. Cấu hình máy chủ với --device:
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": [
"@playwright/mcp@latest",
"--device",
"iPhone 15"
]
}
}
}Rồi nhờ AI: "Mở trang http://localhost:3000, thử đăng nhập và cho mình biết có lỗi nào hiện trên console không". README có tuỳ chọn --console-level để chọn mức thông điệp console được trả về. Kết quả: AI chạy qua các bước và báo lại những gì nó thấy, giúp bạn phát hiện lỗi sớm.
D.Dev sinh mã kiểm thử tự động
Nếu bạn viết kiểm thử bằng Playwright, có thể nhờ AI thao tác thử trên trang rồi tạo mã. Tuỳ chọn --codegen cho phép chọn ngôn ngữ, mặc định là TypeScript. Ví dụ đặt Python:
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": [
"@playwright/mcp@latest",
"--codegen",
"python"
]
}
}
}Kết quả: bạn có bản nháp mã để chỉnh lại, đỡ phải gõ từ đầu. Hãy đọc lại mã trước khi đưa vào dự án.
VI.Lỗi hay gặp và cách xử lý
A.Báo lỗi không tìm thấy npx hoặc lệnh không chạy
Thường do chưa cài Node.js hoặc phiên bản thấp hơn 18. Chạy node --version để kiểm tra, cài hoặc cập nhật Node.js rồi khởi động lại phần mềm AI.
B.Dán cấu hình xong mà không thấy máy chủ playwright
Có thể bạn dán nhầm tệp, hoặc JSON bị thiếu dấu ngoặc / dấu phẩy. Kiểm tra lại cú pháp JSON và khởi động lại công cụ. Nếu vẫn không được, thử dùng lệnh thêm MCP của chính công cụ đó (ví dụ claude mcp add cho Claude Code) thay vì sửa tệp tay.
C.Phần mềm mở trình duyệt chậm hoặc hết thời gian chờ ở lần đầu
Lần đầu npx phải tải gói, có thể lâu. Một số công cụ có ô thiết lập thời gian chờ, như ví dụ Cline trong README có "timeout": 30. Hãy thử lại sau khi tải xong.
D.AI không đọc được tệp trên máy hoặc không mở được địa chỉ file://
Đây là hành vi mặc định có chủ ý: truy cập tệp bị giới hạn trong thư mục làm việc, còn file:// bị chặn. Cách an toàn là đặt tệp cần dùng vào thư mục làm việc. Chỉ bật --allow-unrestricted-file-access khi bạn thật sự hiểu và tin tưởng nội dung AI sẽ xử lý.
E.Lỗi chứng chỉ HTTPS khi thử trang nội bộ
Trang thử nghiệm thường dùng chứng chỉ tự ký. README có cờ --ignore-https-errors để bỏ qua lỗi này. Chỉ nên bật khi thử trên trang của chính bạn, đừng dùng khi duyệt web thông thường.
AI điều khiển trình duyệt có thể đăng nhập, bấm nút và gửi dữ liệu thay bạn. Đừng giao tài khoản ngân hàng hoặc việc không thể hoàn tác cho AI tự làm. Hãy dặn nó dừng trước bước xác nhận cuối. Cờ --allowed-origins và --blocked-origins, theo chính README, không phải là ranh giới bảo mật, nên đừng coi chúng là lớp bảo vệ duy nhất.
VII.Có nên dùng không
Điểm mạnh: cài đơn giản (một đoạn cấu hình, chạy qua npx), tương thích nhiều công cụ AI, do Microsoft phát triển, giấy phép Apache-2.0 và vẫn được cập nhật. Cách đọc trang bằng cây truy cập giúp thao tác rõ ràng, không phụ thuộc mô hình xem ảnh.
Giới hạn: chính README thừa nhận nếu bạn dùng coding agent, cách CLI kết hợp SKILLS (repo microsoft/playwright-cli) tiết kiệm token hơn, vì không phải nạp sơ đồ công cụ lớn và cây truy cập dài vào ngữ cảnh của mô hình. Playwright MCP phù hợp hơn với các vòng lặp cần giữ trạng thái trình duyệt liên tục, như khám phá tự động, kiểm thử tự sửa, hoặc quy trình tự chủ chạy lâu.
Khi nào chọn cách khác: nếu bạn là lập trình viên dùng coding agent và rất để ý giới hạn ngữ cảnh, hãy xem Playwright CLI. Nếu việc của bạn chỉ là lấy dữ liệu từ một trang đơn giản, một script nhỏ có thể gọn hơn. Còn nếu bạn muốn AI tự thao tác web theo từng bước và bạn giám sát được, Playwright MCP là lựa chọn đáng thử.
Câu hỏi thường gặp
Playwright MCP có miễn phí không?
Repo dùng giấy phép Apache-2.0 và bạn chạy qua npx, README không nói có phí riêng cho máy chủ này. Tuy nhiên công cụ AI bạn dùng cùng với nó có thể có chi phí riêng, tuỳ từng nhà cung cấp.
Có cần GPU hoặc mô hình xem ảnh không?
Không. README nói máy chủ hoạt động hoàn toàn trên dữ liệu có cấu trúc (accessibility snapshot), không cần mô hình thị giác. README không đề cập yêu cầu GPU.
Chạy được trên Windows không?
README chỉ nêu yêu cầu Node.js 18 trở lên và một phần mềm khách MCP, không giới hạn hệ điều hành. Vì vậy chỉ cần có Node.js và công cụ MCP tương thích. Tư liệu chưa nói rõ từng hệ điều hành cụ thể.
Phải cài gì ngoài Node.js?
Bạn cần một phần mềm khách MCP như VS Code, Cursor, Windsurf, Claude Desktop, Goose, Grok, Junie. Máy chủ được tải và chạy bằng npx với gói @playwright/mcp. Riêng chế độ --extension cần thêm Playwright Extension.
Dữ liệu và tệp trên máy mình có an toàn không?
Mặc định truy cập tệp chỉ giới hạn trong thư mục làm việc và địa chỉ file:// bị chặn. Bạn nên cẩn trọng với các cờ nới quyền, và theo README thì --allowed-origins và --blocked-origins không phải ranh giới bảo mật. Các chi tiết khác về dữ liệu, tư liệu chưa nêu.
Playwright MCP khác Playwright CLI thế nào?
Theo README, CLI kết hợp SKILLS tiết kiệm token hơn nên hợp với coding agent. MCP phù hợp các vòng lặp cần giữ trạng thái trình duyệt liên tục và khả năng quan sát sâu, như khám phá tự động hoặc kiểm thử tự sửa.
Có dùng được với trình duyệt khác ngoài Chrome không?
Có. Cờ --browser hỗ trợ chrome, firefox, webkit và msedge. Chế độ --extension để nối vào trình duyệt đang chạy chỉ dành cho Edge hoặc Chrome.


