Dokumentation

MCP-Server

turbometrics direkt mit Claude Desktop und anderen KI-Tools verbinden — ohne Copy-Paste.

turbometrics lässt sich direkt mit Claude und anderen KI-Tools verbinden — ohne Copy-Paste, ohne Dashboard öffnen. Du stellst Fragen in natürlicher Sprache, das KI-Tool fragt turbometrics im Hintergrund ab und gibt dir eine fertige Antwort zurück.

Was du damit machen kannst

Scans & Performance

  • „Wie ist der aktuelle Score von turbopress.de?"
  • „Welche Findings hat turbometrics.de?"
  • „Hat sich mein Score diese Woche verbessert?"
  • „Vergleiche turbopress.de mit turbometrics.de"
  • „Scanne https://neue-domain.de und zeig mir die Ergebnisse" (auch neue, noch nicht überwachte Domains)
  • „Starte einen Scan für example.com in der EU-Region"

Real User Monitoring

  • „Zeig mir die Core Web Vitals von turbopress.de"
  • „Wie hat sich der LCP meiner Website in den letzten 30 Tagen entwickelt?"
  • „Welche Seiten auf turbopress.de haben den schlechtesten LCP?"
  • „Wie war der INP-Wert letzte Woche im Vergleich zu dieser Woche?"

Alerts & Account

  • „Zeig mir alle offenen Alerts"
  • „Liste meine letzten Scans gefiltert nach Status"
  • „Zeig mir Details zu Alert #123"
  • „Markiere alle Alerts als gelesen"
  • „Welchen Plan habe ich und wie viele API-Anfragen habe ich heute noch?"

Voraussetzungen

  • turbometrics-Account ab Starter-Plan
  • API-Token unter Profil → API
  • Claude Desktop oder ChatGPT Desktop (Mac oder Windows) oder ein anderes MCP-kompatibles Tool

Einrichtung in Claude Desktop

Mac

  1. Node.js installieren – eine der folgenden Methoden:

    Mit Homebrew:

    brew install node
    

    Ohne Homebrew: nodejs.org/de/download → macOS Installer (.pkg) herunterladen und ausführen.

  2. API-Token erstellen unter Profil → API

  3. Konfigurationsdatei öffnen:

~/Library/Application Support/Claude/claude_desktop_config.json
  1. Eintrag ergänzen:
{
  "mcpServers": {
    "turbometrics": {
      "command": "/opt/homebrew/bin/npx",
      "args": [
        "mcp-remote",
        "https://turbometrics.de/mcp",
        "--header",
        "Authorization: Bearer DEIN_API_TOKEN"
      ]
    }
  }
}
  1. Claude Desktop neu starten

Windows

  1. Node.js installieren: nodejs.org/de/download → Windows Installer (.msi) herunterladen und ausführen.

  2. API-Token erstellen unter Profil → API

  3. Korrekten npx-Pfad ermitteln — CMD öffnen (Win + R, cmd, Enter) und eingeben:

where npx

Der Pfad sieht typischerweise so aus: C:\Program Files\nodejs\npx.cmd

  1. Konfigurationsdatei öffnen. Im Explorer-Adressfeld eingeben:
%APPDATA%\Claude\claude_desktop_config.json
  1. Eintrag ergänzen — Pfad aus Schritt 3 bei command eintragen, DEIN_API_TOKEN ersetzen:
{
  "mcpServers": {
    "turbometrics": {
      "command": "C:\\Program Files\\nodejs\\npx.cmd",
      "args": [
        "mcp-remote",
        "https://turbometrics.de/mcp",
        "--header",
        "Authorization: Bearer DEIN_API_TOKEN"
      ]
    }
  }
}

Hinweis: Backslashes im JSON müssen doppelt geschrieben werden (\\).

  1. Claude Desktop neu starten

Einrichtung in ChatGPT Desktop

ChatGPT Desktop (Mac und Windows) unterstützt MCP-Server ab Version 1.2025.x. Die Einrichtung ist nahezu identisch mit Claude Desktop – nur der Pfad zur Konfigurationsdatei unterscheidet sich.

Voraussetzung: Node.js muss installiert sein (s. Abschnitt Claude Desktop oben).

Mac

  1. Korrekten npx-Pfad ermitteln:
which npx
  1. Konfigurationsdatei öffnen (ggf. neu anlegen):
~/Library/Application Support/ChatGPT/mcp.json
  1. Eintrag ergänzen – Pfad aus Schritt 1 und API-Token eintragen:
{
  "mcpServers": {
    "turbometrics": {
      "command": "/opt/homebrew/bin/npx",
      "args": [
        "mcp-remote",
        "https://turbometrics.de/mcp",
        "--header",
        "Authorization: Bearer DEIN_API_TOKEN"
      ]
    }
  }
}
  1. ChatGPT Desktop vollständig beenden (Cmd+Q) und neu starten.

Windows

  1. Konfigurationsdatei öffnen (ggf. neu anlegen). Im Explorer-Adressfeld eingeben:
%APPDATA%\ChatGPT\mcp.json
  1. Eintrag ergänzen – npx-Pfad aus where npx und API-Token eintragen:
{
  "mcpServers": {
    "turbometrics": {
      "command": "C:\\Program Files\\nodejs\\npx.cmd",
      "args": [
        "mcp-remote",
        "https://turbometrics.de/mcp",
        "--header",
        "Authorization: Bearer DEIN_API_TOKEN"
      ]
    }
  }
}
  1. ChatGPT Desktop vollständig beenden (System-Tray → Quit) und neu starten.

Hinweis: Falls ChatGPT Desktop die Konfiguration nicht erkennt, probiere mcp_servers.json als alternativen Dateinamen.

Andere MCP-Clients

Der MCP-Server ist mit allen MCP-kompatiblen Tools nutzbar, zum Beispiel Cursor oder Windsurf.

Einstellung Wert
Server-URL https://turbometrics.de/mcp
Transport Streamable HTTP
Auth Authorization: Bearer DEIN_API_TOKEN

Verfügbare Tools

Tool Beschreibung
list_domains Alle überwachten URLs mit Status
get_latest_scan Neuester Scan mit Score, Findings und TTFB
get_scan_history Score-Verlauf — für überwachte und neue Domains
get_findings Detaillierte Findings eines Scans
list_alerts Offene und gelöste Alerts
list_scans Scans auflisten — filterbar nach Domain, Status und Seite
get_alert Details zu einem einzelnen Alert
get_rum_summary Core Web Vitals p75-Werte (RUM)
get_rum_metric_history Tagesverlauf einer RUM-Metrik (LCP, CLS, INP, FCP, TTFB)
get_rum_pages Langsamste Seiten nach Metrik
compare_domains Zwei Domains direkt vergleichen
trigger_scan Scan starten — für jede URL, auch neue Domains; optional mit Region, Force oder Auth
mark_alerts_read Alerts als gelesen markieren
get_account_info Account-Details: Plan, API-Limits, RUM-Status

Plan

Der MCP-Server ist ab dem Starter-Plan verfügbar.

Weiterlesen

REST APITarife & LimitsQuellcode auf GitHubMCP Registry Eintrag