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

chrome-devtools-mcp: cho AI điều khiển Chrome, gỡ lỗi và đo hiệu năng — hướng dẫn cài đặt và dùng

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

Bài này là một góc nhìn khác về ChromeDevTools/chrome-devtools-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: chrome-devtools-mcp: cho AI điều khiển và gỡ lỗi Chrome — hướng dẫn cài đặt và dùng →

chrome-devtools-mcp: cho AI điều khiển Chrome, gỡ lỗi và đo hiệu năng — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

chrome-devtools-mcp là máy chủ MCP (kèm công cụ dòng lệnh) cho phép trợ lý AI như Claude, Cursor hay Copilot điều khiển và kiểm tra một trình duyệt Chrome thật bằng sức mạnh của Chrome DevTools. Bạn dùng nó để đo hiệu năng trang web, xem lỗi console, phân tích request mạng và tự động hoá thao tác trên trang. Cài khá dễ: chỉ cần Node.js, Chrome và dán một đoạn cấu hình JSON vào phần mềm AI của bạn.

chrome-devtools-mcp là một máy chủ MCP do đội Chrome DevTools làm, giúp trợ lý AI lập trình (Claude, Cursor, Copilot, Antigravity…) mở và điều khiển một trình duyệt Chrome thật. Nó cũng có sẵn một công cụ dòng lệnh tên chrome-devtools để bạn tự điều khiển Chrome từ terminal, không cần MCP.

Vấn đề nó giải quyết rất đời thường: AI viết code xong nhưng không nhìn thấy trang web chạy ra sao. Bạn phải tự mở trình duyệt, tự đọc lỗi, rồi dán lại cho AI. Với repo này, chính AI mở trang, xem lỗi console, xem request mạng, chụp màn hình và đo tốc độ. Bạn chỉ cần ra lệnh bằng lời.

Repo hiện có khoảng 55.000 sao và khoảng 4.600 fork, giấy phép Apache-2.0, viết bằng TypeScript và vẫn được cập nhật đều trong vài tháng gần đây. Phù hợp nhất với lập trình viên mới, người làm web, chủ shop có website cần kiểm tra tốc độ, hoặc nhân viên kỹ thuật muốn nhờ AI soi lỗi trang. Điểm đáng giá nhất là nó dùng chính Chrome DevTools nên số liệu hiệu năng đáng tin hơn kiểu AI đoán mò.

MCP server

ChromeDevTools/chrome-devtools-mcp

Máy chủ MCP và CLI của đội Chrome DevTools, cho trợ lý AI lập trình mở Chrome thật, ghi trace hiệu năng, xem log, mạng và chụp màn hình.

★ 55kTypeScriptApache-2.0
Xem repo trên GitHub

I.chrome-devtools-mcp làm được gì

Theo README, repo có ba nhóm tính năng chính.

A.Đo hiệu năng bằng trace thật

Nó dùng Chrome DevTools để ghi lại một bản trace hiệu năng của trang, rồi rút ra các nhận định có thể hành động. Với bạn, nghĩa là có thể hỏi AI "vì sao trang này chậm" và nhận câu trả lời dựa trên số đo thật.

Các công cụ hiệu năng còn có thể gửi URL của trace tới Google CrUX API để lấy dữ liệu trải nghiệm của người dùng thật, đặt cạnh dữ liệu đo trong phòng thí nghiệm. Bạn có thể tắt việc này bằng cờ --no-performance-crux.

B.Gỡ lỗi trình duyệt nâng cao

AI có thể phân tích các request mạng, chụp màn hình và đọc thông báo trong console của trình duyệt. Stack trace trong console có source map, tức là chỉ về đúng dòng code gốc của bạn chứ không phải đoạn code đã bị nén khó đọc.

C.Tự động hoá đáng tin cậy

Bên dưới, repo dùng Puppeteer để thao tác trên Chrome và tự chờ kết quả của mỗi hành động. Nhờ vậy AI ít bị lỗi kiểu bấm quá sớm khi trang chưa tải xong.

D.Có thêm bộ skill dạy AI dùng DevTools

