Smartlead über MCP mit Microsoft Copilot 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 + Microsoft Copilot

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 Microsoft Copilot 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.

Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die Smartlead-Tools braucht.
6. Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.

Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.

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

Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.

Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.

Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden