CleverReach über MCP mit Cursor verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → CleverReach klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

CleverReach + Cursor

E-Mail-Marketing mit CleverReach aus Deutschland: Gruppen und Empfänger mit Attributen, Tags und Events, Massen-Upserts, Aktivierung und Double-Opt-in-Mails, Blacklist und Bounces, Mailing-Entwürfe mit Vorschau und Vorlagen sowie Berichte versendeter Mailings mit Öffnungen, Klicks und Bounces. REST API v3 mit OAuth; der finale Versand an eine Liste bleibt in CleverReach.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

CLEVERREACH_CLIENT_ID, CLEVERREACH_CLIENT_SECRET

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 10 Minuten. Du brauchst Admin-Rechte in deinem CleverReach-Konto, um eine OAuth-App anzulegen.

1. Öffne in CleverReach Account, Extras, REST API und lege eine OAuth-App an.
2. Wähle die Scopes Recipients (oa_receivers), Reports (oa_reports), Forms (oa_forms) und Emails (oa_mailings).
3. Trag die Redirect-URL <your AnythingMCP URL>/api/mcp-oauth/callback ein. Auf AnythingMCP Cloud ist das https://cloud.anythingmcp.com/api/mcp-oauth/callback.
4. Kopiere die Client ID der App in CLEVERREACH_CLIENT_ID und das Client Secret in CLEVERREACH_CLIENT_SECRET. Lass CLEVERREACH_REFRESH_TOKEN leer und installiere den Connector.
5. Klicke auf der Connector-Seite auf Authorize with Provider und melde dich bei CleverReach an. Das Refresh-Token wird für dich eingetragen und gespeichert, Access-Tokens werden automatisch erneuert.
6. Führe cleverreach_whoami aus: Es zeigt das Konto, zu dem das Token gehört, und bestätigt die Verbindung.

Was er liest: Gruppen (Empfängerlisten) mit der Zahl aller, aktiver, inaktiver und gebouncter Empfänger sowie ihren Filtern (Segmenten); die Empfänger einer Gruppe mit E-Mail, Aktiv-Status, Zeitstempeln, Quelle und Attributen; einen Empfänger per ID oder E-Mail mit globalen Attributen, Tags, Punkten und Bounce-Status, den Gruppen, in denen er ist, und seinen Events aus Shops oder Apps; Empfänger über Gruppen hinweg, gefunden mit einem temporären Filter (es wird nichts gespeichert); Tags und Attribute (Datenfelder); die Blacklist und Bounces nach Kategorie (hardbounce, softbounce, blocked, delayed, spam); Anmeldeformulare; Mailings nach Status (finished, draft, waiting, running, automation) mit Inhalt und Links; deine eigenen Vorlagen und Mailing-Kategorien; Berichte versendeter Mailings mit Öffnungen, Klicks, Bounces, Abmeldungen, Detailstatistiken nach Modus (Clients, Länder, erste Stunden, Links, Conversion und mehr) und den Empfängern, die geöffnet, geklickt, gebounct oder sich abgemeldet haben.

Was er schreibt: Gruppen mit cleverreach_create_group und cleverreach_update_group; Empfänger mit cleverreach_create_receiver, cleverreach_upsert_receivers (viele auf einmal, abgeglichen per E-Mail, in Paketen von einigen Hundert), cleverreach_update_receiver, cleverreach_activate_receiver und cleverreach_deactivate_receiver (bleibt in der Gruppe, bekommt aber keine Mailings); Tags mit cleverreach_add_receiver_tags und cleverreach_remove_receiver_tags; Datenfelder mit cleverreach_create_attribute (global oder pro Gruppe mit group_id); die Blacklist mit cleverreach_add_to_blacklist und cleverreach_remove_from_blacklist; Mailing-Entwürfe mit cleverreach_create_mailing und cleverreach_update_mailing sowie Testversand mit cleverreach_send_mailing_preview, der nur E-Mail-Adressen von Benutzern deines CleverReach-Kontos annimmt.

