Overview
Das Model Context Protocol (MCP) ist ein offener Standard, der es AI-Anwendungen ermöglicht, eine Verbindung zu externen Datenquellen und APIs herzustellen. Der Dodo Payments MCP Server gibt AI-Assistenten wie Claude, Cursor und anderen MCP-kompatiblen Clients Zugriff auf Ihre Zahlungsinfrastruktur. Der Dodo Payments MCP Server verwendet eine Code Mode-Architektur. Anstatt Hunderte einzelner Tools für jeden API-Endpunkt bereitzustellen, ermöglicht Code Mode AI-Agenten, TypeScript-Code gegen das Dodo Payments SDK in einer isolierten Sandbox zu schreiben und auszuführen.Zentrale Funktionen
- Zahlungsvorgänge — Zahlungen und Rückerstattungen erstellen, abrufen und verwalten
- Abonnementverwaltung — Wiederkehrende Abrechnungen, Upgrades und Kündigungen bearbeiten
- Kundenverwaltung — Kundendaten und Portalzugriff verwalten
- Produktkatalog — Produkte, Preise und Rabatte erstellen und aktualisieren
- Lizenzverwaltung — Softwarelizenzen aktivieren, validieren und verwalten
- Nutzungsbasierte Abrechnung — Nutzungsbasierte Mengen erfassen und abrechnen
How Code Mode Works
Der Dodo Payments MCP Server stellt Ihrem AI-Agenten zwei Tools bereit:- Docs Search Tool — Durchsucht die Dokumentation zur Dodo Payments API und zum SDK, um verfügbare Vorgänge und Parameter zu verstehen.
- Code Execution Tool — Schreibt TypeScript-Code für das SDK, der in einer sicheren Sandbox ausgeführt wird.
Quick Setup
Connect to the Dodo Payments MCP Server in your AI client:- Agent Plugin (recommended)
- Cursor
- Claude Desktop
- Windsurf
- Claude Code
Das Dodo Agent Plugin installiert beide MCP-Server und alle siebzehn Skills in einem Schritt für Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro und OpenCode (OpenCode benötigt eine zusätzliche
skills.paths-Einstellung). Gemini CLI erhält nur die beiden MCP-Server, da es kein Agent-Skill-Primitiv besitzt. In der Anleitung zu AI Coding Agents finden Sie Installationsbefehle für die einzelnen Agenten.Wenn Ihr Agent nicht in dieser Liste enthalten ist, verwenden Sie die untenstehenden Tabs, um den MCP-Server direkt zu konfigurieren.Erfordert Node.js 18 oder höher. Der Remote-Server verwendet OAuth zur Authentifizierung. Bei der ersten Verbindung werden Sie aufgefordert, Ihren API-Schlüssel einzugeben und Ihre Umgebung auszuwählen.
Dodo Knowledge MCP
Zusätzlich zum Dodo Payments MCP Server (für die Ausführung von API-Vorgängen) bieten wir Dodo Knowledge MCP an – einen semantischen Suchserver, der AI-Assistenten sofortigen Zugriff auf die Dokumentation von Dodo Payments ermöglicht.Erbaut mit ContextMCP.ai: Dodo Knowledge MCP wird von ContextMCP angetrieben und ermöglicht schnelle semantische Suche über unsere Dokumentation mit Hilfe von Vektor-Einbettungen.
Was ist Dodo Knowledge MCP?
Dodo Knowledge MCP ist ein Remote-MCP-Server für die semantische Dokumentationssuche. Finden Sie relevante Dokumentation mithilfe natürlichsprachlicher Anfragen, erhalten Sie präzise und aktuelle Informationen zu Dodo Payments und stellen Sie eine Verbindung her, ohne API-Schlüssel oder eine lokale Installation zu benötigen.Schnelle Einrichtung
Verbinden Sie sich in Ihrem AI-Client mit Dodo Knowledge MCP:- Cursor
- Claude Desktop
- Windsurf
- Claude Code
Fügen Sie Folgendes zu
~/.cursor/mcp.json hinzu:Erfordert Node.js 18 oder höher. Das Paket
mcp-remote stellt die Verbindung zum Remote-MCP-Server her.Beide MCP-Server gemeinsam verwenden
Für die beste AI-unterstützte Entwicklungserfahrung sollten Sie beide MCP-Server verwenden:Fehlerbehebung bei Knowledge MCP
Wenn Verbindungsprobleme auftreten, löschen Sie den MCP-Authentifizierungscache mitrm -rf ~/.mcp-auth, starten Sie Ihre Client-Anwendung neu, prüfen Sie die Client-Protokolle auf Fehlermeldungen und verifizieren Sie die Node.js-Version (erfordert 18+).
Knowledge MCP Server
Konfigurationsseite von Dodo Knowledge MCP öffnen
Installation
Wählen Sie die Installationsmethode, die zu Ihrem Arbeitsablauf passt.Remote-MCP-Server (empfohlen)
Greifen Sie ohne lokale Einrichtung oder Installation auf den gehosteten MCP-Server zu.1
Access the remote server
Öffnen Sie https://mcp.dodopayments.com in Ihrem Browser.
2
Configure your MCP client
Kopieren Sie die bereitgestellte JSON-Konfiguration für Ihren jeweiligen Client. Fügen Sie sie für Cursor oder Claude Desktop zu den MCP-Einstellungen hinzu:
3
Authenticate and configure
Der OAuth-Ablauf fordert Sie auf:
- Ihren Dodo Payments API-Schlüssel einzugeben
- Ihre Umgebung auszuwählen (test oder live)
- Ihren MCP-Clienttyp auszuwählen
4
Complete setup
Klicken Sie auf Login and Approve, um die Verbindung zu autorisieren.
Nach der Verbindung kann Ihr AI-Assistent die Dodo Payments API in Ihrem Namen nutzen.
NPM-Paket
Installieren und führen Sie den MCP-Server lokal aus.- NPX (No Installation)
- MCP Client Configuration
Docker
Führen Sie den MCP-Server in einem Container aus.Docker-Images sind in der GitHub Container Registry verfügbar.
Client-Konfiguration
Konfigurieren Sie den Dodo Payments MCP-Server in Ihrem bevorzugten AI-Client.- Cursor
- Claude Desktop
- Claude Code
- VS Code
- Cline (VS Code)
- Zed
- Other Clients
Richten Sie den Dodo Payments MCP-Server in Cursor ein, um einen dialogorientierten Zugriff auf Ihre Zahlungsdaten zu ermöglichen.Installation mit einem KlickVerwenden 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)Klicken Sie anschließend in Cursors
mcp.json unter Cursor-Einstellungen > Tools & MCP > Neuer MCP-Server, um Ihre Umgebungsvariablen festzulegen.Manuelle Konfiguration1
Open Cursor settings
Navigieren Sie zu Cursor-Einstellungen > Tools & MCP oder drücken Sie
Cmd/Ctrl + Shift + P und suchen Sie nach „MCP Settings“.2
Edit configuration
Klicken Sie auf Neuer MCP-Server, um die Datei
mcp.json zu öffnen.3
Add Dodo Payments configuration
Wählen Sie eine der folgenden Konfigurationen:Remote Server (Recommended)Local NPX
4
Save and restart
Speichern Sie die Konfigurationsdatei und starten Sie Cursor neu.
Überprüfen Sie die Verbindung, indem Sie den AI-Assistenten zu Ihren Dodo Payments-Daten befragen.
Umgebungsvariablen
Konfigurieren Sie das Verhalten des MCP-Servers mithilfe von Umgebungsvariablen.Remote-Ausführung
Stellen Sie den MCP-Server als Remote-HTTP-Server für webbasierte Clients oder agentische Workflows bereit.Konfiguration des Remote-Servers
Nach der Bereitstellung können Clients über die Server-URL eine Verbindung herstellen:Autorisierungs-Header
Der Remote-Server akzeptiert die Authentifizierung über die folgenden Header:Best Practices für Sicherheit
Code Mode bietet inhärente Sicherheit, indem Code in einer Sandbox-Umgebung ausgeführt und API-Schlüssel serverseitig injiziert werden. Befolgen Sie diese Best Practices, um Ihre Zugangsdaten zu schützen.API Key Management
API Key Management
Übergeben Sie niemals Zugangsdaten an die Versionsverwaltung. Speichern Sie API-Schlüssel in Umgebungsvariablen oder sicheren Systemen zur Geheimnisverwaltung:Rotieren Sie Schlüssel regelmäßig, indem Sie in regelmäßigen Abständen neue API-Schlüssel generieren und alte über Ihr Dodo Payments-Dashboard widerrufen. Verwenden Sie während der Entwicklung immer API-Schlüssel im Testmodus, um Auswirkungen auf Produktionsdaten zu vermeiden.
Access Control
Access Control
Wenn Sie den Server remote bereitstellen, verlangen Sie immer eine Authentifizierung über den Header
Authorization oder den Header x-dodo-payments-api-key.Network Security
Network Security
Stellen Sie Remote-MCP-Server immer hinter HTTPS-Endpunkten bereit. Schützen Sie sich vor Missbrauch, indem Sie sowohl auf MCP-Server- als auch auf API-Ebene Rate-Limits implementieren. Konfigurieren Sie Firewall-Regeln, um festzulegen, welche Clients eine Verbindung zu Ihrem MCP-Server herstellen dürfen.
Fehlerbehebung
Connection issues
Connection issues
Überprüfen Sie, ob Ihr API-Schlüssel korrekt festgelegt ist und über die erforderlichen Berechtigungen verfügt:Überprüfen Sie, ob Sie die Dodo Payments API-Endpunkte erreichen können. Aktivieren Sie ausführliches Logging in Ihrem MCP-Client, um Verbindungsprobleme zu diagnostizieren.
Authentication errors
Authentication errors
Stellen Sie sicher, dass Sie Testschlüssel mit Test-Endpunkten und Live-Schlüssel mit Produktions-Endpunkten verwenden. Überprüfen Sie, ob
DODO_PAYMENTS_ENVIRONMENT korrekt festgelegt ist (live_mode für die Produktion). Wenn die Probleme weiterhin bestehen, generieren Sie über Ihr Dashboard einen neuen API-Schlüssel.Tool execution failures
Tool execution failures
Stellen Sie sicher, dass der AI-Assistent für jedes Tool korrekt formatierte Parameter bereitstellt. Prüfen Sie die Fehlerantwort der API auf konkrete Hinweise zur Fehlerursache. Überprüfen Sie, ob der Vorgang funktioniert, wenn Sie die Dodo Payments API direkt über curl oder Postman aufrufen.
Warum Code Mode
Herkömmliche MCP-Implementierungen leiden unter einer „Tool-Vermehrung“, bei der jeder API-Endpunkt als separates Tool bereitgestellt wird. Code Mode ist aus mehreren Gründen besser:LLMs schreiben besser Code, als sie Tools aufrufen
LLMs wurden anhand von Millionen Zeilen praxisnahem Code trainiert und schreiben daher ganz natürlich gute Skripte. Tool-Aufrufe basieren häufig auf synthetischen Beispielen.„Einen LLM dazu zu bringen, Aufgaben mit Tool-Aufrufen auszuführen, ist so, als würde man Shakespeare einen einmonatigen Mandarin-Kurs besuchen lassen und ihn anschließend bitten, ein Theaterstück auf Mandarin zu schreiben.“ — Cloudflare
Verhindert eine übermäßige Belastung des Kontextfensters
Bei herkömmlichen Ansätzen verbraucht jede Tool-Definition Tokens, bevor die Unterhaltung beginnt. Die Bereitstellung von mehr als 50 Tools kann 55.000–100.000+ Tokens verbrauchen. Anthropic stellte fest, dass Tool-Definitionen vor der Optimierung bis zu 134.000 Tokens verbrauchen konnten. Code Mode lädt nur 2 Tool-Definitionen (etwa 1.000 Tokens). Der Agent durchsucht die Dokumentation nach Bedarf. Das Tool Search Tool von Anthropic bewahrte 95 % des Kontextfensters und reduzierte den Overhead von 77.000 auf 8.700 Tokens.Reduziert die Latenz durch programmatische Orchestrierung
Herkömmliche Tool-Aufrufe erfordern für jeden Vorgang einen vollständigen Roundtrip der Modellinferenz. Wenn eine Aufgabe 20 API-Aufrufe erfordert, sind das 20 Roundtrips. In Code Mode schreibt der Agent ein Skript, das alle Aufrufe ausführt und nur das Endergebnis zurückgibt. Anthropic beobachtete mit diesem Ansatz eine Reduzierung der Token-Anzahl um 37 % sowie eine höhere Genauigkeit (der Wissensabruf verbesserte sich von 25,6 % auf 28,5 %).Von Grund auf sicherer
Code Mode bietet inhärente Sicherheitsvorteile:- Keine API-Schlüssel in Parametern — API-Schlüssel werden serverseitig injiziert und niemals in Tool-Parametern offengelegt, die an den LLM gesendet werden.
- Isolierte Sandbox — Code wird in einer sicheren Umgebung ohne Zugriff auf das Netzwerk oder das Host-Dateisystem ausgeführt.
- Kontrolliertes SDK — Dem Agenten stehen nur autorisierte SDK-Methoden zur Verfügung.
Für APIs jeder Größe skalierbar
Mit zunehmender Größe einer API nimmt die Leistung herkömmlicher MCP-Implementierungen ab, da mehr Tools geladen werden müssen. Code Mode bleibt unabhängig vom Umfang der API mit 2 Tools konstant. Cloudflare fasste mehr als 2.500 API-Endpunkte in 2 Tools und etwa 1.000 Tokens Kontext zusammen.Weitere Informationen finden Sie in den Engineering-Blogs von Anthropic und Cloudflare sowie in der Dokumentation zu Programmatic Tool Calling von Claude.
Ressourcen
API Reference
Vollständige Dodo Payments API-Dokumentation durchsuchen
MCP Protocol
Mehr über den Model Context Protocol-Standard erfahren
GitHub Repository
Quellcode des MCP-Servers anzeigen und beitragen
NPM Package
MCP-Server von NPM installieren