GTmetrix MCP

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

GTmetrix MCP

공식 GTmetrix MCP 서버는 AI 도구를 GTmetrix에 연결하여 프롬프트만으로 실제 페이지 성능 테스트를 실행하고, 보고서를 읽고, 기록을 추적하고, 모니터링을 관리할 수 있게 해줍니다.

사용해 보는 데 GTmetrix 계정이 필요하지 않습니다. 게스트로 연결해 바로 테스트를 시작하세요. 로그인하면 더 많은 테스트와 기능을 이용할 수 있습니다.

• 서버 URL: https://gtmetrix.com/mcp
• 전송 방식: Streamable HTTP (원격, 설치할 항목 없음)
• 인증: 게스트(로그인 불필요), OAuth 또는 Authorization: Bearer 헤더를 통한 API 키
• 지원 도구: Claude, ChatGPT, Codex, Cursor, GitHub Copilot CLI 및 MCP 호환 클라이언트

---

빠른 시작

옵션 1: OAuth(권장)

1. AI 도구에서 새 원격 MCP 서버 또는 사용자 지정 커넥터를 추가합니다.
2. 이름을 GTmetrix으로 지정하고 URL을 https://gtmetrix.com/mcp로 설정합니다.
3. Connect / Authenticate를 클릭합니다.

API 키가 필요하지 않습니다. GTmetrix 계정 페이지의 MCP Setup 섹션에서 MCP URL을 복사할 수도 있습니다.

게스트로 사용하기

시작하는 데 GTmetrix 계정은 필요하지 않습니다. 게스트는 제한된 수의 게스트 크레딧으로 테스트를 실행하고, 보고서를 읽고, 위치, 브라우저 및 기기를 조회할 수 있습니다.

게스트 크레딧을 모두 사용했거나 계정에 연결된 기능(페이지 기록, 모니터링, 알림, 태그)을 사용하려면 AI에게 로그인을 요청하세요. AI가 gtmetrix_reauthenticate을 호출하면 로그인하거나 무료 계정을 만들 수 있는 로그인 페이지가 표시됩니다.

옵션 2: API 키

GTmetrix 계정 페이지에서 API 키를 생성한 다음 클라이언트 설정에 추가합니다.

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"

JSON 설정(Cursor 및 원격 HTTP 서버를 지원하는 기타 클라이언트)

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

GitHub Copilot CLI (OAuth만 지원)

/mcp add GTmetrix

Server Type을 HTTP, URL을 https://gtmetrix.com/mcp, Tools를 *로 설정하고 저장한 다음 브라우저에서 인증합니다.

단계별 가이드: Claude · ChatGPT · Codex · Cursor · Copilot CLI

---

프롬프트 예시

• "런던과 시드니에서 LTE를 사용하는 iPhone으로 example.com을 테스트하고 성능이 비슷한지 알려줘."
• "example.com의 최신 보고서를 분석하고 주요 문제 3가지를 쉽게 설명해줘."
• "태그가 'client'인 모니터링 페이지를 모두 점검해줘. B 등급 미만이거나 LCP가 2초를 넘는 항목을 표시해줘."
• "이번 주 체크아웃 페이지 보고서를 지난달 보고서와 비교해줘. 성능이 저하된 부분이 있어?"
• "홈페이지의 일일 모니터링을 설정하고 LCP가 2.5초를 넘으면 알림을 보내줘."
• "사이트의 렌더링 차단 JavaScript를 수정한 다음 GTmetrix를 다시 실행해 개선 여부를 확인해줘."

---

도구

게스트는 테스트 도구(gtmetrix_get_report_har 제외)와 계정 및 참조 도구를 사용할 수 있습니다. 나머지 도구를 사용하려면 GTmetrix 계정이 필요합니다.

테스트

도구	기능
gtmetrix_start_test	URL 테스트를 시작합니다. 위치, 브라우저, 시뮬레이션 기기, 연결 속도 제한, AdBlock, 동영상, 쿠키, HTTP 인증, URL 허용/차단 목록, 뷰포트 크기 및 보고서 보관 기간(1, 6, 12 또는 24개월)을 지원합니다.
gtmetrix_get_test	실행 중인 테스트를 확인합니다. 서버 측에서 최대 30초 동안 롱 폴링하고 완료되면 보고서 ID를 반환합니다.
gtmetrix_get_report	완료된 보고서를 가져옵니다. GTmetrix 등급, Performance 및 Structure 점수, Core Web Vitals(LCP, TBT, CLS), 영향도 순으로 정렬된 상위 5개 Lighthouse 문제, 리소스 요약, HAR 및 전체 Lighthouse JSON 다운로드 링크를 제공합니다.
gtmetrix_get_report_har	HAR URL을 직접 다운로드할 수 없는 클라이언트를 위해 HAR 워터폴을 인라인으로 반환합니다. 기본적으로 크기 제한이 적용됩니다.

