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:

3. Installation und Einrichtung

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

Formular nach ID abrufen

Klonformular

Formular genehmigen

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

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