Bỏ qua tới nội dung
Ông T.vn

playwright-mcp: Cho AI tự mở và thao tác trình duyệt — hướng dẫn cài đặt và dùng

11 phút đọcCập nhật

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 →

playwright-mcp: Cho AI tự mở và thao tác trình duyệt — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

playwright-mcp là máy chủ MCP do Microsoft phát triển, cho phép trợ lý AI điều khiển trình duyệt bằng Playwright thông qua cây truy cập (accessibility tree) thay vì ảnh chụp màn hình. Bạn dùng nó để AI mở trang, bấm nút, điền form, kiểm tra web. Cài đặt khá dễ: chỉ cần Node.js 18 trở lên và dán một đoạn cấu hình vào phần mềm AI bạn đang dùng.

Playwright MCP là một máy chủ MCP (Model Context Protocol) cho phép trợ lý AI điều khiển trình duyệt web thông qua Playwright. Nói đơn giản: bạn gắn nó vào phần mềm AI như Claude Code, Cursor, VS Code hay Claude Desktop, rồi ra lệnh bằng tiếng thường, kiểu "mở trang này, tìm giúp mình mục kia". AI sẽ tự mở trình duyệt và làm theo.

Repo này dành cho ai? Lập trình viên muốn AI tự kiểm tra website mình đang làm. Người làm kinh doanh, văn phòng muốn AI tra cứu, điền form, lấy thông tin lặp đi lặp lại trên web. Người mới cũng dùng được, vì phần cài đặt chủ yếu là dán một đoạn cấu hình.

Điểm đáng giá nhất là cách nó "nhìn" trang web. Thay vì chụp ảnh màn hình rồi bắt AI đoán, nó đọc cấu trúc trang dưới dạng dữ liệu có cấu trúc (accessibility snapshot). Theo README, cách này nhanh, nhẹ, không cần mô hình biết xem ảnh, và ít bị mơ hồ hơn. Repo hiện có khoảng 39.570 sao và 3.427 fork, giấy phép Apache-2.0, vẫn được cập nhật trong 3 tháng gần đây.

MCP server

microsoft/playwright-mcp

Máy chủ MCP của Microsoft giúp AI mở trình duyệt, đọc trang web và thao tác như người dùng thật, qua Playwright, không cần ảnh chụp màn hình.

★ 40kTypeScriptApache-2.0
Xem repo trên GitHub

I.Playwright MCP làm được gì

Điều khiển trình duyệt bằng dữ liệu có cấu trúc. Máy chủ dùng cây truy cập của Playwright, không dùng điểm ảnh. Lợi ích thực tế: AI không phải "nhìn ảnh rồi đoán nút nằm đâu", nên thao tác ổn định hơn. README gọi đây là cách áp dụng công cụ mang tính xác định (deterministic).

Không cần mô hình xem ảnh. Mô hình chỉ cần xử lý văn bản là dùng được. Bạn không bị giới hạn ở những mô hình có khả năng thị giác.

Chạy với nhiều phần mềm AI. README liệt kê hướng dẫn cho Amp, Antigravity, Claude Code, Claude Desktop, Cline, Codex, Copilot, Cursor, Factory, Gemini CLI, Goose, Grok, Junie, Kiro, LM Studio, opencode, Qodo Gen, VS Code, Warp, Windsurf. Bạn dùng công cụ nào thì cũng có chỗ để cắm vào.

Nhiều tuỳ chọn cấu hình. Bạn thêm các tham số vào danh sách args. Vài tham số hữu ích cho người mới:

  • --headless: chạy trình duyệt ngầm, không hiện cửa sổ. Mặc định là hiện cửa sổ.
  • --browser: chọn trình duyệt, gồm chrome, firefox, webkit, msedge.
  • --isolated: giữ hồ sơ trình duyệt trong bộ nhớ, không lưu xuống đĩa.
  • --device "iPhone 15": giả lập thiết bị di động. Còn có --mobile để giả lập điện thoại chung; README nói trang di động thường nhẹ hơn nên tiết kiệm token.
  • --caps: bật thêm khả năng, gồm vision, pdf, devtools.
  • --allowed-origins và --blocked-origins: giới hạn các nguồn mà trình duyệt được phép gọi. README nhấn mạnh đây không phải ranh giới bảo mật.
  • --extension: kết nối vào trình duyệt đang chạy (chỉ Edge/Chrome), cần cài "Playwright Extension".

