# chrome-devtools-mcp: cho AI điều khiển Chrome thật để debug và đo tốc độ — hướng dẫn cài đặt và dùng

> chrome-devtools-mcp là MCP server (kèm 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ó để AI tự debug lỗi, xem request mạng, chụp màn hình và đo hiệu năng trang web. Cài khá dễ: cần Node.js, Chrome và dán một đoạn cấu hình JSON vào công cụ AI của bạn.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-06-22 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/chrome-devtools-mcp-ai-dieu-khien-chrome-debug-do-toc-do

Chrome DevTools MCP (`chrome-devtools-mcp`) là công cụ cho trợ lý AI viết code của bạn, như Claude, Cursor, Copilot hay Antigravity, tự điều khiển và soi một trình duyệt Chrome thật. Nó chạy như một MCP server, và cũng có sẵn bản dòng lệnh (CLI) để dùng ngay từ terminal. Nhờ nó, AI không còn phải "đoán mò" trang web của bạn đang chạy ra sao. AI tự mở trang, bấm thử, đọc lỗi và đo tốc độ.

Ai nên dùng? Lập trình viên mới muốn nhờ AI tìm lỗi giao diện. Người làm web cho cửa hàng hay công ty muốn biết vì sao trang tải chậm. Cả người không chuyên code nhưng đang dùng một công cụ AI hỗ trợ MCP cũng làm theo được. Repo do chính nhóm Chrome DevTools đứng tên, giấy phép Apache-2.0, hiện có khoảng 55.187 sao và 4.604 fork, và vẫn được cập nhật trong 3 tháng gần đây.

Điểm đáng giá nhất: bạn chỉ cần gõ một câu tiếng thường, ví dụ "kiểm tra hiệu năng trang này", rồi AI tự mở Chrome, ghi lại bản đo (trace) và đưa ra gợi ý cải thiện. Trong bài này mình hướng dẫn từ cài đặt đến vài tình huống dùng thật, kèm những lỗi bạn dễ gặp.

```repo
- repo | ChromeDevTools/chrome-devtools-mcp
- kind | MCP server
- desc | MCP server và CLI của đội Chrome DevTools, cho trợ lý AI tự mở Chrome thật để bấm thử, xem lỗi, chụp màn hình và đo hiệu năng trang web.
- stars | 55k
- lang | TypeScript
- license | Apache-2.0
```

## Chrome DevTools MCP làm được gì

Công cụ gom ba nhóm việc chính, đều dựa trên những thứ dân web vẫn dùng hằng ngày.

### Đo hiệu năng và rút ra gợi ý

Nó dùng Chrome DevTools để ghi trace (bản ghi quá trình tải và chạy trang), rồi trích ra những nhận định có thể hành động được. Bạn không cần tự đọc biểu đồ phức tạp. AI đọc giúp và nói thẳng chỗ nào đang chậm.

Ngoài ra, công cụ đo hiệu năng có thể gửi URL của trang tới Google CrUX API để lấy dữ liệu trải nghiệm người dùng thật. Số liệu này được đặt cạnh số đo trong phòng thí nghiệm để bạn có bức tranh đầy đủ hơn. Nếu không muốn, bạn tắt bằng cờ `--no-performance-crux`.

### Soi lỗi trình duyệt

AI có thể xem 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ó kèm source map, nghĩa là lỗi trỏ về đúng dòng code gốc của bạn thay vì file đã nén khó đọc.

### Tự động hoá thao tác trong Chrome

Phía dưới dùng thư viện puppeteer để bấm, gõ, chuyển trang trong Chrome, và tự chờ kết quả của mỗi thao tác. Nhờ vậy các bước ít bị lỗi do bấm quá sớm khi trang chưa tải xong.

### Bộ skill đi kèm

Gói còn có các skill, tức là phần hướng dẫn dạy AI cách dùng công cụ cho đúng:

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

Cuối cùng là cờ `--slim`: nếu bạn chỉ cần thao tác trình duyệt cơ bản, cờ này mở ra một bộ công cụ rút gọn.

## Cần chuẩn bị gì

Theo README, bạn cần:

- [Node.js](https://nodejs.org/) bản LTS. File `package.json` ghi rõ yêu cầu Node `^20.19.0 || ^22.12.0 || >=23`, nên Node quá cũ sẽ không chạy.
- Trình duyệt Chrome bản stable hiện tại hoặc mới hơn.
- npm (thường đi kèm Node.js).
- Một công cụ AI hỗ trợ MCP, ví dụ Claude Code, Cursor, VS Code (Copilot) hay Antigravity.

README không đòi tài khoản riêng, API key hay card đồ hoạ cho chính công cụ này. Phần hệ điều hành README cũng chưa nêu cụ thể. Chrome chính thức được hỗ trợ là 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.

```note
Công cụ cho AI quyền xem và sửa mọi dữ liệu trong trình duyệt mà nó điều khiển. Đừng mở trang chứa thông tin cá nhân hay dữ liệu nhạy cảm mà bạn không muốn chia sẻ với công cụ AI của mình.
```

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

```steps
- Kiểm tra Node và Chrome | Chắc chắn máy có Node.js đủ mới, npm và Chrome bản stable
- Thêm cấu hình MCP | Dán đoạn JSON vào phần cấu hình MCP của công cụ AI
- Chạy câu lệnh đầu tiên | Gõ prompt thử để AI mở Chrome và đo một trang
- Cài CLI (tuỳ chọn) | Cài gói toàn cục để điều khiển Chrome từ terminal
- Cài skill hoặc plugin (tuỳ chọn) | Dạy AI dùng công cụ đúng cách
```

### Kiểm tra Node.js và Chrome

Mở terminal (PowerShell hoặc Command Prompt trên Windows, Terminal trên macOS) và xem bạn đã có Node chưa. Hai lệnh dưới đây là lệnh phổ thông để xem phiên bản:

```bash
node --version
npm --version
```

Nếu máy báo không tìm thấy lệnh, bạn cần cài Node.js bản LTS từ trang nodejs.org trước. Nếu số phiên bản thấp hơn mức `package.json` yêu cầu (ví dụ Node 18), hãy nâng cấp lên bản LTS mới.

### Thêm cấu hình vào công cụ AI

Đây là bước chính. Bạn thêm đoạn cấu hình sau vào phần MCP của công cụ AI đang dùng:

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

Đoạn này bảo công cụ AI chạy `npx` để tải và khởi động `chrome-devtools-mcp` mỗi khi cần. Phần `@latest` đảm bảo luôn dùng bản mới nhất. Cờ `-y` cho npx tự đồng ý tải gói, khỏi phải bấm xác nhận.

Chỗ người mới hay vấp: mỗi công cụ (Claude Code, Cursor, VS Code, Antigravity) để file cấu hình MCP ở một nơi khác nhau. README không liệt kê hết ở trang chính mà chỉ sang file `docs/client-configurations.md` trong repo. Bạn mở file đó để xem đúng chỗ dán cho công cụ của mình.

Nếu bạn muốn tắt thu thập thống kê sử dụng, README cho phép thêm cờ vào `args`:

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

Mặc định, Google thu thập thống kê sử dụng như tỷ lệ gọi công cụ thành công, độ trễ và thông tin môi trường. Việc thu thập này sẽ tự tắt nếu có biến môi trường `CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS` hoặc `CI`. Ngoài ra server định kỳ kiểm tra bản cập nhật trên npm, và bạn tắt việc đó bằng biến `CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS`.

### Chạy câu lệnh đầu tiên

Mở lại công cụ AI (hoặc làm mới danh sách MCP của nó) rồi gõ prompt mẫu của README:

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

Bạn có thể viết bằng tiếng Việt cũng được, miễn là nói rõ trang cần đo. Lưu ý: trình duyệt không mở ngay khi bạn vừa kết nối MCP. Chrome chỉ khởi động khi AI dùng một công cụ thật sự cần trình duyệt.

### Cài CLI (tuỳ chọn)

Gói còn có lệnh `chrome-devtools`, để điều khiển trình duyệt từ terminal mà không cần MCP. Cài toàn cục bằng npm:

```sh
npm i chrome-devtools-mcp@latest -g
```

Sau đó thử các lệnh trong README:

```sh
chrome-devtools navigate_page 1 --url "https://developers.chrome.com"
chrome-devtools take_screenshot 1 --filePath screenshot.png
chrome-devtools stop
```

Ba lệnh trên lần lượt mở một trang, chụp màn hình lưu thành `screenshot.png`, rồi dừng công cụ. Danh sách đầy đủ lệnh và tuỳ chọn nằm trong `docs/cli.md`.

### Cài skill hoặc plugin (tuỳ chọn)

Cách nhanh nhất là cài dạng plugin, vì nó cài luôn MCP server và toàn bộ skill. Theo README:

- Claude Code: chạy `/plugin marketplace add ChromeDevTools/chrome-devtools-mcp`, rồi `/plugin install chrome-devtools-mcp@chrome-devtools-plugins`.
- Copilot / VS Code: chạy **Chat: Install Plugin From Source** và nhập `ChromeDevTools/chrome-devtools-mcp`.
- Gemini CLI: chạy lệnh dưới đây.

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

Nếu công cụ AI của bạn không hỗ trợ plugin, bạn chép thủ công thư mục skill từ gói npm. Ví dụ dưới đây dành cho Claude Code; công cụ khác thì dùng thư mục skills của nó:

```sh
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 viết theo kiểu Linux/macOS, README không có bản riêng cho Windows. Skill `chrome-devtools-cli` cần có CLI, nên bạn phải cài gói toàn cục trước khi dùng.

Một điều quan trọng: skill mô tả công cụ của một phiên bản cụ thể. Mỗi lần bạn cập nhật MCP server hoặc CLI, hãy cập nhật skill luôn, vì skill cũ có thể bảo AI dùng công cụ hay tham số đã đổi. 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` rồi chép lại thư mục skill.

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

Cách kiểm tra theo README rất đơn giản. Gõ vào công cụ AI câu sau:

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

Nếu mọi thứ ổn, công cụ AI sẽ mở trình duyệt Chrome và ghi lại một performance trace. Bạn thấy cửa sổ Chrome hiện lên, trang được tải, rồi AI trả lời kết quả đo.

Với CLI, bạn chạy lệnh `chrome-devtools take_screenshot 1 --filePath screenshot.png` (sau khi đã mở trang bằng `navigate_page`). Thành công khi có file `screenshot.png` trong thư mục hiện tại.

Nếu chưa thấy gì, nhớ rằng Chrome chỉ mở khi AI cần dùng nó. Hãy chắc chắn prompt của bạn thực sự yêu cầu thao tác trên trình duyệt.

## 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 của công cụ. Các prompt chỉ là ví dụ, bạn sửa lại theo trang của mình.

### Chủ shop muốn biết vì sao trang bán hàng chậm

Bạn có một website bán hàng và khách phàn nàn tải lâu. Bạn nhờ lập trình viên hoặc chính công cụ AI của mình chạy một câu như:

```
Check the performance of https://ten-shop-cua-ban.example
```

AI mở Chrome, ghi trace và trả về những điểm đáng chú ý. Nếu muốn đi sâu vào một chỉ số cụ thể, bạn nhờ AI dùng skill `debug-optimize-lcp` để tìm cách cải thiện Largest Contentful Paint, tức thời gian hiện nội dung chính của trang. Kết quả là một danh sách việc cần sửa, thay vì một biểu đồ khó hiểu.

> Đưa cho AI một trình duyệt thật, nó sẽ ngừng đoán và bắt đầu kiểm chứng.
>
> — Ông T

### Lập trình viên mới debug lỗi giao diện

Bạn vừa sửa code mà nút "Thanh toán" không phản hồi. Thay vì mở DevTools rồi dò từng tab, bạn nhờ AI mở trang, bấm thử nút, đọc thông báo trong console và xem request mạng nào thất bại. Vì stack trace có source map, lỗi trỏ về dòng code gốc của bạn. Bạn nhận về nguyên nhân khả dĩ cùng vị trí cần sửa, và có thể nhờ AI chụp màn hình trước/sau để so sánh.

### Nhân viên văn phòng chụp màn hình hàng loạt bằng CLI

Bạn cần chụp ảnh vài trang nội bộ để đưa vào báo cáo. Với CLI, bạn viết một script nhỏ gọi lần lượt lệnh mở trang rồi chụp:

```sh
chrome-devtools navigate_page 1 --url "https://developers.chrome.com"
chrome-devtools take_screenshot 1 --filePath screenshot.png
chrome-devtools stop
```

Đổi URL và tên file cho từng trang. Skill `chrome-devtools-cli` giúp AI viết các script kiểu này cho bạn. Kết quả là các file ảnh nằm sẵn trong thư mục, không phải chụp tay từng trang.

### Kiểm tra trợ năng và lỗi đăng nhập

Nếu bạn làm web cho khách hàng, có hai skill hữu ích. `a11y-debugging` giúp AI kiểm tra và đề xuất cách sửa các lỗi trợ năng. `cookie-debugging` giúp xử lý cookie, phiên đăng nhập và xác thực, hợp khi người dùng cứ bị đăng xuất bất thường. Bạn chỉ cần mô tả triệu chứng, AI sẽ dùng skill tương ứng để kiểm tra trên trình duyệt thật.

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

### Máy báo không tìm thấy npx hoặc node

Nguyên nhân thường là chưa cài Node.js. Cài bản LTS từ nodejs.org, đóng rồi mở lại terminal và công cụ AI, sau đó thử lại. Nếu đã có Node mà vẫn lỗi, kiểm tra phiên bản có đáp ứng yêu cầu `^20.19.0 || ^22.12.0 || >=23` hay không.

### Đã dán cấu hình nhưng công cụ AI không thấy MCP

Thường do dán sai chỗ hoặc JSON sai cú pháp (thiếu dấu phẩy, thừa ngoặc). Mỗi công cụ có nơi cấu hình riêng, nên hãy đối chiếu với `docs/client-configurations.md`. Sau khi sửa, khởi động lại công cụ AI.

### Gõ prompt rồi mà Chrome không mở

Hành vi này là bình thường nếu AI chưa gọi công cụ cần trình duyệt. README nói rõ server chỉ mở Chrome khi có công cụ cần đến. Hãy yêu cầu một việc cụ thể như đo hiệu năng một URL. Nếu vẫn không mở, nhờ AI dùng skill `troubleshooting` hoặc xem `docs/troubleshooting.md`, vốn dành cho lỗi kết nối giữa MCP và Chrome.

### AI dùng công cụ hoặc tham số không tồn tại

Đây là dấu hiệu skill đã cũ so với phiên bản MCP hoặc CLI bạn đang chạy. README cảnh báo skill cũ có thể chỉ AI dùng tham số đã đổi. Cập nhật gói, rồi cập nhật lại skill (bằng lệnh của plugin hoặc chép lại thư mục như ở trên).

### Trình duyệt khác Chrome chạy lạ

README 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 đảm bảo. Nếu gặp hành vi lạ, hãy thử lại với Chrome bản stable.

## Có nên dùng không

Điểm mạnh: công cụ do chính nhóm Chrome DevTools làm, bám sát những gì dân web quen dùng, từ trace hiệu năng, console có source map đến request mạng. Cài đặt chủ yếu là dán một đoạn JSON. Có cả MCP lẫn CLI nên bạn chọn được cách dùng phù hợp, và có bộ skill sẵn cho các việc hay gặp như LCP, rò rỉ bộ nhớ, cookie, trợ năng.

Giới hạn bạn nên biết: AI nhìn và sửa được mọi dữ liệu trong trình duyệt nó điều khiển, nên cần cẩn thận với trang có thông tin nhạy cảm. Mặc định có thu thập thống kê sử dụng và có thể gửi URL tới CrUX API khi đo hiệu năng, dù bạn tắt được bằng `--no-usage-statistics` và `--no-performance-crux`. Chính thức chỉ hỗ trợ Chrome. Công cụ cũng cần một client AI hỗ trợ MCP, nên nếu bạn không dùng công cụ AI nào như vậy thì chưa tận dụng được hết.

Khi nào chọn cách khác? Nếu bạn chỉ cần xem nhanh một trang một lần, mở DevTools có sẵn trong Chrome vẫn nhanh hơn. Còn nếu bạn hay phải kiểm tra, debug hoặc đo trang lặp đi lặp lại và đã quen làm việc với trợ lý AI, đây là công cụ rất đáng thử. Bạn có thể bắt đầu bằng đúng một câu prompt kiểm tra hiệu năng để xem nó hợp với mình 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í sử dụng. Bạn vẫn có thể phát sinh chi phí từ công cụ AI mà bạn dùng cùng nó, nhưng tư liệu của repo chưa có thông tin về phần này.

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

README không yêu cầu GPU hay phần cứng riêng. Bạn chỉ cần Node.js bản LTS, npm và Chrome bản stable trở lên.

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

README không nêu rõ hệ điều hành được hỗ trợ. Cấu hình MCP dùng `npx` nên về nguyên tắc chạy được ở nơi có Node.js. Riêng các lệnh chép skill thủ công trong README viết theo kiểu Linux/macOS, và README chưa có bản cho Windows.

### Dữ liệu của tôi có an toàn không?

README cảnh báo công cụ cho client MCP xem và sửa mọi dữ liệu trong trình duyệt, nên đừng để lộ thông tin nhạy cảm. Mặc định Google thu thập thống kê sử dụng, tắt được bằng `--no-usage-statistics`. Công cụ đo hiệu năng có thể gửi URL trace tới Google CrUX API, tắt được bằng `--no-performance-crux`.

### Có dùng được với trình duyệt khác ngoài Chrome không?

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

### Nó khác gì việc tự mở DevTools trong Chrome?

DevTools bạn tự thao tác bằng tay, còn công cụ này cho trợ lý AI dùng sức mạnh của DevTools để tự ghi trace, đọc console, xem request mạng và chụp màn hình. README cũng nói nó dùng puppeteer để tự động hoá thao tác và tự chờ kết quả. Tư liệu không so sánh trực tiếp với công cụ khác.

### Tôi có dùng được mà không cần MCP không?

Được. Gói có sẵn lệnh `chrome-devtools` để điều khiển trình duyệt từ terminal mà không cần MCP, cài bằng `npm i chrome-devtools-mcp@latest -g`. Danh sách lệnh đầy đủ nằm trong `docs/cli.md` của repo.
