Marketo MCP-Server

Ein Model Context Protocol-Server für Adobe Marketo Engage. Geben Sie Claude Desktop, Cursor und anderen MCP-kompatiblen Clients direkten, authentifizierten Zugriff auf die Marketo REST-API — lesen und schreiben Sie Formulare, Smart Lists, Kanäle, Leads, Aktivitäten und Listen mit natürlicher Sprache.

Warum

Marketing-Ops-, Growth- und RevOps-Teams verbringen Stunden damit, sich durch die Marketo-Benutzeroberfläche zu klicken, um ein Formular zu klonen, Assets zu genehmigen, einen Lead nachzuschlagen oder eine Smart List zu prüfen. Der Marketo MCP-Server verbindet genau diese REST-API-Operationen mit einem LLM-Agenten, sodass Sie sagen können:

• „Klone Formular 1234 in den Ordner Q2 Webinars und genehmige es.“

• „Zeige mir die letzten Aktivitäten für den Lead alex@example.com.“

• „Erstelle einen neuen E-Mail-Kanal namens 'Lifecycle Nurture'.“

…und das Modell führt die tatsächlichen Marketo-API-Aufrufe in Ihrem Namen aus.

Related MCP server: Dynamic Form MCP

Inhaltsverzeichnis

• Funktionen

• Schnellstart

• Voraussetzungen

• Konfiguration

• Verfügbare Tools

• Verwendung mit Claude Desktop

• Verwendung mit Cursor / anderen MCP-Clients

• Fehlerbehebung

• Entwicklung

• Mitwirken

Funktionen

• Formularverwaltung — Auflisten, Inspizieren, Klonen und Genehmigen von Formularen über die Marketo Asset-API

• Smart List-Operationen — Auflisten und Inspizieren von Smart Lists

• Kanal-CRUD — Erstellen, Lesen, Aktualisieren und Löschen von Kanälen

• Lead-Datenbank — Abrufen von Leads nach ID oder E-Mail, massenhaftes Erstellen oder Aktualisieren von Leads, Löschen von Leads

• Aktivitäts- & Änderungsprotokolle — Abrufen von Aktivitäten und Feldänderungen für jeden Lead

• Listenmitgliedschaft — Hinzufügen oder Entfernen von Leads aus statischen Listen

• Programmverwaltung — Auflisten, Inspizieren, Klonen von Programmen und Abrufen von Programmmitgliedern

• E-Mail-Operationen — Auflisten, Inspizieren und Senden von Beispiel-E-Mails für die Qualitätssicherung

• Automatische Authentifizierung — OAuth 2.0 Client-Credentials-Flow mit Token-Caching & Refresh

• Stdio-Transport — Funktioniert sofort mit Claude Desktop, Cursor und jedem MCP-Client, der Stdio unterstützt

Schnellstart

Option A — Smithery (empfohlen)

npx -y @smithery/cli install @alexleventer/marketo-mcp --client claude

Folgen Sie den Anweisungen, um Ihre Marketo-Basis-URL, Client-ID und Client-Secret einzugeben.

Option B — npx (keine Installation)

Fügen Sie Folgendes zur Konfiguration Ihres MCP-Clients hinzu (z. B. claude_desktop_config.json):

{
  "mcpServers": {
    "marketo": {
      "command": "npx",
      "args": ["-y", "marketo-mcp"],
      "env": {
        "MARKETO_BASE_URL": "https://123-ABC-456.mktorest.com/rest",
        "MARKETO_CLIENT_ID": "your-client-id",
        "MARKETO_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Option C — aus dem Quellcode

git clone https://github.com/alexleventer/marketo-mcp.git
cd marketo-mcp
npm install
npm run build

Kopieren Sie den vom Build ausgegebenen Konfigurationsblock in Ihren MCP-Client.

Voraussetzungen

• Node.js 18 oder höher

• Marketo-API-Zugangsdaten (Client-ID & Client-Secret von einem LaunchPoint-Dienst)

• Eine Marketo-Instanz mit aktiviertem REST-API-Zugriff

• Ein MCP-kompatibler Client — Claude Desktop, Cursor, Cline oder ein anderer

Erhalt von Marketo-API-Zugangsdaten

1. Melden Sie sich bei der Marketo-Administration an

2. Admin → Integration → LaunchPoint

3. Neu → Neuer Dienst, setzen Sie den Diensttyp auf Benutzerdefiniert und wählen Sie einen Anzeigenamen (z. B. MCP Server)

4. Weisen Sie einen API-only-Benutzer mit den benötigten Berechtigungen zu (Read-Only Assets, Read-Write Lead, etc.)

5. Speichern Sie die Client-ID und das Client-Secret

6. Ihre Basis-URL finden Sie unter Admin → Integration → Web Services → REST API Endpoint (entfernen Sie /rest/v1/* — behalten Sie nur https://<munchkin>.mktorest.com/rest)

Konfiguration

Die gesamte Konfiguration erfolgt über Umgebungsvariablen:

Kopieren Sie .env.example nach .env für die lokale Entwicklung.

Verfügbare Tools

Jedes Tool akzeptiert typisierte Argumente, die mit zod validiert werden, und gibt die rohe Marketo-JSON-Antwort zurück. Siehe die Adobe Marketo REST API-Referenz für Details auf Feldebene.

Verwendung mit Claude Desktop

1. Installieren Sie Claude Desktop

2. Öffnen Sie die Konfiguration unter ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows)

3. Fügen Sie den mcpServers-Block aus Schnellstart ein

4. Starten Sie Claude Desktop neu

Verwendung mit Cursor / anderen MCP-Clients

Jeder MCP-Client, der Stdio-Server unterstützt, funktioniert. Verweisen Sie auf die erstellte Binärdatei:

{
  "mcpServers": {
    "marketo": {
      "command": "npx",
      "args": ["-y", "marketo-mcp"],
      "env": { "MARKETO_BASE_URL": "...", "MARKETO_CLIENT_ID": "...", "MARKETO_CLIENT_SECRET": "..." }
    }
  }
}

Ratenbegrenzungen

Marketo erzwingt mehrere API-Ratenbegrenzungen. Beachten Sie diese bei der Durchführung von Batch-Operationen:

Wenn Sie 606 Max rate limit reached erhalten, warten Sie 20 Sekunden, bevor Sie es erneut versuchen. Die Marketo REST-API gibt in einigen Fällen einen Retry-After-Header zurück.

Fehlerbehebung

Sie können Tool-Aufrufe lokal mit dem MCP-Inspektor untersuchen:

npm run inspector

Entwicklung

src/
├── index.ts       # MCP server + all tool registrations
├── auth.ts        # OAuth token manager (caches until expiry)
└── constants.ts   # Env var bindings

npm run dev          # Run with ts-node + .env
npm run typecheck    # Type-check without emit
npm run lint         # ESLint
npm run format       # Prettier
npm run build        # Compile to build/

Mitwirken

Probleme und Pull Requests sind willkommen unter github.com/alexleventer/marketo-mcp.

1. Forken Sie das Repo

2. Erstellen Sie einen Feature-Branch

3. npm run lint && npm run typecheck

4. Öffnen Sie einen PR

Lizenz

ISC — siehe LICENSE.

Schlüsselwörter: marketo mcp server, marketo model context protocol, marketo claude, marketo ai, adobe marketo mcp, marketo api claude desktop, marketo automation llm, marketo engage mcp