Có sẵn lựa chọn thay thế. README tự nói thẳng: nếu bạn dùng coding agent, có thể nên dùng Playwright CLI kèm SKILLS vì tiết kiệm token hơn. MCP phù hợp hơn cho 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 lỗi, hoặc quy trình tự chạy dài.

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 >=18).
  • Một phần mềm khách MCP (MCP client): VS Code, Cursor, Windsurf, Claude Desktop, Goose, Grok, Junie hoặc công cụ khác hỗ trợ MCP.

README không nói gì về API key riêng cho Playwright MCP, không nói về yêu cầu GPU hay cấu hình máy. Phần mềm AI bạn dùng có thể cần tài khoản hoặc key của chính nó, nhưng đó là chuyện của công cụ đó. Hệ điều hành cụ thể cũng không được nêu trong phần README mình có; bạn kiểm tra thêm trong repo nếu cần chắc chắn.

Để kiểm tra Node, mở terminal (trên Windows là PowerShell hoặc Command Prompt) và gõ:

Terminal
node --version

Nếu số hiện ra nhỏ hơn 18, bạn cần cập nhật Node trước.

III.Cài đặt từng bước

  1. Kiểm tra Node.jsĐảm bảo máy có Node.js 18 trở lên
  2. Chọn phần mềm AIXác định bạn dùng Claude Code, VS Code, Cursor hay công cụ khác
  3. Thêm máy chủ vào clientDán cấu hình chuẩn hoặc chạy lệnh thêm MCP của công cụ đó
  4. Khởi động lại clientĐể phần mềm nạp máy chủ mới
  5. Thử một yêu cầuNhờ AI mở một trang web đơn giản

A.Kiểm tra Node.js

Mở terminal và chạy lệnh dưới đây. Máy chủ chạy thông qua npx, đi kèm Node.js, nên thiếu Node là không chạy được.

Terminal
node --version

B.Dùng cấu hình chuẩn cho hầu hết công cụ

README gọi đây là "Standard config", chạy được trên đa số công cụ. Bạn dán đoạn này vào file cấu hình MCP của phần mềm bạn dùng:

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

Giải thích: command là npx, tức là tự tải và chạy gói @playwright/mcp. @latest nghĩa là luôn lấy bản mới nhất. Chỗ người mới hay vấp: mỗi phần mềm lưu file cấu hình ở một chỗ khác nhau, nên hãy xem hướng dẫn của chính phần mềm đó (README có dẫn link cho từng công cụ). Nếu file đã có sẵn nội dung khác, bạn chỉ thêm mục playwright vào trong mcpServers, đừng dán đè cả file.

C.Nếu bạn dùng Claude Code

Mở terminal và chạy một lệnh duy nhất:

Terminal
claude mcp add playwright npx @playwright/mcp@latest

Lệnh này đăng ký máy chủ tên playwright, chạy bằng npx @playwright/mcp@latest.

D.Nếu bạn dùng VS Code

README có hai cách: bấm nút cài tự động trên trang repo, hoặc làm theo hướng dẫn thủ công và dùng cấu hình chuẩn ở trên. Ngoài ra có thể cài qua dòng lệnh VS Code:

Terminal
# For VS Code
code --add-mcp '{"name":"playwright","command":"npx","args":["@playwright/mcp@latest"]}'

Sau khi cài, máy chủ sẽ dùng được với agent GitHub Copilot trong VS Code. Lưu ý: nếu dùng PowerShell trên Windows, cách bao dấu nháy của lệnh này có thể khác. Nếu lệnh báo lỗi, hãy dùng cách dán cấu hình chuẩn cho chắc.

