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

Erste Schritte

1. Erhalten Sie Marketo API-Anmeldeinformationen

Melden Sie sich bei Ihrem Marketo-Administrationsbereich an
Navigieren Sie zu Admin > Integration > LaunchPoint
Klicken Sie auf Neu > Neuer Dienst
Geben Sie die Servicedetails ein:
- Service: Benutzerdefiniert
- Anzeigename: (z. B. „MCP-Server“)
Speichern Sie die angegebene Client-ID und das Client-Geheimnis

2. Umgebungsvariablen konfigurieren

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

Öffnen Sie Claude Desktop
Gehen Sie zu den Entwicklereinstellungen
Fügen Sie die Konfigurationseinstellungen ein , die während des Build-Prozesses ausgegeben wurden
Speichern der Konfiguration
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:

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
Berechtigungsfehler
- Überprüfen Sie, ob Ihr API-Benutzer über ausreichende Berechtigungen verfügt
- Überprüfen Sie die Ordnerzugriffsberechtigungen für Formularvorgänge
Ratenbegrenzung
- Der Server übernimmt automatisch die Token-Aktualisierung
- Erwägen Sie die Implementierung einer Wiederholungslogik für ratenbegrenzte Anfragen.

Bewährte Methoden

Umweltmanagement
- Übergeben Sie .env -Dateien niemals der Versionskontrolle
- Verwenden Sie unterschiedliche Anmeldeinformationen für Entwicklung und Produktion
- Wechseln Sie regelmäßig Ihre API-Anmeldeinformationen
Sicherheit
- Anmeldeinformationen sicher speichern
- Verwenden Sie Umgebungsvariablen für vertrauliche Daten
- Überwachen Sie API-Zugriffsprotokolle
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

Beitragen

Forken Sie das Repository
Erstellen eines Feature-Zweigs
Nehmen Sie Ihre Änderungen vor
Senden einer Pull-Anfrage

Unterstützung

Bei Problemen und Fragen:

Überprüfen Sie die Marketo REST API-Dokumentation
Überprüfen Sie die oben aufgeführten häufigen Fehlerszenarien
Senden Sie ein Problem im Repository

Marketo MCP Server

Integrations