Gói npm kèm sẵn các skill (hướng dẫn cho AI) như: chrome-devtools (gỡ lỗi và tự động hoá bằng công cụ MCP), chrome-devtools-cli (chạy CLI và viết script shell), a11y-debugging (kiểm tra và sửa lỗi trợ năng), cookie-debugging (cookie, phiên đăng nhập), debug-optimize-lcp (cải thiện Largest Contentful Paint), memory-leak-debugging (tìm rò rỉ bộ nhớ) và troubleshooting (sửa lỗi kết nối giữa MCP và Chrome).

E.Chế độ gọn và các tuỳ chọn

Cờ --slim chỉ bật một bộ công cụ rút gọn cho các việc trình duyệt cơ bản. Ngoài ra README nhắc tới các tuỳ chọn như --headless, --isolated và --executablePath (đường dẫn trình duyệt tuỳ chỉnh). Danh sách đầy đủ nằm trong thư mục docs/ của repo.

II.Cần chuẩn bị gì

Theo README và package.json, bạn cần:

  • Node.js bản LTS. File package.json ghi rõ yêu cầu Node ^20.19.0 || ^22.12.0 || >=23. Nếu máy bạn dùng Node cũ hơn, hãy nâng cấp trước.
  • Chrome bản stable hiện tại hoặc mới hơn.
  • npm (thường đi kèm Node.js).
  • Một phần mềm AI hỗ trợ MCP (MCP client) như Claude Code, Cursor, VS Code với Copilot, Gemini CLI hoặc Antigravity.

README không nói gì về yêu cầu GPU, dung lượng ổ cứng hay hệ điều hành cụ thể, và không yêu cầu API key riêng cho repo này. Chi phí dùng mô hình AI là chuyện của phần mềm AI bạn đang dùng.

Máy chủ này cho phép phần mềm AI xem và sửa mọi dữ liệu trong trình duyệt mà nó điều khiển. Đừng mở các trang chứa thông tin cá nhân hay nhạy cảm (ngân hàng, email, quản trị) trong cửa sổ Chrome mà AI đang dùng.

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

  1. Kiểm tra Node và ChromeĐảm bảo máy có Node.js bản LTS, npm và Chrome stable
  2. Thêm cấu hình MCPDán đoạn JSON của chrome-devtools vào phần mềm AI của bạn
  3. Khởi động lại phần mềm AIĐể nó nạp máy chủ MCP mới
  4. Thử câu lệnh đầu tiênNhờ AI kiểm tra hiệu năng một trang web
  5. (Tuỳ chọn) Cài CLI hoặc skillCài gói toàn cục hoặc plugin nếu muốn dùng thêm

A.Kiểm tra Node.js và npm

Mở terminal (PowerShell trên Windows, Terminal trên macOS) và gõ hai lệnh dưới. Các lệnh --version là lệnh phổ thông, chỉ để xem máy đã có Node và npm chưa, và phiên bản có đạt yêu cầu không.

Terminal
node --version
npm --version

Nếu báo không tìm thấy lệnh, bạn cần cài Node.js bản LTS trước từ trang chủ Node.js.

B.Thêm cấu hình vào phần mềm AI (MCP client)

Đây là bước quan trọng nhất. README hướng dẫn thêm đoạn cấu hình sau vào MCP client của bạn:

JSON
{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": ["-y", "chrome-devtools-mcp@latest"]
    }
  }
}

Giải thích: npx sẽ tự tải và chạy gói chrome-devtools-mcp mà bạn không cần cài tay. Đuôi @latest đảm bảo phần mềm AI luôn dùng bản mới nhất.

Chỗ người mới hay vấp: mỗi phần mềm AI để file cấu hình MCP ở một nơi khác nhau. README chỉ sang tài liệu docs/client-configurations.md trong repo cho hướng dẫn riêng từng phần mềm (Antigravity, Claude Code, Cursor, VS Code). Hãy mở file đó và làm theo mục tương ứng với phần mềm của bạn.

C.Cài bằng plugin (nếu bạn dùng Claude Code, Copilot hoặc Gemini CLI)

Plugin sẽ cài cả máy chủ MCP lẫn toàn bộ skill. README ghi ba cách:

Trong Claude Code, chạy lần lượt hai lệnh:

Terminal
/plugin marketplace add ChromeDevTools/chrome-devtools-mcp
/plugin install chrome-devtools-mcp@chrome-devtools-plugins

Với Copilot / VS Code, README bảo chạy lệnh Chat: Install Plugin From Source rồi nhập ChromeDevTools/chrome-devtools-mcp.

