Cấu hình

Matthias Rohmer

José Luis Zapata

Bạn có thể định cấu hình Chrome DevTools cho tác nhân để tuỳ chỉnh cách tác nhân tương tác với trình duyệt, những công cụ nào được bật và cách tác nhân xử lý dữ liệu.

Định cấu hình máy chủ bằng cách truyền các cờ dòng lệnh trong mảng args của tệp cấu hình máy khách Giao thức ngữ cảnh mô hình (MCP). Đây thường là tệp config.json.

Ví dụ: để chạy Chrome ở chế độ không có giao diện người dùng và sử dụng kênh Canary, hãy dùng cấu hình sau:

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "chrome-devtools-mcp@latest",
        "--headless",
        "--channel=canary"
      ]
    }
  }
}

Các trường hợp cấu hình phổ biến

Các trường hợp sau đây mô tả những cách phổ biến để định cấu hình Công cụ của Chrome cho nhà phát triển cho các tác nhân.

Chạy ở chế độ không có giao diện người dùng

Để thực hiện các tác vụ ở chế độ nền mà không có cửa sổ trình duyệt hiển thị, hãy chạy Chrome ở chế độ không có giao diện người dùng. Thêm cờ --headless vào đối số máy chủ.

Kết nối với một phiên trình duyệt hiện có

Theo mặc định, Công cụ của Chrome cho nhà phát triển dành cho tác nhân sẽ bắt đầu một phiên bản Chrome mới. Tuy nhiên, bạn có thể kết nối nhân viên hỗ trợ với một phiên trình duyệt hiện có. Điều này rất hữu ích nếu nhân viên hỗ trợ cần điều tra một vấn đề trong phiên mà bạn đã bắt đầu (ví dụ: nếu bạn đã đăng nhập).

Bạn có thể kết nối với một phiên hiện có theo hai cách:

Tự động kết nối (Chrome 144 trở lên)

Nếu bạn sử dụng cờ --autoConnect, máy chủ MCP sẽ tự động kết nối với một phiên bản Chrome đang hoạt động.

1. Trong trình duyệt Chrome đang chạy, hãy chuyển đến chrome://inspect/#remote-debugging và bật tính năng Gỡ lỗi từ xa.
2. Thêm --autoConnect vào cấu hình MCP: json "args": ["chrome-devtools-mcp@latest", "--autoConnect"]
3. Khi tác nhân cố gắng kết nối, Chrome sẽ hiện một hộp thoại yêu cầu bạn cấp quyền. Nhấp vào Cho phép.

Kết nối thủ công

Nếu không thể sử dụng --autoConnect (ví dụ: trong môi trường hộp cát), bạn có thể khởi động Chrome theo cách thủ công bằng cổng gỡ lỗi và kết nối bằng --browser-url.

1. Khởi động Chrome từ thiết bị đầu cuối có bật tính năng gỡ lỗi từ xa và thư mục dữ liệu người dùng tuỳ chỉnh.
   • macOS: shell /Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile-stable
   • Windows: shell start chrome --remote-debugging-port=9222 --user-data-dir=%TEMP%\chrome-profile-stable
   • Linux: shell google-chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile-stable
2. Định cấu hình tác nhân để kết nối với cổng này: json "args": ["chrome-devtools-mcp@latest", "--browser-url=http://127.0.0.1:9222"]

Cho phép truy cập vào tệp bên ngoài thư mục tạm thời

Các công cụ đọc hoặc ghi tệp (ví dụ: lưu ảnh chụp màn hình, dấu vết hoặc tải tiện ích) chỉ có thể truy cập vào các đường dẫn trong thư mục gốc của không gian làm việc đã định cấu hình. Máy chủ sử dụng các gốc mà ứng dụng MCP của bạn cung cấp thông qua chức năng gốc MCP, cộng với mọi thư mục mà bạn truyền bằng --filesystemRoot (bí danh --workspace). Nếu ứng dụng của bạn không cung cấp các gốc và bạn không đặt --filesystemRoot, thì quyền truy cập vào tệp sẽ bị giới hạn ở thư mục tạm thời của hệ điều hành. Các yêu cầu cho những đường dẫn khác sẽ không thành công và gặp lỗi Access denied: ... is not within any of the configured workspace roots.

Để cho phép truy cập vào thư mục dự án, hãy thêm --filesystemRoot vào đối số máy chủ. Bạn có thể lặp lại cờ này để cho phép nhiều thư mục:

"args": ["chrome-devtools-mcp@latest", "--filesystemRoot=/path/to/project"]

Tài liệu tham khảo về các lựa chọn cấu hình

Các phần sau đây liệt kê các cờ cấu hình hiện có. Để biết các lựa chọn và thông tin cập nhật mới nhất, hãy xem kho lưu trữ GitHub của MCP Chrome DevTools.

Các lựa chọn kết nối

Sử dụng các lựa chọn này để định cấu hình cách máy chủ kết nối với Chrome.

Các lựa chọn khởi chạy trình duyệt

Các tuỳ chọn này áp dụng khi máy chủ MCP khởi động Chrome.

Các lựa chọn về bảo mật và quyền riêng tư

Hãy sử dụng các lựa chọn này để quản lý chế độ cài đặt bảo mật và quyền riêng tư đối với dữ liệu.

Danh mục tính năng

Bạn có thể bật hoặc tắt các nhóm công cụ bằng những cờ này.

Lựa chọn chụp ảnh màn hình

Sử dụng các lựa chọn này để tuỳ chỉnh cách tác nhân chụp ảnh màn hình.

Các lựa chọn thử nghiệm

Hãy dùng các lựa chọn này để bật các tính năng thử nghiệm đang trong quá trình phát triển.

Tuỳ chọn khác

Sử dụng các tuỳ chọn này để định cấu hình tính năng ghi nhật ký, định tuyến trang và bản đồ nguồn hoặc để bật một bộ công cụ đơn giản.

Biến môi trường

Bạn cũng có thể sử dụng các biến môi trường sau để định cấu hình máy chủ:

• CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS: Nếu được đặt, tuỳ chọn này sẽ tắt tính năng thu thập số liệu thống kê về việc sử dụng (tương đương với --no-usage-statistics).
• CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS: Nếu được đặt, sẽ tắt các hoạt động kiểm tra định kỳ để tìm bản cập nhật.
• CI: Nếu được đặt, chính sách này sẽ tắt tính năng thu thập số liệu thống kê về việc sử dụng.
• NODE_DEBUG: Đặt thành * để bật tính năng ghi nhật ký gỡ lỗi chi tiết (hoạt động cùng với --logFile).