GTmetrix MCP
chính thứcGTmetrix 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)
- 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.
- Đặt tên là
GTmetrixvà đặt URL thànhhttps://gtmetrix.com/mcp. - 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_test | Bắ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_test | Kiể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_report | Lấ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_har | Trả 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_pages | Liệ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_history | Lấ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_monitoring | Bậ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_events | Liệ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_tags | Liệt kê các thẻ của bạn và số trang sử dụng từng thẻ. |
gtmetrix_save_page_tag | Tạo thẻ hoặc đổi tên/đổi màu thẻ hiện có. |
gtmetrix_update_page_tags | Gắn hoặc gỡ thẻ trên tối đa 500 trang cùng lúc. |
gtmetrix_delete_page_tag | Xó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_status | Hiể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_catalog | Tra 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-guidegtmetrix://docs/report-analysis-guidegtmetrix://docs/har-analysis-guidegtmetrix://docs/general-test-error-guidegtmetrix://docs/lighthouse-error-guidegtmetrix://catalog/browsersgtmetrix://catalog/locationsgtmetrix://catalog/simulated-devicesgtmetrix://catalog/throttle-connectionsgtmetrix://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.
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ả.