Với Gemini CLI:

Terminal
gemini extensions install --auto-update https://github.com/ChromeDevTools/chrome-devtools-mcp

Cờ --auto-update giúp tự cập nhật. Lưu ý: hai lệnh /plugin ... gõ bên trong khung chat của Claude Code, không gõ ở terminal thường.

D.Cài công cụ dòng lệnh (không bắt buộc)

Nếu muốn điều khiển Chrome từ terminal mà không qua MCP, cài gói toàn cục:

Terminal
npm i chrome-devtools-mcp@latest -g

Sau đó bạn có lệnh chrome-devtools. Xem phần dùng thật bên dưới để biết ví dụ.

E.Cài skill thủ công (nếu AI của bạn không hỗ trợ plugin)

Gói npm có chứa các skill. README đưa ví dụ cho Claude Code, bạn chép thư mục skill vào thư mục skills của AI đang dùng:

Terminal
npm i chrome-devtools-mcp@latest -g
# Example for Claude Code. Use the skills directory of your agent.
mkdir -p ~/.claude/skills
cp -R "$(npm root -g)/chrome-devtools-mcp/skills/chrome-devtools-cli" ~/.claude/skills/

Các lệnh mkdir -p và cp -R là kiểu Linux/macOS (hoặc Git Bash trên Windows). Với PowerShell thuần, bạn cần dùng lệnh tương đương, README chưa ghi bản PowerShell. Skill chrome-devtools-cli cần CLI, nên phải cài gói toàn cục trước.

Skill mô tả công cụ của đúng một phiên bản. Mỗi lần cập nhật máy chủ hoặc CLI, hãy cập nhật lại skill để AI không dùng nhầm tham số cũ.

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

Sau khi thêm cấu hình, khởi động lại phần mềm AI. Rồi gõ đúng câu lệnh mẫu mà README đề xuất:

Code
Check the performance of https://developers.chrome.com

Nếu mọi thứ ổn, phần mềm AI sẽ mở trình duyệt và ghi một performance trace. Bạn sẽ thấy cửa sổ Chrome bật lên, rồi AI báo kết quả phân tích.

Lưu ý README nói rõ: máy chủ chỉ mở Chrome khi AI gọi một công cụ cần đến trình duyệt. Nên nếu vừa kết nối xong mà chưa thấy Chrome mở thì chưa phải lỗi. Hãy ra lệnh như trên là nó sẽ mở.

Nếu không chạy được, README gợi ý xem hướng dẫn xử lý sự cố docs/troubleshooting.md, hoặc dùng skill troubleshooting.

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

A.Chủ shop kiểm tra website bán hàng chậm

Chị Lan bán mỹ phẩm online, khách than trang sản phẩm tải lâu. Chị không biết code, nhưng có dùng một phần mềm AI hỗ trợ MCP. Chị nhờ nhân viên cài sẵn, rồi gõ:

Code
Check the performance of https://ten-shop-cua-ban.vn

AI mở Chrome, ghi trace và trả về các điểm làm trang chậm. Chị đưa danh sách này cho người làm web sửa. Có số liệu cụ thể nên hai bên khỏi cãi nhau là "chậm do mạng hay do web".

Thay vì dán lỗi qua lại giữa trình duyệt và khung chat, bạn để AI tự mở trang và tự đọc lỗi.

Ông T

B.Lập trình viên mới tìm lỗi trên trang đang viết

Minh mới học web, trang của bạn bấm nút không thấy phản hồi. Bạn mở dự án đang chạy ở máy, rồi nhờ AI trong editor:

Code
Mở trang đang chạy ở máy, bấm nút Gửi, rồi cho mình xem lỗi trong console và các request mạng bị thất bại.

Vì có source map, lỗi chỉ về đúng dòng trong code gốc. Bạn sửa theo gợi ý của AI rồi nhờ nó thử lại. Đây là đúng khả năng README nêu: phân tích request mạng, đọc console và thao tác tự động trên trang.

C.Dùng CLI ghi lại ảnh chụp trang trong script

Nếu bạn muốn chụp ảnh một trang bằng lệnh mà không cần AI, README có ví dụ dùng CLI. Số 1 là chỉ số trang, đúng như README ghi:

