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
- 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
marketo_get_forms({
maxReturn: 200, // optional, default: 200
offset: 0, // optional, default: 0
status: 'draft' // optional, 'draft' or 'approved'
})
marketo_get_form_by_id({
formId: 1234
})
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
})
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
Sie können MCP Inspector mit dem folgenden Befehl auf diesem Server ausführen: npx @modelcontextprotocol/inspector node build/index.js
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