Rivly mit Claude, ChatGPT oder Cursor verbinden

Schritt 1: Schlüssel erstellen

1. In Rivly links „MCP & Agenten“ öffnen. Der Schlüssel gilt für das Projekt, das oben links ausgewählt ist.
2. Rechte wählen: „Nur lesen“ genügt für Auswertungen und Textentwürfe. „Lesen und schreiben“ erlaubt dem Assistenten zusätzlich, Schritte einer Empfehlung abzuhaken und den Messplan zu ergänzen.
3. Auf „Schlüssel erstellen“ klicken. Der Schlüssel beginnt mit rv_live_ und wird genau einmal vollständig angezeigt.
4. Schlüssel sofort kopieren und im Passwortspeicher ablegen. Später sehen Sie nur noch die verkürzte Form. Ist er verloren, widerrufen Sie ihn und erstellen einen neuen.

Erstellen und widerrufen kann nur der Inhaber des Kontos. Jedes Projekt hat seinen eigenen Schlüssel: Für eine zweite Marke wechseln Sie oben links das Projekt und erstellen dort einen weiteren.

Schritt 2: Zugangsdaten eintragen

Wählen Sie Ihren Assistenten. In jedem Fall ersetzen Sie <IHR-SCHLÜSSEL> durch den kopierten Schlüssel, danach starten Sie den Assistenten neu.

Claude Desktop

Die Einstellungen öffnen, Bereich Entwickler, und die Datei claude_desktop_config.json bearbeiten. Den Eintrag einfügen, Claude Desktop beenden und neu starten.

{
  "mcpServers": {
    "rivly": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.rivly.de", "--header", "Authorization: Bearer <IHR-SCHLÜSSEL>"]
    }
  }
}

Cursor

Die Datei mcp.json im Ordner .cursor Ihres Benutzerverzeichnisses anlegen oder ergänzen, den Eintrag einfügen und Cursor neu starten.

{
  "mcpServers": {
    "rivly": {
      "url": "https://mcp.rivly.de",
      "headers": { "Authorization": "Bearer <IHR-SCHLÜSSEL>" }
    }
  }
}

ChatGPT

1. In ChatGPT Einstellungen → Connectors öffnen und „Rivly“ hinzufügen.
2. Server-URL: https://mcp.rivly.de
3. Authentifizierung: Bearer und dahinter Ihr Schlüssel.

Eigener Agent

Jeder Agent, der das Model Context Protocol spricht, erreicht Rivly per POST unter derselben Adresse. Der folgende Aufruf listet die Werkzeuge auf und prüft damit, ob der Schlüssel funktioniert.

curl -X POST https://mcp.rivly.de \
  -H "Authorization: Bearer <IHR-SCHLÜSSEL>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Was der Agent kann

Fünfundzwanzig Werkzeuge stehen bereit, achtzehn zum Lesen und sieben zum Schreiben. Die schreibenden arbeiten nur mit dem Recht „Lesen und schreiben“, sonst antwortet Rivly, dass der Schlüssel nur lesen darf.

1. get_overview (lesen): Rivly-Index, Kanalwerte und „Kurz gesagt“ der aktuellen Woche.
2. get_ai_answers (lesen): KI-Antworten im Wortlaut je Kauffrage und System, mit Quellen.
3. get_rankings (lesen): Google-Positionen, KI-Übersicht und Suchvolumen je Suchanfrage.
4. get_competitors (lesen): Wettbewerber mit Werten aller vier Kanäle.
5. get_recommendations (lesen): Offene Empfehlungen mit Schritten, Punkten und Status.
6. get_core (lesen): Profil, Angebot, Suchanfragen mit Volumen, Kauffragen und Wettbewerber mit dem Grund ihrer Aufnahme aus dem Kern des Projekts.
7. get_map (lesen): Marktkarte des Fahrplans: Felder mit Stand, Nachfrage, Spitzenreiter und eigener Seite, dazu die Maßnahmen mit ihrer Kennung.
8. get_site_audit (lesen): Website-Check: Technik, Sitemap, llms.txt, Zugang für KI-Anbieter und Seiten-Potenzial.
9. get_page_brief (lesen): Seitenbrief zu einer Maßnahme oder einem Feld: Überschrift, Abschnitte, Kundenfragen, Schema und llms.txt-Zeile.
10. get_llms_txt (lesen): Entwurf der llms.txt mit den Seiten des Kerns, dazu die Zeilen für Seiten, die noch nicht online sind.
11. get_structure (lesen): Struktur der Website gegen die Nachfrage: Nachfrage ohne Seite, Seiten ohne Platz 1 und Themen ohne Nachfrage.
12. get_live_check_history (lesen): Verlauf des KI-Live-Checks: Fragen mit den Antworten von ChatGPT und Gemini, Quelle App oder MCP, Rest der Wochenquote.
13. get_ads (lesen): Kanal Werbung: aktive Anzeigen der Marke und der Wettbewerber aus Meta und Google, mit Themen und Winnern.
14. get_press (lesen): Kanal Presse: redaktionelle Artikel der letzten 30 Tage, Anteil an der Berichterstattung und Medien, die nur Wettbewerber nennen.
15. get_backlinks (lesen): Backlinks im Website-Check: verweisende Domains gegen die Wettbewerber, starke Links, Lücken und fehlende Verzeichnisse, monatlich erhoben.
16. get_business_profile (lesen): Google Business im Website-Check: eigene Einträge mit Prüfung gegen die Website, Platz in Google Maps und Bewertungen.
17. get_history (lesen): Verlauf je Kalenderwoche: Rivly-Index und die Kanäle GEO, SEO, Werbung und Presse, dazu Ereignisse wie eine neue Messbasis.
18. get_measure_plan (lesen): Messplan: welche Kauffragen und Suchanfragen Rivly jede Woche misst, mit letztem Ergebnis und freien Plätzen im Tarif.
19. update_recommendation (schreiben): Schritt abhaken, einplanen oder erledigt melden.
20. add_prompt (schreiben): Kauffrage oder Suchanfrage zum Messplan hinzufügen.
21. check_page (schreiben): Eine Seite der Website sofort prüfen: erreichbar, Sitemap, Verlinkung, Suchanfrage, Schema und llms.txt.
22. mark_action_done (schreiben): Aktive Maßnahme als erledigt melden, die nächste Messung prüft die Wirkung.
23. ask_live_check (schreiben): Eine Frage live an ChatGPT und Gemini stellen, mit derselben Wochenquote wie der Chat in der App.
24. promote_live_check (schreiben): Eine Frage aus dem Live-Check als Kauffrage in den Messplan übernehmen, damit sie jede Woche gemessen wird.
25. create_page_brief (schreiben): Einen neuen Seitenbrief zu einer Maßnahme oder einem Feld schreiben lassen, mit derselben Monatsquote wie der Knopf im Fahrplan.

