GTmetrix MCP

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

GTmetrix MCP

Resmî GTmetrix MCP sunucusu, yapay zekâ aracınızı GTmetrix'e bağlayarak bir istemden gerçek sayfa performans testleri çalıştırmasını, raporları okumasını, geçmişi izlemesini ve izlemeyi yönetmesini sağlar.

Denemek için GTmetrix hesabı gerekmez. Misafir olarak bağlanıp hemen test etmeye başlayın. Daha fazla test ve özelliğin kilidini açmak için oturum açın.

• Sunucu URL'si: https://gtmetrix.com/mcp
• Aktarım: Streamable HTTP (uzak, kurulum gerekmez)
• Kimlik doğrulama: Misafir (oturum açma gerekmez), OAuth veya Authorization: Bearer başlığı üzerinden API anahtarı
• Şunlarla çalışır: Claude, ChatGPT, Codex, Cursor, GitHub Copilot CLI ve MCP uyumlu tüm istemciler

---

Hızlı başlangıç

Seçenek 1: OAuth (önerilen)

1. Yapay zekâ aracınıza yeni bir uzak MCP sunucusu / özel bağlayıcı ekleyin.
2. Adını GTmetrix olarak belirleyin ve URL'yi https://gtmetrix.com/mcp olarak ayarlayın.
3. Bağlan / Kimlik doğrula seçeneğine tıklayın.

API anahtarı gerekmez. MCP URL'sini GTmetrix Hesap sayfanızın MCP Setup bölümünden de kopyalayabilirsiniz.

Misafir olarak kullanma

Başlamak için GTmetrix hesabına ihtiyacınız yok. Misafir olarak sınırlı sayıda misafir kredisiyle test çalıştırabilir, raporları okuyabilir ve konumları, tarayıcıları ve cihazları arayabilirsiniz.

Misafir kredileriniz bittiğinde veya hesaba bağlı özellikleri (sayfa geçmişi, izleme, uyarılar, etiketler) kullanmak istediğinizde yapay zekânızdan oturum açmasını isteyin. Yapay zekânız gtmetrix_reauthenticate çağrısını yapar ve oturum açabileceğiniz veya ücretsiz hesap oluşturabileceğiniz bir oturum açma sayfası açılır.

Seçenek 2: API anahtarı

GTmetrix Hesap sayfanızdan bir API anahtarı oluşturun, ardından bunu istemcinizin yapılandırmasına ekleyin.

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 yapılandırması (Cursor ve uzak HTTP sunucularını destekleyen diğer istemciler)

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

GitHub Copilot CLI (yalnızca OAuth)

/mcp add GTmetrix

Sunucu Türü'nü HTTP, URL'yi https://gtmetrix.com/mcp, Araçlar'ı * olarak ayarlayın, kaydedin ve ardından tarayıcıda kimlik doğrulaması yapın.

Adım adım kılavuzlar: Claude · ChatGPT · Codex · Cursor · Copilot CLI

---

Örnek istemler

• "example.com'u Londra ve Sidney'den LTE üzerinden bir iPhone'da test et ve performansın karşılaştırılabilir olup olmadığını söyle."
• "example.com için en son raporumu analiz et ve en önemli 3 sorunu anlaşılır bir dille açıkla."
• "'client' etiketiyle işaretlenmiş tüm izlenen sayfalarımın durumunu kontrol et. B notunun altındakileri veya LCP değeri 2 saniyeyi aşanları belirt."
• "Ödeme sayfam için bu haftaki raporları geçen ayla karşılaştır. Performansta gerileme oldu mu?"
• "Ana sayfamda günlük izlemeyi ayarla ve LCP 2,5 saniyeyi aşarsa beni uyar."
• "Sitemde oluşturmayı engelleyen JavaScript'i düzelt, ardından GTmetrix'i yeniden çalıştır ve iyileşmeyi doğrula."

---

Araçlar

Misafirler Test araçlarını (gtmetrix_get_report_har hariç) ve Hesap ile başvuru araçlarını kullanabilir. Diğer araçlar için GTmetrix hesabı gerekir.

Test

Araç	Ne işe yarar
gtmetrix_start_test	Bir URL'de test başlatır. Konum, tarayıcı, simüle edilmiş cihaz, bağlantı kısıtlama, AdBlock, video, çerezler, HTTP kimlik doğrulaması, URL izin/engelleme listeleri, görüntü alanı boyutu ve rapor saklama süresi (1, 6, 12 veya 24 ay) seçeneklerini destekler.
gtmetrix_get_test	Çalışan bir testi kontrol eder. Sunucu tarafında uzun yoklama yapar (çağrı başına en fazla 30 sn) ve test tamamlandığında rapor kimliğini döndürür.
gtmetrix_get_report	Tamamlanmış bir raporu getirir: GTmetrix notu, Performance ve Structure puanları, Core Web Vitals (LCP, TBT, CLS), etkiye göre sıralanmış en önemli 5 Lighthouse sorunu, kaynak özeti ve HAR ile tam Lighthouse JSON dosyaları için indirme bağlantıları.
gtmetrix_get_report_har	HAR URL'sini doğrudan indiremeyen istemciler için HAR şelalesini satır içinde döndürür. Varsayılan olarak boyut sınırı uygulanır.

