GTmetrix MCP

chính thức

GTmetrix MCP chính thức: chạy kiểm tra hiệu suất trang thực tế, đọc báo cáo, theo dõi lịch sử và quản lý giám sát từ công cụ AI của bạn. Có quyền truy cập dành cho khách; cần OAuth hoặc API key để sử dụng đầy đủ tính năng.

Bạn có thể làm gì với GTmetrix MCP?

  • Chạy kiểm tra hiệu suất — Yêu cầu trợ lý kiểm tra một URL từ vị trí, trình duyệt, thiết bị và cấu hình giới hạn tốc độ đã chọn, sau đó trả về báo cáo.
  • Phân tích báo cáo — Xem điểm GTmetrix, Core Web Vitals và các vấn đề hàng đầu của Lighthouse, kèm liên kết tải xuống HAR và JSON của Lighthouse.
  • Theo dõi lịch sử và các hồi quy — Liệt kê các trang của bạn cùng điểm số mới nhất và lấy mọi báo cáo của một trang để so sánh xu hướng theo thời gian.
  • Quản lý giám sát và cảnh báo — Bật hoặc tắt tính năng giám sát và đặt điều kiện cảnh báo về điểm số, thời gian, kích thước trang, số lượng yêu cầu hoặc CLS.
  • Sắp xếp trang bằng thẻ — Tạo, đổi tên, gắn hoặc xóa thẻ trên tối đa 500 trang cùng lúc.
  • Kiểm tra tài khoản và danh mục — Xem số tín dụng còn lại và tra cứu các vị trí, trình duyệt, thiết bị và cấu hình giới hạn tốc độ hiện có.

Máy chủ MCP được lưu trữ

npx add-mcp 'https://gtmetrix.com/mcp'

Cài vào Claude Code, Codex, Cursor và nhiều công cụ khác

Tài liệu

GTmetrix MCP

Máy chủ GTmetrix MCP chính thức kết nối công cụ AI của bạn với GTmetrix để công cụ có thể chạy các bài kiểm tra hiệu suất trang thực tế, đọc báo cáo, theo dõi lịch sử và quản lý hoạt động giám sát chỉ bằng một câu lệnh.

Không cần tài khoản GTmetrix để dùng thử. Kết nối với tư cách khách và bắt đầu kiểm tra ngay. Đăng nhập để mở khóa thêm lượt kiểm tra và tính năng.

  • URL máy chủ: https://gtmetrix.com/mcp
  • Giao thức truyền tải: Streamable HTTP (từ xa, không cần cài đặt)
  • Xác thực: Khách (không cần đăng nhập), OAuth hoặc khóa API qua tiêu đề Authorization: Bearer
  • Tương thích với: Claude, ChatGPT, Codex, Cursor, GitHub Copilot CLI và mọi ứng dụng khách tương thích với MCP

Bắt đầu nhanh

Tùy chọn 1: OAuth (khuyên dùng)

  1. Thêm máy chủ MCP từ xa / trình kết nối tùy chỉnh mới trong công cụ AI của bạn.
  2. Đặt tên là GTmetrix và đặt URL thành https://gtmetrix.com/mcp.
  3. Nhấp vào Connect / Authenticate.

Không cần khóa API. Bạn cũng có thể sao chép URL MCP từ mục MCP Setup trên trang Tài khoản GTmetrix.

Sử dụng với tư cách khách

Bạn không cần tài khoản GTmetrix để bắt đầu. Với tư cách khách, bạn có thể chạy kiểm tra, đọc báo cáo và tra cứu vị trí, trình duyệt và thiết bị bằng số tín dụng khách có giới hạn.

Khi hết tín dụng khách hoặc muốn dùng các tính năng gắn với tài khoản (lịch sử trang, giám sát, cảnh báo, thẻ), hãy yêu cầu AI đăng nhập cho bạn. AI sẽ gọi gtmetrix_reauthenticate, sau đó bạn sẽ nhận được trang đăng nhập để đăng nhập hoặc tạo tài khoản miễn phí.

Tùy chọn 2: Khóa API

Tạo khóa API trên trang Tài khoản GTmetrix, sau đó thêm khóa vào cấu hình ứng dụng khách.

Claude Code

claude mcp add gtmetrix https://gtmetrix.com/mcp --transport http --header "Authorization: Bearer YOUR_API_KEY"