Terminal
npm i chrome-devtools-mcp@latest -g
chrome-devtools navigate_page 1 --url "https://developers.chrome.com"
chrome-devtools take_screenshot 1 --filePath screenshot.png
chrome-devtools stop

Ba lệnh sau lần lượt: mở địa chỉ, chụp ảnh lưu vào file screenshot.png, rồi dừng. Hợp với nhân viên kỹ thuật muốn đưa vào một script kiểm tra định kỳ. Toàn bộ lệnh và tuỳ chọn có trong docs/cli.md.

D.Dùng skill để xử lý các vấn đề chuyên sâu

Khi gặp vấn đề cụ thể, bạn có thể nhờ AI dùng skill tương ứng. Ví dụ với trang chậm phần ảnh lớn đầu trang, nhờ AI dùng skill debug-optimize-lcp. Trang bị lỗi đăng nhập hoặc mất phiên thì dùng cookie-debugging. Trang ngày càng nặng khi dùng lâu thì dùng memory-leak-debugging. Cần soát lỗi trợ năng thì dùng a11y-debugging. Bạn chỉ cần mô tả vấn đề bằng lời thường, AI sẽ dùng bộ công cụ Chrome để kiểm tra giúp.

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

A.Cấu hình thêm rồi mà AI không thấy công cụ

Thường do chưa khởi động lại phần mềm AI, hoặc dán cấu hình sai file. Hãy mở lại docs/client-configurations.md để xem đúng chỗ đặt cấu hình cho phần mềm của bạn, đóng hẳn rồi mở lại. Nếu vẫn lỗi, nhờ AI dùng skill troubleshooting.

B.Lỗi do Node quá cũ

package.json yêu cầu Node ^20.19.0 || ^22.12.0 || >=23. Chạy node --version để kiểm tra, nếu thấp hơn thì cài lại Node.js bản LTS rồi thử lại.

C.Chrome không tự mở

Máy chủ chỉ mở trình duyệt khi AI gọi công cụ cần trình duyệt. Hãy ra lệnh cụ thể, ví dụ yêu cầu mở một địa chỉ hoặc đo hiệu năng một trang. Nếu vẫn không mở, kiểm tra Chrome đã cài và là bản stable hiện tại hoặc mới hơn.

D.Dùng trình duyệt khác Chrome

README nói repo chính thức chỉ hỗ trợ Google Chrome và Chrome for Testing. Các trình duyệt nền Chromium khác có thể chạy nhưng không được đảm bảo. Nếu gặp hành vi lạ, hãy quay lại dùng Chrome.

E.Skill cũ làm AI gọi sai công cụ

Nếu bạn cài skill thủ công rồi sau đó cập nhật gói, skill cũ có thể chỉ AI dùng tham số đã đổi. Hãy chạy lại npm i chrome-devtools-mcp@latest -g rồi chép lại thư mục skill, hoặc dùng lệnh cập nhật của trình quản lý plugin.

F.Lo ngại về dữ liệu gửi đi

Mặc định Google thu thập thống kê sử dụng (tỉ lệ thành công, độ trễ của các công cụ, thông tin môi trường). Bạn có thể tắt bằng cách thêm cờ vào cấu hình:

JSON
"args": ["-y", "chrome-devtools-mcp@latest", "--no-usage-statistics"]

Việc thu thập cũng tự tắt nếu đặt biến môi trường CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS hoặc CI. Máy chủ còn định kỳ kiểm tra bản cập nhật trên npm, bạn tắt bằng biến CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS.

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

Điểm mạnh. Do chính đội Chrome DevTools làm nên bám sát công cụ gốc. Cài đặt gọn: một đoạn JSON là xong. Số liệu hiệu năng đến từ trace thật. Có thêm CLI và bộ skill nên dùng được cả khi không có MCP. Giấy phép Apache-2.0 và dự án đang hoạt động.

Giới hạn. Nó cho AI quyền xem và sửa mọi dữ liệu trong trình duyệt, nên cần cẩn thận với thông tin nhạy cảm. Mặc định có thu thập thống kê sử dụng, bạn phải tự tắt nếu không muốn. Chính thức chỉ hỗ trợ Chrome. Nó không phải công cụ thay bạn hiểu code: AI vẫn có thể phân tích sai, bạn nên tự kiểm lại những thay đổi quan trọng.

