Ortto MCP Server
offiziellOrtto’s neuer MCP Server ermöglicht es, Ihren bevorzugten KI-Assistenten mit Ortto zu verbinden. Nach der Verbindung kann Ihr Assistent sicher auf Kundendaten, Zielgruppen und Kampagneneinblicke aus Ortto’s CDP und Marketing-Automatisierungsplattform zugreifen.
Was kann man mit Ortto MCP machen?
- Kampagnen abrufen und filtern — Kampagnen nach Typ, Status oder Namen mit
get_campaignsabfragen. - Kontakte und Zielgruppen durchsuchen — Kontakte nach Namen oder Feld finden und Zielgruppen mit
get_contactsundget_audiencesauflisten. - Kampagnenleistungsberichte abrufen — Analysen zu E-Mails, Journeys, SMS oder Push-Benachrichtigungen über
get_email_report,get_journey_report,get_sms_reportundget_push_reportabrufen. - Auf benutzerdefinierte Berichte zugreifen — Von Benutzern erstellte Berichte auflisten und deren Daten mit
list_reportsundget_reportabrufen. - Wissensdatenbank-Inhalte verwalten — Kategorien erstellen, HTML-Artikel veröffentlichen und den Index mit
create_category,create_article_from_htmlundmodify_indexneu organisieren. - Kontoschema und Markenbuch prüfen — Benutzerdefinierte Felder und Branding-Einstellungen über
get_schemaundget_brand_bookabrufen.
Dokumentation
Gehe zu ortto.com
Startseite Ortto MCP Ortto MCP
Ortto MCP
Was ist MCP?
Das Model Context Protocol (MCP) ist ein offener Standard, der es KI-Agenten (wie Claude oder ChatGPT) ermöglicht, sicher mit externen Tools und Datenquellen zu interagieren.
Sie verbinden Ihren KI-Agenten (den MCP-Client) direkt mit dem MCP-Server von Ortto. Dadurch kann Ihr Agent Ihre Ortto-Daten verstehen und darauf reagieren.
Ihr Agent kann Sie dann bei einer Vielzahl von Aufgaben mit Eingabeaufforderungen in natürlicher Sprache unterstützen. Zum Beispiel:
- „Zeige mir die Performance meiner E-Mail-Kampagnen der letzten 30 Tage.“
- „Welche Journeys erzielen die besten Ergebnisse in Bezug auf Conversions?“
- „Gib mir eine Liste meiner engagiertesten Kontakte aus diesem Monat.“
Konfigurieren der MCP-Datenquelle
Um mit unserer MCP-Funktion zu beginnen, müssen Sie MCP als Datenquelle in Ihrem Ortto-Konto erstellen. Befolgen Sie diese Schritte zur Einrichtung:
- Navigieren Sie in Ihrem Ortto-Konto zu CDP > Datenquellen.
- Klicken Sie auf Neue Datenquelle und suchen Sie nach MCP.
- Geben Sie einen Namen für Ihre MCP-Datenquelle ein und klicken Sie auf Verbinden.
4. Sobald die Datenquelle erstellt ist, erhalten Sie Zugriff auf einen Bereichsschlüssel (Scoped Key). Diesen Schlüssel benötigen Sie, um Ortto mit dem gewünschten KI-Agenten (Claude, ChatGPT usw.) zu verbinden.
Sie sind nun bereit, Ortto mit Ihrem KI-Agenten zu verbinden. Je nach verwendetem KI-Agenten lesen Sie den entsprechenden Artikel unten:
- Verwenden von Ortto MCP mit Claude
- Verwenden von Ortto MCP mit ChatGPT
TIPP: Sie können Ortto MCP mit jeder App verbinden, die benutzerdefinierte Konnektoren unterstützt. Wenn die von Ihnen verwendete App oben nicht aufgeführt ist, verwenden Sie einfach die entsprechende Remote-MCP-Server-URL, basierend darauf, wo Ihr Ortto-Konto gehostet wird.
- Vereinigte Staaten:
https://mcp-api-us.ortto.app/mcp?jwt=your-scoped-key - Europa:
https://mcp-api-eu.ortto.app/mcp?jwt=your-scoped-key - Australien:
https://mcp-api-au.ortto.app/mcp?jwt=your-scoped-key
Wenn Sie nicht sicher sind, wo Ihr Konto gehostet wird, finden Sie diese Information in der App unter Einstellungen > Datenschutz, Sicherheit und DSGVO > Daten-Hosting.
Unterstützte Tools/Aktionen
Der Ortto MCP-Server ermöglicht es KI-Agenten, über spezifische Tools/Aktionen mit Ihren Ortto-Daten zu interagieren. Die folgenden Tabellen sind nach Datenkategorie geordnet und beschreiben die unterstützten Tools/Aktionen sowie ihre Definitionen.
TIPP: Die in den folgenden Tabellen aufgeführten Tools/Aktionen sind lediglich die Namenskonvention, die von unserer MCP-Funktion verwendet wird. Sie müssen diese Namen nicht explizit in Ihrem KI-Agenten-Tool verwenden. Ihr Agent wählt automatisch das passende Tool/die passende Aktion basierend auf Ihrer Anfrage in natürlicher Sprache aus und verwendet sie.
Kampagnenmanagement
| Tool/Aktion | Beschreibung |
|---|---|
| get_campaigns | Ruft eine Liste Ihrer Kampagnen mit Filter- und Paginierungsoptionen ab. Unterstützt die Filterung nach Kampagnentyp, Status und Suchanfragen. |
Beispiele:
- „Zeige mir alle meine E-Mail-Kampagnen des letzten Monats“
- „Hole Kampagnen, die derzeit laufen“
- „Finde Kampagnen mit ‚Sommer‘ im Namen“
Kontakte und Zielgruppen
| Tool/Aktion | Beschreibung |
|---|---|
| get_contacts | Ruft Kontakte mit umfassenden Filteroptionen ab, einschließlich Zielgruppen-ID, Feldauswahl und Suchfunktionen. |
| get_audiences | Listet alle Zielgruppen in Ihrem Konto mit Such- und Paginierungsunterstützung auf. |
Beispiele:
- „Rufe alle Kontakte mit ‚Schmidt‘ im Namen ab“
- „Finde Zielgruppen mit weniger als 1.000 Mitgliedern“
- „Zeige mir die E-Mail-Adressen und Namen der letzten 10 Kontakte, die sich angemeldet haben“
Kampagnenberichte
| Tool/Aktion | Beschreibung |
|---|---|
| get_email_report | Erstellt detaillierte Leistungsberichte für E-Mail-Kampagnen, einschließlich Öffnungsraten, Klickraten und Engagement-Metriken. |
| get_journey_report | Liefert umfassende Journey-Performance-Analysen mit anpassbaren Zeiträumen. |
| get_journey_shape_report | Analysiert spezifische Journey-Shapes und deren Metriken. |
| get_sms_report | Ruft Leistungsdaten und Engagement-Statistiken von SMS-Kampagnen ab. |
| get_push_report | Greift auf Analysen und Zustellmetriken von Push-Benachrichtigungskampagnen zu. |
Beispiele:
- „Erstelle einen E-Mail-Bericht für die Kampagne ‚Weihnachtsangebot‘“
- „Wie ist die Gesamtleistung der Journey ‚Warenkorbabbruch‘?“
Benutzerdefinierte Berichte
| Tool/Aktion | Beschreibung |
|---|---|
| list_reports | Greift auf benutzererstellte Berichte aus Ihrem Ortto-Konto zu, mit Filterung nach Diagrammtyp und Suchfunktionen. |
| get_report | Ruft spezifische Berichtsdaten mit anpassbaren Zeiträumen und Aktualisierungsoptionen ab. |
Beispiele:
- „Liste alle Kreisdiagramm-Berichte in meinem Konto auf“
- „Rufe die Daten für den Bericht ‚Q3-Umsatz‘ ab“
Konto und Konfiguration
| Tool/Aktion | Beschreibung |
|---|---|
| get_schema | Ruft das vollständige Datenschema für Ihre Ortto-Instanz ab, einschließlich benutzerdefinierter Felder und Datenstruktur. |
| get_brand_book | Greift auf Ihre Brand-Book-Einstellungen zu, einschließlich Farben, Schriftarten und Branding-Elementen. |
Beispiele:
- „Welche Primär- und Sekundärfarben sind in unserem Brand Book definiert?“
- „Rufe alle benutzerdefinierten Felder in meinem Konto ab, die ‚Beispiel‘ im Namen haben“
Asset-Management
| Tool/Aktion | Beschreibung |
|---|---|
| create_asset | Erstellt neue Assets, hauptsächlich HTML-E-Mails, mit anpassbarem Inhalt und Metadaten. |
| get_asset_html | Ruft den HTML-Inhalt vorhandener Assets zur Überprüfung oder Änderung ab. |
| update_asset_meta | Aktualisiert Asset-Metadaten, einschließlich Namen, Betreffzeilen und Absenderinformationen. |
Beispiele:
- „Erstelle ein neues Werbe-E-Mail-Asset mit dem Titel ‚Nicht zu verpassende Angebote‘ und Inhalten, die erklären, warum Nutzer den bevorstehenden Sale nicht verpassen sollten“
- „Rufe den HTML-Inhalt des Assets mit dem Namen ‚Willkommens-E-Mail v2‘ ab“
Wissensdatenbank
| Tool/Aktion | Beschreibung |
|---|---|
| get_index | Ruft die Struktur der Wissensdatenbank ab, einschließlich Kategorien und Artikelhierarchie. |
| create_category | Erstellt neue Wissensdatenbank-Kategorien mit optionalen Eltern-Kind-Beziehungen. |
| create_article_from_html | Erstellt Wissensdatenbank-Artikel aus HTML-Inhalten mit Kategorisierung. |
| move_article | Verschiebt Artikel zwischen Kategorien in Ihrer Wissensdatenbank. |
| modify_index | Aktualisiert die Indexstruktur und Organisation der Wissensdatenbank. |
Beispiele:
- „Generiere einen Wissensdatenbank-Artikel aus diesem HTML und betitele ihn mit ‚MCP-Übersicht‘“
- „Erstelle eine neue Kategorie namens ‚Fehlerbehebung‘“
- „Zeige mir die aktuelle Struktur der Wissensdatenbank“
Anfragelimits
Wenn Sie einen KI-Agenten über die Ortto MCP-Funktion verwenden, stoßen Sie auf zwei verschiedene Arten von Limits. Während KI-Agenten (wie Claude oder ChatGPT) ihre eigenen Limits bezüglich Anfragelänge und Antwortgröße durchsetzen, unterliegen alle API-Aufrufe, die über den Ortto MCP-Server geleitet werden, unseren standardmäßigen Ortto-API-Ratenlimits. Diese Ratenlimits gelten basierend auf Ihrem Abonnementplan und werden implementiert, um Systemstabilität und faire Nutzung zu gewährleisten.
Erfahren Sie mehr über unsere API-Ratenlimits.