Codex (config.toml)

[mcp_servers.gtmetrix]
url = "https://gtmetrix.com/mcp"

[mcp_servers.gtmetrix.http_headers]
Authorization = "Bearer YOUR_API_KEY"

Cấu hình JSON (Cursor và các ứng dụng khách khác hỗ trợ máy chủ HTTP từ xa)

{
  "mcpServers": {
    "gtmetrix": {
      "url": "https://gtmetrix.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

GitHub Copilot CLI (chỉ OAuth)

/mcp add GTmetrix

Đặt Server Type thành HTTP, URL thành https://gtmetrix.com/mcp, Tools thành *, lưu lại, sau đó xác thực trong trình duyệt.

Hướng dẫn từng bước: Claude · ChatGPT · Codex · Cursor · Copilot CLI


Ví dụ câu lệnh

  • "Kiểm tra example.com từ London và Sydney trên iPhone qua LTE rồi cho tôi biết hiệu suất có tương đương không."
  • "Phân tích báo cáo mới nhất của tôi cho example.com và giải thích 3 vấn đề hàng đầu bằng ngôn ngữ dễ hiểu."
  • "Kiểm tra tình trạng tất cả các trang tôi đang giám sát có gắn thẻ 'client'. Đánh dấu mọi trang có điểm dưới B hoặc LCP trên 2 giây."
  • "So sánh các báo cáo tuần này của trang thanh toán với tháng trước. Có gì bị giảm hiệu suất không?"
  • "Thiết lập giám sát hằng ngày cho trang chủ và cảnh báo tôi nếu LCP vượt quá 2,5 giây."
  • "Khắc phục JavaScript chặn hiển thị trên trang web của tôi, sau đó chạy lại GTmetrix và xác nhận hiệu suất đã cải thiện."

Công cụ

Khách có thể sử dụng các công cụ Kiểm tra (ngoại trừ gtmetrix_get_report_har) và các công cụ Tài khoản và tham khảo. Các công cụ còn lại yêu cầu tài khoản GTmetrix.

Kiểm tra

Công cụChức năng
gtmetrix_start_testBắt đầu kiểm tra một URL. Hỗ trợ vị trí, trình duyệt, thiết bị mô phỏng, giới hạn tốc độ kết nối, AdBlock, video, cookie, xác thực HTTP, danh sách URL cho phép/chặn, kích thước khung nhìn và thời hạn lưu báo cáo (1, 6, 12 hoặc 24 tháng).
gtmetrix_get_testKiểm tra trạng thái của bài kiểm tra đang chạy. Chờ lâu ở phía máy chủ (tối đa 30 giây mỗi lần gọi) và trả về ID báo cáo khi hoàn tất.
gtmetrix_get_reportLấy báo cáo đã hoàn tất: điểm GTmetrix, điểm Performance và Structure, Core Web Vitals (LCP, TBT, CLS), 5 vấn đề Lighthouse hàng đầu được xếp hạng theo mức độ ảnh hưởng, bản tóm tắt tài nguyên và liên kết tải xuống HAR cùng JSON Lighthouse đầy đủ.
gtmetrix_get_report_harTrả về biểu đồ thác nước HAR trực tiếp trong nội dung, dành cho các ứng dụng khách không thể tải trực tiếp URL HAR. Mặc định có giới hạn kích thước.

Lịch sử và trang

Công cụChức năng
gtmetrix_list_pagesLiệt kê các trang của bạn (URL + cài đặt kiểm tra) cùng điểm số mới nhất, Web Vitals, trạng thái giám sát và thẻ. Lọc theo URL, vị trí, trình duyệt, thiết bị, giới hạn tốc độ, tần suất giám sát, thẻ và nhiều tiêu chí khác.
gtmetrix_get_report_historyLấy mọi báo cáo của một trang, theo thứ tự mới nhất trước, để phân tích xu hướng và suy giảm hiệu suất.

Giám sát và cảnh báo

Công cụChức năng
gtmetrix_set_page_monitoringBật (theo giờ, ngày, tuần, tháng) hoặc tắt tính năng giám sát cho một trang.
gtmetrix_get_page_alert_conditionsĐọc các điều kiện cảnh báo của một trang.
gtmetrix_set_page_alert_conditionsĐặt điều kiện cảnh báo cho điểm số, thời gian (LCP, TTFB, TBT, v.v.), kích thước trang, số yêu cầu hoặc CLS.
gtmetrix_get_page_alert_eventsLiệt kê các cảnh báo đã được kích hoạt cho một trang, kèm liên kết đến các báo cáo liên quan.

Thẻ

Công cụChức năng
gtmetrix_list_page_tagsLiệt kê các thẻ của bạn và số trang sử dụng từng thẻ.
gtmetrix_save_page_tagTạo thẻ hoặc đổi tên/đổi màu thẻ hiện có.
gtmetrix_update_page_tagsGắn hoặc gỡ thẻ trên tối đa 500 trang cùng lúc.
gtmetrix_delete_page_tagXóa vĩnh viễn một thẻ.

Tài khoản và tham khảo

Công cụChức năng
gtmetrix_get_account_statusHiển thị gói dịch vụ, số tín dụng API còn lại và ngày nạp tiếp theo (khách sẽ thấy số tín dụng khách còn lại).
gtmetrix_get_catalogTra cứu các trình duyệt, vị trí, thiết bị mô phỏng, cấu hình giới hạn tốc độ và kiểm tra Lighthouse hiện có.
gtmetrix_get_guideĐọc các hướng dẫn tích hợp về tùy chọn kiểm tra, phân tích báo cáo, phân tích HAR và lỗi kiểm tra.
gtmetrix_reauthenticateĐăng nhập từ kết nối khách hoặc chuyển sang tài khoản GTmetrix khác.

Tài nguyên

Máy chủ cũng cung cấp các hướng dẫn và danh mục dưới dạng tài nguyên MCP:

  • gtmetrix://docs/test-options-guide
  • gtmetrix://docs/report-analysis-guide
  • gtmetrix://docs/har-analysis-guide
  • gtmetrix://docs/general-test-error-guide
  • gtmetrix://docs/lighthouse-error-guide
  • gtmetrix://catalog/browsers
  • gtmetrix://catalog/locations
  • gtmetrix://catalog/simulated-devices
  • gtmetrix://catalog/throttle-connections
  • gtmetrix://catalog/lighthouse-audits

Tín dụng và giới hạn

  • Mọi người đều có thể sử dụng MCP. Khách nhận được số tín dụng có giới hạn; tài khoản GTmetrix cung cấp nhiều tín dụng hơn.
  • Các bài kiểm tra và hành động khác sử dụng tín dụng API theo cùng mức với GTmetrix API. Ghi video tốn thêm 0.9 tín dụng cho mỗi bài kiểm tra.
  • Hạn mức tín dụng tùy thuộc vào gói dịch vụ. Một số gói PRO được nạp tín dụng hằng ngày. Yêu cầu AI chạy gtmetrix_get_account_status để xem số dư.
  • Số bài kiểm tra đồng thời: 2 trên Basic, 8 trên PRO.
  • Một số tính năng (nhiều vị trí hơn, giám sát theo giờ, video trong cảnh báo) tùy thuộc vào gói dịch vụ của bạn.

Xem các gói GTmetrix PRO


Câu hỏi thường gặp

Đây có phải là chatbot không? Không. Đây là lớp kết nối giúp công cụ AI bạn đang dùng truy cập GTmetrix.

Tôi có cần tài khoản GTmetrix không? Không. Bạn có thể kết nối với tư cách khách và chạy kiểm tra ngay. Đăng nhập để mở khóa thêm lượt kiểm tra và tính năng.

Tôi có cần khóa API không? Chỉ khi cấu hình thủ công. Kết nối OAuth không cần khóa API.

Tại sao kết quả không được hiển thị dưới dạng biểu đồ? Việc hiển thị phụ thuộc vào công cụ AI của bạn. Sau khi nhận báo cáo, hãy yêu cầu công cụ "trực quan hóa dữ liệu này".

Công cụ có thể tự khắc phục vấn đề cho tôi không? GTmetrix cung cấp dữ liệu và chẩn đoán. Nếu công cụ AI của bạn cũng có thể chỉnh sửa mã hoặc CMS, công cụ có thể áp dụng các bản sửa lỗi rồi chạy lại bài kiểm tra để xác nhận kết quả.


Liên kết