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

microsoft/playwright-mcp: tự động hoá trình duyệt bằng AI — hướng dẫn cài đặt và dùng

13 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 →

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.

MCP server

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.

★ 40kTypeScriptApache-2.0
Xem repo trên GitHub

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, pdf hoặc devtools bằ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

  1. Kiểm tra Node.jsĐảm bảo máy có Node.js 18 trở lên
  2. Chọn MCP clientDùng VS Code, Cursor, Codex, Claude Code hoặc client tương thích
  3. Thêm cấu hìnhKhai báo lệnh npx chạy @playwright/mcp@latest
  4. Khởi động lại clientĐể client nạp MCP server mới
  5. 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:

Terminal
node --version

Kế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:

JSON
{
  "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:

Terminal
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:

TOML
[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:

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

Mở 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:

Terminal
npx @playwright/mcp@latest

Bạ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:

Terminal
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:

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

Factory dùng:

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

Cline có ví dụ cấu hình local như sau:

JSON
{
  "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:

JSON
{
  "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:

text
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:

text
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à:

text
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:

JSON
{
  "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.

3.9/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?

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ử.

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 trước
    2. B.Thêm cấu hình chuẩn
    3. C.Cài trong Codex
    4. D.Cài trong Claude Code
    5. E.Cài trong Cursor
    6. F.Cài trong VS Code
    7. G.Cài trong các client khác
    8. H.Tuỳ chỉnh khi đã chạy được
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ shop kiểm tra quy trình đặt hàng
    2. B.Nhân viên văn phòng kiểm tra biểu mẫu
    3. C.Dev kiểm thử luồng đăng nhập
    4. D.Kiểm tra trang trên thiết bị di động
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Node.js quá cũ hoặc chưa có trong PATH
    2. B.Sai định dạng cấu hình JSON hoặc TOML
    3. C.Dùng sai tên lệnh của MCP client
    4. D.Server không truy cập được website cần kiểm tra
    5. E.Trình duyệt mở sai chế độ hoặc tự đóng
  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ỏ.