Chuyển đến nội dung

microsoft / playwright-mcp

Playwright MCP

Cho trợ lý AI như Claude, Copilot, Cursor tự mở trình duyệt, bấm nút, điền form và đọc trang web giúp bạn

Playwright MCP là một máy chủ MCP (chuẩn để gắn công cụ vào trợ lý AI) do Microsoft làm, giúp AI điều khiển trình duyệt thật bằng Playwright. Thay vì nhìn ảnh chụp màn hình, AI đọc cấu trúc trang (accessibility snapshot) nên thao tác ổn định, hợp để kiểm thử web, thu thập thông tin hay tự động hoá thao tác lặp lại.

  • 39.732 sao
  • 3.446 fork
  • TypeScript
  • Cập nhật hôm qua
  • Apache 2.0 (dùng tự do, kể cả thương mại)
Độ khó
Vừa Cần gõ vài lệnh hoặc dùng Docker
Dạng
Plugin / mở rộng, Dòng lệnh (CLI)
Chạy trên
Node.js, Windows, macOS, Linux
Chi phí
Miễn phí hoàn toàn

Trải nghiệm khi dùng Playwright MCP

Bạn thêm Playwright MCP vào ứng dụng AI đang dùng, ví dụ Claude Desktop, Claude Code, VS Code hay Cursor, bằng một đoạn cấu hình ngắn hoặc một lệnh. Sau khi khởi động lại, trợ lý của bạn có thêm bộ công cụ trình duyệt: mở trang, bấm, gõ chữ, chụp ảnh, đọc nội dung.

Khi bạn ra lệnh kiểu: vào trang web của shop mình, thử đặt một đơn hàng mẫu và cho biết có lỗi gì không, một cửa sổ trình duyệt thật sẽ bật lên và tự thao tác theo AI. Bạn thấy từng bước, còn AI nhận về bản mô tả cấu trúc trang rồi quyết định bước tiếp theo.

Mặc định, trình duyệt dùng một hồ sơ riêng nên các lần đăng nhập được giữ lại giữa các phiên. Bạn có thể đổi sang chế độ tách biệt, hoặc nối vào trình duyệt đang dùng qua tiện ích mở rộng nếu muốn AI dùng sẵn tài khoản đã đăng nhập, nhưng cần thận trọng với việc đó.

Tính năng nổi bật

Đọc trang bằng cấu trúc, không cần xem ảnh

AI nhận cây accessibility của trang, nên không cần mô hình biết đọc ảnh và ít bị nhầm vị trí nút hơn so với cách dựa vào ảnh chụp.

Điều khiển trình duyệt thật

Hỗ trợ Chrome, Edge, Firefox, WebKit; chạy có giao diện (mặc định) hoặc ẩn bằng tuỳ chọn headless.

Cài vào nhiều ứng dụng AI

README có hướng dẫn cho Claude Code, Claude Desktop, VS Code, Cursor, Codex, Gemini CLI, LM Studio, Windsurf và nhiều ứng dụng MCP khác.

Hồ sơ lưu bền hoặc tách biệt

Chọn hồ sơ lưu đăng nhập giữa các phiên, chế độ isolated trong bộ nhớ, hay nạp trạng thái đăng nhập từ file.

Giới hạn truy cập

Có tuỳ chọn hạn chế trang được phép truy cập, chặn service worker, và mặc định chặn truy cập file ngoài thư mục làm việc.

Tuỳ chọn mở rộng

Bật thêm khả năng như xuất PDF, vision hoặc devtools, giả lập thiết bị di động, chọn ngôn ngữ sinh mã kiểm thử.

Tận dụng Playwright MCP vào việc gì?

Lập trình viên, tester

Kiểm tra giao diện web trước khi ra mắt

Nhờ AI đi qua các bước đăng ký, thanh toán thử, ghi lại chỗ lỗi và có thể sinh mã Playwright để chạy lại.

Người vận hành, dân văn phòng

Thao tác lặp lại trên website không có API

Nhờ AI điền cùng một biểu mẫu nhiều lần hoặc lấy số liệu từ trang quản trị. Cần tuân thủ điều khoản của trang.

Người làm nghiên cứu, content

Tìm và tổng hợp thông tin từ nhiều trang

AI mở từng trang, đọc nội dung và tóm tắt lại, hữu ích khi trang cần bấm qua nhiều bước mới thấy dữ liệu.

Lập trình viên frontend

Gỡ lỗi trang web cùng AI

