Ortto MCP Server

offiziell

Ortto’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_campaigns abfragen.
  • Kontakte und Zielgruppen durchsuchen — Kontakte nach Namen oder Feld finden und Zielgruppen mit get_contacts und get_audiences auflisten.
  • Kampagnenleistungsberichte abrufen — Analysen zu E-Mails, Journeys, SMS oder Push-Benachrichtigungen über get_email_report, get_journey_report, get_sms_report und get_push_report abrufen.
  • Auf benutzerdefinierte Berichte zugreifen — Von Benutzern erstellte Berichte auflisten und deren Daten mit list_reports und get_report abrufen.
  • Wissensdatenbank-Inhalte verwalten — Kategorien erstellen, HTML-Artikel veröffentlichen und den Index mit create_category, create_article_from_html und modify_index neu organisieren.
  • Kontoschema und Markenbuch prüfen — Benutzerdefinierte Felder und Branding-Einstellungen über get_schema und get_brand_book abrufen.

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:

  1. Navigieren Sie in Ihrem Ortto-Konto zu CDP > Datenquellen.
  2. Klicken Sie auf Neue Datenquelle und suchen Sie nach MCP.
  3. 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/AktionBeschreibung
get_campaignsRuft 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/AktionBeschreibung
get_contactsRuft Kontakte mit umfassenden Filteroptionen ab, einschließlich Zielgruppen-ID, Feldauswahl und Suchfunktionen.
get_audiencesListet 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/AktionBeschreibung
get_email_reportErstellt detaillierte Leistungsberichte für E-Mail-Kampagnen, einschließlich Öffnungsraten, Klickraten und Engagement-Metriken.
get_journey_reportLiefert umfassende Journey-Performance-Analysen mit anpassbaren Zeiträumen.
get_journey_shape_reportAnalysiert spezifische Journey-Shapes und deren Metriken.
get_sms_reportRuft Leistungsdaten und Engagement-Statistiken von SMS-Kampagnen ab.
get_push_reportGreift 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/AktionBeschreibung
list_reportsGreift auf benutzererstellte Berichte aus Ihrem Ortto-Konto zu, mit Filterung nach Diagrammtyp und Suchfunktionen.
get_reportRuft 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/AktionBeschreibung
get_schemaRuft das vollständige Datenschema für Ihre Ortto-Instanz ab, einschließlich benutzerdefinierter Felder und Datenstruktur.
get_brand_bookGreift 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/AktionBeschreibung
create_assetErstellt neue Assets, hauptsächlich HTML-E-Mails, mit anpassbarem Inhalt und Metadaten.
get_asset_htmlRuft den HTML-Inhalt vorhandener Assets zur Überprüfung oder Änderung ab.
update_asset_metaAktualisiert 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/AktionBeschreibung
get_indexRuft die Struktur der Wissensdatenbank ab, einschließlich Kategorien und Artikelhierarchie.
create_categoryErstellt neue Wissensdatenbank-Kategorien mit optionalen Eltern-Kind-Beziehungen.
create_article_from_htmlErstellt Wissensdatenbank-Artikel aus HTML-Inhalten mit Kategorisierung.
move_articleVerschiebt Artikel zwischen Kategorien in Ihrer Wissensdatenbank.
modify_indexAktualisiert 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.