chrome-devtools-mcp: cho AI điều khiển và gỡ lỗi Chrome — hướng dẫn cài đặt và dùng
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 →

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 đang chạy thật. Bạn dùng nó để đo hiệu năng, 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 ứng dụng 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 của bạn (Claude, Cursor, Copilot, Antigravity…) mở, điều khiển và soi lỗi một trình duyệt Chrome thật. Nó cũng có một công cụ dòng lệnh tên chrome-devtools để bạn tự điều khiển Chrome từ terminal mà không cần MCP. Repo hiện có khoảng 55.000 sao và 4.600 fork, giấy phép Apache-2.0.
Bình thường AI chỉ đọc được code, chứ không thấy trang web của bạn chạy ra sao. Có công cụ này, AI tự mở trang, bấm thử, đọc lỗi trong console, xem request nào chậm, rồi mới sửa. Bạn đỡ phải mô tả lỗi bằng lời hay chụp màn hình dán vào khung chat.
Công cụ hợp với lập trình viên mới, người làm web cho shop, hoặc nhân viên văn phòng đang nhờ AI viết trang web, landing page. Điểm đáng giá nhất: nó dùng chính bộ công cụ DevTools của Chrome, nên số liệu hiệu năng và lỗi là số liệu thật, không phải AI đoán.
ChromeDevTools/chrome-devtools-mcp
Máy chủ MCP và CLI của Chrome DevTools, cho trợ lý AI lập trình điều khiển Chrome thật, gỡ lỗi, chụp màn hình và đo hiệu năng trang web.
I.chrome-devtools-mcp làm được gì
Theo README, repo có ba nhóm tính năng chính.
- Phân tích hiệu năng. AI ghi lại một bản trace (bản ghi quá trình tải trang) bằng Chrome DevTools rồi rút ra các gợi ý cụ thể. Bạn không cần hiểu hết biểu đồ DevTools, chỉ cần hỏi "trang này chậm ở đâu".
- Gỡ lỗi trình duyệt nâng cao. AI xem được các request mạng, chụp ảnh màn hình và đọc thông báo trong console. Lỗi trong console có kèm stack trace đã được ánh xạ về mã nguồn gốc (source-mapped), nên dễ chỉ ra đúng dòng code gây lỗi.
- Tự động hoá đáng tin cậy. Repo dùng Puppeteer để thao tác trên Chrome và tự chờ kết quả của từng thao tác xong mới làm tiếp. Nhờ vậy AI ít bị "bấm hụt" khi trang chưa tải xong.
Ngoài ra còn một số thứ hay ho:
- Công cụ dòng lệnh
chrome-devtools. Dùng được từ terminal hoặc viết thành script shell, không cần máy chủ MCP. - Bộ skill đi kèm. Đây là các "bài hướng dẫn" dạy AI cách dùng công cụ cho đúng. Gồm
chrome-devtools(gỡ lỗi và tự động hoá bằng công cụ MCP),chrome-devtools-cli(chạy CLI, viết script),a11y-debugging(kiểm tra khả năng tiếp cận),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). - Cờ
--slim. Chỉ mở một bộ công cụ rút gọn cho các việc trình duyệt cơ bản. - Các cờ cấu hình khác như
--headless(chạy không hiện cửa sổ) và--isolated. Danh sách đầy đủ nằm trong tài liệu cấu hình của repo.
II.Cần chuẩn bị gì
Theo README và package.json, bạn cần:
- Node.js bản LTS. Cụ thể
package.jsonyêu cầu Node^20.19.0 || ^22.12.0 || >=23. Bạn nên kiểm tra phiên bản trước khi cài. - npm. Thường đi kèm khi cài Node.js.
- Google Chrome bản stable hiện tại hoặc mới hơn. README nói 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.
- Một ứng dụng AI hỗ trợ MCP (MCP client), ví dụ Claude Code, Cursor, VS Code với Copilot, Antigravity hoặc Gemini CLI.
Tư liệu không nhắc tới API key riêng, GPU hay yêu cầu hệ điều hành cụ thể cho repo này. Ứng dụng AI bạn dùng có thể có tài khoản hay chi phí riêng, bạn xem ở nhà cung cấp đó.
Máy chủ này cho trợ lý AI xem và sửa được MỌI dữ liệu trong trình duyệt mà nó điều khiển. Đừng mở trang ngân hàng, email, hay trang chứa thông tin cá nhân khi đang để AI dùng công cụ. Hãy dùng trình duyệt cho việc thử nghiệm và tránh để lộ thông tin nhạy cảm cho AI.
III.Cài đặt từng bước
- Kiểm tra Node và ChromeĐảm bảo Node.js đủ phiên bản và Chrome đã cài
- Thêm cấu hình MCPDán đoạn JSON vào ứng dụng AI của bạn
- Chạy thử câu lệnh đầu tiênNhờ AI đo hiệu năng một trang web
- (Tuỳ chọn) Cài plugin và skillDạy AI dùng công cụ đúng cách
- (Tuỳ chọn) Cài CLIĐiều khiển Chrome trực tiếp từ terminal
A.Kiểm tra Node.js và Chrome
Mở terminal. Trên Windows là PowerShell hoặc Windows Terminal, trên macOS là Terminal. Gõ hai lệnh sau để xem phiên bản:
node -v
npm -vNếu báo "không tìm thấy lệnh", bạn chưa cài Node.js. Hãy tải bản LTS ở trang chủ nodejs.org. Nếu số phiên bản thấp hơn mức yêu cầu (Node 20.19 trở lên với nhánh 20, 22.12 trở lên với nhánh 22, hoặc 23 trở lên), bạn cần nâng cấp. Chrome thì chỉ cần là bản stable mới.
B.Thêm cấu hình vào ứng dụng AI
Đây là bước chính. README chỉ cần bạn thêm đoạn cấu hình sau vào MCP client:
{
"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ỗi khi cần, nên bạn không phải cài thủ công. Hậu tố @latest luôn lấy bản mới nhất. Cờ -y để npx khỏi hỏi xác nhận.
Chỗ người mới hay vấp: mỗi ứng dụng AI lưu file cấu hình MCP ở một nơi khác nhau. README không ghi từng chỗ, mà chỉ bạn sang tài liệu "Client Configurations Guide" trong repo (file docs/client-configurations.md). Hãy mở file đó, tìm đúng ứng dụng của bạn (Claude Code, Cursor, VS Code, Antigravity…) rồi làm theo. Sau khi lưu cấu hình, thường bạn cần khởi động lại ứng dụng AI.
C.Chạy thử câu lệnh đầu tiên
Trong khung chat của ứng dụng AI, gõ đúng câu mẫu trong README:
Check the performance of https://developers.chrome.comBạn có thể gõ tiếng Việt, ví dụ "Kiểm tra hiệu năng của trang …", AI sẽ hiểu. Cửa sổ Chrome sẽ mở ra và AI ghi một bản trace hiệu năng. Lưu ý: trình duyệt chỉ tự mở khi AI dùng một công cụ cần đến nó. Chỉ kết nối tới máy chủ MCP thôi thì Chrome chưa mở, nên đừng lo nếu lúc mới cài chưa thấy gì.
D.(Tuỳ chọn) Cài plugin và skill
Plugin sẽ cài cả máy chủ MCP lẫn toàn bộ skill. README ghi ba cách, tuỳ ứng dụng của bạn.
Với Claude Code, chạy lần lượt hai lệnh sau trong khung chat của Claude Code:
/plugin marketplace add ChromeDevTools/chrome-devtools-mcp
/plugin install chrome-devtools-mcp@chrome-devtools-pluginsVới Copilot / VS Code, chạy lệnh Chat: Install Plugin From Source rồi nhập ChromeDevTools/chrome-devtools-mcp.
Với Gemini CLI, chạy trong terminal:
gemini extensions install --auto-update https://github.com/ChromeDevTools/chrome-devtools-mcpNếu ứng dụng AI của bạn không hỗ trợ plugin, README hướng dẫn chép thủ công thư mục skill. Ví dụ dưới đây dành cho Claude Code, còn ứng dụng khác thì dùng thư mục skill của ứng dụng đó:
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/Lệnh npm i ... -g cài gói vào máy. Lệnh mkdir -p tạo thư mục skill nếu chưa có. Lệnh cp -R chép skill vào đó. Các lệnh này theo cú pháp bash. Trên Windows bạn nên chạy trong Git Bash hoặc WSL, vì PowerShell không có sẵn mkdir -p và cp -R theo kiểu này.
E.(Tuỳ chọn) Cài công cụ dòng lệnh
Nếu muốn tự điều khiển Chrome từ terminal, không qua AI, cài gói toàn cục:
npm i chrome-devtools-mcp@latest -gSau đó lệnh chrome-devtools dùng được ở mọi nơi. Skill chrome-devtools-cli cũng cần bước này, nên nếu dùng skill đó thì bạn phải cài toàn cục trước.
IV.Kiểm tra đã chạy được chưa
Cách kiểm tra theo README rất đơn giản: gõ câu lệnh mẫu "Check the performance of https://developers.chrome.com" vào ứng dụng AI. Nếu cài đúng, ứng dụng AI sẽ mở trình duyệt Chrome và ghi một bản trace hiệu năng, sau đó báo lại các nhận xét.
Với CLI, bạn thử ba lệnh sau. Lệnh đầu mở trang, lệnh hai chụp ảnh màn hình lưu vào screenshot.png, lệnh ba dừng lại:
chrome-devtools navigate_page 1 --url "https://developers.chrome.com"
chrome-devtools take_screenshot 1 --filePath screenshot.png
chrome-devtools stopThấy file screenshot.png xuất hiện trong thư mục hiện tại là thành công. Số 1 trong lệnh là cách README dùng để chỉ trang, bạn xem thêm ý nghĩa trong tài liệu CLI của repo (docs/cli.md).
V.Dùng vào việc thật
Dưới đây là vài tình huống mình thấy hợp với khả năng mà README mô tả. Câu lệnh mẫu bạn có thể viết bằng tiếng Việt hoặc tiếng Anh.
A.Chủ shop có trang bán hàng tải chậm
Bối cảnh: bạn thuê người làm trang web bán hàng và thấy khách than tải lâu. Bạn không rành kỹ thuật nhưng đang dùng một trợ lý AI lập trình để chỉnh trang.
Cách làm: nhờ AI đo trước rồi mới sửa.
Check the performance of https://trang-cua-ban.vn và cho mình biết 3 việc nên sửa trước.Kết quả: AI mở Chrome, ghi trace, rồi liệt kê điểm nghẽn bằng số liệu thật. Nếu trang chậm ở phần ảnh lớn đầu trang, bạn có thể dùng skill debug-optimize-lcp để AI tập trung cải thiện chỉ số LCP. Bạn có thể đo lại sau khi sửa để so sánh.
Đừng để AI đoán trang web của bạn đang lỗi ở đâu, hãy cho nó mở trình duyệt lên và tự nhìn.
Ông T
B.Lập trình viên mới đang đuổi một lỗi khó hiểu
Bối cảnh: trang chạy trên máy bạn, bấm nút thì không có gì xảy ra. Bạn không biết lỗi nằm ở đâu.
Cách làm: mở trang đang chạy, rồi nhờ AI kiểm tra.
Mở trang http://localhost:3000, 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.Kết quả: AI đọc console, kèm stack trace đã ánh xạ về mã nguồn, và xem lại các request mạng. Nhờ đó chỉ ra đúng dòng code và request lỗi để sửa. Bạn không phải mở DevTools rồi tự đọc.
C.Nhân viên văn phòng chụp ảnh trang web hàng loạt
Bối cảnh: bạn cần ảnh chụp màn hình vài trang để đưa vào báo cáo hay slide, không muốn bấm tay từng cái.
Cách làm: dùng công cụ dòng lệnh, chạy từng lệnh hoặc gộp vào một script shell. Với mỗi trang, bạn mở trang rồi chụp:
chrome-devtools navigate_page 1 --url "https://developers.chrome.com"
chrome-devtools take_screenshot 1 --filePath screenshot.png
chrome-devtools stopKết quả: có sẵn file ảnh ở đường dẫn bạn đặt. Muốn viết script cho nhiều trang, nhờ AI dùng skill chrome-devtools-cli để soạn giúp. Các lệnh và tuỳ chọn đầy đủ nằm trong tài liệu CLI của repo.
D.Dev kiểm tra khả năng tiếp cận và rò rỉ bộ nhớ
Bối cảnh: bạn làm web cho khách và cần rà lại trang trước khi bàn giao.
Cách làm: sau khi cài skill, nhờ AI dùng đúng skill cho từng việc.
Dùng skill a11y-debugging để kiểm tra trang http://localhost:3000 và sửa các lỗi tiếp cận.Dùng skill memory-leak-debugging để tìm xem trang này có rò rỉ bộ nhớ không.Kết quả: AI có sẵn quy trình do tác giả viết để kiểm tra và đề xuất cách sửa, nên làm gọn hơn so với việc để nó tự mày mò.
VI.Lỗi hay gặp và cách xử lý
A.Báo lỗi khi chạy npx hoặc phiên bản Node quá cũ
Nguyên nhân thường là Node.js chưa cài hoặc cũ hơn mức package.json yêu cầu (^20.19.0 || ^22.12.0 || >=23). Chạy node -v để xem. Nếu thấp hơn, cài lại bản LTS mới từ trang chủ Node.js rồi khởi động lại ứng dụng AI.
B.Cấu hình đã dán nhưng chưa thấy công cụ xuất hiện
Có thể bạn dán sai file, vì mỗi ứng dụng AI lưu cấu hình MCP ở chỗ khác nhau. Mở docs/client-configurations.md trong repo, làm đúng theo mục của ứng dụng bạn. Kiểm tra JSON không thiếu dấu phẩy hay ngoặc, rồi khởi động lại ứng dụng.
C.Chrome không tự mở sau khi cài
Đây thường không phải lỗi. README nói trình duyệt chỉ khởi động khi AI dùng một công cụ cần đến nó. Hãy gõ câu lệnh mẫu để AI chạy thử. Nếu vẫn lỗi kết nối giữa MCP và Chrome, xem tài liệu troubleshooting (docs/troubleshooting.md) hoặc dùng skill troubleshooting của repo.
D.Dùng trình duyệt khác Chrome và gặp hành vi lạ
README ghi 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. Nếu gặp lỗi lạ, hãy thử lại với Chrome stable trước.
E.Skill cũ làm AI gọi sai công cụ
Skill mô tả công cụ của một phiên bản cụ thể. README cảnh báo skill cũ có thể khiến AI dùng công cụ hay tham số đã đổi. Mỗi khi cập nhật máy chủ MCP hoặc CLI, hãy cập nhật cả skill. Với plugin thì dùng lệnh cập nhật của trình quản lý plugin. Với cài thủ công thì chạy lại npm i chrome-devtools-mcp@latest -g và chép lại thư mục skill.
VII.Có nên dùng không
Điểm mạnh. Đây là công cụ do chính đội Chrome DevTools làm, nên dùng chung nền tảng với trình duyệt bạn đang dùng. Cài đặt nhẹ (một đoạn JSON), chạy được với nhiều ứng dụng AI, có thêm CLI và bộ skill sẵn cho các việc hay gặp như LCP, tiếp cận, cookie, rò rỉ bộ nhớ. Repo vẫn được cập nhật trong vài tháng gần đây.
Giới hạn. Bạn cần Node.js đúng phiên bản và một ứng dụng AI hỗ trợ MCP. Chỉ Chrome được hỗ trợ chính thức. Ngoài ra có hai điều về dữ liệu bạn nên biết, đều theo README:
- Công cụ cho AI đọc và chỉnh sửa mọi dữ liệu trong trình duyệt, nên đừng để lộ thông tin nhạy cảm.
- Google thu thập thống kê sử dụng theo mặc định (tỉ lệ gọi công cụ thành công, độ trễ, thông tin môi trường). Bạn tắt bằng cờ
--no-usage-statistics, ví dụ"args": ["-y", "chrome-devtools-mcp@latest", "--no-usage-statistics"], hoặc đặt biến môi trườngCHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS.
Các công cụ đo hiệu năng cũng có thể gửi URL của bản trace tới API CrUX của Google để lấy dữ liệu người dùng thực. Muốn tắt, thêm cờ --no-performance-crux. Máy chủ còn tự kiểm tra bản cập nhật trên npm, tắt bằng biến CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS.
Khi nào chọn cách khác. Nếu bạn chỉ cần xem trang web một cách thủ công, DevTools có sẵn trong Chrome là đủ. Nếu dự án cần kiểm thử tự động viết sẵn thành bộ test cố định, một khung kiểm thử riêng sẽ hợp hơn. Công cụ này mạnh nhất khi bạn muốn AI tự nhìn, tự thử và tự sửa lỗi trên trang đang chạy.
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à chạy qua npx, README không nhắc phí riêng cho công cụ. Tuy vậy ứng dụng AI bạn dùng (Claude, Cursor, Copilot…) có thể có gói hoặc chi phí riêng, bạn xem ở nhà cung cấp đó.
Cần cài những gì trước khi dùng?
Bạn cần Node.js bản LTS (package.json yêu cầu ^20.19.0 || ^22.12.0 || >=23), npm và Google Chrome bản stable hiện tại hoặc mới hơn. Bạn cũng cần một ứng dụng AI hỗ trợ MCP để dán cấu hình vào.
Chạy trên Windows được không?
Tư liệu không liệt kê hệ điều hành cụ thể. Phần cấu hình dùng npx chạy trên Node.js nên về nguyên tắc không phụ thuộc hệ điều hành. Riêng các lệnh chép skill trong README viết theo kiểu bash (mkdir -p, cp -R), nên trên Windows bạn nên dùng Git Bash hoặc WSL.
Dữ liệu trong trình duyệt của mình có an toàn không?
README cảnh báo công cụ cho ứng dụng AI xem, kiểm tra và chỉnh sửa mọi dữ liệu trong trình duyệt hoặc DevTools. Vì vậy bạn không nên mở thông tin nhạy cảm khi AI đang dùng công cụ. Ngoài ra Google thu thập thống kê sử dụng mặc định, và bạn tắt được bằng cờ --no-usage-statistics.
Có dùng được với trình duyệt khác như Edge hay Brave không?
README ghi 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 và có thể gặp hành vi bất thường. Bạn dùng theo cách tự chịu trách nhiệm.
Công cụ này khác gì chỉ dùng Puppeteer?
README nói công cụ dùng Puppeteer để tự động hoá thao tác, đồng thời thêm sức mạnh của Chrome DevTools như ghi trace hiệu năng, đọc console có source map và phân tích request mạng. Nó còn đóng gói thành máy chủ MCP để trợ lý AI gọi trực tiếp. Tư liệu không có so sánh chi tiết hơn.
Có cần GPU hay API key riêng không?
README không nhắc yêu cầu GPU hay API key cho công cụ này. Các bước cài chỉ gồm Node.js, Chrome và cấu hình MCP. Chi phí hay key của ứng dụng AI bạn dùng thì nằm ngoài tư liệu của repo.