Die Methodik als Ressource

Neben den Werkzeugen stellt Rivly unter rivly://methodik eine Beschreibung bereit, wie der Rivly-Index, die vier Kanäle und die Messwochen zu lesen sind. Ein Assistent, der Ressourcen unterstützt, kann sie vor der ersten Auswertung lesen und deutet die Zahlen dann nicht falsch.

Beispiel: Eine Seite bauen

So setzt ein Assistent mit dem Recht „Lesen und schreiben“ eine Maßnahme aus dem Fahrplan in eine fertige Seite um. Sie sagen zum Beispiel: „Nimm die erste offene Maßnahme aus dem Fahrplan, hole den Seitenbrief und baue die Seite. Prüfe sie danach und melde die Maßnahme als erledigt.“

1. get_map: Der Assistent liest den Fahrplan und wählt eine Maßnahme. Ist noch keine aktiv, setzt er eine mit update_recommendation auf „in Arbeit“.
2. get_page_brief: Er holt den Seitenbrief mit Überschrift, Abschnitten, Kundenfragen, Schema und llms.txt-Zeile. Gibt es noch keinen, lässt create_page_brief ihn schreiben. Nach etwa einer Minute steht er in get_page_brief.
3. Der Assistent baut die Seite. Mit Zugriff auf den Code Ihrer Website, zum Beispiel in Cursor, legt er sie direkt dort an.
4. check_page: Nach dem Veröffentlichen prüft er die Seite sofort: erreichbar, Sitemap, Verlinkung, Suchanfrage, Schema und llms.txt.
5. mark_action_done: Er meldet die Maßnahme als erledigt. Die nächste Messung prüft die Wirkung.

Sicherheit

Der Schlüssel gilt nur für dieses Projekt und nur für die gewählten Rechte. Andere Projekte Ihres Kontos bleiben außen vor. Ein Assistent darf nie mehr als Sie: Was Ihre Rolle im Konto nicht darf, lehnt Rivly auch über den Schlüssel ab.

Jede Abfrage wird protokolliert, mit Zeitpunkt, Werkzeug und Assistent. Den Wortlaut der Abfragen und Antworten speichert Rivly nicht. Zur Abwehr von Missbrauch steht die IP-Adresse der Abfrage 90 Tage im Protokoll, danach löscht Rivly sie.

„Widerrufen“ trennt alle verbundenen Assistenten sofort. Für weiteren Zugang erstellen Sie einen neuen Schlüssel und tragen ihn erneut ein.

Wenn es nicht klappt

1. Fehler 401: Der Schlüssel ist widerrufen oder unvollständig eingetragen. Prüfen Sie, ob das Wort Bearer mit einem Leerzeichen davorsteht und der Schlüssel vollständig kopiert ist, sonst erstellen Sie einen neuen.
2. Fehler 429: Mehr als 60 Abfragen in einer Minute je Schlüssel. Der Assistent kann die Abfrage nach einer Minute wiederholen.
3. „Dieser Schlüssel darf nur lesen“: Das Werkzeug schreibt, der Schlüssel hat nur Leserechte. Unter MCP & Agenten auf „Lesen und schreiben“ umstellen.
4. „Quote erreicht“: ask_live_check zählt wie der Chat in der App je Woche, create_page_brief wie der Knopf im Fahrplan je Monat. Rivly nennt dem Assistenten das Datum, ab dem wieder Platz ist. Ein schon geschriebener Brief bleibt über get_page_brief kostenlos abrufbar.
5. Der Assistent findet Rivly nicht: Meist fehlt der Neustart. Beenden Sie den Assistenten vollständig und öffnen Sie ihn erneut.