microsoft/playwright-mcp: tự động hoá trình duyệt bằng AI — 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
microsoft/playwright-mcp là MCP server đưa khả năng tự động hoá trình duyệt Playwright vào các ứng dụng AI như VS Code, Cursor, Claude Desktop và Codex. Bạn cần Node.js 18 trở lên cùng một MCP client; cách cài chủ yếu là thêm cấu hình dùng npx nên khá đơn giản.
microsoft/playwright-mcp là MCP server giúp các ứng dụng AI điều khiển trình duyệt bằng Playwright. AI có thể đọc cấu trúc trang, mở trang web và thực hiện các thao tác theo dữ liệu có cấu trúc thay vì dựa vào ảnh chụp màn hình.
Repo này phù hợp với người muốn cho AI làm việc với website, kiểm thử giao diện, khám phá luồng thao tác hoặc tự động hoá các tác vụ lặp lại trong trình duyệt. Điểm đáng giá nhất là server dùng accessibility tree nên không bắt buộc dùng mô hình có khả năng nhìn ảnh. Cách tương tác này nhẹ, rõ ràng và ít phụ thuộc vào vị trí pixel trên màn hình.
Dự án dùng TypeScript, có gói npm @playwright/mcp, giấy phép Apache-2.0 và hiện có khoảng 39.591 sao cùng 3.431 fork. README cũng phân biệt rõ MCP với Playwright CLI: 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, đọc sâu cấu trúc trang và suy luận nhiều bước.
microsoft/playwright-mcp
MCP server giúp AI điều khiển trình duyệt bằng Playwright qua cây accessibility, không cần mô hình nhìn ảnh.
I.Playwright MCP làm được gì
Cho AI điều khiển trình duyệt qua MCP. Server cung cấp giao diện để MCP client kết nối với Playwright. Vì vậy, bạn có thể dùng AI trong môi trường quen thuộc như VS Code, Cursor, Claude Desktop, Codex hoặc các client được README liệt kê.
Đọc trang bằng accessibility tree. Thay vì gửi toàn bộ ảnh màn hình cho mô hình, server cung cấp cấu trúc có ý nghĩa như nút, ô nhập, liên kết và nội dung trang. Điều này giúp AI tìm đúng phần tử ổn định hơn trong các thao tác web thông thường.
Không bắt buộc mô hình vision. README nêu rõ Playwright MCP hoạt động thuần trên dữ liệu có cấu trúc. Bạn không cần một mô hình chuyên xử lý ảnh chỉ để AI nhận biết nút hoặc biểu mẫu trên trang.
Giảm sự mơ hồ khi thao tác. Cách làm dựa trên phần tử và cấu trúc accessibility giúp tránh một số lỗi thường gặp của tự động hoá bằng ảnh, chẳng hạn nhấp lệch vì cửa sổ thay đổi kích thước hoặc giao diện đổi vị trí.
Hỗ trợ nhiều trình duyệt và chế độ chạy. Phần cấu hình có các tuỳ chọn chọn Chrome, Firefox, WebKit hoặc Microsoft Edge, chạy có giao diện hoặc headless, mô phỏng thiết bị di động, dùng hồ sơ riêng và kết nối đến endpoint/CDP khi cần.
Giới hạn nơi trình duyệt được phép truy cập. Server có tuỳ chọn allowlist, blocklist origin và giới hạn host. Đây là những thiết lập quan trọng khi bạn cho AI truy cập website thật hoặc chạy trong môi trường dùng chung.
Mở rộng khả năng khi cần. Có thể bật các capability như
vision,pdfhoặcdevtoolsbằng tuỳ chọn--caps. README cũng có các tuỳ chọn cho console message, quyền trình duyệt, thư mục đầu ra và thời gian tự đóng trình duyệt.Giữ trạng thái cho các vòng lặp dài. README mô tả MCP phù hợp với các quy trình cần persistent state, introspection phong phú và suy luận lặp lại trên cấu trúc trang. Đây là điểm hữu ích khi một tác vụ không chỉ gồm mở trang rồi bấm một nút.
II.Cần chuẩn bị gì
Bạn cần Node.js phiên bản 18 trở lên. Đây là yêu cầu được ghi trong README và cũng tương ứng với yêu cầu Node >=18 trong package.json.
Bạn cần một MCP client để sử dụng server. README liệt kê VS Code, Cursor, Windsurf, Claude Desktop, Goose, Grok, Junie và nhiều client khác. Trong bài này, các ví dụ tập trung vào cấu hình chung, Codex, Claude Code, Cursor và VS Code.
README không nói rằng bạn phải có tài khoản riêng, API key, GPU hay trình duyệt đã cài sẵn. README cũng không nêu hệ điều hành cụ thể. Vì vậy, nếu bạn cần biết một client cụ thể có chạy được trên hệ điều hành của mình hay không, hãy kiểm tra tài liệu của chính client đó.
Nếu dùng cấu hình chuẩn, client sẽ chạy gói npm bằng npx:
Server có thể điều khiển trình duyệt và truy cập các trang bạn cho phép. Không nên cấp quyền rộng hơn nhu cầu. Đặc biệt, hãy cân nhắc kỹ các tuỳ chọn cho phép truy cập file hoặc bind server ra mọi giao diện mạng.
III.Cài đặt từng bước
- Kiểm tra Node.jsĐảm bảo máy có Node.js 18 trở lên
- Chọn MCP clientDùng VS Code, Cursor, Codex, Claude Code hoặc client tương thích
- Thêm cấu hìnhKhai báo lệnh npx chạy @playwright/mcp@latest
- Khởi động lại clientĐể client nạp MCP server mới
- Kiểm tra công cụGửi yêu cầu để AI mở và đọc một trang web
A.Kiểm tra Node.js trước
Mở Terminal, PowerShell hoặc cửa sổ dòng lệnh của hệ điều hành. Kiểm tra phiên bản Node.js bằng lệnh sau:
node --versionKết quả cần là Node.js 18 hoặc mới hơn. Nếu lệnh không tồn tại hoặc phiên bản thấp hơn, bạn chưa đáp ứng yêu cầu trong README. Hãy cài hoặc nâng cấp Node.js trước khi cấu hình MCP client.
Bạn không cần clone repo để dùng cách cài đặt chuẩn trong README. npx sẽ chạy gói @playwright/mcp@latest theo cấu hình của client.
B.Thêm cấu hình chuẩn
README đưa ra cấu hình dùng được trong phần lớn MCP client:
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": [
"@playwright/mcp@latest"
]
}
}
}playwright là tên server trong client. command yêu cầu client gọi npx. Phần args chỉ ra gói npm cần chạy. Khi copy cấu hình, cần giữ đúng dấu ngoặc, dấu phẩy và tên gói.
README không yêu cầu điền API key vào cấu hình này. Nếu client của bạn có màn hình thêm MCP server, hãy nhập cùng lệnh npx @playwright/mcp@latest theo cách client hướng dẫn.
C.Cài trong Codex
Nếu dùng Codex CLI, README cung cấp lệnh sau:
codex mcp add playwright npx "@playwright/mcp@latest"Lệnh này thêm server với tên playwright. Người mới thường nhầm tên gói với tên server. Trong lệnh trên, playwright đầu tiên là tên cấu hình, còn @playwright/mcp@latest là gói npm.
Bạn cũng có thể tạo hoặc chỉnh sửa file ~/.codex/config.toml và thêm:
[mcp_servers.playwright]
command = "npx"
args = ["@playwright/mcp@latest"]Nếu bạn dùng cách chỉnh file, cần đặt đúng khối TOML và không biến phần args thành chuỗi đơn. Sau khi lưu, hãy khởi động lại phiên làm việc hoặc client để cấu hình được nạp.
D.Cài trong Claude Code
README cung cấp lệnh dành cho Claude Code:
claude mcp add playwright npx @playwright/mcp@latestMở terminal nơi có lệnh claude, chạy lệnh trên rồi mở lại phiên Claude Code nếu server chưa xuất hiện. Nếu terminal báo không tìm thấy claude, đó là vấn đề cài đặt của Claude Code, không phải cấu hình Playwright MCP.
E.Cài trong Cursor
Trong Cursor, đi tới Cursor Settings → MCP → Add new MCP Server. Đặt tên tuỳ ý, chọn loại command và dùng lệnh:
npx @playwright/mcp@latestBạn cũng có thể mở phần Edit để kiểm tra cấu hình hoặc thêm các đối số dòng lệnh. Khi thêm thủ công, không gộp nhầm cả cấu hình JSON vào trường command nếu giao diện đã tách riêng tên và lệnh.
F.Cài trong VS Code
README hướng dẫn dùng cấu hình chuẩn trong tài liệu MCP của VS Code. Ngoài ra, bạn có thể dùng VS Code CLI:
code --add-mcp '{"name":"playwright","command":"npx","args":["@playwright/mcp@latest"]}'Lệnh này thêm MCP server có tên playwright vào VS Code. Trên Windows PowerShell, việc bao quanh JSON có thể khác tuỳ phiên bản shell và cách cài VS Code CLI. Nếu lệnh không chạy do cách quoting, hãy thêm server thủ công trong phần cấu hình MCP của VS Code bằng đúng các trường name, command và args ở trên.
G.Cài trong các client khác
README cũng có cấu hình hoặc hướng dẫn cho Amp, Antigravity, Cline, Copilot, Factory, Gemini CLI, Goose, Grok, Junie, Kiro, LM Studio, opencode, Qodo Gen, Warp và Windsurf. Với client hỗ trợ cấu hình JSON, dùng cấu hình chuẩn. Với client có lệnh riêng, dùng đúng lệnh được README cung cấp.
Ví dụ, Amp CLI dùng:
amp mcp add playwright -- npx @playwright/mcp@latestFactory dùng:
droid mcp add playwright "npx @playwright/mcp@latest"Cline có ví dụ cấu hình local như sau:
{
"mcpServers": {
"playwright": {
"type": "stdio",
"command": "npx",
"timeout": 30,
"args": [
"-y",
"@playwright/mcp@latest"
],
"disabled": false
}
}
}Không nên lấy toàn bộ tuỳ chọn của Cline rồi dán nguyên vào client khác. Mỗi client có định dạng MCP riêng. Hãy dùng đúng mẫu dành cho client bạn đang sử dụng.
H.Tuỳ chỉnh khi đã chạy được
Sau khi cấu hình cơ bản hoạt động, bạn có thể thêm đối số vào danh sách args. Ví dụ, README cho phép chọn trình duyệt:
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": [
"@playwright/mcp@latest",
"--browser",
"firefox"
]
}
}
}Các giá trị được README nêu cho --browser là chrome, firefox, webkit và msedge. Bạn cũng có thể dùng --headless để chạy không hiện cửa sổ trình duyệt, hoặc --mobile để mô phỏng thiết bị di động. --mobile không thể kết hợp với --device.
Khi cần giới hạn website, xem các tuỳ chọn --allowed-hosts, --allowed-origins và --blocked-origins. Khi cần truy cập file, lưu ý rằng mặc định việc truy cập file bị giới hạn theo workspace root và điều hướng tới URL file:// bị chặn. README có tuỳ chọn --allow-unrestricted-file-access, nhưng chỉ nên bật khi bạn hiểu rõ phạm vi quyền.
IV.Kiểm tra đã chạy được chưa
Cách kiểm tra thực tế là mở MCP client sau khi thêm cấu hình và xem server playwright có xuất hiện trong danh sách công cụ hay không. README nói rằng sau khi cài, Playwright MCP sẽ sẵn sàng để GitHub Copilot agent sử dụng trong VS Code.
Bạn có thể gửi một yêu cầu đơn giản cho AI, chẳng hạn: Mở một trang web công khai và mô tả các tiêu đề, liên kết và nút chính trên trang. Nếu server hoạt động, AI sẽ có thể dùng Playwright để tương tác với trang bằng cấu trúc accessibility thay vì chỉ nhìn ảnh.
Nếu bạn bật chế độ headed mặc định, cửa sổ trình duyệt có thể xuất hiện. README ghi rằng headed là mặc định, còn --headless dùng để chạy không hiện cửa sổ. Với headless browser, idle timeout mặc định là một giờ; với browser có giao diện, mặc định không tự đóng. Đây là dấu hiệu hữu ích khi kiểm tra hành vi chạy.
V.Dùng vào việc thật
A.Chủ shop kiểm tra quy trình đặt hàng
Chủ shop có thể nhờ AI mở trang bán hàng nội bộ, đọc cấu trúc trang và kiểm tra xem các phần quan trọng có hiện đúng không. Ví dụ prompt:
Mở trang quản trị bán hàng, kiểm tra trang danh sách đơn hàng và cho tôi biết có nút lọc, ô tìm kiếm, cột trạng thái và nút xem chi tiết hay không. Không gửi biểu mẫu và không thay đổi dữ liệu.Kết quả mong đợi là AI mô tả được các phần tử mà nó đọc từ trang. Đây là tình huống phù hợp với accessibility tree vì mục tiêu là kiểm tra cấu trúc và khả năng thao tác, không phải phân tích hình ảnh quảng cáo.
B.Nhân viên văn phòng kiểm tra biểu mẫu
Nhân viên có thể dùng MCP để rà soát một biểu mẫu trực tuyến trước khi đưa cho khách hàng. Prompt mẫu:
Mở trang biểu mẫu đăng ký, liệt kê các trường bắt buộc, nút gửi và thông báo lỗi đang hiển thị. Chỉ kiểm tra, không nhập dữ liệu thật.AI có thể đọc tên trường, nút và thông báo mà trình duyệt cung cấp trong accessibility tree. Cách này giúp phát hiện một trường bị thiếu nhãn hoặc nút không rõ chức năng trong một quy trình nhiều bước.
C.Dev kiểm thử luồng đăng nhập
Dev có thể dùng Playwright MCP để khám phá luồng đăng nhập hoặc kiểm tra trang sau khi triển khai. Prompt an toàn hơn là:
Mở trang đăng nhập của môi trường kiểm thử. Kiểm tra ô tên người dùng, ô mật khẩu và nút đăng nhập. Không dùng tài khoản thật và không gửi thông tin đăng nhập.Nếu cần kiểm tra thêm, có thể yêu cầu AI đọc nội dung trang sau khi dev tự hoàn tất bước đăng nhập. Việc giữ trạng thái trình duyệt và đọc cấu trúc trang là điểm MCP phù hợp với các vòng lặp khám phá hoặc kiểm thử tự phục hồi mà README đề cập.
D.Kiểm tra trang trên thiết bị di động
Một nhóm nội dung có thể dùng tuỳ chọn --mobile để mô phỏng chế độ di động:
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": [
"@playwright/mcp@latest",
"--mobile"
]
}
}
}Sau khi khởi động lại client, bạn có thể yêu cầu AI kiểm tra menu, biểu mẫu và nút chính trên phiên bản di động. README cho biết chế độ này dùng Pixel 10 cho Chromium và iPhone 17 cho WebKit, đồng thời các trang di động thường nhẹ hơn nên tiết kiệm token.
Tự động hoá tốt bắt đầu từ cấu trúc trang rõ ràng, không phải từ việc đoán vị trí pixel.
Ông T
VI.Lỗi hay gặp và cách xử lý
A.Node.js quá cũ hoặc chưa có trong PATH
Nếu client không chạy được npx, hãy kiểm tra node --version. README yêu cầu Node.js 18 hoặc mới hơn. Sau khi cài hoặc nâng cấp Node.js, mở lại terminal và client để PATH mới được nhận.
B.Sai định dạng cấu hình JSON hoặc TOML
Một dấu phẩy thừa, sai dấu ngoặc hoặc đặt args thành chuỗi có thể khiến client không đọc được server. Hãy đối chiếu với cấu hình chuẩn trong README. Với Codex, dùng đúng cú pháp TOML; với các client khác, dùng đúng định dạng mà client đó yêu cầu.
C.Dùng sai tên lệnh của MCP client
Mỗi client có cách thêm server riêng. Ví dụ Codex dùng codex mcp add, Claude Code dùng claude mcp add, còn Cursor thêm trong phần Settings. Không nên dùng lệnh của client này cho client khác.
D.Server không truy cập được website cần kiểm tra
Playwright MCP có các tuỳ chọn giới hạn host và origin. Nếu bạn đã thêm allowlist hoặc blocklist, hãy kiểm tra lại host/origin mục tiêu. Không vội bật --allowed-hosts * hoặc các quyền rộng nếu chưa hiểu tác động.
E.Trình duyệt mở sai chế độ hoặc tự đóng
Mặc định browser chạy headed, nhưng --headless sẽ ẩn cửa sổ. Với headless browser, idle timeout mặc định là một giờ; bạn có thể xem lại --idle-timeout nếu quy trình dài bị đóng sau thời gian không có tool call hoàn tất. Nếu dùng --mobile cùng --device, cấu hình sẽ xung đột vì README không cho phép kết hợp hai tuỳ chọn này.
VII.Có nên dùng không
Nên dùng nếu bạn muốn kết nối AI với trình duyệt bằng MCP, cần đọc cấu trúc trang có tổ chức hoặc cần một phiên trình duyệt có trạng thái cho các tác vụ khám phá và kiểm thử. Việc cài đặt cơ bản khá nhẹ: Node.js 18 trở lên, một MCP client và cấu hình chạy npx @playwright/mcp@latest.
Điểm mạnh là không phụ thuộc vào screenshot, không nhất thiết cần mô hình vision và có nhiều tuỳ chọn kiểm soát browser, host, origin, thiết bị, quyền và đầu ra. Repo cũng có cấu hình cho nhiều client nên dễ thử trong công cụ bạn đang dùng.
Giới hạn là hiệu quả phụ thuộc vào MCP client, cấu trúc accessibility của website và quyền mà bạn cấp. README không cung cấp trong phần tư liệu được gửi một quy trình cài đặt riêng cho từng hệ điều hành, cũng không nêu yêu cầu tài khoản, API key hoặc GPU. Nếu bạn đang dùng coding agent cần tiết kiệm token và chỉ muốn các lệnh ngắn gọn, README gợi ý cân nhắc Playwright CLI kết hợp SKILLs thay vì MCP.
Tóm lại, Playwright MCP là lựa chọn đáng thử cho tự động hoá trình duyệt có suy luận nhiều bước, kiểm thử khám phá và các quy trình cần giữ ngữ cảnh. Với tác vụ coding agent tốc độ cao, hãy so sánh thêm với CLI trước khi chọn kiến trúc cuối cùng.
Câu hỏi thường gặp
Playwright MCP có miễn phí không?
Tư liệu được gửi cho biết repo dùng giấy phép Apache-2.0 và có gói npm @playwright/mcp. Tư liệu chưa nói về chi phí sử dụng npx, chi phí MCP client hoặc chi phí mô hình AI.
Có cần GPU hoặc mô hình vision không?
README nói Playwright MCP hoạt động bằng accessibility tree và không cần mô hình vision. Tư liệu cũng không nêu yêu cầu GPU.
Có chạy được trên Windows không?
README chỉ yêu cầu Node.js 18 trở lên và một MCP client tương thích, không nêu hệ điều hành cụ thể. Vì vậy tư liệu chưa xác nhận riêng khả năng chạy trên Windows.
Có cần API key không?
Cấu hình chuẩn trong README chỉ dùng command npx và gói @playwright/mcp@latest, không có API key. Tư liệu chưa nói về yêu cầu xác thực của từng website hoặc MCP client.
Playwright MCP khác Playwright CLI thế nào?
README mô tả MCP phù hợp với vòng lặp cần persistent state, introspection phong phú và suy luận liên tục trên cấu trúc trang. README cũng nói coding agent có thể hưởng lợi từ Playwright CLI kết hợp SKILLs vì cách này tiết kiệm token hơn.
Có thể dùng với Cursor, VS Code và Codex không?
Có. README có hướng dẫn hoặc cấu hình cho Cursor, VS Code và Codex, ngoài nhiều MCP client khác.
Dữ liệu trình duyệt có an toàn không?
Server có các tuỳ chọn giới hạn host, origin, quyền trình duyệt và truy cập file. Tuy nhiên tư liệu không đưa ra cam kết bảo mật tổng quát, nên bạn cần giới hạn quyền và tránh dùng dữ liệu thật khi kiểm thử.


