GTmetrix MCP

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

GTmetrix MCP

Der offizielle GTmetrix-MCP-Server verbindet dein KI-Tool mit GTmetrix, damit es direkt über eine Eingabe echte Seitengeschwindigkeitstests ausführen, Berichte lesen, den Verlauf verfolgen und das Monitoring verwalten kann.

Zum Ausprobieren ist kein GTmetrix-Konto erforderlich. Verbinde dich als Gast und beginne sofort mit dem Testen. Melde dich an, um weitere Tests und Funktionen freizuschalten.

• Server-URL: https://gtmetrix.com/mcp
• Transport: Streamable HTTP (remote, keine Installation erforderlich)
• Authentifizierung: Gast (keine Anmeldung), OAuth oder API-Schlüssel über den Header Authorization: Bearer
• Funktioniert mit: Claude, ChatGPT, Codex, Cursor, GitHub Copilot CLI und jedem MCP-kompatiblen Client

---

Schnellstart

Option 1: OAuth (empfohlen)

1. Füge in deinem KI-Tool einen neuen Remote-MCP-Server / benutzerdefinierten Connector hinzu.
2. Nenne ihn GTmetrix und lege die URL auf https://gtmetrix.com/mcp fest.
3. Klicke auf Verbinden / Authentifizieren.

Du benötigst keinen API-Schlüssel. Du kannst die MCP-URL auch im Abschnitt MCP Setup deiner GTmetrix-Kontoseite kopieren.

Als Gast verwenden

Du brauchst kein GTmetrix-Konto, um loszulegen. Als Gast kannst du mit einer begrenzten Anzahl an Gast-Credits Tests ausführen, Berichte lesen und Standorte, Browser und Geräte nachschlagen.

Wenn deine Gast-Credits aufgebraucht sind oder du Funktionen nutzen möchtest, die an ein Konto gebunden sind (Seitenverlauf, Monitoring, Benachrichtigungen, Tags), bitte deine KI, dich anzumelden. Sie ruft gtmetrix_reauthenticate auf. Daraufhin wird eine Anmeldeseite angezeigt, auf der du dich anmelden oder ein kostenloses Konto erstellen kannst.

Option 2: API-Schlüssel

Erstelle auf deiner GTmetrix-Kontoseite einen API-Schlüssel und füge ihn anschließend zur Konfiguration deines Clients hinzu.

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-Konfiguration (Cursor und andere Clients, die Remote-HTTP-Server unterstützen)

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

GitHub Copilot CLI (nur OAuth)

/mcp add GTmetrix

Lege Server Type auf HTTP, URL auf https://gtmetrix.com/mcp und Tools auf * fest, speichere die Einstellungen und authentifiziere dich anschließend im Browser.

Schritt-für-Schritt-Anleitungen: Claude · ChatGPT · Codex · Cursor · Copilot CLI

---

Beispiel-Prompts

• „Teste example.com von London und Sydney aus auf einem iPhone über LTE und sag mir, ob die Leistung vergleichbar ist.“
• „Analysiere meinen neuesten Bericht für example.com und erkläre die drei wichtigsten Probleme in einfachen Worten.“
• „Prüfe den Zustand aller meiner überwachten Seiten mit dem Tag 'client'. Hebe alles hervor, was schlechter als Note B ist oder einen LCP von über 2 s hat.“
• „Vergleiche die Berichte dieser Woche für meine Checkout-Seite mit denen des letzten Monats. Hat sich etwas verschlechtert?“
• „Richte tägliches Monitoring für meine Homepage ein und benachrichtige mich, wenn der LCP über 2,5 Sekunden steigt.“
• „Behebe renderblockierendes JavaScript auf meiner Website, führe anschließend GTmetrix erneut aus und bestätige die Verbesserung.“

---

Tools

Gäste können die Test-Tools (außer gtmetrix_get_report_har) sowie die Konto- und Referenz-Tools verwenden. Für alle übrigen Tools ist ein GTmetrix-Konto erforderlich.

Tests

Tool	Funktion
gtmetrix_start_test	Startet einen Test für eine URL. Unterstützt Standort, Browser, simuliertes Gerät, Verbindungslimitierung, AdBlock, Video, Cookies, HTTP-Authentifizierung, URL-Zulassungs-/Sperrlisten, Viewport-Größe und Berichtsspeicherung (1, 6, 12 oder 24 Monate).
gtmetrix_get_test	Prüft einen laufenden Test. Wartet serverseitig bis zu 30 Sekunden pro Aufruf und gibt nach Abschluss die Berichts-ID zurück.
gtmetrix_get_report	Ruft einen abgeschlossenen Bericht ab: GTmetrix-Note, Performance- und Structure-Werte, Core Web Vitals (LCP, TBT, CLS), die fünf wichtigsten Lighthouse-Probleme nach Auswirkung sortiert, eine Ressourcenübersicht sowie Download-Links für HAR und vollständiges Lighthouse-JSON.
gtmetrix_get_report_har	Gibt den HAR-Wasserfall direkt aus, wenn der Client die HAR-URL nicht direkt herunterladen kann. Die Größe ist standardmäßig begrenzt.

