Smartlead über MCP mit ChatGPT verbinden

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

Smartlead + ChatGPT

Cold-E-Mail-Outreach mit Smartlead in jedem KI-Agent: Kampagnen mit Sequenzen und Zeitplänen aufbauen und steuern, Leads und ihre Kategorien verwalten, Antworten im Master-Inbox lesen und beantworten, Kampagnen- und Kontoanalysen vergleichen und Absender-Mailboxen samt Warmup prüfen. Mit einem Smartlead-API-Schlüssel; endgültige Abmeldungen und 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:

SMARTLEAD_API_KEY

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 2 Minuten. Für den API-Zugang brauchst du einen kostenpflichtigen Smartlead-Tarif.

1. Öffne in Smartlead Settings und den Bereich API Keys (in manchen Tarifen unter Settings, Integrations).
2. Kopiere den API-Schlüssel in SMARTLEAD_API_KEY. Der Connector hängt ihn an jede Anfrage als Query-Parameter api_key an, füge also nur den Schlüssel ein.
3. Installiere den Connector und führe smartlead_list_campaigns aus: Es listet deine Kampagnen und bestätigt den Schlüssel.

Der Schlüssel gibt vollen Zugriff auf das Konto, behandle ihn also wie ein Passwort.

Kampagnen: smartlead_list_campaigns kommt zuerst, denn die id jeder Kampagne ist die campaign_id aller anderen Tools. smartlead_get_campaign, smartlead_get_campaign_sequences und smartlead_list_campaign_email_accounts zeigen ihren Aufbau. Für eine neue Kampagne verkettet die KI smartlead_create_campaign (eine leere Kampagne im Status DRAFTED), smartlead_save_campaign_sequences, smartlead_update_campaign_schedule (Zeitzone, Wochentage, Versandfenster, Minuten zwischen E-Mails, neue Leads pro Tag, Startzeit), smartlead_update_campaign_settings (Name, Öffnungs- und Klick-Tracking, wann ein Lead keine Mails mehr bekommt, Nur-Text, Follow-up-Anteil, KI-Mailbox-Zuordnung, Abmeldetext), smartlead_add_email_accounts_to_campaign und smartlead_add_leads_to_campaign, danach smartlead_update_campaign_status mit START. Die Status sind START (nicht ACTIVE), PAUSED, STOPPED (endgültig; für eine Pause nimm PAUSED) und ARCHIVED. Ein Start verschickt echte E-Mails, lass dir also vorher Sequenz, Zeitplan und Anzahl der Leads zeigen.

Sequenzen: smartlead_save_campaign_sequences ersetzt die ganze Sequenz: Weggelassene Schritte werden entfernt. Die KI liest sie vorher mit smartlead_get_campaign_sequences, behält die IDs bestehender Schritte und sendet jeden Schritt. Personalisiert wird mit {{first_name}}, {{company_name}} und den Namen deiner benutzerdefinierten Felder.

Leads:

• smartlead_list_campaign_leads listet die Leads einer Kampagne. Jede Zeile hat die Campaign-Lead-Map-ID (die id der Zeile, genutzt von smartlead_create_lead_note) und den Lead selbst (lead.id, genutzt als lead_id).
• smartlead_get_lead_by_email findet einen Lead über alle Kampagnen, smartlead_get_lead liest einen per ID, smartlead_get_lead_campaign_overview zeigt alle Kampagnen, in denen er steckt.
• smartlead_add_leads_to_campaign nimmt höchstens 400 Leads pro Aufruf. Leads auf der globalen Sperrliste, abgemeldete oder schon in anderen Kampagnen laufende Leads werden übersprungen, sofern die Einstellungen nichts anderes sagen; die Antwort zählt hochgeladene, doppelte und gesperrte Leads.
• Änderungen: smartlead_update_lead (die API verlangt die E-Mail auch, wenn sie gleich bleibt; bis zu 200 benutzerdefinierte Felder), smartlead_update_lead_category (IDs aus smartlead_list_lead_categories, optional mit Pausieren), smartlead_pause_lead, smartlead_resume_lead (sofort oder nach einigen Tagen) und smartlead_unsubscribe_lead_from_campaign für eine Kampagne.

Antworten: smartlead_list_inbox_replies listet Antworten aus dem Master-Inbox über alle Kampagnen, neueste zuerst, gefiltert nach Kampagne, Mailbox, Kategorie oder Antwortzeit; smartlead_get_inbox_item öffnet einen Thread. Zum Antworten liefert smartlead_get_lead_message_history für jede Nachricht stats_id, message_id und time; die KI übergibt sie als email_stats_id, reply_message_id und reply_email_time an smartlead_reply_to_lead. Die Antwort geht von der Mailbox dieses Threads raus, sofort oder zu einer scheduled_time. smartlead_create_lead_note legt eine interne Notiz an.

Analysen: pro Kampagne smartlead_get_campaign_analytics (Gesamtwerte seit Start und Fortschritt der Leads), smartlead_get_campaign_analytics_by_date, smartlead_get_campaign_sequence_analytics (pro Schritt und A/B-Variante) und smartlead_get_campaign_statistics (eine Zeile pro gesendeter E-Mail). smartlead_get_overall_analytics deckt das ganze Konto ab, optional beschränkt auf bestimmte Kampagnen oder Kunden.

Mailboxen und Warmup: smartlead_list_email_accounts zeigt Adresse, Anbieter, Tageslimits, SMTP/IMAP-Zustand und Warmup; eine kaputte Verbindung hat isSmtpSuccess=false. Dazu smartlead_get_email_account, smartlead_get_warmup_stats (letzte 7 Tage: gesendete Warmup-Mails, im Posteingang, im Spam, Antworten), smartlead_update_email_account (Tageslimit, Absendername, Signatur, BCC, eigene Tracking-Domain, Minuten zwischen E-Mails) und smartlead_update_warmup (an oder aus, Tagesvolumen, Steigerung, Antwortquote).

Webhooks, Agenturen und Listen: smartlead_list_campaign_webhooks und smartlead_upsert_campaign_webhook (legt einen an oder aktualisiert ihn, wenn id übergeben wird) mit den Events EMAIL_SENT, EMAIL_OPEN, EMAIL_LINK_CLICK, EMAIL_REPLY, EMAIL_BOUNCE, LEAD_UNSUBSCRIBED und LEAD_CATEGORY_UPDATED. smartlead_list_clients liefert die Kunden-IDs eines Agentur-Kontos (White Label); smartlead_list_lead_lists listet die Lead-Listen.

Bei der Installation ausgeschaltet: smartlead_unsubscribe_lead_globally (meldet den Lead von allen Kampagnen ab und sperrt künftige Importe der Adresse), smartlead_delete_lead_from_campaign (entfernt den Lead samt Fortschritt aus dieser Kampagne) und smartlead_delete_campaign_webhook. Sie lassen sich nicht rückgängig machen, deshalb schaltet ein Workspace-Admin sie ein, wenn das Team sie braucht.

Datenformate: Zählwerte sind Anzahlen von E-Mails oder Leads, Quoten sind Prozentwerte. Analysedaten sind YYYY-MM-DD, mit optionaler IANA-Zeitzone (Standard UTC) für die Tagesgrenzen. Zeitstempel sind ISO 8601 in UTC, sofern keine Zeitzone übergeben wird.

Seitenweise Abfrage: Listen nehmen offset (Standard 0) und limit (Standard 100, beim Inbox 20). Die KI erhöht offset um limit, bis weniger Zeilen als limit kommen; smartlead_list_campaign_leads liefert zusätzlich total_leads.

Limits und häufige Fehler: Smartlead bremst Anfragespitzen (in Standardtarifen etwa 10 Anfragen pro 2 Sekunden) und antwortet mit 429; kurz warten und erneut versuchen. 401 Invalid API Key heißt falscher Schlüssel, 404 eine falsche ID oder eine ID aus einem anderen Konto, und 400 nennt das ungültige Feld.

Der Connector verbindet keine neuen Absender-Mailboxen und löscht keine Kampagnen.

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 ChatGPT 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.

ChatGPT fügt MCP-Server als Plugins auf seiner Seite Plugins hinzu, im Web und in den kostenpflichtigen Tarifen. Den Entwicklermodus brauchst du dafür nicht mehr. In einem Business-Workspace dürfen das nur Admins und Owner; in Enterprise und Edu kann ein Admin die Berechtigung Create plugins with MCPs vergeben.

1. Geh zu chatgpt.com/plugins, klicke auf + und dann auf Add custom MCP server.
2. Gib einen Namen ein, z. B. Name: Smartlead.
3. Trag unter Connection als Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID ein und lass Authentication auf OAuth.
4. Wähle I understand and want to continue und dann Create as a plugin. Wenn ChatGPT danach fragt, meldest du dich bei AnythingMCP an und erlaubst den Zugriff.
5. Installiere das neue Plugin unter deinen persönlichen Plugins, tippe dann in einem Chat @ und wähle es aus.

Verfügbare Tools

Beispiel-Prompts

• „Welche meiner aktiven Kampagnen hat diesen Monat die beste Antwortquote? Zeig für jede Versand, Antworten und Bounces.“
• „Zeig mir die Antworten der letzten 24 Stunden, die als Interested kategorisiert sind.“
• „Antworte auf die letzte Mail von [email protected] in der Kampagne Q4 Outreach und schlag ein Telefonat nächste Woche vor. Zeig mir den Text vor dem Senden.“
• „Welche Absender-Mailboxen haben eine kaputte SMTP-Verbindung oder viele Warmup-Mails im Spam?“
• „Pausiere den Lead [email protected] in allen Kampagnen, in denen er ist.“

FAQ

Funktioniert der kostenlose ChatGPT-Tarif mit eigenen MCP-Servern? OpenAI dokumentiert eigene MCP-Server nur für kostenpflichtige Tarife; den Free-Tarif führt OpenAI nicht auf.

Nächste Schritte

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