HeyReach über MCP mit Cursor verbinden

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

HeyReach + Cursor

LinkedIn-Outreach mit HeyReach in jedem KI-Agent: Kampagnen steuern und Leads hinzufügen oder stoppen, Lead- und Firmenlisten sowie Lead-Tags pflegen, Unterhaltungen im gemeinsamen LinkedIn-Postfach lesen und beantworten, Absenderkonten und Kontakte 1. Grades prüfen, Outreach-Statistiken vergleichen und Webhooks verwalten. Mit einem HeyReach-API-Schlüssel; Löschungen sind bei der Installation ausgeschaltet.

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:

HEYREACH_API_KEY

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 2 Minuten. Du brauchst einen HeyReach-Workspace.

1. Öffne in HeyReach Integrations und den Bereich HeyReach API.
2. Klicke auf Get API Key, dann auf New API Key, und kopiere den Schlüssel in HEYREACH_API_KEY. Schlüssel laufen nicht ab, lassen sich dort aber löschen oder deaktivieren. Ein Schlüssel gehört zu genau einem Workspace.
3. Installiere den Connector und führe heyreach_check_api_key aus: Es antwortet mit 200 und leerem Body, wenn der Schlüssel funktioniert.

Der Schlüssel wird im Header X-API-KEY gesendet.