Verlauf und Seiten

Tool	Funktion
gtmetrix_list_pages	Listet deine Seiten (URL + Testeinstellungen) mit den neuesten Werten, Web Vitals, Monitoring-Status und Tags auf. Filtere nach URL, Standort, Browser, Gerät, Drosselung, Monitoring-Häufigkeit, Tags und mehr.
gtmetrix_get_report_history	Ruft alle Berichte einer Seite ab, beginnend mit dem neuesten, um Trends und Regressionen zu analysieren.

Monitoring und Benachrichtigungen

Tool	Funktion
gtmetrix_set_page_monitoring	Aktiviert (stündlich, täglich, wöchentlich, monatlich) oder deaktiviert das Monitoring für eine Seite.
gtmetrix_get_page_alert_conditions	Liest die Benachrichtigungsbedingungen einer Seite aus.
gtmetrix_set_page_alert_conditions	Legt Benachrichtigungsbedingungen für Werte, Zeitangaben (LCP, TTFB, TBT usw.), Seitengröße, Anfragen oder CLS fest.
gtmetrix_get_page_alert_events	Listet ausgelöste Benachrichtigungen einer Seite mit Links zu den zugehörigen Berichten auf.

Tags

Tool	Funktion
gtmetrix_list_page_tags	Listet deine Tags und die Anzahl der Seiten auf, die jeweils damit versehen sind.
gtmetrix_save_page_tag	Erstellt einen Tag oder benennt einen vorhandenen Tag um bzw. ändert dessen Farbe.
gtmetrix_update_page_tags	Fügt bis zu 500 Seiten gleichzeitig einen Tag hinzu oder entfernt ihn.
gtmetrix_delete_page_tag	Löscht einen Tag dauerhaft.

Konto und Referenz

Tool	Funktion
gtmetrix_get_account_status	Zeigt deinen Tarif, die verbleibenden API-Credits und das Datum der nächsten Aufladung an (Gäste sehen ihre verbleibenden Gast-Credits).
gtmetrix_get_catalog	Ruft verfügbare Browser, Standorte, simulierte Geräte, Drosselungsvoreinstellungen und Lighthouse-Audits ab.
gtmetrix_get_guide	Liest integrierte Anleitungen zu Testoptionen, Berichtsanalyse, HAR-Analyse und Testfehlern.
gtmetrix_reauthenticate	Meldet dich über eine Gastverbindung an oder wechselt zu einem anderen GTmetrix-Konto.

---

Ressourcen

Der Server stellt seine Anleitungen und Kataloge außerdem als MCP-Ressourcen bereit:

• 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

---

Credits und Limits

• Jeder kann den MCP verwenden. Gäste erhalten eine begrenzte Anzahl an Credits; mit einem GTmetrix-Konto erhältst du mehr.
• Tests und andere Aktionen verbrauchen API-Credits zum gleichen Satz wie die GTmetrix-API. Videoaufzeichnungen kosten zusätzlich 0,9 Credits pro Test.
• Die verfügbaren Credits hängen von deinem Tarif ab. Bei ausgewählten PRO-Tarifen werden die Credits täglich aufgefüllt. Bitte deine KI, gtmetrix_get_account_status auszuführen, um deinen Kontostand anzuzeigen.
• Gleichzeitige Tests: 2 bei Basic, 8 bei PRO.
• Einige Funktionen (mehr Standorte, stündliches Monitoring, Video bei Benachrichtigungen) hängen von deinem Tarif ab.

GTmetrix-PRO-Tarife ansehen

---

FAQ

Ist das ein Chatbot? Nein. Es ist eine Verbindungsschicht, die deinem bereits verwendeten KI-Tool Zugriff auf GTmetrix ermöglicht.

Brauche ich ein GTmetrix-Konto? Nein. Du kannst dich als Gast verbinden und sofort Tests ausführen. Melde dich an, um weitere Tests und Funktionen freizuschalten.

Brauche ich einen API-Schlüssel? Nur bei manueller Konfiguration. Für OAuth-Verbindungen ist keiner erforderlich.

Warum werden meine Ergebnisse nicht als Diagramme angezeigt? Die Darstellung hängt von deinem KI-Tool ab. Bitte es nach dem Abrufen eines Berichts, „diese Daten zu visualisieren“.

Kann es Probleme für mich beheben? GTmetrix stellt Daten und Diagnosen bereit. Wenn dein KI-Tool auch deinen Code oder dein CMS bearbeiten kann, kann es Korrekturen anwenden und den Test erneut ausführen, um das Ergebnis zu bestätigen.

---

Links

• Einführung in GTmetrix MCP
• Einrichtungsanleitung
• GTmetrix-API-Dokumentation
• Support