Übersicht
Das Model Context Protocol (MCP) ist ein offener Standard, der es KI-Anwendungen ermöglicht, sicher mit externen Datenquellen und APIs zu verbinden. Der Dodo Payments MCP Server bietet KI-Assistenten wie Claude, Cursor und anderen MCP-kompatiblen Clients strukturierten Zugriff auf Ihre Zahlungsinfrastruktur. Der Dodo Payments MCP-Server ist mit Stainless erstellt und verwendet die Code Mode-Architektur, die es KI-Agenten ermöglicht, TypeScript-Code gegen das Dodo Payments SDK in einer isolierten Sandbox-Umgebung zu schreiben und auszuführen.Hauptfunktionen
- Zahlungsoperationen: Zahlungen und Rückerstattungen erstellen, abrufen und verwalten
- Abonnementverwaltung: Wiederkehrende Abrechnungen, Upgrades und Stornierungen verwalten
- Kundenverwaltung: Kundendaten und Portalzugang verwalten
- Produktkatalog: Produkte, Preise und Rabatte erstellen und aktualisieren
- Lizenzverwaltung: Softwarelizenzen aktivieren, validieren und verwalten
- Nutzungsbasierte Abrechnung: Abrechnungen für gemessene Nutzung verfolgen und erstellen
Wie Code Mode funktioniert
Der Dodo Payments MCP-Server verwendet Code Mode und bietet Ihrem KI-Agenten zwei leistungsstarke Werkzeuge:- Docs Search Tool: Dokumentation über die Dodo Payments API und SDK abfragen, um verfügbare Operationen und Parameter zu verstehen
- Code Execution Tool: TypeScript-Code gegen das SDK schreiben, der in einer sicheren Sandbox-Umgebung ohne Web- oder Dateisystemzugriff ausgeführt wird
Dodo Knowledge MCP
Neben dem Dodo Payments MCP Server (zum Ausführen von API-Operationen) bieten wir Dodo Knowledge MCP an - einen semantischen Suchserver, der KI-Assistenten sofortigen Zugriff auf die Dokumentation und Wissensdatenbank von Dodo Payments ermöglicht.Built with ContextMCP.ai: Dodo Knowledge MCP wird von ContextMCP betrieben, was eine schnelle semantische Suche in unserer Dokumentation mithilfe von Vektor-Embeddings ermöglicht.
Was ist Dodo Knowledge MCP?
Dodo Knowledge MCP ist ein Remote-MCP-Server, der Folgendes bietet:- Semantische Dokumentationssuche: Finden Sie relevante Dokumentation mit natürlichen Sprachabfragen
- Kontextuelle Antworten: KI-Assistenten erhalten genaue, aktuelle Informationen über Dodo Payments
- Null Einrichtung: Keine API-Schlüssel oder lokale Installation erforderlich - einfach verbinden und Abfragen starten
Schnelle Einrichtung
Verbinden Sie sich mit Dodo Knowledge MCP in Ihrem KI-Client:- Cursor
- Claude Desktop
- Windsurf
- Claude Code
Fügen Sie hinzu zu
~/.cursor/mcp.json:Erfordert Node.js 18 oder höher. Das
mcp-remote Paket verwaltet die Verbindung zum Remote-MCP-Server.Verwendung beider MCP-Server zusammen
Für das beste KI-unterstützte Entwicklungserlebnis empfehlen wir die Verwendung beider MCP-Server:| Server | Zweck | Anwendungsfall |
|---|---|---|
| Dodo Knowledge MCP | Dokumentationssuche | ”Wie gehe ich mit Webhooks um?”, “Welche Zahlungsmethoden werden unterstützt?” |
| Dodo Payments MCP | API-Operationen | Zahlungen erstellen, Abonnements verwalten, Rückerstattungen bearbeiten |
Fehlerbehebung Knowledge MCP
Wenn Sie auf Verbindungsprobleme stoßen:- MCP-Authentifizierungscache leeren:
rm -rf ~/.mcp-auth - Starten Sie Ihre Client-Anwendung neu
- Überprüfen Sie die Client-Protokolle auf Fehlermeldungen
- Überprüfen Sie die Node.js-Version: Erfordert Node.js 18+
Knowledge MCP Server
Greifen Sie auf die Konfigurationsseite von Dodo Knowledge MCP zu
Installation
Wählen Sie die Installationsmethode, die am besten zu Ihrem Workflow passt.Remote MCP-Server (Empfohlen)
Greifen Sie auf den gehosteten MCP-Server zu, ohne lokale Einrichtung oder Installation. Dies ist der schnellste Weg, um zu beginnen.Zugriff auf den Remote-Server
Navigieren Sie zu https://mcp.dodopayments.com in Ihrem Browser.
Konfigurieren Sie Ihren MCP-Client
Kopieren Sie die bereitgestellte JSON-Konfiguration für Ihren spezifischen Client. Für Cursor oder Claude Desktop fügen Sie dies zu Ihren MCP-Einstellungen hinzu:
Authentifizieren und konfigurieren
Der OAuth-Fluss fordert Sie auf:
- Geben Sie Ihren Dodo Payments API-Schlüssel ein
- Wählen Sie Ihre Umgebung (Test oder Live)
- Wählen Sie Ihren MCP-Clienttyp
NPM-Paket
Installieren und führen Sie den MCP-Server lokal mit NPM aus.- NPX (Keine Installation)
- MCP-Client-Konfiguration
Docker
Führen Sie den MCP-Server in einer containerisierten Umgebung für konsistente Bereitstellung aus.Docker-Images sind auf GitHub Container Registry verfügbar.
Client-Konfiguration
Konfigurieren Sie den Dodo Payments MCP-Server in Ihrem bevorzugten KI-Client.- Cursor
- Claude Desktop
- Claude Code
- VS Code
- Cline (VS Code)
- Zed
- Andere Clients
Richten Sie den Dodo Payments MCP-Server in Cursor ein, um konversationellen Zugriff auf Ihre Zahlungsdaten zu ermöglichen.Ein-Klick-InstallationVerwenden Sie die Schaltfläche unten, um den MCP-Server direkt in Cursor zu installieren:[
](https://cursor.com/en-US/install-mcp?name=dodopayments-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRvZG9wYXltZW50cy1tY3AiXSwiZW52Ijp7IkRPRE9fUEFZTUVOVFNfQVBJX0tFWSI6IlNldCB5b3VyIERPRE9fUEFZTUVOVFNfQVBJX0tFWSBoZXJlLiIsIkRPRE9fUEFZTUVOVFNfV0VCSE9PS19LRVkiOiJTZXQgeW91ciBET0RPX1BBWU1FTlRTX1dFQkhPT0tfS0VZIGhlcmUuIn19)Nach dem Klicken setzen Sie Ihre Umgebungsvariablen in Cursors
mcp.json über Cursor-Einstellungen > Tools & MCP > Neuer MCP-Server.Manuelle KonfigurationCursor-Einstellungen öffnen
Navigieren Sie zu Cursor-Einstellungen > Features > Model Context Protocol oder drücken Sie
Cmd/Ctrl + Shift + P und suchen Sie nach “MCP-Einstellungen”.Konfiguration bearbeiten
Klicken Sie auf Konfiguration bearbeiten, um die
mcp_config.json Datei zu öffnen.Dodo Payments-Konfiguration hinzufügen
Wählen Sie eine der folgenden Konfigurationen:Remote-Server (Empfohlen)Lokales NPX
Umgebungsvariablen
Konfigurieren Sie das Verhalten des MCP-Servers mithilfe von Umgebungsvariablen.| Variable | Beschreibung | Erforderlich |
|---|---|---|
DODO_PAYMENTS_API_KEY | Ihr Dodo Payments API-Schlüssel | Ja |
DODO_PAYMENTS_WEBHOOK_KEY | Ihr Webhook-Signierschlüssel | Nein |
DODO_PAYMENTS_ENVIRONMENT | Setzen Sie auf live_mode für die Produktion | Nein |
Remote Ausführen
Setzen Sie den MCP-Server als Remote-HTTP-Server für webbasierte Clients oder agentische Workflows ein.Remote-Server-Konfiguration
Sobald bereitgestellt, können sich Clients über die Server-URL verbinden:Autorisierungsheader
Der Remote-Server akzeptiert die Authentifizierung über die folgenden Header:| Header | Beschreibung |
|---|---|
Authorization | Bearer-Token-Authentifizierung |
x-dodo-payments-api-key | Direkter API-Schlüssel-Header |
Client-Fähigkeiten
Verschiedene MCP-Clients unterstützen unterschiedliche Ebenen der MCP-Spezifikation. Der Server kann die Tool-Schemas automatisch anpassen, um diese Einschränkungen zu umgehen.Verfügbare Client-Presets
| Client | Beschreibung |
|---|---|
infer | Automatische Erkennung des Clients (Standard) |
cursor | Cursor-Editor |
claude | Claude AI-Web oder Desktop |
claude-code | Claude Code CLI |
openai-agents | OpenAI-Agentenplattform |
Manuelle Fähigkeitskonfiguration
Für Clients, die oben nicht aufgeführt sind, konfigurieren Sie die Fähigkeiten manuell:top-level-unions- Unterstützung für Top-Level-Vereinigungstypenvalid-json- Korrekte JSON-String-Argumentanalyserefs- Unterstützung für $ref-Zeiger in Schemataunions- Unterstützung für Vereinigungstypen (anyOf)formats- Unterstützung für Formatvalidierungentool-name-length=N- Maximale Länge des Toolnamens
Tool-Filterung
Steuern Sie, welche API-Operationen Ihrem KI-Assistenten zur Verfügung stehen, um die Leistung zu optimieren und die Sicherheit zu gewährleisten.Nach Operationstyp filtern
Zugriff auf schreibgeschützte oder schreibbare Operationen einschränken.Nach Ressource filtern
Tools auf bestimmte API-Ressourcen beschränken.Bestimmte Tools ein- oder ausschließen
Feinabstimmung, welche einzelnen Tools verfügbar sind.Filter kombinieren
Wenden Sie mehrere Filter gleichzeitig für präzise Kontrolle an.URL-Abfrageparameterfilterung (Remote-Server)
Bei Verwendung des Remote-Servers Filter über URL-Abfrageparameter anwenden:Dynamischer Tools-Modus
Für große APIs kann das gleichzeitige Laden aller Tools den Kontextbereich der KI überfordern. Der dynamische Tools-Modus bietet eine effizientere Alternative.list_api_endpoints- Entdeckt verfügbare Methoden mit optionaler Filterungget_api_endpoint_schema- Holt detailliertes Schema für eine bestimmte Methodeinvoke_api_endpoint- Führt eine Methode mit den entsprechenden Parametern aus
Dynamische Tools werden automatisch für APIs mit mehr als 50 Methoden aktiviert. Überschreiben Sie mit
--tools=all um alle Tools einzuschließen.Erweiterte Nutzung
Programmatische Integration
Erstellen Sie benutzerdefinierte MCP-Server oder erweitern Sie den vorhandenen programmatisch.Entwicklung benutzerdefinierter Tools
Erweitern Sie den MCP-Server mit Ihren eigenen Tools und Geschäftslogik.Sicherheitsbestimmungen
Schützen Sie Ihre API-Anmeldeinformationen und gewährleisten Sie sichere Integrationen.API-Schlüsselverwaltung
API-Schlüsselverwaltung
Geben Sie niemals Anmeldeinformationen in die Versionskontrolle einSpeichern Sie API-Schlüssel in Umgebungsvariablen oder sicheren Geheimnisverwaltungssystemen.Drehen Sie Schlüssel regelmäßigGenerieren Sie regelmäßig neue API-Schlüssel und widerrufen Sie alte über Ihr Dodo Payments-Dashboard.Verwenden Sie Testschlüssel für die EntwicklungVerwenden Sie immer Testmodus-API-Schlüssel während der Entwicklung, um zu vermeiden, dass Produktionsdaten betroffen sind.
Zugriffskontrolle
Zugriffskontrolle
Wenden Sie Tool-Filterung in der Produktion anBeschränken Sie die exponierten Operationen auf das, was Ihr KI-Assistent benötigt.Implementieren Sie Authentifizierung für Remote-ServerBeim Remote-Deployment ist immer eine Authentifizierung über den
Authorization Header oder den x-dodo-payments-api-key Header erforderlich.Überwachen Sie die API-NutzungVerfolgen Sie die Aktivität des MCP-Servers über Ihr Dodo Payments-Dashboard und richten Sie Warnungen für ungewöhnliche Muster ein.Netzwerksicherheit
Netzwerksicherheit
Verwenden Sie HTTPS für Remote-ServerSetzen Sie Remote-MCP-Server immer hinter HTTPS-Endpunkten ein.Implementieren Sie RatenbegrenzungSchützen Sie sich vor Missbrauch, indem Sie Ratenlimits sowohl auf MCP-Server- als auch auf API-Ebene implementieren.Beschränken Sie den NetzwerkzugriffKonfigurieren Sie Firewall-Regeln, um zu beschränken, welche Clients sich mit Ihrem MCP-Server verbinden können.
Fehlerbehebung
Verbindungsprobleme
Verbindungsprobleme
Überprüfen Sie Ihren API-SchlüsselStellen Sie sicher, dass Ihr API-Schlüssel korrekt gesetzt ist und die erforderlichen Berechtigungen hat.Überprüfen Sie Ihre NetzwerkverbindungStellen Sie sicher, dass Sie die Dodo Payments API-Endpunkte erreichen können.Überprüfen Sie die Client-ProtokolleAktivieren Sie ausführliches Logging in Ihrem MCP-Client, um Verbindungsprobleme zu diagnostizieren.
Authentifizierungsfehler
Authentifizierungsfehler
Bestätigen Sie die API-SchlüsselumgebungStellen Sie sicher, dass Sie Testschlüssel mit Testendpunkten und Live-Schlüssel mit Produktionsendpunkten verwenden.Überprüfen Sie die UmgebungsvariableÜberprüfen Sie, ob
DODO_PAYMENTS_ENVIRONMENT korrekt gesetzt ist (live_mode für die Produktion).Generieren Sie Anmeldeinformationen neuWenn Probleme weiterhin bestehen, generieren Sie einen neuen API-Schlüssel über Ihr Dashboard.Fehler bei der Toolausführung
Fehler bei der Toolausführung
Validieren Sie EingabeparameterStellen Sie sicher, dass der KI-Assistent korrekt formatierte Parameter für jedes Tool bereitstellt.Überprüfen Sie FehlermeldungenÜberprüfen Sie die Fehlermeldung von der API für spezifische Hinweise darauf, was schiefgelaufen ist.Testen Sie direkt mit der APIÜberprüfen Sie, ob die Operation funktioniert, wenn Sie die Dodo Payments API direkt über curl oder Postman aufrufen.
Kompatibilitätsprobleme mit Clients
Kompatibilitätsprobleme mit Clients
Versuchen Sie ein anderes Client-PresetWenn Tools nicht richtig funktionieren, versuchen Sie, Ihren Client explizit anzugeben:Überprüfen Sie die Unterstützung von FähigkeitenEinige Clients unterstützen nicht alle Funktionen des JSON-Schemas. Verwenden Sie
--describe-capabilities um zu verstehen, was unterstützt wird.