Ein Schlüssel für REST-API und MCP-Server

Schnellstart

Jede Anfrage authentifiziert sich mit einem API-Schlüssel, den du in der App erstellst. Richte curl, deine CI oder einen beliebigen HTTP-Client auf https://app.relvato.com/api/v1.

# 1 — Confirm your key works and see the endpoints
curl https://app.relvato.com/api/v1 \
  -H "Authorization: Bearer rlv_your_key"

# 2 — List the sites Relvato monitors for you
curl https://app.relvato.com/api/v1/sites \
  -H "Authorization: Bearer rlv_your_key"

# 3 — Read recent runs (optionally scoped to one site)
curl "https://app.relvato.com/api/v1/runs?limit=10" \
  -H "Authorization: Bearer rlv_your_key"

# 4 — One run in detail, then the fix brief Relvato's AI would answer
curl https://app.relvato.com/api/v1/runs/RUN_ID \
  -H "Authorization: Bearer rlv_your_key"
curl https://app.relvato.com/api/v1/runs/RUN_ID/fix-prompt \
  -H "Authorization: Bearer rlv_your_key"

# 5 — Trigger an on-demand scan of a site (full-access key)
curl -X POST https://app.relvato.com/api/v1/sites/SITE_ID/scan \
  -H "Authorization: Bearer rlv_your_key"

Authentifizierung

Sende deinen Schlüssel bei jeder Anfrage als Authorization: Bearer rlv_your_key (ein x-api-key-Header funktioniert ebenfalls). Ein fehlender, widerrufener oder unbekannter Schlüssel liefert 401.

Schlüssel legst du unter API access in der App an und widerrufst sie dort. Schlüssel beginnen mit rlv_ und werden nur einmal beim Anlegen angezeigt. Jeder Schlüssel ist read-only (alles, was liest: Websites, Zustand, Performance, Läufe, Monitore, Updates, Aktivität, Fix-Briefings, Alarm-Einstellungen) oder full access (zusätzlich Websites und Monitore hinzufügen und konfigurieren, ausführen, Ergebnisse prüfen und vorgeschlagene Korrekturen anwenden). Schlüssel von vor der Einführung der Berechtigungen haben vollen Zugriff. Behandle Schlüssel wie ein Passwort.

REST-Endpunkte

Jeder Endpunkt ist auf das Konto hinter dem Schlüssel beschränkt und liefert JSON. Basis-URL https://app.relvato.com/api/v1.

Beispiel: Websites auflisten

{
  "sites": [
    {
      "id": "st_1a2b3c",
      "name": "style4street",
      "url": "https://style4street.com",
      "connectionType": "wordpress"
    }
  ]
}

Beispiel: aktuelle Läufe

Ein Lauf, der fehlgeschlagen war, aber später aufgelöst wurde (Baseline akzeptiert oder ignoriert), meldet status: "passed" mit resolved: true.

{
  "runs": [
    {
      "id": "rn_9f8e7d",
      "siteId": "st_1a2b3c",
      "checkId": "ck_4d5e6f",
      "journey": "checkout",
      "checkName": "Checkout",
      "status": "passed",
      "resolved": false,
      "trigger": "schedule",
      "startedAt": "2026-08-31T09:15:00.000Z",
      "durationMs": 4210,
      "error": null,
      "warning": null
    }
  ]
}

Beispiel: ein Lauf im Detail

Befunde stehen in metrics.items. Ein großer Lauf wird gekürzt statt abgeschnitten: Lange Reihen werden zu Zusammenfassungen, und was weggelassen wurde, steht in metricsTrimmed – Überschrift und Befunde bleiben immer erhalten.

{
  "runId": "rn_9f8e7d",
  "runUrl": "https://app.relvato.com/runs/rn_9f8e7d",
  "check": { "key": "google-search", "name": "Google Search" },
  "status": "passed",
  "warning": "https://style4street.com/category/topuri/hanorace/ lost 57% of its Google impressions",
  "metrics": {
    "headline": { "tone": "warn", "text": "🔎 1 thing to review on Google Search (as of 2026-09-24)" },
    "items": [
      { "text": "https://style4street.com/category/topuri/hanorace/ lost 57% of its Google impressions — 98 in the 7 days to 2026-09-24, against 226 in an average week before", "tone": "warn" }
    ],
    "search": { "engine": "google", "tiles": [ … ], "dailies": [ { "label": "Impressions per day", "days": 84, "last7Total": 2196, "usualLast7Total": 2583 } ], … }
  },
  "metricsTrimmed": {
    "note": "Large parts were left out to keep this short — the run page has everything.",
    "omitted": ["search.dailies (the per-day values — summarized)", "search.tiles[].weekly (the 8 weekly bars)"]
  }
}

Beispiel: das Fix-Briefing eines Laufs

Für einen Lauf mit Befund liefert fix-prompt das Briefing, das Relvatos eigene KI beantwortet: den Stack der Website, was sich kurz davor geändert hat, Fehler und Befunde und bei Google / Bing Search die Belege, die Ursachen ausschließen. Gib es deinem eigenen Modell oder lies es selbst.

{
  "runId": "rn_9f8e7d",
  "runUrl": "https://app.relvato.com/runs/rn_9f8e7d",
  "hasIssue": true,
  "prompt": "# Help me understand a Google Search change on my WordPress site\n\nYou are a senior SEO specialist. … ## Evidence Relvato already has …"
}

Rate-Limits

