MCP-Server

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.io?"
• „Hat sich mein Score diese Woche verbessert?"
• „Vergleiche turbopress.de mit turbometrics.io"
• „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
• Claude, ChatGPT oder ein anderes MCP-kompatibles Tool

Für den Weg über Claude und ChatGPT brauchst du keinen API-Token mehr — die Anmeldung läuft über turbometrics selbst. Ein Token brauchst du nur noch für Clients ohne OAuth-Unterstützung (siehe unten).

Einrichtung in Claude (empfohlen)

Du trägst nur die Server-URL ein, meldest dich bei turbometrics an und bestätigst einmal — fertig.

1. In Claude: Settings → Connectors → „Add custom connector"
2. Als URL eintragen: https://turbometrics.io/mcp
3. „Add" klicken, dann „Connect"
4. Du landest auf einer Seite von turbometrics: anmelden und „Erlauben" klicken

Der Connector gilt geräteübergreifend für deinen Claude-Account (claude.ai, Desktop-App, Mobile-Apps).

Den Zugriff siehst du danach unter Profil → API im Abschnitt „Verbundene Apps" — dort kannst du ihn jederzeit wieder entziehen.

Hinweis: Die Eingabe eigener Request-Header ist in der Connector-Oberfläche von Claude nur in einer Beta verfügbar, die nicht für alle Konten freigeschaltet ist. Der OAuth-Weg oben funktioniert unabhängig davon.

Einrichtung in Claude Code

claude mcp add --transport http turbometrics https://turbometrics.io/mcp

Beim ersten Aufruf öffnet sich der Browser für die Anmeldung. Ein --header ist nicht mehr nötig.

ChatGPT (Developer Mode)

Hinweis: Developer Mode ist aktuell Beta und nur mit ChatGPT Plus oder Pro verfügbar.

1. In ChatGPT: Settings → Developer Mode aktivieren
2. Apps & Connectors → neuen Connector erstellen
3. Server-URL https://turbometrics.io/mcp eintragen
4. Der Anmeldung bei turbometrics folgen und bestätigen

Alternative: lokale Einrichtung per npx (mcp-remote)

Für Clients ohne OAuth-Unterstützung kannst du den MCP-Server weiterhin lokal über mcp-remote und einen API-Token einbinden. Den Token erstellst du unter Profil → API.

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

4. Eintrag ergänzen:

{
  "mcpServers": {
    "turbometrics": {
      "command": "/opt/homebrew/bin/npx",
      "args": [
        "mcp-remote",
        "https://turbometrics.io/mcp",
        "--header",
        "Authorization: Bearer DEIN_API_TOKEN"
      ]
    }
  }
}

5. Claude Desktop neu starten

Claude Desktop – 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

4. Konfigurationsdatei öffnen. Im Explorer-Adressfeld eingeben:

%APPDATA%\Claude\claude_desktop_config.json

5. 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.io/mcp",
        "--header",
        "Authorization: Bearer DEIN_API_TOKEN"
      ]
    }
  }
}

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

6. Claude Desktop neu starten

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

2. Konfigurationsdatei öffnen (ggf. neu anlegen):

~/Library/Application Support/ChatGPT/mcp.json

3. Eintrag ergänzen – Pfad aus Schritt 1 und API-Token eintragen:

{
  "mcpServers": {
    "turbometrics": {
      "command": "/opt/homebrew/bin/npx",
      "args": [
        "mcp-remote",
        "https://turbometrics.io/mcp",
        "--header",
        "Authorization: Bearer DEIN_API_TOKEN"
      ]
    }
  }
}

4. 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

2. 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.io/mcp",
        "--header",
        "Authorization: Bearer DEIN_API_TOKEN"
      ]
    }
  }
}

3. 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.

Die OAuth-Metadaten liegen unter /.well-known/oauth-protected-resource und /.well-known/oauth-authorization-server. Clients, die sich per Dynamic Client Registration oder Client ID Metadata Document ausweisen, werden beide unterstützt.

Verfügbare Tools

Wenn die Verbindung nicht zustande kommt

Die URL muss https://turbometrics.io/mcp lauten — mit .io. Unter turbometrics.de antwortet der Endpunkt zwar, aber die Anmeldung liegt dort nicht. Der Client kann sich deshalb nicht autorisieren und meldet einen Verbindungsfehler, ohne zu sagen, woran es liegt.

Ältere Einrichtungen mit einem Token im Request-Header funktionieren nicht mehr. Trenne den Connector und richte ihn neu ein — die Anmeldung läuft jetzt über OAuth, du wirst dabei einmal durch einen Zustimmungsdialog geführt.

Bei dauerhaften Fehlern hilft Trennen und neu verbinden. Der Zugriffstoken gilt eine Stunde und wird danach im Hintergrund erneuert. Ist eine Erneuerung einmal gescheitert, holt der Connector sie nicht von selbst nach.

Ein Fehler mit „503" ist vorübergehend. Er heißt, dass die Anmeldung gerade nicht geprüft werden konnte — nicht, dass sie ungültig ist. Warte einen Moment und versuche es erneut.

Plan

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

Weiterlesen

→ REST API → Tarife & Limits → Quellcode auf GitHub → MCP Registry Eintrag