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

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

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.

```repo
- repo | ChromeDevTools/chrome-devtools-mcp
- kind | MCP server
- desc | 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.
- stars | 55k
- lang | TypeScript
- license | Apache-2.0
```

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

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

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

- **Node.js bản LTS.** Cụ thể `package.json` yê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 đó.

```note
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.
```

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

```steps
- 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 MCP | Dán đoạn JSON vào ứng dụng AI của bạn
- Chạy thử câu lệnh đầu tiên | Nhờ AI đo hiệu năng một trang web
- (Tuỳ chọn) Cài plugin và skill | Dạ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
```

### 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:

```bash
node -v
npm -v
```

Nế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.

### 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:

```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ỗ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.

### 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.com
```

Bạ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ì.

### (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-plugins
```

Vớ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:

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

Nế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 đó:

```bash
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.

### (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:

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

Sau đó 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.

## 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:

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

Thấ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`).

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

### 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

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

### 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:

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

Kế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.

### 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ò.

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

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

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

### 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ù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.

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

## 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ường `CHROME_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.