기록 및 페이지

도구	기능
gtmetrix_list_pages	최신 점수, Web Vitals, 모니터링 상태 및 태그와 함께 페이지(URL + 테스트 설정)를 나열합니다. URL, 위치, 브라우저, 기기, 속도 제한, 모니터링 빈도, 태그 등으로 필터링할 수 있습니다.
gtmetrix_get_report_history	추세 및 회귀 분석을 위해 페이지의 모든 보고서를 최신순으로 가져옵니다.

모니터링 및 알림

도구	기능
gtmetrix_set_page_monitoring	페이지의 모니터링을 켜거나(매시간, 매일, 매주, 매월) 끕니다.
gtmetrix_get_page_alert_conditions	페이지의 알림 조건을 읽습니다.
gtmetrix_set_page_alert_conditions	점수, 시간(LCP, TTFB, TBT 등), 페이지 크기, 요청 또는 CLS에 대한 알림 조건을 설정합니다.
gtmetrix_get_page_alert_events	페이지에서 발생한 알림과 해당 알림의 근거가 되는 보고서 링크를 나열합니다.

태그

도구	기능
gtmetrix_list_page_tags	태그 목록과 각 태그를 사용하는 페이지 수를 표시합니다.
gtmetrix_save_page_tag	태그를 만들거나 기존 태그의 이름 또는 색상을 변경합니다.
gtmetrix_update_page_tags	한 번에 최대 500개 페이지에 태그를 추가하거나 제거합니다.
gtmetrix_delete_page_tag	태그를 영구적으로 삭제합니다.

계정 및 참조

도구	기능
gtmetrix_get_account_status	요금제, 남은 API 크레딧 및 다음 충전 날짜를 표시합니다(게스트에게는 남은 게스트 크레딧이 표시됨).
gtmetrix_get_catalog	사용 가능한 브라우저, 위치, 시뮬레이션 기기, 속도 제한 프리셋 및 Lighthouse 감사를 조회합니다.
gtmetrix_get_guide	테스트 옵션, 보고서 분석, HAR 분석 및 테스트 오류에 관한 기본 제공 가이드를 읽습니다.
gtmetrix_reauthenticate	게스트 연결에서 로그인하거나 다른 GTmetrix 계정으로 전환합니다.

---

리소스

서버는 가이드와 카탈로그도 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

---

크레딧 및 제한

• 누구나 MCP를 사용할 수 있습니다. 게스트에게는 제한된 수의 크레딧이 제공되며, GTmetrix 계정이 있으면 더 많은 크레딧을 이용할 수 있습니다.
• 테스트 및 기타 작업은 GTmetrix API와 동일한 비율로 API 크레딧을 사용합니다. 동영상 녹화에는 테스트당 0.9크레딧이 추가됩니다.
• 크레딧 한도는 요금제에 따라 다릅니다. 일부 PRO 요금제는 매일 크레딧이 충전됩니다. AI에게 gtmetrix_get_account_status을 실행해 잔액을 확인하도록 요청하세요.
• 동시 테스트: Basic은 2개, PRO는 8개입니다.
• 일부 기능(더 많은 위치, 매시간 모니터링, 알림에 동영상 사용)은 요금제에 따라 제공됩니다.

GTmetrix PRO 요금제 보기

---

FAQ

챗봇인가요? 아니요. 이미 사용 중인 AI 도구가 GTmetrix에 접근할 수 있도록 해주는 연결 계층입니다.

GTmetrix 계정이 필요한가요? 아니요. 게스트로 연결해 바로 테스트를 실행할 수 있습니다. 로그인하면 더 많은 테스트와 기능을 이용할 수 있습니다.

API 키가 필요한가요? 수동으로 설정하는 경우에만 필요합니다. OAuth 연결에는 API 키가 필요하지 않습니다.

결과가 차트로 표시되지 않는 이유는 무엇인가요? 결과를 시각화하는 방식은 AI 도구에 따라 다릅니다. 보고서를 받은 후 "이 데이터를 시각화해줘"라고 요청하세요.

문제를 대신 수정해 줄 수 있나요? GTmetrix는 데이터와 진단 정보를 제공합니다. AI 도구가 코드나 CMS도 편집할 수 있다면 수정 사항을 적용하고 테스트를 다시 실행해 결과를 확인할 수 있습니다.

---

링크

• GTmetrix MCP 소개
• 설정 가이드
• GTmetrix API 문서
• 지원