# 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

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

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

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

```repo
- repo | ChromeDevTools/chrome-devtools-mcp
- kind | MCP server
- desc | 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.
- 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.

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

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

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

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

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

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

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

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

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

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

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

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

```bash
/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**:

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

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

```sh
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ụ.

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

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

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

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

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

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

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

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

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

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

```sh
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ù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.

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

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

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

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

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

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

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

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