Marketo MCP-Server

Ein Model Context Protocol-Server für die Interaktion mit der Marketo-API. Dieser Server bietet Tools zur Verwaltung von Marketo-Formularen, einschließlich Auflisten, Klonen und Genehmigen von Formularen.

Voraussetzungen

• Node.js (v14 oder höher)

• Marketo-API-Anmeldeinformationen (Client-ID und Client-Geheimnis)

• Eine Marketo-Instanz mit aktiviertem API-Zugriff

• Claude Desktop installiert

Related MCP server: Xero MCP Server

Erste Schritte

1. Erhalten Sie Marketo API-Anmeldeinformationen

1. Melden Sie sich bei Ihrem Marketo-Administrationsbereich an

2. Navigieren Sie zu Admin > Integration > LaunchPoint

3. Klicken Sie auf Neu > Neuer Dienst

4. Geben Sie die Servicedetails ein:

   • Service: Benutzerdefiniert

   • Anzeigename: (z. B. „MCP-Server“)

5. Speichern Sie die angegebene Client-ID und das Client-Geheimnis

2. Umgebungsvariablen konfigurieren

1. Erstellen Sie eine .env Datei im Stammverzeichnis:

# Your Marketo instance URL (required)
# Example: https://123-ABC-456.mktorest.com/rest
MARKETO_BASE_URL=your-marketo-instance-url

# Your API credentials (required)
MARKETO_CLIENT_ID=your-client-id
MARKETO_CLIENT_SECRET=your-client-secret

3. Installation und Einrichtung

# Install dependencies
npm install

# Build the project
npm run build

# The build process will output configuration settings in your console
# Copy these settings into your Claude Desktop developer configuration

4. Claude Desktop-Konfiguration

1. Öffnen Sie Claude Desktop

2. Gehen Sie zu den Entwicklereinstellungen

3. Fügen Sie die Konfigurationseinstellungen ein , die während des Build-Prozesses ausgegeben wurden

4. Speichern der Konfiguration

5. Starten Sie Claude Desktop neu

Verfügbare Tools

Formularliste abrufen

marketo_get_forms({
  maxReturn: 200,  // optional, default: 200
  offset: 0,       // optional, default: 0
  status: 'draft'  // optional, 'draft' or 'approved'
})

Formular nach ID abrufen

marketo_get_form_by_id({
  formId: 1234
})

Klonformular

marketo_clone_form({
  formId: 1234,           // ID of form to clone
  name: "New Form Name",  // Name for the cloned form
  description: "Form description",  // optional
  folderId: 5678         // optional, destination folder ID
})

Formular genehmigen

marketo_approve_form({
  formId: 1234,
  comment: "Approved by MCP server"  // optional
})

Fehlerbehandlung

Häufige Fehlerszenarien und Lösungen:

1. Authentifizierungsfehler

   • Überprüfen Sie, ob Ihre Client-ID und Ihr Client-Geheimnis korrekt sind

   • Überprüfen Sie, ob Ihr API-Zugriff in Marketo aktiviert ist

   • Stellen Sie sicher, dass Ihre Instanz-URL korrekt ist

2. Berechtigungsfehler

   • Überprüfen Sie, ob Ihr API-Benutzer über ausreichende Berechtigungen verfügt

   • Überprüfen Sie die Ordnerzugriffsberechtigungen für Formularvorgänge

3. Ratenbegrenzung

   • Der Server übernimmt automatisch die Token-Aktualisierung

   • Erwägen Sie die Implementierung einer Wiederholungslogik für ratenbegrenzte Anfragen.

Bewährte Methoden

1. Umweltmanagement

   • Übergeben Sie .env -Dateien niemals der Versionskontrolle

   • Verwenden Sie unterschiedliche Anmeldeinformationen für Entwicklung und Produktion

   • Wechseln Sie regelmäßig Ihre API-Anmeldeinformationen

2. Sicherheit

   • Anmeldeinformationen sicher speichern

   • Verwenden Sie Umgebungsvariablen für vertrauliche Daten

   • Überwachen Sie API-Zugriffsprotokolle

3. Leistung

   • Zwischenspeichern von Formulardaten, wenn angemessen

   • Verwenden der Paginierung für große Formularlisten

   • Behandeln Sie Ratenbegrenzungen angemessen

Entwicklung

Projektstruktur

├── src/
│   ├── index.ts        # Server entry point
│   ├── auth.ts         # Token management
│   └── constants.ts    # Configuration
├── .env                # Environment variables (not in git)
├── .env.example        # Example environment file
└── .gitignore         # Git ignore rules

Sie können MCP Inspector mit dem folgenden Befehl auf diesem Server ausführen: npx @modelcontextprotocol/inspector node build/index.js

Beitragen

1. Forken Sie das Repository

2. Erstellen eines Feature-Zweigs

3. Nehmen Sie Ihre Änderungen vor

4. Senden einer Pull-Anfrage

Unterstützung

Bei Problemen und Fragen:

1. Überprüfen Sie die Marketo REST API-Dokumentation

2. Überprüfen Sie die oben aufgeführten häufigen Fehlerszenarien

3. Senden Sie ein Problem im Repository