Double Opt-in: Die KI legt den Empfänger mit registered auf jetzt und activated „0“ an und ruft dann cleverreach_send_form_mail mit dem Typ activate und einer Formular-ID aus cleverreach_list_forms auf; als Nachweis der Einwilligung übergibt sie doidata. CleverReach aktiviert den Empfänger, sobald der Link geklickt wird. Ohne registered und activated ist ein neuer Empfänger sofort aktiv, und dafür brauchst du eine nachweisbare Einwilligung.

Einwilligung: Empfänger sind personenbezogene Daten im Sinne der DSGVO. Die KI fügt nur Adressen mit dokumentierter Einwilligung hinzu oder aktiviert sie, zeigt dir, was sich ändert, und wartet vor jedem Schreibzugriff auf dein Ja.

Bei der Installation deaktiviert: cleverreach_delete_receiver, das einen Empfänger endgültig aus einer Gruppe löscht, etwa für eine Löschanfrage; seine Historie in dieser Gruppe geht verloren. Ein Workspace-Admin schaltet es bewusst ein. Bis dahin hält das Deaktivieren den Empfänger aus allen Mailings heraus.

Datenformate: IDs sind Zahlen, die als Strings gesendet werden. Empfänger-Tools nehmen die Empfänger-ID oder die E-Mail-Adresse. Zeiten (registered, activated, deactivated, stamp, Berichtsdaten) sind Unix-Zeitstempel in Sekunden; 0 heißt nicht gesetzt. Ein Empfänger ist in einer Gruppe aktiv, wenn activated gesetzt und deactivated 0 ist. global_attributes gelten in jeder Gruppe, attributes in einer Gruppe. Tags bestehen aus Buchstaben, Ziffern, _ und -, mit optionalem Herkunftspräfix vor einem Punkt, etwa shop.vip.

Blättern: Seiten beginnen bei 0. Empfänger nehmen pagesize (bis 5000) und page; Bounces kommen mit bis zu 500 pro Seite; Mailings nehmen limit und page (Blättern nur, wenn state nicht all ist). Eine Seite, die kürzer als die Seitengröße ist, ist die letzte.

Häufige Fehler: Die Antwort enthält einen Fehlercode und eine Meldung. 401 bedeutet, dass das Token abgelaufen ist oder widerrufen wurde: Klicke erneut auf Authorize with Provider und prüfe, ob Client ID und Secret zur selben App gehören. 403 bedeutet, dass der OAuth-App der Scope für diesen Bereich fehlt: Ergänze Recipients, Reports, Forms oder Emails in der App und autorisiere erneut. 404 bedeutet eine unbekannte ID oder eine Adresse, die nicht in dieser Gruppe oder nicht auf der Blacklist steht. 400 bedeutet ungültige Daten, etwa einen falschen Attributnamen oder Zeitstempel.

Der Connector verschickt kein Mailing an seine Liste: CleverReach vergibt das nur mit einem zusätzlichen Scope auf Anfrage, deshalb startest du den finalen Versand in CleverReach, nachdem du die Vorschau geprüft hast. Er löscht keine Gruppen oder Mailings und legt keine Formulare oder Vorlagen an.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Cursor hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Cursor liest MCP-Server aus ~/.cursor/mcp.json. Füge diesen Eintrag hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte Cursor neu.
3. Öffne Cursor → Settings → MCP und prüfe, ob anythingmcp aufgeführt und verbunden ist.
4. Leg los: Der Agent kann jetzt die CleverReach-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Wie viele aktive, inaktive und gebouncte Empfänger hat die Gruppe Newsletter DE?“
• „Füg [email protected] mit dem Vornamen Max zur Gruppe Webinar-Leads hinzu und schick ihm die Double-Opt-in-Mail unseres Anmeldeformulars.“
• „Welche Empfänger haben im Newsletter der letzten Woche auf den Preis-Link geklickt? Liste ihre E-Mail-Adressen auf.“
• „Leg für die Gruppe Kunden einen Mailing-Entwurf mit dem Betreff „Unser Herbst-Update“ an und schick eine Vorschau an meine eigene Adresse.“
• „Vergleich die Öffnungs- und Klickraten der letzten drei versendeten Newsletter.“

FAQ

Unterstützt Cursor eigene MCP-Server im kostenlosen Tarif? Ja, MCP gibt es in den Tarifen Hobby, Pro und Business.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden