DokumentationMarketo-Entwicklerhandbuch

[Eingeschränkte Verfügbarkeit]{class="badge informative" title="Diese Funktion befindet sich derzeit in einer eingeschränkten Beta-Version"}

Marketo Engage MCP-Server

Letzte Aktualisierung: 8. Mai 2026

Erstellt für:

  • {"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}
AVAILABILITY
Diese Funktion ist nur eingeschränkt verfügbar. Um den Zugriff anzufordern, füllen Sie dieses Formular aus. Stellen Sie sicher, dass Sie die Munchkin ID Ihres Abonnements bereit haben.

Das Model Context Protocol (MCP) ist ein offener Standard, der es KI-Tools ermöglicht, mit externen Services zu kommunizieren. Der Marketo MCP-Server fungiert als Brücke zwischen Ihrem KI-Assistenten und Marketo. Es stellt mehr als 100 Vorgänge in Formularen, Programmen, intelligenten Kampagnen, Leads, E-Mails, Snippets, Listen und Ordnern bereit.

Wenn Ihr KI-Tool den MCP-Server aufruft, führt der Server den entsprechenden REST-API-Aufruf in Ihrem Namen aus. Dabei werden die Anmeldeinformationen verwendet, die Sie in jeder Anfrage angeben. Sie müssen keine Server-seitige Software installieren, bereitstellen oder ausführen.

IMPORTANT
Das Model Context Protocol (MCP) ist ein aufstrebender Open-Source-Standard, der Sicherheits- oder Zuverlässigkeitsrisiken mit sich bringen kann. Adobe MCP-Server-Integrationen und die zugehörige Dokumentation werden ohne Mängelgewähr und ohne Gewährleistung jeglicher Art bereitgestellt.
Die Verbindung von MCP-Clients oder -Servern mit Adobe-Produkten ist eine vom Kunden gewählte Konfiguration, und die Kunden sind dafür verantwortlich, die Sicherheit und Eignung jeder MCP-Integration zu bewerten. Adobe übernimmt keine Verantwortung für Probleme, die sich aus einer Fehlkonfiguration, einer fehlerhaften Verwendung des MCP, Sicherheitslücken in Drittanbieterimplementierungen oder unbeabsichtigten Aktionen ergeben, die über MCP-fähige Workflows ausgeführt werden.
Um Risiken zu reduzieren, empfiehlt Adobe, Integrationen vor der produktiven Verwendung in einer Sandbox-Umgebung zu testen und alle MCP-initiierten Aktionen und Antworten sorgfältig zu überprüfen und zu validieren, bevor sie bestätigt oder sich darauf verlassen.

MCP-Grundlagen

Stellen Sie sich MCP wie einen USB-C-Port für KI-Anwendungen vor. USB-C bietet eine standardisierte Möglichkeit, Ihre Geräte mit verschiedenen Peripheriegeräten und Zubehör zu verbinden, und MCP bietet eine standardisierte Möglichkeit, KI-Modelle mit Datenquellen und Tools zu verbinden. — Model Context Protocol

MCP ermöglicht einem KI-Tool, gleichzeitig eine Verbindung zu mehreren externen Services herzustellen. Ein KI-Assistent könnte beispielsweise:

  • Herstellen einer Verbindung zu einem Textverarbeitungsprogramm für die KI-gestützte Dokumenterstellung
  • Verbinden mit Animations-Tools wie Blender für Build-Visualisierungen
  • Herstellen einer Verbindung zu Adobe After Effects für die Videobearbeitung

MCP ist ein Kommunikationsprotokoll: ein offener Standard, den jede Anwendung implementieren kann, um ihre Daten und Aktionen KI-Tools zur Verfügung zu stellen.

Was Marketo Engage MCP tut und was nicht

Wenn Sie den Umfang von MCP verstehen, können Sie Erwartungen definieren, bevor Sie Ihr KI-Tool verbinden.

MCP macht:

  • Ermöglichen des Zugriffs auf Marketo Daten und Funktionen über standardmäßige REST-APIs
  • Ausführen von API-Aufrufen in Ihrem Namen mit den Anmeldedaten, die Sie bei jeder Anfrage angeben
  • Unterstützung mehrerer gleichzeitiger Benutzer, von denen jeder mit seinen eigenen Anmeldeinformationen verbunden ist
  • Aktualisierung des OAuth-Tokens automatisch verarbeiten. Sie müssen den Ablauf von Token nicht verwalten
  • Arbeiten Sie in Umgebungen, die durch Mandanten isoliert sind, sodass sich Ihre Daten nie mit der Sitzung eines anderen Benutzers überschneiden

MCP nicht:

  • Verwenden, Hosten oder Ausführen von KI- oder maschinellen Lernmodellen. Die gesamte KI-Verarbeitung erfolgt in Ihrem KI-Tool, nicht im MCP
  • Trainieren Sie mit beliebigen Daten, einschließlich Ihrer Kundendaten, oder lernen Sie daraus
  • Erzeugt Vorhersagen, Empfehlungen oder Entscheidungen. Die Entscheidungsfindung liegt in der Verantwortung des nachgelagerten KI-Tools oder -Benutzers
  • Speichern oder Speichern von Anmeldeinformationen, Anfragedaten oder Sitzungsstatus zwischen Anfragen
  • Installation, Bereitstellung und Verwaltung von Server-seitiger Software erforderlich

Je nach API-Nutzung kann MCP Daten übertragen, einschließlich potenziell sensibler Felder, aber B2B-Daten umfassen Kundengeschäftsdaten und keine personenbezogenen Daten.

Voraussetzungen

  • Eine Marketo mit aktiviertem REST-API-Zugriff
  • Administratorzugriff zum Erstellen von API-Anmeldeinformationen in Marketo LaunchPoint
  • Eines der folgenden KI-Tools: Claude Desktop, Cursor, Codex, Claude Code (CLI) oder VS Code mit GitHub Copilot
  • Netzwerkzugriff auf die MCP-Server-URL: https://marketo-mcp.adobe.io/mcp

Marketo-Anmeldedaten abrufen

Sie benötigen die folgenden Werte aus Ihrer Marketo:

  • Client-ID
  • Client Secret (Client-Geheimnis)
  • Munchkin-Konto-ID

Wenn Sie bereits über diese verfügen, fahren Sie mit KI-Tool konfigurieren fort.

Client-ID und Client-Geheimnis

  1. Navigieren Sie Admin > LaunchPoint.
  2. Wählen Sie Ihren API-Service aus. Wenn Sie noch keinen haben, wählen Sie Neu > Neuer Service, wählen Sie Benutzerdefiniert als Service-Typ und weisen Sie einen dedizierten API-Benutzer zu.
  3. Wählen Sie Details anzeigen und kopieren Sie die Werte Client-ID und Client-).

Munchkin-Konto-ID

  1. Navigieren Sie Admin > Munchkin.
  2. Kopieren Sie die Munchkin-Konto-ID. Das Format ist XXX-XXX-XXX und entspricht dem Präfix Ihrer Instanz-URL.

Konfigurieren Ihres KI-Tools

Jedes KI-Tool hat ein etwas anderes Setup. Verbindungsbeispiele werden für gängige Tools bereitgestellt.

TIP
Um eine Verbindung zu mehreren Marketo-Instanzen herzustellen, fügen Sie separate Einträge in Ihrer MCP-Konfiguration mit eindeutigen Namen hinzu: marketo-prod und marketo-staging, jeweils mit den entsprechenden Anmeldeinformationen.

Claude Desktop claude-desktop

Um eine Verbindung zu Claude Desktop herzustellen, laden Sie marketo-mcp-bridge.zip herunter und entpacken Sie sie. Legen Sie marketo-mcp-bridge.mjs an einem bekannten Speicherort ab, damit Sie im nächsten Schritt darauf verweisen können.

Sie benötigen außerdem:

  • Node.js v18+
  • npm
  1. Claude Desktop öffnen
  2. Navigieren Sie zu Einstellungen > Entwickler > Konfiguration bearbeiten
  3. Fügen Sie Folgendes zu claude_desktop_config.json hinzu:
{
  "preferences": {
    ...
  },
  "mcpServers": {
    "marketo-mcp": {
      "command": "node",
      "args": ["/path/to/marketo-bridge/bridge.mjs"],
      "env": {
        "MARKETO_MCP_PROD_CLIENT_ID": "<your-client-id>",
        "MARKETO_MCP_PROD_CLIENT_SECRET": "<your-client-secret>",
        "MARKETO_MCP_PROD_MUNCHKIN_ID": "<your-munchkin-id>"
      }
    }
  }
}
  1. Claude Desktop neu starten

Cursor cursor

Wenn Ihre Cursor-MCP-Konfiguration bereits andere Server enthält, fügen Sie den marketo Eintrag unter mcpServers hinzu.
Das folgende Beispiel zeigt den vollständigen mcpServers-Block unter Einstellungen > MCP oder .cursor/mcp.json in Ihrem Projektverzeichnis:

IMS-Token
code language-json 
{
  "mcpServers": {
    "marketo": {
      "type": "http",
      "url": "https://marketo-mcp.adobe.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR-IMS-TOKEN",
        "x-gw-ims-org-id": "YOUR-IMS-ORG-ID"
      }
    }
  }
}
Marketo-Client-Anmeldedaten
code language-json 
{
  "mcpServers": {
    "marketo": {
      "type": "http",
      "url": "https://marketo-mcp.adobe.io/mcp",
      "headers": {
        "X-Marketo-Client-Id": "YOUR-CLIENT-ID",
        "X-Marketo-Client-Secret": "YOUR-CLIENT-SECRET",
        "X-Marketo-Munchkin-Id": "YOUR-MUNCHKIN-ID"
      }
    }
  }
}

Cursor neu starten.

Claude-Code (CLI) claude-code

Führen Sie den folgenden Befehl an Ihrem Terminal aus und ersetzen Sie dabei Ihre Anmeldeinformationen:

IMS-Token
code language-bash 
claude mcp add --transport http marketo \
  https://marketo-mcp.adobe.io/mcp \
  --header "Authorization: Bearer YOUR-IMS-TOKEN" \
  --header "x-gw-ims-org-id: YOUR-IMS-ORG-ID"
Marketo-Client-Anmeldedaten
code language-bash 
claude mcp add --transport http marketo \
  https://marketo-mcp.adobe.io/mcp \
  --header "X-Marketo-Client-Id: YOUR-CLIENT-ID" \
  --header "X-Marketo-Client-Secret: YOUR-CLIENT-SECRET" \
  --header "X-Marketo-Munchkin-Id: YOUR-MUNCHKIN-ID"

OpenAI-Code codex

  1. Gehen Sie zu Einstellungen > MCP-Server > Server hinzufügen
  2. Fügen Sie die Server-URL hinzu: https://marketo-mcp.adobe.io/mcp
  3. Fügen Sie die Kopfzeilen für Ihre Authentifizierungsmethode hinzu:
IMS-Token
  • Autorisierung: „Bearer YOUR-IMS-TOKEN“
  • x-gw-ims-org-id: „IHRE-IMS-ORG-ID“
Marketo-Client-Anmeldedaten
  • X-Marketo-Client-ID: „IHRE-CLIENT-ID“
  • X-Marketo-Client-Secret: „IHR-CLIENT-GEHEIMNIS“
  • X-Marketo-Munchkin-ID: „IHRE-MUNCHKIN-ID“
  1. Klicken Sie auf Speichern , um den Vorgang abzuschließen.

VS-Code mit GitHub Copilot vscode

Drücken Sie Strg+Umschalt+P (oder Befehlstaste+Umschalt+P auf macOS), geben Sie MCP: Benutzerkonfiguration öffnen ein und drücken Sie die Eingabetaste. Dadurch wird mcp.json geöffnet. Fügen Sie den marketo Eintrag innerhalb des servers hinzu:

IMS-Token
code language-json 
{
  "servers": {
    "marketo": {
      "type": "http",
      "url": "https://marketo-mcp.adobe.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR-IMS-TOKEN",
        "x-gw-ims-org-id": "YOUR-IMS-ORG-ID"
      }
    }
  }
}
Marketo-Client-Anmeldedaten
code language-json 
{
  "servers": {
    "marketo": {
      "type": "http",
      "url": "https://marketo-mcp.adobe.io/mcp",
      "headers": {
        "X-Marketo-Client-Id": "YOUR-CLIENT-ID",
        "X-Marketo-Client-Secret": "YOUR-CLIENT-SECRET",
        "X-Marketo-Munchkin-Id": "YOUR-MUNCHKIN-ID"
      }
    }
  }
}
NOTE
Verwenden Sie aus Sicherheitsgründen die Interpolation von Umgebungsvariablen in Konfigurationsdateien, anstatt Anmeldeinformationen direkt einzufügen. Sie können Variablen mithilfe von Syntax wie ${MARKETO_CLIENT_SECRET} referenzieren und sie in Ihrer Umgebung festlegen. Dadurch wird verhindert, dass Anmeldeinformationen in versionsgesteuerten Dateien im Nur-Text-Format gespeichert werden.

Weitere Tools other-tools

Der Marketo MCP-Server wird von Adobe gehostet und unter einer öffentlichen URL bereitgestellt. Jeder MCP-Client, der Remote-Server über einen HTTP-Transport unterstützt, kann eine Verbindung mit ihm herstellen.
Sie benötigen keine tool-spezifische Bridge oder lokal installierte Software. Wenn Ihr Tool oben nicht aufgeführt ist, verwenden Sie die Verbindungsdetails unten, um es manuell zu konfigurieren.

Verbindungsdetails:

Einstellung
Wert
Transport
HTTP (Streamable HTTP)
Server-URL
https://marketo-mcp.adobe.io/mcp

Authentifizierungs-Header:

Senden Sie bei jeder Anfrage die Header für eine der folgenden Authentifizierungsmethoden. Wo Sie die Server-URL und die Header eingeben, hängt von Ihrem Tool ab. Konsultieren Sie daher die MCP-Dokumentation.

IMS-Token
table 0-row-2 1-row-2 2-row-2
Header Wert
Authorization Bearer YOUR-IMS-TOKEN
x-gw-ims-org-id Ihre IMS-Organisations-ID
Marketo-Client-Anmeldedaten
table 0-row-2 1-row-2 2-row-2 3-row-2
Header Wert
X-Marketo-Client-Id Ihre Client-ID
X-Marketo-Client-Secret Ihr Client-Geheimnis
X-Marketo-Munchkin-Id Ihre Munchkin-Konto-ID

Wenn Ihr Tool eine JSON-Konfiguration akzeptiert, beginnen Sie mit den Cursor- oder VS-Code-Beispielen und passen Sie die Schlüssel (mcpServers, servers) an das Schema Ihres Tools an.

Verfügbare Vorgänge

Sobald die Verbindung hergestellt ist, können Sie Ihren KI-Assistenten bitten, Vorgänge in den folgenden Kategorien durchzuführen. Eine vollständige Liste der unterstützten Vorgänge mit API-Referenzen finden Sie unter Unterstützte MCP-Vorgänge.

Formulare

Formulare durchsuchen, erstellen, klonen und genehmigen. Hinzufügen oder Entfernen von Feldern, Konfigurieren von Regeln für die Feldsichtbarkeit und Ermitteln, wo Formulare eingebettet sind.

Beispiel-Eingabeaufforderungen:

  • „Alle genehmigten Formulare anzeigen“
  • „Klonen Sie das Formular „Kontakt“ in den Ordner „Q2 Campaign“.
  • „Hinzufügen eines Firmenfelds zum Demo-Anfrageformular“

Intelligente Kampagnen

Erstellen Sie intelligente Kampagnen, konfigurieren Sie Filter für intelligente Listen, fügen Sie Flussschritte hinzu und aktivieren oder deaktivieren Sie Kampagnen.

Beispiel-Eingabeaufforderungen:

  • „Welche intelligenten Kampagnen sind derzeit aktiv?“
  • „Erstellen Sie im Ordner „Vorgänge“ eine neue intelligente Kampagne mit dem Namen Aktualisierung der Lead-Bewertung.“
  • „Flussschritte in der Willkommens-E-Mail-Kampagne anzeigen“

Leads und Listen

Suchen nach Leads nach E-Mail-Adresse, Erstellen oder Aktualisieren von Lead-Datensätzen und Verwalten der statischen Listenmitgliedschaft.

Beispiel-Eingabeaufforderungen:

  • „Lead mit E-Mail jane@example.com suchen“
  • „Lead-ID 12345 zur MQL-Liste im 2. Quartal hinzufügen“
  • „Erstellen Sie eine neue statische Liste mit dem Namen Summer Event Attendees“

Programme

Erstellen, Klonen und Taggen von Programmen. Programme nach Typ, Kanal oder Datumsbereich durchsuchen.

Beispiel-Eingabeaufforderungen:

  • „Klonen Sie das Webinar-Programm für das 4. Quartal in den Ereignisordner für 2026“
  • „Erstellen Sie im Ordner „Kampagnen“ ein neues E-Mail-Programm mit dem Namen „Sommerverkauf“.“
  • „Alle Programme anzeigen, die als Webinar getaggt sind“

E-Mails und Snippets

E-Mails durchsuchen, E-Mails aus Vorlagen erstellen, Inhaltsabschnitte aktualisieren und wiederverwendbare Snippets verwalten.

Beispiel-Eingabeaufforderungen:

  • „Alle E-Mail-Entwürfe anzeigen“
  • „Aktualisieren des Kopfzeilenabschnitts der Begrüßungs-E-Mail“
  • „Welche Assets verwenden das Snippet „Holiday Promo“?“

Instanzstruktur

Um Ihre Marketo zu verstehen, durchsuchen Sie Ordner, Kanäle, Tag-Typen und Aktivitätstypen.

Beispiel-Eingabeaufforderungen:

  • „Alle Ordner in Marketo auflisten“
  • „Alle verfügbaren Kanäle anzeigen“
  • „Welche Tag-Typen sind konfiguriert?“

Massenvorgänge

Exportieren Sie Lead-Daten in Batches und überprüfen Sie den Import- oder Exportvorgangsstatus.

Beispiel-Eingabeaufforderungen:

  • „Erstellen eines Massenexports von Leads, die in den letzten 30 Tagen erstellt wurden“
  • „Status des Exportvorgangs xx überprüfen“

Fehlerbehebung

Fehler
Ursache
Korrigieren
"Marketo-Anmeldeinformationen nicht bereitgestellt“
Mindestens ein X-Marketo-Client-Id, X-Marketo-Client-Secret oder X-Marketo-Munchkin-Id fehlt.
Überprüfen Sie, ob alle Kopfzeilen der Client-Anmeldeinformationen für Marketo in Ihrer Konfiguration vorhanden sind.
„401 Nicht autorisiert“
Ihre Anmeldedaten fehlen, sind ungültig oder abgelaufen. Bei Marketo-Client-Anmeldeinformationen ist die Client-ID oder das Client-Geheimnis falsch. Bei einem IMS-Token ist das Token ungültig oder abgelaufen.
Überprüfen Sie die Anmeldeinformationen für Ihre Authentifizierungsmethode. Überprüfen Sie die Client-Anmeldeinformationen erneut Client-ID und Client-) unter Admin > LaunchPoint. Generieren Sie für ein IMS-Token ein neues Token und aktualisieren Sie die Authorization-Kopfzeile.
„403 Verboten“
Ihre Anmeldedaten sind gültig, aber Ihre Marketo-Instanz ist nicht für den MCP-Zugriff aktiviert.
Wenden Sie sich an Ihren Marketo MCP-Administrator, um den MCP-Zugriff für Ihre Munchkin-Konto-ID zu aktivieren.
„Zu viele Anfragen“ (Ratenlimit)
Sie haben zu viele Anfragen innerhalb eines kurzen Zeitraums oder zu viele Anfragen gleichzeitig gesendet und die API-Beschränkungen Ihrer Marketo erreicht.
Reduzieren Sie die Häufigkeit und Anzahl der gleichzeitig gesendeten Anfragen und warten Sie eine kurze Zeit, bevor Sie es erneut versuchen. Verwenden Sie einen dedizierten API-Benutzer, um Ihr Kontingent zu verfolgen und zu verwalten.
Verbindungs-Timeout oder Zurückgewiesen
Der MCP-Server ist nicht über das Netzwerk erreichbar.
Bestätigen Sie, dass Sie die Server-URL aus Ihrer Umgebung erreichen können. Überprüfen Sie ggf. die VPN-Anforderungen.
Tool-Aufrufe geben leere Ergebnisse zurück
Der API-Benutzer verfügt nicht über die erforderlichen Berechtigungen für den angeforderten Asset-Typ.
Bitten Sie Ihren Marketo, die Rolle und die Berechtigungen des API-Benutzers zu überprüfen.

Sicherheitsüberlegungen

IMPORTANT
Verwenden Sie einen dedizierten API-Benutzer in Marketo, der nur über die für Ihre Arbeit erforderlichen Berechtigungen verfügt. Verwenden Sie keine Administratorberechtigungen für den API-Zugriff erneut.
  • Anmeldeinformationen pro Anfrage. Bei jeder Anfrage werden die Client-ID, das Client-Geheimnis, die Munchkin-ID und der REST-API-Endpunkt in HTTP-Headern übertragen. Der Server speichert oder speichert sie nicht im Cache.
  • Isolierung mehrerer Mandanten. Jede Anfrage verwendet einen eigenen Satz von Anmeldeinformationen. Ihre Daten überschneiden sich nicht mit der Sitzung eines anderen Benutzers.
  • Munchkin ID-Zulassungsliste. Der Server akzeptiert nur Anfragen für genehmigte Marketo. Anfragen, die eine nicht autorisierte Munchkin-ID verwenden, werden mit einem 403-Fehler zurückgewiesen.
  • API-Ratenbeschränkungen. Der MCP-Server übernimmt die API-Ratenbeschränkungen Ihrer Marketo. Verwenden Sie einen dedizierten API-Benutzer, um die Kontingentnutzung zu verfolgen und zu verwalten.
  • Halten Sie Anmeldeinformationen außerhalb der Versionskontrolle. Verwenden Sie die Umgebungsvariableninterpolation (${MARKETO_CLIENT_SECRET}), wenn Ihr KI-Tool sie unterstützt, sodass Anmeldeinformationen nicht im Klartext in Repository-Dateien gespeichert werden.
recommendation-more-help
marketo-developer-help