Anfragen sind pro Minute und Konto begrenzt — über REST und MCP zusammen. Dein Tarif setzt die Obergrenze:

Jede Antwort enthält X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset. Über dem Limit kommt 429 mit einem Retry-After-Header.

Statuscodes

MCP-Server (für KI-Agenten)

Relvato ist auch ein Remote-Model Context Protocol-Server mit 57 Tools, sodass ein Agent wie Claude im Gespräch erledigen kann, was du im Dashboard tun würdest: eine Website hinzufügen und dich durch die Verbindung führen, Monitore auswählen und konfigurieren (bis zu den Seiten, die der visuelle Monitor prüft), sie ausführen, die Ergebnisse erklären und, wenn du zustimmst, eine gewollte Änderung übernehmen oder dir den Link geben, mit dem du die vorgeschlagene Korrektur eines Laufs in WordPress anwendest. Du verbindest ihn per Anmeldung bei Relvato oder mit einem API-Schlüssel; in beiden Fällen teilt er sich das Rate-Limit mit der REST-API. Änderungen an Dateiintegrität, Skripten und DNS freigeben, wer Alarme bekommt, Geheimnisse und Löschen bleiben im Dashboard.

Gelistet in der GitHub MCP Registry ↗.

Anmelden, ohne Schlüssel. Füge den Endpunkt als Connector in Claude (claude.ai, Desktop oder Claude Code), ChatGPT oder VS Code hinzu. Der Client öffnet die Anmeldung bei Relvato; du erlaubst ihm, deine Websites und Ergebnisse zu lesen und Änderungen vorzunehmen: Websites und Monitore hinzufügen, Zeitpläne ändern und Scans starten. Die Anmeldung funktioniert in Clients, die Client ID Metadata Documents unterstützen; Cursor und Dockers MCP-Gateway können das noch nicht und nutzen einen API-Schlüssel.

Gehörst du zu einer Organisation, wählst du bei der Anmeldung einen ihrer Workspaces; dein persönlicher Workspace wird dort nicht angeboten. Für deinen persönlichen Workspace nutze einen API-Schlüssel.

Was du einen mit Relvato verbundenen Agenten fragen kannst:

• „Warum ist der Checkout meines Shops letzte Nacht fehlgeschlagen, und wie behebe ich das?“
• „Richte das Monitoring für example.com ein und sag mir, was ich zum Verbinden tun muss.“
• „Wer wird alarmiert, wenn ein Security-Monitor ein Problem findet, und über welche Kanäle?“
• „Füge meine Preis- und Blogseite zum visuellen Monitor hinzu und führe ihn aus.“
• „Wie schnell ist mein Shop für echte Besucher, und was bremst ihn?“

Endpunkt https://app.relvato.com/api/mcp

In einem Client, der eine mcp.json liest, reicht der Endpunkt – der Client fragt beim ersten Mal nach der Anmeldung:

{
  "mcpServers": {
    "relvato": {
      "type": "http",
      "url": "https://app.relvato.com/api/mcp"
    }
  }
}

Um stattdessen einen API-Schlüssel zu nutzen (ein Skript, ein Client ohne Anmeldung oder dein persönlicher Workspace, während du in einer Organisation bist), füge den Header hinzu. Ein nur lesender Schlüssel bekommt nur die Lese-Tools:

{
  "mcpServers": {
    "relvato": {
      "type": "http",
      "url": "https://app.relvato.com/api/mcp",
      "headers": {
        "Authorization": "Bearer rlv_your_key"
      }
    }
  }
}

Claude-Code-Plugin

In Claude Code fügt das Relvato-Plugin den Server und drei Skills hinzu, mit denen du direkt im Repository deiner Website arbeitest. Installiere es aus unserem Marketplace, führe dann /mcp aus und melde dich an:

claude plugin marketplace add Relvato/relvato-mcp
claude plugin install relvato@relvato

• /relvato:setup fügt die Website hinzu, die dieses Repository deployt, weist nach, dass sie dir gehört (es kann das Verifizierungs-Meta-Tag in deinen Code einfügen), wählt Monitore aus und startet die ersten Läufe.
• /relvato:check-after-deploy führt nach einem Deploy die Monitore der Website aus, sagt, wie lange sie dauern, und meldet, was bestanden hat und was kaputt ist.
• /relvato:fix-failure liest einen fehlgeschlagenen Lauf, findet die Ursache in deinem Code, nimmt mit deinem OK die kleinste Korrektur vor und führt diesen Monitor erneut aus.

Perplexity

Mit einem Perplexity-Tarif Pro, Max oder Enterprise fügst du Relvato als eigenen Connector hinzu: Settings → Connectors → + Custom connector → Remote. Gib den Endpunkt oben als MCP-Server-URL an und wähle Streamable HTTP als Transport.

Wähle bei Authentication API key und füge einen Relvato-API-Schlüssel ein (du erstellst ihn unter API access in der App; ein Nur-Lese-Schlüssel bekommt nur die Lese-Tools). Die OAuth-Option von Perplexity funktioniert mit der Anmeldung von Relvato noch nicht: Sie setzt voraus, dass der Server Perplexity automatisch registriert, und das bietet Relvato nicht an.

Webhooks

Die API antwortet, wenn du fragst. Um es sofort zu erfahren, wenn ein Monitor ein Problem findet, richte einen Webhook ein: Relvato schickt für jeden Alarm ein signiertes JSON-Ereignis per POST an deine URL (ab Pro). Webhook einrichten →

Häufige Fragen