Inviomail MCP Dokumentation
Diese Seite ist die öffentliche Dokumentation des Inviomail MCP-Servers für Nutzer, Entwickler und KI-Agents. Über MCP (Model Context Protocol) können ChatGPT, Claude und andere KI-Assistenten direkt mit deinem Inviomail-Konto arbeiten: Kontakte und Tags pflegen, Newsletter und Automatisierungen entwerfen, Formulare und Landingpages bearbeiten und Auswertungen lesen. Die MCP-Anbindung ist in allen Inviomail-Tarifen enthalten.
Öffentliche URLs:
- Lesbare HTML-Ansicht:
https://admin.inviomail.de/api/docs/mcp - Markdown:
https://admin.inviomail.de/api/docs/mcp.md - REST-API-Dokumentation: https://admin.inviomail.de/api/docs/api
Basisinformationen
- MCP-Server-URL:
https://mcp.inviomail.de/mcp - Transport: Streamable HTTP (stateless, Remote-MCP)
- Authentifizierung: OAuth 2.1 (empfohlen) oder statischer MCP-Key
- OAuth Authorization Server:
https://admin.inviomail.de(Metadaten unterhttps://admin.inviomail.de/.well-known/oauth-authorization-server) - Das Inviomail-Konto (Tenant) wird ausschließlich über das OAuth-Token beziehungsweise den MCP-Key bestimmt.
- Daten und Verarbeitung: Hosting in Deutschland, DSGVO-konform.
Verbindungsarten
OAuth (empfohlen)
OAuth ist die empfohlene Verbindung für ChatGPT, Claude und andere moderne MCP-Clients. Der KI-Client öffnet den sicheren Inviomail-Login, du meldest dich mit deinem normalen Inviomail-Zugang an und erlaubst die angefragten Rechte. Passwörter und statische Schlüssel werden dabei nicht mit dem Client geteilt.
Du brauchst nur die MCP-Server-URL https://mcp.inviomail.de/mcp. Ein Key ist nicht nötig.
Statischer MCP-Key
Für feste Verbindungen aus eigenen KI-Anwendungen, Agents oder Skripten ohne OAuth-Unterstützung kannst du einen statischen MCP-Key erstellen: im Inviomail-Adminbereich unter Einstellungen > Integrationen > KI-Verbindungen (MCP), Verbindungsart MCP-Key. Der Key wird nur einmal angezeigt, kann jederzeit widerrufen werden und wird bei jedem Request als Bearer-Token mitgeschickt:
POST https://mcp.inviomail.de/mcp
Authorization: Bearer <MCP-Key>
Content-Type: application/json
Accept: application/json, text/event-stream
Behandle einen MCP-Key wie ein Passwort und speichere ihn nicht in öffentlich zugänglichem Code.
Mit ChatGPT verbinden
Der genaue Wortlaut in ChatGPT kann sich ändern. Der grundsätzliche Ablauf:
- In ChatGPT die Einstellungen öffnen und den Bereich für Plugins beziehungsweise Apps aufrufen.
- Falls nötig den Entwicklermodus aktivieren, damit ein eigener MCP-Konnektor hinzugefügt werden kann.
- Eine neue MCP-Verbindung erstellen, zum Beispiel mit dem Namen
Inviomail. - Als Server-URL
https://mcp.inviomail.de/mcpeintragen und OAuth als Anmeldung wählen. - Verbindung erstellen, mit dem Inviomail-Login anmelden und die angeforderten Rechte erlauben.
Danach kannst du Inviomail im Chat auswählen und zum Beispiel fragen: Liste mir meine letzten 5 Newsletter auf.
Mit Claude verbinden
- In Claude die Einstellungen öffnen und zu Konnektoren gehen.
- Einen benutzerdefinierten Konnektor hinzufügen, zum Beispiel mit dem Namen
Inviomail. - Als URL
https://mcp.inviomail.de/mcpeintragen und die Verbindung hinzufügen. - Mit dem Inviomail-Login anmelden, den MCP-Zugriff erlauben und die angezeigten Werkzeuge freigeben.
Teste die Verbindung danach mit einem einfachen Prompt, zum Beispiel: Hast du Zugriff auf Inviomail?
Andere MCP-Clients und eigene Agents
Jeder MCP-Client mit Unterstützung für Remote-MCP über Streamable HTTP kann sich verbinden. Clients mit OAuth-Unterstützung nutzen die MCP-Server-URL und durchlaufen den Login automatisch. Clients ohne OAuth senden einen statischen MCP-Key im Authorization-Header.
Beispiel für eine Client-Konfiguration mit MCP-Key:
{
"mcpServers": {
"inviomail": {
"url": "https://mcp.inviomail.de/mcp",
"headers": {
"Authorization": "Bearer <MCP-Key>"
}
}
}
}
Berechtigungen und Sicherheit
- Unter Einstellungen > Integrationen > KI-Verbindungen (MCP) siehst du jede aktive Verbindung und kannst ihre Berechtigungen einzeln bearbeiten oder sie widerrufen.
- Standardmäßig sind normale Funktionen freigegeben, etwa Kontakte und Tags verwalten, Entwürfe bearbeiten oder Reporting lesen.
- Kritische Rechte musst du gesondert freigeben: Newsletter endgültig versenden, Flows veröffentlichen und Kontoeinstellungen ändern. Sie sind standardmäßig ausgeschaltet.
- Auch mit freigegebenem Recht holt der Assistent vor einem Versand oder einer Veröffentlichung deine ausdrückliche Zustimmung zum konkreten Stand ein.
- Folgenreiche Änderungen wie Tag-Umbenennungen, Zusammenführungen oder Löschungen laufen über einen zweistufigen Ablauf aus Vorbereiten und Bestätigen.
Werkzeuge im Überblick
Der Server stellt mehr als 90 Werkzeuge bereit. Die wichtigsten Bereiche:
- Kontext:
get_tenant_contextzeigt verbundenes Konto und Berechtigungen. - Kontakte: suchen, lesen, anlegen, abmelden, Profile und eigene Kontaktfelder pflegen, Tags zuordnen (
search_contacts,get_contact_by_email,subscribe_contact,update_contact_by_email,add_contact_tagsund weitere). - Double-Opt-in: ausstehende Anmeldungen prüfen, Bestätigungsmail erneut senden, Tippfehler korrigieren (
list_doi_pending_requests,resend_doi_confirmation,correct_doi_pending_emailund weitere). - Tags: auflisten, Nutzung prüfen, anlegen, umbenennen, zusammenführen, ungenutzte löschen (
list_tags,get_tag_usage,create_tag,prepare_tag_mergeund weitere). - Anmeldeformulare: erstellen, konfigurieren, Webhooks verwalten (
list_subscription_forms,create_subscription_form,update_subscription_formund weitere). - Newsletter: Entwürfe erstellen und bearbeiten, Inhalte prüfen, Vorschau, Testversand, Zielgruppe festlegen und nach Freigabe versenden (
list_campaigns,create_campaign,update_campaign_content,send_campaign_testund weitere). - Automatisierungen: Flows und Flow-E-Mails erstellen, prüfen, Statistiken lesen und nach Freigabe veröffentlichen (
list_flows,create_flow,update_flow_draft,get_flow_statsund weitere). - Landingpages: Seiten mit einem Assistenten erstellen, bearbeiten und veröffentlichen.
- Mediathek: Bilder auflisten, hochladen oder per URL importieren (
list_media_images,upload_media_image_file,import_media_image_from_url).
Die vollständige, jeweils aktuelle Werkzeugliste mit Parametern liefert der MCP-Server selbst über tools/list.
Beispiel-Prompts
Prüfe meinen Newsletter-Entwurf „Monatsrückblick“ und schlage Verbesserungen für Betreff und Inhalt vor.Erstelle einen Entwurf für eine Willkommensserie mit drei E-Mails und passenden Pausen.Schau dir meine Tags an und berate mich, ob die Struktur sinnvoll ist. Ändere zunächst nichts.Wie viele neue Kontakte kamen diesen Monat über mein Anmeldeformular?
Wenn die Verbindung nicht funktioniert
- Ist die URL
https://mcp.inviomail.de/mcpkorrekt eingetragen? - Bist du mit dem richtigen Inviomail-Konto angemeldet?
- Ist die Verbindung im KI-Assistenten aktiv und im aktuellen Chat ausgewählt?
- Sind die benötigten Funktionen in Inviomail und im KI-Assistenten erlaubt? Nach einer neuen Freigabe hilft oft ein neuer Chat.
- Bei einem MCP-Key: Ist der Key gültig und nicht widerrufen, und wird er als
Authorization: Bearer <MCP-Key>gesendet?
Persönliche Hilfe per E-Mail: support@inviomail.de