E.Nếu bạn dùng Cursor

Vào Cursor Settings -> MCP -> Add new MCP Server. Đặt tên tuỳ ý, chọn kiểu command, rồi nhập lệnh:

Terminal
npx @playwright/mcp@latest

Bạn cũng có thể bấm nút cài nhanh trên trang README.

F.Nếu bạn dùng Codex

Terminal
codex mcp add playwright npx "@playwright/mcp@latest"

Hoặc sửa file ~/.codex/config.toml:

TOML
[mcp_servers.playwright]
command = "npx"
args = ["@playwright/mcp@latest"]

G.Các công cụ khác

README còn có hướng dẫn riêng cho Amp, Antigravity, Cline, Copilot, Factory, Gemini CLI, Goose, Grok, Junie, Kiro, LM Studio, opencode, Qodo Gen, Warp và Windsurf. Ví dụ Grok dùng lệnh sau:

Terminal
grok mcp add playwright -- npx @playwright/mcp@latest

Với công cụ không có ở đây, hãy dùng cấu hình chuẩn ở trên.

H.Thêm tuỳ chọn nếu cần

Tham số được thêm vào danh sách args. Ví dụ chạy trình duyệt ngầm:

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

Mỗi tham số cũng có biến môi trường tương ứng, ví dụ PLAYWRIGHT_MCP_HEADLESS. Phần README mình có bị cắt giữa bảng tuỳ chọn, nên danh sách đầy đủ bạn xem trong README gốc của repo.

IV.Kiểm tra đã chạy được chưa

README không mô tả riêng một bước "kiểm tra", nên mình gợi ý cách kiểm tra hợp lý dựa trên những gì tư liệu nói:

  1. Khởi động lại phần mềm AI, rồi xem danh sách MCP server trong phần cài đặt. Mục playwright nên xuất hiện và không báo lỗi.
  2. Nhờ AI một việc đơn giản, ví dụ: "Mở trang example.com và cho mình biết tiêu đề trang".
  3. Mặc định trình duyệt chạy ở chế độ có cửa sổ (README ghi "headed by default"), nên bạn sẽ thấy một cửa sổ trình duyệt mở ra. Nếu bạn đã thêm --headless thì sẽ không thấy cửa sổ, đó là bình thường.

Nếu AI trả lời được nội dung trang, bạn đã cài xong.

V.Dùng vào việc thật

Dưới đây là bốn tình huống mình thấy bám sát khả năng của repo. Các câu lệnh mẫu bạn gõ thẳng vào khung chat của phần mềm AI.

Bạn không cần dạy AI nhìn ảnh, chỉ cần cho nó đọc cấu trúc trang là nó bấm đúng chỗ.

Ông T

A.Lập trình viên kiểm tra nhanh website đang làm

Bạn vừa sửa form đăng ký và muốn biết nó còn chạy không. Chạy web ở máy mình rồi nhờ AI:

Code
Mở http://localhost:3000, vào trang đăng ký, điền thử thông tin giả và bấm gửi. Cho mình biết có lỗi nào hiện ra không.

Kết quả: AI mở trình duyệt, điền form, báo lại những gì nhìn thấy trên trang. README còn nói máy chủ phù hợp với kiểu việc như kiểm thử tự sửa lỗi. Nếu bạn muốn AI sinh mã kiểm thử, có tuỳ chọn --codegen với các ngôn ngữ typescript, python, java, csharp hoặc none.

B.Chủ shop tra giá đối thủ

Bạn bán hàng online và hay phải mở vài trang để so giá cùng một sản phẩm. Bạn nhờ:

Code
Mở trang A và trang B, tìm sản phẩm "ấm đun siêu tốc 1.8L", lập bảng gồm tên, giá và đường dẫn của 5 kết quả đầu tiên.

Kết quả: AI lần lượt mở từng trang, đọc nội dung và gom thành bảng cho bạn. Việc tay tốn vài chục phút giờ gói trong một câu. Lưu ý: kiểm tra lại số liệu trước khi dùng để quyết định giá, vì AI có thể đọc sai.

C.Nhân viên văn phòng điền form lặp lại

Bạn phải nhập cùng kiểu thông tin vào một cổng web nhiều lần mỗi tuần. Bạn có thể đưa dữ liệu trong chat rồi nhờ:

Code
Mở cổng nhập liệu này, điền lần lượt 3 dòng dữ liệu dưới đây vào form. Dừng lại trước khi bấm gửi để mình kiểm tra.

Kết quả: AI điền sẵn, bạn xem rồi tự bấm gửi. Việc dặn "dừng trước khi gửi" giúp bạn giữ quyền quyết định cuối cùng.

D.Kiểm tra giao diện trên điện thoại

Bạn làm trang giới thiệu và muốn biết nó hiển thị thế nào trên điện thoại. Thêm --device vào cấu hình:

JSON
{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest",
        "--device",
        "iPhone 15"
      ]
    }
  }
}

Rồi nhờ AI: "Mở trang của mình và cho biết menu có hiện đầy đủ không". Kết quả: AI duyệt trang như trên iPhone 15. Nếu chỉ cần giả lập điện thoại chung, README có --mobile.

Trình duyệt do AI điều khiển có thể bấm, điền và gửi thật. Đừng cho nó thao tác trên tài khoản ngân hàng, thanh toán hay dữ liệu nhạy cảm khi chưa kiểm soát. Nếu không muốn lưu đăng nhập và cookie xuống đĩa, hãy thêm tuỳ chọn --isolated. Các tuỳ chọn --allowed-origins và --blocked-origins theo README không phải ranh giới bảo mật, đừng dựa vào chúng để chặn rủi ro.

VI.Lỗi hay gặp và cách xử lý

A.Báo không tìm thấy lệnh npx

Nguyên nhân thường gặp là máy chưa cài Node.js hoặc terminal chưa nhận. Chạy node --version để kiểm tra. Nếu chưa có hoặc nhỏ hơn 18, cài lại Node.js bản mới rồi mở lại terminal và phần mềm AI.

B.Phần mềm AI không hiện máy chủ playwright

Thường do file cấu hình sai cú pháp JSON (thiếu dấu phẩy, thừa ngoặc) hoặc bạn dán vào nhầm file. Kiểm tra lại cho giống đúng cấu hình chuẩn, rồi tắt hẳn và mở lại phần mềm. Mỗi công cụ có chỗ cấu hình riêng, nên đối chiếu với đúng mục của công cụ đó trong README.

C.Chạy trên máy chủ không có màn hình

Mặc định trình duyệt mở có cửa sổ, nên trên máy không có giao diện đồ hoạ có thể bị lỗi. Thêm --headless vào args. README còn có --no-sandbox để tắt sandbox, nhưng đây là lựa chọn kém an toàn hơn; chỉ dùng khi bạn hiểu rõ và thật sự cần.

D.AI không đọc được file ngoài thư mục làm việc

Theo README, mặc định truy cập file bị giới hạn trong thư mục gốc làm việc, và việc mở địa chỉ file:// bị chặn. Có tuỳ chọn --allow-unrestricted-file-access để nới, nhưng cách an toàn hơn là chuyển file cần dùng vào thư mục làm việc.

E.Trang cần đăng nhập, hoặc AI tốn quá nhiều token

Với trang cần đăng nhập, bạn có thể dùng --extension để kết nối vào trình duyệt đang chạy của mình (Edge hoặc Chrome, cần cài Playwright Extension), nhưng hãy cân nhắc kỹ về quyền truy cập. Còn nếu thấy tốn token, README gợi ý --mobile để trang nhẹ hơn, hoặc cân nhắc dùng Playwright CLI kèm SKILLS cho coding agent.

VII.Có nên dùng không

Điểm mạnh. Do Microsoft phát triển, giấy phép Apache-2.0, cộng đồng lớn, vẫn đang được cập nhật. Cài đặt gọn: chỉ cần Node.js 18 trở lên và một đoạn cấu hình. Hỗ trợ rất nhiều phần mềm AI. 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. Nhiều tuỳ chọn để chọn trình duyệt, giả lập thiết bị, chạy ngầm hoặc giữ hồ sơ trong bộ nhớ.