Khi nào chọn cách khác. Nếu chỉ cần mở một trang và đọc chữ, một công cụ cào dữ liệu đơn giản có thể đủ. Nếu bạn cần kiểm thử tự động chạy lặp lại trong hệ thống CI, hãy tìm hiểu thêm bộ test chuyên dụng. Còn nếu muốn AI tự nhìn thấy và sửa lỗi giao diện ngay trong lúc viết code, đây là một lựa chọn rất đáng thử.

4.6/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

chrome-devtools-mcp có miễn phí không?

Repo dùng giấy phép Apache-2.0 và README không nhắc tới phí. Bạn vẫn phải tính chi phí của phần mềm AI hay mô hình AI mà bạn dùng cùng nó, phần đó tuỳ nhà cung cấp và tư liệu chưa nói rõ.

Có cần GPU hay máy cấu hình mạnh không?

README không đề cập yêu cầu GPU hay phần cứng. Tư liệu chỉ nêu cần Node.js bản LTS, npm và Chrome bản stable hiện tại hoặc mới hơn.

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

README không liệt kê hệ điều hành hỗ trợ cụ thể. Gói chạy bằng Node.js và Chrome nên về nguyên tắc không bị khoá hệ điều hành, nhưng các lệnh mẫu chép skill dùng cú pháp Linux/macOS (mkdir -p, cp -R), nên trên Windows bạn dùng Git Bash hoặc lệnh tương đương.

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

Máy chủ cho phần mềm AI thấy và sửa được mọi dữ liệu trong trình duyệt nó điều khiển, nên đừng mở trang nhạy cảm. Mặc định Google thu thập thống kê sử dụng, tắt bằng cờ --no-usage-statistics. Công cụ hiệu năng có thể gửi URL trace tới Google CrUX API, tắt bằng --no-performance-crux.

Dùng được với Claude, Cursor, Copilot không?

Có. README nêu rõ nó dùng được với các trợ lý AI như Antigravity, Claude, Cursor, Copilot, và có hướng dẫn plugin cho Claude Code, Copilot/VS Code, Gemini CLI. Hướng dẫn cấu hình riêng từng phần mềm nằm trong docs/client-configurations.md.

Khác gì Puppeteer thông thường?

Puppeteer là thư viện mà repo dùng bên dưới để thao tác Chrome. chrome-devtools-mcp thêm lớp MCP để AI gọi được, cộng khả năng ghi trace hiệu năng, đọc console có source map và phân tích mạng bằng Chrome DevTools. Tư liệu chưa so sánh chi tiết với các công cụ khác.

Có dùng được trình duyệt khác như Edge hay Brave không?

README nói chỉ chính thức hỗ trợ Google Chrome và Chrome for Testing. Các trình duyệt nền Chromium khác có thể chạy nhưng không được đảm bảo và có thể gặp hành vi bất ngờ.

Chuyển nhanh tới mục

  1. I.chrome-devtools-mcp làm được gì
    1. A.Đo hiệu năng bằng trace thật
    2. B.Gỡ lỗi trình duyệt nâng cao
    3. C.Tự động hoá đáng tin cậy
    4. D.Có thêm bộ skill dạy AI dùng DevTools
    5. E.Chế độ gọn và các tuỳ chọn
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Kiểm tra Node.js và npm
    2. B.Thêm cấu hình vào phần mềm AI (MCP client)
    3. C.Cài bằng plugin (nếu bạn dùng Claude Code, Copilot hoặc Gemini CLI)
    4. D.Cài công cụ dòng lệnh (không bắt buộc)
    5. E.Cài skill thủ công (nếu AI của bạn không hỗ trợ plugin)
  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 website bán hàng chậm
    2. B.Lập trình viên mới tìm lỗi trên trang đang viết
    3. C.Dùng CLI ghi lại ảnh chụp trang trong script
    4. D.Dùng skill để xử lý các vấn đề chuyên sâu
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Cấu hình thêm rồi mà AI không thấy công cụ
    2. B.Lỗi do Node quá cũ
    3. C.Chrome không tự mở
    4. D.Dùng trình duyệt khác Chrome
    5. E.Skill cũ làm AI gọi sai công cụ
    6. F.Lo ngại về dữ liệu gửi đi
  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ỏ.