Geçmiş ve sayfalar

Araç	Ne işe yarar
gtmetrix_list_pages	Sayfalarınızı (URL + test ayarları), en son puanları, Web Vitals değerlerini, izleme durumunu ve etiketleriyle birlikte listeler. URL, konum, tarayıcı, cihaz, kısıtlama, izleme sıklığı, etiketler ve daha fazlasına göre filtreler.
gtmetrix_get_report_history	Eğilim ve gerileme analizi için bir sayfanın tüm raporlarını en yeniden eskiye doğru getirir.

İzleme ve uyarılar

Araç	Ne işe yarar
gtmetrix_set_page_monitoring	Bir sayfa için izlemeyi açar (saatlik, günlük, haftalık, aylık) veya kapatır.
gtmetrix_get_page_alert_conditions	Bir sayfanın uyarı koşullarını okur.
gtmetrix_set_page_alert_conditions	Puanlar, süreler (LCP, TTFB, TBT vb.), sayfa boyutu, istekler veya CLS için uyarı koşulları belirler.
gtmetrix_get_page_alert_events	Bir sayfanın tetiklediği uyarıları, bu uyarıların dayandığı raporların bağlantılarıyla birlikte listeler.

Etiketler

Araç	Ne işe yarar
gtmetrix_list_page_tags	Etiketlerinizi ve her birini kullanan sayfa sayısını listeler.
gtmetrix_save_page_tag	Bir etiket oluşturur veya mevcut bir etiketi yeniden adlandırır/renklendirir.
gtmetrix_update_page_tags	Tek seferde en fazla 500 sayfaya etiket ekler veya sayfalardan etiket kaldırır.
gtmetrix_delete_page_tag	Bir etiketi kalıcı olarak siler.

Hesap ve başvuru

Araç	Ne işe yarar
gtmetrix_get_account_status	Planınızı, kalan API kredilerinizi ve bir sonraki yenileme tarihini gösterir (misafirler kalan misafir kredilerini görür).
gtmetrix_get_catalog	Kullanılabilir tarayıcıları, konumları, simüle edilmiş cihazları, kısıtlama ön ayarlarını ve Lighthouse denetimlerini arar.
gtmetrix_get_guide	Test seçenekleri, rapor analizi, HAR analizi ve test hatalarıyla ilgili yerleşik kılavuzları okur.
gtmetrix_reauthenticate	Misafir bağlantısından oturum açar veya farklı bir GTmetrix hesabına geçer.

---

Kaynaklar

Sunucu ayrıca kılavuzlarını ve kataloglarını MCP kaynakları olarak sunar:

• 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

---

Krediler ve sınırlar

• MCP'yi herkes kullanabilir. Misafirler sınırlı sayıda kredi alır; GTmetrix hesabı daha fazla kredi sağlar.
• Testler ve diğer işlemler, GTmetrix API ile aynı oranda API kredisi kullanır. Video kaydı test başına 0,9 kredi ekler.
• Kredi miktarları planınıza bağlıdır. Bazı PRO planlarında krediler günlük olarak yenilenir. Bakiyenizi görmek için yapay zekânızdan gtmetrix_get_account_status çalıştırmasını isteyin.
• Eşzamanlı testler: Basic'te 2, PRO'da 8.
• Bazı özellikler (daha fazla konum, saatlik izleme, uyarılarda video) planınıza bağlıdır.

GTmetrix PRO planlarını görün

---

SSS

Bu bir sohbet robotu mu? Hayır. Bu, kullandığınız yapay zekâ aracına GTmetrix erişimi sağlayan bir bağlantı katmanıdır.

GTmetrix hesabına ihtiyacım var mı? Hayır. Misafir olarak bağlanıp hemen test çalıştırabilirsiniz. Daha fazla test ve özelliğin kilidini açmak için oturum açın.

API anahtarına ihtiyacım var mı? Yalnızca elle yapılandırma için. OAuth bağlantılarında API anahtarı gerekmez.

Sonuçlarım neden grafik olarak gösterilmiyor? Görselleştirme, yapay zekâ aracınıza bağlıdır. Raporu aldıktan sonra "bu verileri görselleştir" diye isteyin.

Sorunları benim için düzeltebilir mi? GTmetrix verileri ve tanılamaları sağlar. Yapay zekâ aracınız kodunuzu veya CMS'nizi de düzenleyebiliyorsa düzeltmeleri uygulayabilir ve sonucu doğrulamak için testi yeniden çalıştırabilir.

---

Bağlantılar

• GTmetrix MCP'yi tanıtıyoruz
• Kurulum kılavuzu
• GTmetrix API belgeleri
• Destek