AI mở trang đang phát triển, xem lỗi hiển thị hoặc thông báo console rồi gợi ý sửa mã trong cùng một phiên.

Người làm website

Thử trang trên giao diện điện thoại

Dùng tuỳ chọn giả lập thiết bị di động để AI kiểm tra giao diện responsive.

Cần chuẩn bị gì?

  • Node.js 18 trở lên.
  • Một ứng dụng hỗ trợ MCP như Claude Desktop, Claude Code, VS Code, Cursor, Windsurf, Goose...
  • Trình duyệt như Chrome hoặc Edge (hoặc Firefox, WebKit) để Playwright điều khiển; có thể cần để Playwright tải trình duyệt lần đầu.
  • Không cần khoá API riêng cho Playwright MCP, nhưng ứng dụng AI bạn dùng có thể có chi phí riêng.

Hướng dẫn cài đặt chi tiết

Cài trên Cấu hình chuẩn (JSON)

  1. Cài sẵn Node.js. Với đa số ứng dụng AI (Claude Desktop, Cursor, Windsurf, LM Studio, Gemini CLI...), bạn dán đoạn cấu hình chuẩn này vào file cấu hình MCP của ứng dụng đó rồi khởi động lại ứng dụng.

    JSON
    {
      "mcpServers": {
        "playwright": {
          "command": "npx",
          "args": [
            "@playwright/mcp@latest"
          ]
        }
      }
    }
  2. Với Claude Desktop, làm theo hướng dẫn cài MCP chính thức rồi dùng đúng đoạn cấu hình trên. Với Cursor, vào Cursor Settings, chọn MCP, thêm máy chủ mới với lệnh npx @playwright/mcp@latest.

Cài trên Claude Code

  1. Mở Terminal và dùng lệnh sau để thêm máy chủ vào Claude Code.

    Terminal
    claude mcp add playwright npx @playwright/mcp@latest
  2. Khởi động lại phiên Claude Code, rồi nhờ Claude mở một trang web để kiểm tra công cụ đã hoạt động.

Cài trên VS Code

  1. README có nút Install Server cho VS Code. Hoặc dùng dòng lệnh của VS Code để thêm máy chủ (dùng PowerShell hoặc bash đều được, chú ý dấu nháy).

    Terminal
    code --add-mcp '{"name":"playwright","command":"npx","args":["@playwright/mcp@latest"]}'
  2. Sau đó máy chủ xuất hiện cho agent GitHub Copilot trong VS Code. Trên Windows PowerShell, nếu lệnh trên lỗi do dấu nháy, hãy dùng cách dán cấu hình chuẩn vào file cấu hình MCP của VS Code.

Dùng thử lần đầu

  1. Sau khi thêm vào ứng dụng AI và khởi động lại, mở một cuộc trò chuyện mới và kiểm tra danh sách công cụ MCP, bạn sẽ thấy các công cụ playwright.

  2. Ra lệnh bằng tiếng Việt, ví dụ: Mở trang https://example.com và cho mình biết tiêu đề trang cùng các liên kết trên đó.

  3. Quan sát cửa sổ trình duyệt vừa bật lên. AI sẽ mở trang, đọc cấu trúc và trả lời.

  4. Thử tác vụ nhiều bước hơn, như điền biểu mẫu liên hệ trên một trang thử nghiệm của bạn rồi báo kết quả.

  5. Nếu muốn trình duyệt không hiện cửa sổ, thêm tuỳ chọn --headless vào danh sách args của cấu hình (README liệt kê các tuỳ chọn khác như --browser, --isolated, --device).

Mẹo dùng hay

  • Cần AI dùng tài khoản đã đăng nhập sẵn thì đọc kỹ mục Browser Extension trong README; còn không, giữ hồ sơ mặc định hoặc chế độ --isolated để tách bạch.
  • Chạy nhiều ứng dụng AI cùng lúc thì dùng --isolated hoặc --user-data-dir riêng, vì một hồ sơ chỉ dùng được cho một trình duyệt tại một thời điểm.
  • Muốn giữ đăng nhập qua các lần chạy, chỉ định thư mục dữ liệu bằng --user-data-dir; muốn xoá thì xoá thư mục hồ sơ.
  • Nếu bạn là lập trình viên dùng agent viết mã, README gợi ý xem thêm Playwright CLI kèm SKILLS vì tiết kiệm token hơn MCP.

