Rivly mit Claude, ChatGPT oder Cursor verbinden
Adresse https://mcp.rivly.de im Assistenten eintragen, bei Rivly anmelden, Projekte und Rechte wählen. Danach liest Ihr Assistent die Werte Ihrer Projekte direkt aus Rivly, ohne Export und ohne Kopieren. Der Server steht in Deutschland.
So funktioniert die Verbindung
Claude, ChatGPT, Cursor und Claude Code brauchen nur die Adresse https://mcp.rivly.de. Beim ersten Verbinden öffnet sich eine Seite von Rivly: Sie melden sich an, wählen Projekte und Rechte und klicken auf „Zulassen“. Einen Schlüssel brauchen nur eigene Agenten, etwa in n8n oder Make.
- „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.
- „Alle Projekte, auch künftige“ gibt dem Assistenten jedes Projekt, das Sie in Rivly öffnen können, auch solche, die später dazukommen. Mit „Ausgewählte Projekte“ wählen Sie einzelne. Im Gespräch nennen Sie das Projekt beim Namen oder mit der Domain, ohne Angabe nimmt der Assistent das Standardprojekt.
- Auch Mitglieder eines Teams verbinden ihren eigenen Assistenten. Er darf nie mehr als ihre Rolle: Wer nur lesen darf, verbindet nur mit „Nur lesen“.
- Projekte und Rechte ändern Sie später im Tab „MCP & Agenten“ mit „Bearbeiten“ bei der Verbindung, ohne neue Anmeldung im Assistenten.
Claude
Am schnellsten geht es mit „In Claude hinzufügen“ im Tab „MCP & Agenten“: Claude öffnet das Fenster für einen eigenen Konnektor, Name und Adresse sind schon eingetragen. Ohne den Knopf öffnen Sie in Claude die Konnektoren (unter „Anpassen“), klicken auf „Hinzufügen“, wählen einen eigenen Konnektor und tragen als Namen Rivly und als Adresse die folgende Zeile ein. Die erkannten Einstellungen zur Anmeldung lassen Sie, wie sie sind. Danach auf „Verbinden“ klicken und bei Rivly anmelden. Die Verbindung gilt dann in Claude im Browser, in der Desktop-App und auf dem Handy. Im kostenlosen Tarif von Claude ist ein eigener Konnektor möglich, in Team- und Enterprise-Konten fügt der Inhaber ihn für alle hinzu.
https://mcp.rivly.de
ChatGPT
Auf chatgpt.com/plugins über das Pluszeichen einen eigenen MCP-Server hinzufügen. Name Rivly, als Server-Adresse die folgende Zeile, als Anmeldung OAuth. Den Hinweis zu nicht geprüften Servern bestätigen, anlegen und installieren, danach bei Rivly anmelden. Im Chat rufen Sie Rivly mit @ auf. Welche Tarife eigene MCP-Server erlauben, legt OpenAI fest, in Firmenkonten entscheidet oft der Administrator.
https://mcp.rivly.de
Cursor
„In Cursor hinzufügen“ im Tab „MCP & Agenten“ trägt den Server direkt in Cursor ein. Von Hand legen Sie unter Einstellungen im Bereich MCP einen neuen Server an oder ergänzen die Datei mcp.json im Ordner .cursor Ihres Benutzerverzeichnisses um den folgenden Eintrag. Beim ersten Aufruf öffnet Cursor die Anmeldung bei Rivly.
{
"mcpServers": {
"rivly": { "url": "https://mcp.rivly.de" }
}
}Claude Code
Den Befehl im Terminal ausführen, mit --scope user steht Rivly in jedem Ordner bereit. Danach in Claude Code /mcp eingeben, rivly wählen und bei Rivly anmelden.
claude mcp add --scope user --transport http rivly https://mcp.rivly.de
Eigener Agent
Ein eigener Agent, n8n oder Make meldet sich mit einem Schlüssel an. Der Schlüssel gilt für ein Projekt. Ihn erstellt der Inhaber des Kontos unter Einstellungen im Tab MCP & Agenten beim Eintrag „Eigener Agent“: Projekt und Rechte wählen, auf „Schlüssel erstellen“ klicken und den Schlüssel sofort kopieren. Er beginnt mit rv_live_, hat 48 Zeichen und steht nur einmal vollständig da. Danach zeigt Rivly eine verkürzte Form mit Punkten in der Mitte, die kein Schlüssel ist. Ist er nicht mehr zur Hand: „Neuen Schlüssel erstellen“. Der folgende Aufruf listet die Werkzeuge auf und prüft so, 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
Neunundzwanzig Werkzeuge stehen bereit, einundzwanzig zum Lesen und acht zum Schreiben. Jedes nimmt das Projekt als Angabe, list_projects nennt die Projekte der Verbindung, get_portfolio zeigt sie alle auf einen Blick. Die schreibenden arbeiten nur mit dem Recht „Lesen und schreiben“ und nur in Projekten, in denen Ihre Rolle Änderungen erlaubt. Greift die Verbindung auf mehrere Projekte zu, nennt der Assistent für eine Änderung das Projekt ausdrücklich.
- list_projects (lesen): Projekte dieser Verbindung mit Kennung, Domain und Rechten, dazu das Standardprojekt.
- get_overview (lesen): Rivly-Index, Kanalwerte und „Kurz gesagt“ der aktuellen Woche.
- get_ai_answers (lesen): KI-Antworten im Wortlaut je Kauffrage und System, mit Quellen.
- get_rankings (lesen): Google-Positionen, KI-Übersicht und Suchvolumen je Suchanfrage.
- get_competitors (lesen): Wettbewerber mit Werten aller vier Kanäle.
- get_recommendations (lesen): Offene Empfehlungen mit Schritten, Punkten und Status.
- get_core (lesen): Profil, Angebot, Suchanfragen mit Volumen, Kauffragen und Wettbewerber mit dem Grund ihrer Aufnahme aus dem Kern des Projekts.
- get_map (lesen): Marktkarte des Fahrplans: Felder mit Stand, Nachfrage, Spitzenreiter und eigener Seite, dazu die Maßnahmen mit ihrer Kennung.
- get_site_audit (lesen): Website und Seiten: Technik, Sitemap, llms.txt, Zugang für KI-Anbieter und Seiten-Potenzial.
- get_page_brief (lesen): Seitenbrief zu einer Maßnahme oder einem Feld: Überschrift, Abschnitte, Kundenfragen, Schema und llms.txt-Zeile.
- get_llms_txt (lesen): Entwurf der llms.txt mit den Seiten des Kerns, dazu die Zeilen für Seiten, die noch nicht online sind.
- get_structure (lesen): Struktur der Website gegen die Nachfrage: Nachfrage ohne Seite, Seiten ohne Platz 1 und Themen ohne Nachfrage.
- 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.
- get_ads (lesen): Kanal Werbung: aktive Anzeigen der Marke und der Wettbewerber aus Meta und Google, mit Themen und Winnern.
- get_press (lesen): Kanal Presse: redaktionelle Artikel der letzten 30 Tage, Anteil an der Berichterstattung und Medien, die nur Wettbewerber nennen.
- get_backlinks (lesen): Backlinks: verweisende Domains gegen die Wettbewerber, starke Links, Lücken und fehlende Verzeichnisse, monatlich erhoben.
- get_business_profile (lesen): Google Business: eigene Einträge mit Prüfung gegen die Website, Platz in Google Maps und Bewertungen.
- get_history (lesen): Verlauf je Kalenderwoche: Rivly-Index und die Kanäle GEO, SEO, Werbung und Presse, dazu Ereignisse wie eine neue Messbasis.
- get_measure_plan (lesen): Messplan: welche Kauffragen und Suchanfragen Rivly regelmäßig misst, mit letztem Ergebnis und freien Plätzen im Tarif.
- get_keyword_topics (lesen): Fokus-Suchanfragen nach Thema und nach rankender Seite, je Gruppe mit Nachfrage, Plätzen in den Top 10 und Zielseite.
- get_portfolio (lesen): Alle Projekte dieser Verbindung auf einen Blick: Rivly-Index mit Veränderung, die vier Kanäle und der nächste Schritt je Projekt.
- update_recommendation (schreiben): Schritt abhaken, einplanen oder erledigt melden.
- add_prompt (schreiben): Kauffrage oder Suchanfrage zum Messplan hinzufügen.
- check_page (schreiben): Eine Seite der Website sofort prüfen: erreichbar, Sitemap, Verlinkung, Suchanfrage, Schema und llms.txt.
- mark_action_done (schreiben): Aktive Maßnahme als erledigt melden, die nächste Messung prüft die Wirkung.
- ask_live_check (schreiben): Eine Frage live an ChatGPT und Gemini stellen, mit derselben Wochenquote wie der Chat in der App.
- promote_live_check (schreiben): Eine Frage aus dem Live-Check als Kauffrage in den Messplan übernehmen, damit sie jede Woche gemessen wird.
- create_page_brief (schreiben): Einen neuen Seitenbrief zu einer Maßnahme oder einem Feld schreiben lassen, mit derselben Monatsquote wie der Knopf im Fahrplan.
- set_keyword_topic (schreiben): Suchanfragen einem Thema zuordnen oder aus ihm nehmen, ein neues Thema anlegen und seine Zielseite setzen.
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.“
- 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“.
- 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.
- Der Assistent baut die Seite. Mit Zugriff auf den Code Ihrer Website, zum Beispiel in Cursor, legt er sie direkt dort an.
- check_page: Nach dem Veröffentlichen prüft er die Seite sofort: erreichbar, Sitemap, Verlinkung, Suchanfrage, Schema und llms.txt.
- mark_action_done: Er meldet die Maßnahme als erledigt. Die nächste Messung prüft die Wirkung.
Sicherheit
Eine Verbindung gilt für die gewählten Projekte und Rechte, ein Schlüssel für genau ein Projekt. Andere Projekte bleiben außen vor. Ein Assistent darf nie mehr als die Person, die ihn verbunden hat: Was ihre Rolle nicht darf, lehnt Rivly auch über MCP ab. Endet ihr Zugang zu einem Projekt, endet er im selben Moment für den Assistenten.
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.
Bei der Anmeldung speichert Rivly den Namen, den der Assistent angibt, und die Adresse, zu der er zurückkehrt. Der Zugang gilt jeweils eine Stunde und erneuert sich, solange der Assistent ihn nutzt. Ohne Nutzung endet er nach 90 Tagen.
Verbundene Assistenten stehen im Tab „MCP & Agenten“ unter „Verbundene Assistenten“. „Bearbeiten“ ändert Projekte und Rechte der eigenen Verbindung, „Trennen“ beendet eine Verbindung sofort. Beim Schlüssel trennt „Widerrufen“ alle Agenten mit diesem Schlüssel, „Neuen Schlüssel erstellen“ ebenso und gibt Ihnen gleich den neuen mit denselben Rechten.
Projekte, die jemand mit Ihnen teilt, etwa Ihre Agentur, verbinden Sie genauso: Sie stehen auf der Seite von Rivly in der Projektauswahl, und Ihre Rolle im Projekt bestimmt, ob der Assistent schreiben darf. Im Tab „MCP & Agenten“ eines geteilten Projekts sehen Sie die Adresse und Ihre eigenen Verbindungen. Schlüssel für eigene Agenten erstellt nur der Inhaber des Kontos, zu dem das Projekt gehört. Er sieht auch Ihre Verbindung und kann Ihren Zugang zum Projekt jederzeit beenden.
Wenn es nicht klappt
- Die Seite von Rivly öffnet sich nicht: Pop-ups für den Assistenten erlauben und die Verbindung im Assistenten neu starten, in Claude und ChatGPT mit „Verbinden“ beim Server.
- „Die Rücksprungadresse passt nicht“ oder „Diese Anfrage ist abgelaufen“: Die Verbindung im Assistenten neu starten, nicht die Seite von Rivly über ein Lesezeichen öffnen.
- Rivly zeigt kein Projekt: Sie sind mit einem Konto ohne Projekt angemeldet. Über „Anderes Konto“ abmelden und mit dem richtigen Konto anmelden.
- Punkte in der Mitte des Schlüssels, etwa rv_live_ab12cd…9f3a: Das ist die verkürzte Anzeige, nicht der Schlüssel. Agenten melden dann Fehler 401 oder „Cannot convert argument to a ByteString“. Erstellen Sie im Tab „MCP & Agenten“ einen neuen Schlüssel und kopieren Sie ihn direkt danach.
- Fehler 401 bei einem eigenen Agenten: Der Schlüssel ist widerrufen, ersetzt oder nicht vollständig eingetragen. Ein vollständiger Schlüssel beginnt mit rv_live_ und hat 48 Zeichen. Den Grund nennt Rivly im Text der Fehlermeldung. Bei einer Verbindung über die Anmeldung erneuert der Assistent den Zugang selbst, bleibt der Fehler, trennen und neu verbinden.
- „spawn npx ENOENT“ in Claude Desktop: Die ältere Einrichtung über mcp-remote braucht Node.js. Einfacher ist der Weg über die Konnektoren, wie oben unter Claude beschrieben.
- Fehler 429: Mehr als 60 Abfragen in einer Minute je Verbindung oder Schlüssel. Der Assistent kann die Abfrage nach einer Minute wiederholen.
- „Diese Verbindung darf nur lesen“ oder „Dieser Schlüssel darf nur lesen“: Das Werkzeug schreibt. Bei einer Verbindung stellen Sie die Rechte im Tab „MCP & Agenten“ mit „Bearbeiten“ auf „Lesen und schreiben“, beim Schlüssel stellen Sie sie im selben Tab um.
- „Dieses Projekt gehört nicht zu dieser Verbindung“: Das Projekt ist nicht ausgewählt oder Ihr Zugang dazu besteht nicht mehr. Mit „Bearbeiten“ bei der Verbindung wählen Sie die Projekte neu.
- „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.
- Der Assistent findet Rivly nicht: Meist fehlt der Neustart. Beenden Sie den Assistenten vollständig und öffnen Sie ihn erneut.
In der App