Giới hạn. Chính README thừa nhận cây truy cập đầy đủ và danh sách công cụ có thể làm tốn nhiều ngữ cảnh (token). Với coding agent xử lý dự án lớn, Playwright CLI kèm SKILLS có thể hợp hơn. Công cụ này cũng không thay thế được sự giám sát của bạn: AI vẫn có thể bấm nhầm hoặc đọc sai. Mình chưa có thông tin trong tư liệu về độ ổn định trên từng hệ điều hành hay với từng website cụ thể.

Khi nào chọn cách khác. Nếu bạn chỉ cần lấy dữ liệu một trang đơn giản, hãy thử cách nhẹ hơn trước. Nếu bạn là lập trình viên dùng coding agent, hãy xem qua Playwright CLI. Còn nếu bạn muốn AI giữ một phiên trình duyệt liên tục để khám phá, thử nghiệm và tự sửa, Playwright MCP là lựa chọn đáng thử.

4.3/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

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 cài qua npm. Tư liệu không nói gì về phí của riêng công cụ này. Phần mềm AI bạn gắn vào (Claude, Copilot, Cursor...) có thể có chi phí riêng theo gói của chúng.

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 (cây truy cập), không cần mô hình xem ảnh. README không nêu yêu cầu về GPU.

Cần cài những gì để chạy?

README yêu cầu Node.js 18 trở lên và một phần mềm khách MCP như VS Code, Cursor, Windsurf, Claude Desktop, Goose, Grok, Junie. Cách chạy phổ biến nhất là lệnh npx @playwright/mcp@latest do phần mềm AI tự gọi.

Chạy được trên Windows không?

Phần README mình có không nêu riêng hệ điều hành nào, chỉ yêu cầu Node.js 18 trở lên. Chưa có thông tin chính thức về Windows trong tư liệu này, nên bạn nên thử và xem thêm trong repo.

Dữ liệu và đăng nhập của mình có an toàn không?

README có các tuỳ chọn như --isolated để giữ hồ sơ trình duyệt trong bộ nhớ, và mặc định chặn truy cập file ngoài thư mục làm việc. Nhưng README cũng nói các tuỳ chọn chặn/cho phép nguồn không phải ranh giới bảo mật. Bạn nên tránh cho AI thao tác trên tài khoản nhạy cảm.

Khác gì Playwright CLI?

README giải thích CLI kèm SKILLS tiết kiệm token hơn nên hợp với coding agent. MCP hợp 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 lỗi hoặc quy trình chạy dài.

Có chạy trình duyệt ngầm được không?

Có. Thêm tham số --headless vào danh sách args. Mặc định trình duyệt chạy có cửa sổ. Bạn cũng có thể chọn trình duyệt bằng --browser với các giá trị chrome, firefox, webkit, msedge.

Chuyển nhanh tới mục

  1. I.Playwright MCP làm được gì
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Kiểm tra Node.js
    2. B.Dùng cấu hình chuẩn cho hầu hết công cụ
    3. C.Nếu bạn dùng Claude Code
    4. D.Nếu bạn dùng VS Code
    5. E.Nếu bạn dùng Cursor
    6. F.Nếu bạn dùng Codex
    7. G.Các công cụ khác
    8. H.Thêm tuỳ chọn nếu cần
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Lập trình viên kiểm tra nhanh website đang làm
    2. B.Chủ shop tra giá đối thủ
    3. C.Nhân viên văn phòng điền form lặp lại
    4. D.Kiểm tra giao diện trên điện thoại
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Báo không tìm thấy lệnh npx
    2. B.Phần mềm AI không hiện máy chủ playwright
    3. C.Chạy trên máy chủ không có màn hình
    4. D.AI không đọc được file ngoài thư mục làm việc
    5. E.Trang cần đăng nhập, hoặc AI tốn quá nhiều token
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.