IDs: campaign_id kommt aus heyreach_list_campaigns, Absender-IDs (account_id, linkedin_account_id, sender_id) aus heyreach_list_linkedin_accounts, list_id aus heyreach_list_lists, conversation_id aus heyreach_list_conversations, webhook_id aus heyreach_list_webhooks. Ein Lead wird über seine LinkedIn-Profil-URL (https://www.linkedin.com/in/<slug>/) oder seine LinkedIn-ID (linkedin_id in Lead-Datensätzen) bestimmt.

Kampagnen:

• Lesen: heyreach_list_campaigns (Filter nach Status oder Absender), heyreach_get_campaign, heyreach_get_campaign_sequence (der Schrittbaum: Kontaktanfrage, Nachricht, InMail, Folgen, Like, Profilbesuch, mit Wartezeiten und Texten), heyreach_list_campaign_leads und heyreach_get_campaigns_for_lead.
• Steuern: heyreach_start_campaign startet einen Entwurf mit Sequenz, Lead-Liste und mindestens einem verbundenen LinkedIn-Absender; heyreach_pause_campaign und heyreach_resume_campaign halten ihn an und setzen ihn fort.
• Leads: heyreach_add_leads_to_campaign fügt bis zu 100 Leads pro Aufruf hinzu, optional mit festem Absender pro Lead, und kann eine pausierte Kampagne im selben Aufruf fortsetzen. heyreach_stop_lead_in_campaign stoppt einen Lead, heyreach_update_lead_custom_fields setzt benutzerdefinierte Felder, die als Variablen in Nachrichten dienen.
• Kampagnenstatus: DRAFT, IN_PROGRESS, PAUSED, FINISHED, CANCELED, FAILED, STARTING, SCHEDULED. Lead-Status: Pending, InSequence, Finished, Paused, Failed, Excluded.

Beim Starten von Kampagnen und Hinzufügen von Leads handeln deine LinkedIn-Konten an echten Profilen, lass dir also vorher Kampagne, Absender und Leads zeigen.

Listen: heyreach_list_lists, heyreach_get_list, heyreach_list_list_leads, heyreach_list_list_companies, heyreach_get_lists_for_lead, heyreach_create_list (leere Lead- oder Firmenliste) und heyreach_add_leads_to_list (bis zu 100 Leads pro Aufruf). Eine Liste ist keine Kampagne: Eine beendete Kampagne übernimmt keine neuen Listen-Leads; dafür gibt es heyreach_add_leads_to_campaign.

Leads und Tags: heyreach_get_lead liest ein Profil per URL (Name, Headline, Firma, Position, Ort, E-Mail, Tags, Berufserfahrung, Ausbildung). Dazu heyreach_get_lead_tags, heyreach_add_lead_tags (behält vorhandene Tags) und heyreach_replace_lead_tags.

Postfach: heyreach_list_conversations listet die Unterhaltungen der Absenderkonten, neueste zuerst, gefiltert nach Absender, Kampagne, Lead, Tags, Lesestatus und Zeit. E-Mail-Adressen und benutzerdefinierte Felder liefert es nicht, die hat heyreach_get_lead. heyreach_get_conversation gibt alle Nachrichten zurück, heyreach_send_message antwortet vom Absender, dem die Unterhaltung gehört, und heyreach_set_conversation_seen markiert sie als gelesen oder ungelesen. Eine gesendete Nachricht erreicht den Lead sofort auf LinkedIn, deshalb zeigt dir die KI den Text vorher.

Absender und Netzwerk: heyreach_list_linkedin_accounts und heyreach_get_linkedin_account zeigen Limits, Cooldowns sowie Sales-Navigator- und Recruiter-Status; heyreach_get_linkedin_account_status sagt, ob die LinkedIn-Sitzung noch verbunden ist und warum nicht. heyreach_list_network listet die Kontakte 1. Grades eines Absenders, heyreach_is_connection prüft einen Lead (Profil-URL oder LinkedIn-ID, nicht beides).

Statistiken: heyreach_get_overall_stats und heyreach_get_stats_by_campaign nehmen start_date und end_date (ISO 8601, zum Beispiel 2026-10-01T00:00:00.000Z) und optional Absender- und Kampagnen-IDs. Sie liefern Profilbesuche, Likes, Follows, gesendete und angenommene Kontaktanfragen, gesendete und beantwortete Nachrichten und InMails samt Annahme- und Antwortquote.

Webhooks: heyreach_list_webhooks, heyreach_get_webhook, heyreach_create_webhook und heyreach_update_webhook. Ein Event-Typ pro Webhook: CONNECTION_REQUEST_SENT, CONNECTION_REQUEST_ACCEPTED, MESSAGE_SENT, MESSAGE_REPLY_RECEIVED, EVERY_MESSAGE_REPLY_RECEIVED, INMAIL_SENT, INMAIL_REPLY_RECEIVED, FOLLOW_SENT, LIKED_POST, VIEWED_PROFILE, CAMPAIGN_COMPLETED, LEAD_TAG_UPDATED.

Bei der Installation ausgeschaltet: heyreach_delete_leads_from_list und heyreach_delete_webhook. Sie lassen sich nicht rückgängig machen, deshalb schaltet ein Workspace-Admin sie ein, wenn das Team sie braucht.

Datenformate: Zeiten sind ISO 8601, in UTC, sofern kein Offset angegeben ist. In den Statistiken ist byDayStats nach Tag (UTC) geordnet, Quoten sind Anteile (0.23 = 23 %).

Seitenweise Abfrage: Die meisten Listen nehmen offset und limit (höchstens 100) und liefern totalCount und items; heyreach_list_list_leads erlaubt bis zu 1000 pro Seite, heyreach_list_network nutzt page_size (höchstens 100). heyreach_list_conversations arbeitet mit Cursor (Standard 10, höchstens 100): Die KI gibt nextCursor als cursor zurück, bis er null ist.

Limits und häufige Fehler: 300 Anfragen pro Minute und Schlüssel; darüber antwortet HeyReach mit 429. 401 heißt falscher oder deaktivierter Schlüssel, 404 eine falsche ID, 400 ein ungültiger Body, etwa ein Name eines benutzerdefinierten Felds mit anderen Zeichen als Buchstaben, Ziffern und Unterstrichen.

Kampagnen anlegen, LinkedIn-Konten verbinden (Passwörter, Cookies, Proxys) und die Organisationsverwaltung sind bewusst ausgelassen; das erledigst du in der HeyReach-App.

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 HeyReach-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Wie lief unser LinkedIn-Outreach letzten Monat? Zeig gesendete und angenommene Kontaktanfragen und die Antwortquote pro Kampagne.“
• „Zeig mir die ungelesenen LinkedIn-Unterhaltungen der letzten 3 Tage mit Name des Leads und letzter Nachricht.“
• „Füge diese drei LinkedIn-Profile der Kampagne Founders DACH hinzu und sag mir, wie viele hinzugefügt wurden.“
• „Ist gerade eines unserer LinkedIn-Absenderkonten getrennt?“
• „In welchen Kampagnen ist https://www.linkedin.com/in/jane-doe, und welchen Status hat sie jeweils?“

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