Zusammenfassung
Lass deine KI mit Iterable arbeiten: Nutzer mit ihren Events und Nachrichten nachschlagen, Listen, Kampagnen und Kampagnenkennzahlen, Vorlagen und Kataloge auswerten, Profile aktualisieren, Events erfassen, Listenmitgliedschaften verwalten und nach deiner Bestätigung eine getriggerte E-Mail senden.
Geführte Einrichtung
Iterable in 2 Minuten mit Microsoft Copilot verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde Iterable in der geführten Einrichtung und trag deine MCP-URL in Microsoft Copilot ein. Ohne Code, ohne eigenen Server.
Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar
Frag einfach
Beispiel-Prompts für Iterable
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Iterable klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein
git clone, kein lokaler Server.
Iterable + Microsoft Copilot
Lass deine KI mit Iterable arbeiten: Nutzer mit ihren Events und Nachrichten nachschlagen, Listen, Kampagnen und Kampagnenkennzahlen, Vorlagen und Kataloge auswerten, Profile aktualisieren, Events erfassen, Listenmitgliedschaften verwalten und nach deiner Bestätigung eine getriggerte E-Mail senden.
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:
ITERABLE_API_URL, ITERABLE_API_KEY
Schritt 1 — Zugangsdaten holen
Die Einrichtung dauert etwa 3 Minuten. Du brauchst einen Iterable-Benutzer, der im Projekt API-Keys anlegen darf, und musst wissen, ob das Projekt in den USA oder in der EU gehostet ist.
- Öffne in Iterable in den Projekteinstellungen Integrations → API Keys und klicke auf New API Key. Wähle einen Server-side-Key, wenn die KI lesen und schreiben soll, oder einen Read-only-Key, wenn sie nur lesen soll. JavaScript- und Mobile-Keys funktionieren hier nicht.
- Kopiere den Key und füge ihn in
ITERABLE_API_KEYein. Ein Key gehört zu genau einem Projekt, ein Connector arbeitet also mit einem Iterable-Projekt. Der Key wird nur an Iterable gesendet, im HeaderApi-Key. - Setze
ITERABLE_API_URLauf das Rechenzentrum des Projekts:https://api.iterable.comfür Projekte in den USA,https://api.eu.iterable.comfür Projekte in der EU (bei denen du dich unter app.eu.iterable.com anmeldest), ohne/apioder einen anderen Pfad. - Installiere den Connector und starte mit
iterable_list_channels: Es prüft den Key und zeigt die Marketing- und Transaktionskanäle des Projekts.
Ein Key für das ganze Projekt: Der Key handelt für das Projekt, nicht für eine einzelne Person. Wer diesen Connector nutzt, sieht jeden Nutzer und jede Kampagne, die der Key lesen darf. Teile den MCP-Server deshalb nur mit Menschen, die das sehen dürfen.
Was abgedeckt ist: Nutzerprofile per E-Mail oder userId mit allen Feldern, ihre letzten Events (eigene Events, Käufe, Versand, Öffnungen, Klicks, Bounces, Abmeldungen) und die an sie gesendeten Nachrichten; Listen mit ihrer Größe und ihren Mitgliedern; Kampagnen mit Details und Kennzahlen; Vorlagen, Kanäle, Nachrichtentypen, Kataloge und Katalogeinträge. Kampagnenkennzahlen kommen als Tabelle, eine Zeile pro Kampagne, mit Sendungen, Zustellungen, eindeutigen Öffnungen und Klicks, Bounces, Beschwerden, Abmeldungen, Käufen und Umsatz.
Änderungen erst nach deinem Ja: Die KI zeigt, was sie schreiben wird, und wartet vor jeder Änderung auf deine Bestätigung.
iterable_update_userführt Felder in ein Profil zusammen. Geänderte Felder können den Nutzer in dynamische Listen verschieben und Journeys starten.iterable_track_eventerfasst ein eigenes Event, etwa eine Anmeldung oder eine Buchung, das ebenfalls eine Journey starten kann.iterable_subscribe_to_listunditerable_unsubscribe_from_liständern die Listenmitgliedschaft. Eine Abmeldung mit der Kanal-Option wirkt wie eine globale Abmeldung von diesem Kanal.iterable_send_emailsendet eine echte E-Mail aus einer getriggerten Kampagne an eine Person, sofort oder zu einem festen Zeitpunkt. Sendungen an viele Menschen bleiben Kampagnen in Iterable.
Bei der Installation ausgeschaltet: iterable_delete_user_by_email und iterable_delete_user_by_user_id entfernen Profile samt Daten endgültig. Ein Administrator schaltet sie nur bewusst ein. Mit einem Read-only-Key antwortet jeder Schreibvorgang mit 403; schalte für ein reines Lese-Setup die Schreib-Tools aus.
E-Mail oder userId: Je nachdem, ob das Projekt E-Mail-basiert, userID-basiert oder hybrid ist, identifiziert die KI einen Nutzer per E-Mail oder per userId, nie mit beidem im selben Aufruf. Zeiten in Antworten sind Epoch-Millisekunden.
Limits pro Projekt: die meisten Lesezugriffe 100 Aufrufe pro Sekunde, Kampagnenkennzahlen 10 pro Minute, Listengröße und Listenmitglieder 5 pro Minute, gesendete Nachrichten 3 pro Sekunde. Die Mitglieder großer Listen werden bei etwa 100 KB abgeschnitten; die KI prüft vorher die Listengröße.
Häufige Fehler: 401 „Invalid API key“ heißt, der Key ist falsch oder gelöscht, ein JavaScript- oder Mobile-Key oder aus dem anderen Rechenzentrum; prüfe ITERABLE_API_URL. 400 mit einem Code wie BadParams oder RequestFieldsTypesMismatched: Ein Parameter oder ein Feldtyp stimmt nicht, die Meldung sagt welcher. 404 oder NotFound: Nutzer, Liste oder Kampagne gibt es in diesem Projekt nicht. 429: Ein Ratenlimit ist erreicht; warte kurz und versuche es erneut.
Der Connector startet keine Export-Jobs und nutzt keine Bulk-Endpunkte, bearbeitet keine Vorlagen oder Snippets, verwaltet keine Experimente oder Journeys, sendet keine In-App-, Push-, SMS- oder Web-Push-Nachrichten, ändert keine Abos pro Nachrichtentyp und ändert keine Kataloge.
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 AnleitungYOUR_SERVER_IDzeigt.
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.
- Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
- Trag einen Server name ein (zum Beispiel
AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft. - Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf
X-API-Keyund klicke auf Create. - 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.
- Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die
Iterable-Tools braucht. - 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
| Tool | What it does |
|---|---|
iterable_list_lists | List the user lists of the Iterable project: id, name, type (Standard, Dynamic, Suppression, Internal), description and creation time… |
iterable_get_list_size | Count the users in one Iterable list |
iterable_list_list_users | Get the users of one Iterable list as plain text, one email (or userId) per line |
iterable_get_user_by_email | Get an Iterable user profile by email: email, userId and all dataFields (profile fields, subscription and channel settings, signup date and… |
iterable_get_user_by_id | Get an Iterable user profile by userId: email, userId and all dataFields |
iterable_get_user_events_by_email | Get the latest events of an Iterable user by email, newest first: custom events, purchases, email sends, opens, clicks, bounces… |
iterable_get_user_events_by_user_id | Get the latest events of an Iterable user by userId, newest first: custom events, purchases, message sends, opens, clicks, bounces and… |
iterable_get_sent_messages | List the messages Iterable sent to a user (by email or userId): message id, campaign id, template id and time, optionally filtered by… |
iterable_list_campaigns | List the campaigns of the Iterable project, a page at a time: id, name, type (Blast or Triggered), state, message medium, template, lists… |
iterable_get_campaign | Get one Iterable campaign by id: name, type, state, message medium, template id, send size, lists and suppression lists, labels, workflow… |
iterable_get_campaign_metrics | Get campaign metrics from Iterable as CSV text: one row per campaign with columns such as total sends, deliveries, unique opens and clicks… |
iterable_list_templates | List the message templates of the Iterable project, a page at a time: template id, name, message type, campaign, creator, created and… |
iterable_list_channels | List the message channels of the Iterable project: id, name, channel type (Marketing or Transactional) and medium (Email, Push, SMS) |
iterable_list_message_types | List the message types of the Iterable project: id, name, channel id, subscription policy (opt-in or opt-out), frequency cap and rate limit |
iterable_list_catalogs | List the catalog names of the Iterable project (catalogs hold products, articles or other items used for personalization) |
iterable_list_catalog_items | List the items of one Iterable catalog, a page at a time: item id, last modified time and the item's fields |
iterable_update_user | Create or update an Iterable user profile by email or userId: the dataFields given are merged into the profile, missing fields are kept |
iterable_track_event | Record a custom event for an Iterable user (by email or userId), such as a signup, a booking or a page view, with its data |
iterable_subscribe_to_list | Add users to a static Iterable list (by email or userId), creating profiles that do not exist unless update_existing_users_only is true |
iterable_unsubscribe_from_list | Remove users from a static Iterable list (by email or userId) |
iterable_send_email | Send the email of a triggered Iterable campaign to one user (by email or userId), now or at send_at, with dataFields for the template |
iterable_delete_user_by_email | Delete an Iterable user by email, asynchronously (email-based and hybrid projects) |
iterable_delete_user_by_user_id | Delete Iterable users by userId, asynchronously; every profile with that userId is removed for good |
Beispiel-Prompts
- „Schlag [email protected] in Iterable nach: ihre Profilfelder, ihre letzten 20 Events und die Kampagnen, die ihr diesen Monat eine E-Mail geschickt haben.“
- „Vergleiche Sendungen, eindeutige Öffnungen, eindeutige Klicks und Abmeldungen unserer letzten fünf Blast-Kampagnen in einer Tabelle.“
- „Wie viele Nutzer sind in der Liste VIP Newsletter, und welche Vorlagen nutzt die Kampagne Welcome?“
- „Füge [email protected] zur Liste Beta testers hinzu und erfasse für ihn ein Event beta_signup, aber zeig mir vorher, was du schreibst.“
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
War dieser Guide hilfreich?