Lưu ý và hạn chế

  • AI điều khiển trình duyệt thật có thể bấm nhầm hoặc thực hiện hành động có hậu quả (đặt hàng, xoá dữ liệu). Hãy cẩn thận khi cho dùng tài khoản thật hoặc trang quan trọng.
  • Các trang web có thể chứa nội dung độc hại cố điều khiển AI (prompt injection). README nói tuỳ chọn chặn hoặc cho phép origin không phải là ranh giới bảo mật, nên đừng coi nó như hàng rào tuyệt đối.
  • Đọc cấu trúc trang tốn nhiều token với các trang lớn; README cũng thừa nhận cách dùng CLI kết hợp SKILLS tiết kiệm hơn cho tác nhân viết mã. Tôn trọng điều khoản của website và luật về dữ liệu cá nhân khi tự động hoá.

Câu hỏi thường gặp

Playwright MCP có miễn phí không?

Có, mã nguồn mở giấy phép Apache-2.0. Chi phí nếu có là của ứng dụng hoặc mô hình AI bạn dùng chứ không phải của Playwright MCP.

Tôi không biết lập trình thì dùng được không?

Dùng được nếu bạn biết sửa file cấu hình MCP trong ứng dụng AI. Sau khi cài xong, bạn chỉ cần ra lệnh bằng tiếng Việt bình thường cho AI.

Khác gì dùng Chrome DevTools MCP?

Cả hai đều là máy chủ MCP cho AI làm việc với trình duyệt. Playwright MCP hỗ trợ Chrome, Edge, Firefox và WebKit, còn Chrome DevTools MCP gắn với Chrome và công cụ DevTools; hãy xem README của từng dự án để chọn theo nhu cầu.

Tải mã nguồn về máy

Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.

Terminal
git clone https://github.com/microsoft/playwright-mcp.git

Repo tương tự nên xem

MCP: nối AI với công cụ57,5K

Chrome DevTools MCP

ChromeDevTools / chrome-devtools-mcp

Cho trợ lý AI điều khiển và soi lỗi trang web trong Chrome thật: hiệu năng, console, mạng, ảnh chụp

VừaNode.jsWindowsmacOSLinux
MCP: nối AI với công cụ34,5K

GitHub MCP Server

github / github-mcp-server

Máy chủ MCP chính thức của GitHub để AI đọc repo, quản lý issue, pull request và theo dõi Actions

VừaDockerWindowsmacOSLinux
MCP: nối AI với công cụ97,8K

Awesome MCP Servers

punkpeye / awesome-mcp-servers

Danh sách tuyển chọn hàng nghìn máy chủ MCP để cho AI dùng file, trình duyệt, cơ sở dữ liệu, ứng dụng...

DễWeb

Nội dung được biên soạn bằng tiếng Việt dựa trên tài liệu chính thức của dự án, cập nhật lần cuối 16/11/2026. Lệnh cài có thể thay đổi theo phiên bản mới; nếu có khác biệt, hãy làm theo README trên GitHub.

Cùng chủ đề: MCP: nối AI với công cụ

MCP: nối AI với công cụ92K

MCP Reference Servers

modelcontextprotocol / servers

Bộ máy chủ MCP mẫu chính thức: đọc file, lấy nội dung web, Git, bộ nhớ, giờ giấc cho Claude và các AI khác

VừaNode.jsPythonWindowsmacOS+1
MCP: nối AI với công cụ64,9K

Context7

upstash / context7

Đưa tài liệu thư viện mới nhất, đúng phiên bản vào trợ lý AI viết code để hết cảnh AI bịa hàm không tồn tại

VừaNode.jsWindowsmacOSLinux
MCP: nối AI với công cụ34,6K

MCP for Blender (blender-mcp)

ahujasid / mcp-for-blender

Nối Claude hay AI khác vào Blender để dựng cảnh 3D, đổi vật liệu và tải mô hình bằng lời dặn

VừaWindowsmacOSLinuxPython
MCP: nối AI với công cụ31,4K

Serena

oraios / serena

Bộ công cụ MCP cho AI viết code hiểu mã ở mức hàm, lớp như một IDE: tìm, sửa, đổi tên xuyên nhiều file

KhóPythonWindowsmacOSLinux
MCP: nối AI với công cụ28,5K

FastMCP

PrefectHQ / fastmcp

Khung Python để viết MCP server và client nhanh: viết một hàm Python là có công cụ cho AI dùng

KhóPython
MCP: nối AI với công cụ24,9K

MCP Python SDK

modelcontextprotocol / python-sdk

Bộ công cụ Python chính thức để viết máy chủ và client Model Context Protocol cho AI

KhóPython

Xem cả 12 repo MCP: nối AI với công cụ Về Kho Repo