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ột MCP server (kèm bộ lệnh CLI) cho phép trợ lý AI như Claude, Cursor, 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, chụp màn hình, tự động hoá thao tác. Cài đặt 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 MCP server do đội Chrome DevTools phát triển, giúp trợ lý AI lập trình (Claude, Cursor, Copilot, Antigravity…) điều khiển và kiểm tra một trình duyệt Chrome đang chạy thật. Nói đơn giản: thay vì bạn tự mở DevTools, bấm từng tab rồi copy lỗi dán cho AI, giờ AI tự làm việc đó. Ngoài dạng MCP server, gói này còn có bộ lệnh CLI để bạn điều khiển trình duyệt ngay từ terminal.
Repo hợp với lập trình viên mới, người làm website, và cả chủ shop hay nhân viên văn phòng có trang web riêng muốn biết "sao trang chậm thế" mà không rành kỹ thuật. Bạn chỉ cần ra lệnh bằng tiếng thường cho AI, phần còn lại do công cụ lo.
Điểm đáng giá nhất là nó dùng chính Chrome DevTools và Puppeteer, nên số liệu hiệu năng, lỗi console, request mạng là dữ liệu thật từ trình duyệt chứ không phải AI đoán. Repo hiện có khoảng 55.187 sao và 4.604 fork, giấy phép Apache-2.0, và vẫn được cập nhật trong 3 tháng gần đây.
ChromeDevTools/chrome-devtools-mcp
Công cụ của đội Chrome DevTools giúp trợ lý AI lập trình mở Chrome thật, đo hiệu năng, xem lỗi console, chụp màn hình và tự động hoá thao tác trên trang.
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 và rút ra gợi ý
Công cụ ghi lại một bản trace hiệu năng bằng Chrome DevTools rồi trích ra các nhận định có thể hành động. Lợi ích thực tế: bạn không phải đọc biểu đồ phức tạp, AI đọc giúp và nói "chỗ nào làm trang chậm".
B.Gỡ lỗi trình duyệt chuyên sâu
AI có thể phân tích các request mạng, chụp ảnh màn hình và đọc thông báo trong console (kèm stack trace đã được ánh xạ về mã nguồn gốc). Khi trang bị lỗi, AI tự nhìn thấy lỗi thay vì chờ bạn mô tả.
C.Tự động hoá đáng tin cậy
Nó dùng Puppeteer để thao tác trên Chrome và tự chờ kết quả của mỗi thao tác. Nhờ vậy AI ít bị "bấm hụt" vì trang chưa tải xong.
D.Bộ lệnh CLI
Gói có lệnh chrome-devtools để điều khiển trình duyệt từ terminal, không cần MCP. Hợp khi bạn muốn viết script chạy lặp lại.
E.Bộ skill đi kèm
Gói có sẵn các skill dạy AI cách dùng công cụ: chrome-devtools, chrome-devtools-cli, a11y-debugging (kiểm tra và sửa lỗi khả năng truy cập), cookie-debugging (cookie, phiên đăng nhập), debug-optimize-lcp (cải thiện Largest Contentful Paint), memory-leak-debugging (rò rỉ bộ nhớ) và troubleshooting (sửa lỗi kết nối giữa MCP và Chrome).
II.Cần chuẩn bị gì
Theo tư liệu, bạn cần:
- Node.js bản LTS. File package.json yêu cầu Node ^20.19.0 || ^22.12.0 || >=23.
- Trình duyệt Chrome bản stable hiện tại hoặc mới hơn.
- npm (thường đi kèm khi cài Node.js).
- Một phần mềm AI hỗ trợ MCP (ví dụ Claude Code, Cursor, VS Code với Copilot, Gemini CLI, Antigravity).
README không nói cần API key riêng, không nói cần GPU, và không nêu yêu cầu về hệ điều hành. Repo 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.
MCP server cho phép trợ lý 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 hoặc nhạy cảm nếu bạn không muốn chia sẻ với AI.
III.Cài đặt từng bước
- Kiểm tra Node.js và ChromeĐảm bảo đã có Node.js LTS, npm và Chrome bản mới
- Thêm cấu hình MCPDán đoạn JSON vào phần mềm AI của bạn
- Chạy câu lệnh thửNhờ AI kiểm tra hiệu năng một trang web
- (Tuỳ chọn) Cài CLICài gói toàn cục để dùng lệnh chrome-devtools
- (Tuỳ chọn) Cài skillCài plugin hoặc chép thư mục skill
A.Kiểm tra Node.js và Chrome
Mở terminal (trên Windows là PowerShell hoặc Command Prompt) và kiểm tra Node cùng npm đã cài chưa. Đây là các lệnh phổ thông, không nằm trong README:
node -v
npm -vNếu báo không tìm thấy lệnh, bạn cần cài Node.js bản LTS từ trang chủ Node.js. Chrome thì cài như bình thường.
B.Thêm cấu hình vào phần mềm AI (MCP client)
Đây là bước chính. Bạn thêm đoạn cấu hình sau vào phần cài đặt MCP của phần mềm AI đang dùng:
{
"mcpServers": {
"chrome-devtools": {
"command": "npx",
"args": ["-y", "chrome-devtools-mcp@latest"]
}
}
}Giải thích: npx tự tải và chạy gói chrome-devtools-mcp, cờ -y để khỏi hỏi xác nhận, còn @latest đảm bảo luôn dùng bản mới nhất. Chỗ người mới hay vấp: mỗi phần mềm (Claude Code, Cursor, VS Code…) lưu cấu hình MCP ở một nơi khác nhau. README chưa ghi chi tiết từng nơi trong phần này, mà trỏ sang file docs/client-configurations.md trong repo. Bạn mở file đó, tìm đúng phần mềm của mình.
C.Cài như plugin (cách nhanh hơn cho một số phần mềm)
Plugin cài cả MCP server lẫn toàn bộ skill, gồm skill CLI. README ghi ba cách:
Với Claude Code, gõ lần lượt hai lệnh trong 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:
gemini extensions install --auto-update https://github.com/ChromeDevTools/chrome-devtools-mcpCờ --auto-update bật tự cập nhật.
D.Cài CLI (tuỳ chọn)
Nếu muốn điều khiển trình duyệt từ terminal không qua MCP:
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 stopLệnh đầu cài gói toàn cục (-g). Lệnh thứ hai mở một trang, lệnh thứ ba chụp ảnh lưu vào screenshot.png, lệnh cuối dừng lại. Danh sách đầy đủ lệnh và tuỳ chọn nằm trong docs/cli.md.
E.Cài skill thủ công (tuỳ chọn)
Nếu phần mềm AI của bạn không hỗ trợ plugin, hãy chép thư mục skill vào thư mục skill của nó. Ví dụ README cho Claude Code:
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 này theo cú pháp bash. Người dùng Windows nên chạy trong Git Bash hoặc WSL, hoặc ưu tiên cách cài plugin ở trên. Lưu ý: skill chrome-devtools-cli cần CLI, nên phải cài gói toàn cục trước khi dùng. Khi cập nhật MCP server hoặc CLI, hãy cập nhật cả skill, vì skill cũ có thể chỉ AI dùng công cụ hoặc tham số đã đổi.
IV.Kiểm tra đã chạy được chưa
Mở phần mềm AI của bạn và gõ câu sau, đúng như README gợi ý:
Check the performance of https://developers.chrome.comNếu cài đúng, phần mềm AI sẽ mở trình duyệt và ghi một bản trace hiệu năng. Bạn sẽ thấy cửa sổ Chrome bật lên rồi AI báo kết quả.
Một điểm dễ hiểu nhầm: MCP server không tự mở Chrome ngay khi kết nối. Chrome chỉ khởi động khi AI dùng một công cụ cần đến trình duyệt. Vì vậy chưa thấy Chrome mở lúc mới thêm cấu hình là bình thường.
Nếu dùng CLI, chạy chrome-devtools take_screenshot 1 --filePath screenshot.png rồi kiểm tra có file ảnh screenshot.png xuất hiện không.
V.Dùng vào việc thật
A.Chủ shop muốn biết vì sao trang bán hàng chậm
Bạn có website bán hàng và khách phàn nàn tải chậm. Bạn không rành kỹ thuật. Hãy nhờ AI bằng một câu tương tự câu mẫu của README:
Check the performance of https://ten-trang-cua-ban.vnAI mở Chrome, ghi trace và đưa ra các nhận định về hiệu năng. Bạn có thể đưa bản tóm tắt đó cho người làm web của mình. Gói còn có skill debug-optimize-lcp chuyên giúp cải thiện chỉ số Largest Contentful Paint.
Thay vì đoán trang chậm vì đâu, bạn để AI mở Chrome thật và đo.
Ông T
B.Lập trình viên mới tìm lỗi trên trang đang viết
Trang của bạn bấm nút không phản ứng. Thay vì mở DevTools và copy từng dòng lỗi, bạn nói với AI: "Mở trang này, kiểm tra thông báo console và các request mạng bị lỗi, rồi giải thích nguyên nhân." Công cụ cho phép AI đọc console (có stack trace ánh xạ về mã nguồn) và phân tích request mạng. Kết quả là AI chỉ ra dòng lỗi và gợi ý cách sửa, bạn đỡ phải dịch qua lại giữa trình duyệt và trình soạn code.
C.Nhân viên văn phòng chụp màn hình hàng loạt bằng script
Bạn cần chụp ảnh một vài trang để làm báo cáo. Cài CLI rồi dùng đúng chuỗi lệnh README cung cấp: mở trang bằng navigate_page, chụp bằng take_screenshot, kết thúc bằng stop. Bạn có thể đặt các lệnh này vào một file script để chạy lại khi cần. Skill chrome-devtools-cli được thiết kế để AI giúp bạn viết script shell kiểu này.
D.Kiểm tra khả năng truy cập hoặc lỗi đăng nhập
Nếu trang của bạn có lỗi đăng nhập hoặc phiên bị mất, bạn có thể nhờ AI dùng skill cookie-debugging để tìm vấn đề về cookie, phiên và xác thực. Với người khiếm thị hay dùng trình đọc màn hình, skill a11y-debugging giúp kiểm tra và sửa các vấn đề truy cập. Bạn chỉ cần nói rõ mục tiêu bằng tiếng thường, ví dụ "kiểm tra khả năng truy cập của trang này và sửa các lỗi tìm thấy".
VI.Lỗi hay gặp và cách xử lý
A.AI không thấy công cụ của chrome-devtools
Thường do cấu hình MCP đặt sai chỗ hoặc chưa khởi động lại phần mềm AI. Hãy mở docs/client-configurations.md trong repo, làm đúng theo phần mềm của bạn, rồi khởi động lại. Repo còn có skill troubleshooting và file docs/troubleshooting.md cho lỗi kết nối giữa MCP và Chrome.
B.Báo lỗi phiên bản Node.js
Nếu Node quá cũ, gói có thể không chạy. package.json yêu cầu Node ^20.19.0 || ^22.12.0 || >=23. Chạy node -v để xem phiên bản và cài lại bản LTS nếu cần.
C.Chrome không mở khi vừa thêm cấu hình
Đây không phải lỗi. Trình duyệt chỉ mở khi AI gọi công cụ cần trình duyệt. Hãy gõ thử câu lệnh kiểm tra ở phần trên.
D.Skill cũ làm AI gọi sai tham số
Skill mô tả công cụ của một phiên bản cụ thể. Sau khi cập nhật MCP server hoặc CLI, hãy cập nhật skill: dùng lệnh cập nhật của trình quản lý plugin, hoặc cài lại gói và chép lại thư mục skill như ở bước cài thủ công.
E.Dùng trình duyệt không phải Chrome
Các trình duyệt nền Chromium khác có thể chạy nhưng README nói rõ không được đảm bảo. Nếu gặp hành vi lạ, hãy thử lại với Google Chrome hoặc Chrome for Testing. Nếu cần trỏ tới trình duyệt khác, README nhắc tới tuỳ chọn --executablePath trong docs/advanced-usage.md.
VII.Có nên dùng không
Điểm mạnh: công cụ do chính đội Chrome DevTools làm, cài nhanh bằng một đoạn JSON, dùng Chrome thật nên số liệu đáng tin, có cả CLI lẫn bộ skill, và có giấy phép Apache-2.0. Nếu bạn đang nhờ AI viết hoặc sửa web, nó là một bổ sung rất hợp lý.
Giới hạn cần biết:
- AI có thể xem và sửa dữ liệu trong trình duyệt được điều khiển, nên đừng dùng với các trang chứa thông tin nhạy cảm.
- Công cụ đo hiệu năng có thể gửi URL của trace tới Google CrUX API để lấy dữ liệu trải nghiệm người dùng thật. Muốn tắt, chạy với cờ
--no-performance-crux. - 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; việc thu thập cũng tắt khi đặt biếnCHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICShoặcCI. - Server tự kiểm tra bản cập nhật trên npm; tắt bằng biến môi trường
CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS. - Chỉ chính thức hỗ trợ Google Chrome và Chrome for Testing.
Nếu bạn chỉ cần chụp một tấm ảnh trang web vài lần, tự làm bằng tay có thể nhanh hơn. Còn nếu bạn thường xuyên nhờ AI gỡ lỗi, đo tốc độ hay tự động hoá thao tác trên web, đây là công cụ đáng cài. Với trường hợp nâng cao như chạy nhiều phiên, kết nối vào Chrome đang mở sẵn hoặc gỡ lỗi trên Android, hãy xem docs/advanced-usage.md; danh sách tham số như --headless, --isolated, --slim nằm trong docs/configuration.md.
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 đến phí sử dụng. Tuy nhiên chi phí của phần mềm AI bạn dùng cùng nó (Claude, Cursor, Copilot…) thì tuỳ từng nhà cung cấp; tư liệu chưa có thông tin về việc này.
Có cần GPU hoặc API key riêng không?
README không yêu cầu GPU và không nhắc đến API key riêng cho chrome-devtools-mcp. Yêu cầu được ghi là Node.js bản LTS, Chrome bản stable hiện tại hoặc mới hơn, và npm.
Chạy trên Windows được không?
README không nêu hạn chế về hệ điều hành. Các lệnh mẫu cài skill thủ công dùng cú pháp bash, nên trên Windows bạn có thể dùng Git Bash hoặc WSL, hoặc chọn cách cài plugin. Tư liệu chưa nói rõ thêm về Windows.
Dữ liệu trong trình duyệt của tôi có an toàn không?
README cảnh báo công cụ cho phép client MCP xem, gỡ lỗi và sửa mọi dữ liệu trong trình duyệt hoặc DevTools. Vì vậy đừng để lộ thông tin cá nhân hay nhạy cảm cho AI. Ngoài ra có thống kê sử dụng (bật mặc định, tắt bằng --no-usage-statistics) và 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 trình duyệt Edge hay Brave không?
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 và có thể gặp hành vi bất ngờ, bạn tự cân nhắc khi dùng.
Cách khác nhau giữa dùng MCP và dùng CLI là gì?
Dạng MCP cho trợ lý AI tự gọi công cụ trong cuộc trò chuyện. Dạng CLI là lệnh chrome-devtools để bạn tự điều khiển trình duyệt từ terminal hoặc viết script mà không cần MCP. Danh sách đầy đủ lệnh nằm trong docs/cli.md của repo.
Làm sao để tắt kiểm tra cập nhật tự động?
Đặt biến môi trường CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS. Theo README, mặc định server định kỳ kiểm tra npm và ghi thông báo khi có bản mới.


