Documentation Index
Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
Use this file to discover all available pages before exploring further.
Overview
The Model Context Protocol (MCP) is an open standard that enables AI applications to securely connect to external data sources and APIs. The Dodo Payments MCP Server provides AI assistants like Claude, Cursor, and other MCP-compatible clients with structured access to your payment infrastructure. The Dodo Payments MCP Server uses the Code Mode architecture. Instead of exposing hundreds of individual tools for every API endpoint, Code Mode enables AI agents to write and execute TypeScript code against the Dodo Payments SDK in an isolated sandbox environment.Key capabilities
- Payment Operations: Create, retrieve, and manage payments and refunds
- Subscription Management: Handle recurring billing, upgrades, and cancellations
- Customer Administration: Manage customer data and portal access
- Product Catalog: Create and update products, pricing, and discounts
- License Management: Activate, validate, and manage software licenses
- Usage-Based Billing: Track and bill for metered usage
How Code Mode Works
The Dodo Payments MCP Server provides your AI agent with exactly two tools:- Docs Search Tool: Queries documentation about the Dodo Payments API and SDK to understand available operations and parameters.
- Code Execution Tool: Writes TypeScript code against the SDK that executes in a secure sandbox environment.
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 sowohl MCP-Server als auch alle acht Skills in einem Schritt für Claude Code, Codex CLI, Cursor und OpenCode. Siehe den AI Coding Agents Guide für installationsspezifische Kommandos.Wenn Ihr Agent nicht in dieser Liste enthalten ist, verwenden Sie die untenstehenden Tabs, um den MCP-Server direkt zu konfigurieren.
Benötigt Node.js 18 oder höher. Der Remote-Server verwendet OAuth zur Authentifizierung — Sie werden aufgefordert, Ihren API-Schlüssel einzugeben und Ihre Umgebung bei der ersten Verbindung auszuwählen.
Dodo Knowledge MCP
Zusätzlich zum Dodo Payments MCP Server (für die Ausführung von API-Operationen), bieten wir Dodo Knowledge MCP — einen semantischen Suchserver, der KI-Assistenten sofortigen Zugriff auf die Dodo Payments-Dokumentation und Wissensdatenbank gewährt.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, der Folgendes bietet:- Semantische Dokumentationssuche: Finden Sie relevante Dokumentation mit Hilfe von natürlichen Sprachabfragen.
- Kontextbezogene Antworten: KI-Assistenten erhalten genaue, aktuelle Informationen über Dodo Payments.
- Null Einrichtung: Es sind keine API-Schlüssel oder lokale Installation erforderlich — einfach verbinden und Abfragen starten.
Schnelle Einrichtung
Verbinden Sie Dodo Knowledge MCP in Ihrem KI-Client:- Cursor
- Claude Desktop
- Windsurf
- Claude Code
Hinzufügen zu
~/.cursor/mcp.json:Benötigt Node.js 18 oder höher. Das
mcp-remote Paket verwaltet die Verbindung zum Remote-MCP-Server.Beide MCP-Server gemeinsam verwenden
Für die beste KI-unterstützte Entwicklungserfahrung 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 bei Knowledge MCP
Wenn Sie Verbindungsprobleme haben:- MCP-Authentifizierungs-Cache leeren:
rm -rf ~/.mcp-auth - Ihre Client-Anwendung neu starten
- Kundentools überprüfen auf Fehlermeldungen
- Node.js-Version überprüfen: Benötigt Node.js 18+
Knowledge MCP Server
Auf die Dodo Knowledge MCP-Konfigurationsseite zugreifen
Installation
Wählen Sie die Installationsmethode, die am besten zu Ihrem Arbeitsablauf passt.Remote-MCP-Server (Empfohlen)
Zugriff auf den gehosteten MCP-Server ohne lokale Einrichtung oder Installation. Dies ist der schnellste Weg, um zu beginnen.Access the remote server
Navigieren Sie zu https://mcp.dodopayments.com in Ihrem Browser.
Configure your 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:
Authenticate and configure
Der OAuth-Flow 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 (No Installation)
- MCP Client Configuration
Docker
Führen Sie den MCP-Server in einer containerisierten Umgebung für einen konsistenten Einsatz aus.Docker-Images sind unter 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
- Other Clients
Richten Sie den Dodo Payments MCP-Server in Cursor ein, um conversationalen Zugriff auf Ihre Zahlungsdaten zu ermöglichen.Ein-Klick-InstallationVerwenden Sie den untenstehenden Button, um den MCP-Server direkt in Cursor zu installieren:[
](https://cursor.com/en-US/install-mcp?name=dodopayments-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRvZG9wYXltZW50cy1tY3AiXSwiZW52Ijp7IkRPRE9fUEFZTUVOVFNfQVBJX0tFWSI6IlNldCB5b3VyIERPRE9fUEFZTUVOVFNfQVBJX0tFWSBoZXJlLiIsIkRPRE9fUEFZTUVOVFNfV0VCSE9PS19LRVkiOiJTZXQgeW91ciBET0RPX1BBWU1FTlRTX1dFQkhPT0tfS0VZIGhlcmUuIn19)Nach dem Klick setzen Sie Ihre Umgebungsvariablen in Cursors
mcp.json über Cursor Einstellungen > Tools & MCP > Neuer MCP-Server.Manuelle KonfigurationOpen Cursor settings
Navigieren Sie zu Cursor Einstellungen > Funktionen > Model Context Protocol oder drücken Sie
Cmd/Ctrl + Shift + P und suchen Sie nach “MCP-Einstellungen”.Edit configuration
Klicken Sie auf Konfiguration bearbeiten, um die
mcp_config.json Datei zu öffnen.Add Dodo Payments configuration
Wählen Sie eine der folgenden Konfigurationen:Remote-Server (Empfohlen)Lokale NPX
Umgebungsvariablen
Konfigurieren Sie das MCP-Server-Verhalten mit 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 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
Einmal bereitgestellt, können sich Clients mithilfe der Server-URL verbinden:Autorisierungsheader
Der Remote-Server akzeptiert Authentifizierung über die folgenden Header:| Header | Beschreibung |
|---|---|
Authorization | Bearer-Token-Authentifizierung |
x-dodo-payments-api-key | Direkter API-Schlüssel-Header |
Sicherheitspraktiken
Code Mode bietet inhärente Sicherheit durch die Ausführung von Code in einer Sandbox-Umgebung und das injizieren von API-Schlüsseln serverseitig. Folgen Sie diesen zusätzlichen Best Practices, um Ihre Anmeldedaten zu schützen.API Key Management
API Key Management
Niemals Anmeldedaten in die Versionskontrolle einfügenSpeichern Sie API-Schlüssel in Umgebungsvariablen oder sicheren Geheimverwaltungssystemen.Regelmäßiger SchlüsselwechselGenerieren 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 API-Schlüssel im Testmodus während der Entwicklung, um zu vermeiden, dass Produktionsdaten beeinflusst werden.
Access Control
Access Control
Implementieren Sie Authentifizierung für Remote-ServerVerlangen Sie bei Remote-Deployments immer eine Authentifizierung über den
Authorization Header oder den x-dodo-payments-api-key Header.API-Nutzung überwachenVerfolgen Sie die Aktivitäten des MCP-Servers über Ihr Dodo Payments-Dashboard und richten Sie Alarme für ungewöhnliche Muster ein.Network Security
Network Security
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 Ratenbeschränkungen auf Server- und API-Ebene implementieren.Eingeschränkter NetzwerkzugangKonfigurieren Sie Firewall-Regeln, um einzuschränken, welche Clients auf Ihren MCP-Server zugreifen können.
Fehlerbehebung
Connection issues
Connection issues
Überprüfen Sie Ihren API-SchlüsselStellen Sie sicher, dass Ihr API-Schlüssel korrekt gesetzt ist und die notwendigen Berechtigungen hat.Überprüfen Sie Ihre NetzwerkverbindungVerifizieren Sie, dass Sie die Endpunkte der Dodo Payments API erreichen können.Überprüfen Sie die Client-LogsAktivieren Sie ausführliches Logging in Ihrem MCP-Client, um Verbindungsprobleme zu diagnostizieren.
Authentication errors
Authentication errors
Bestätigen Sie die Umgebung des API-SchlüsselsStellen Sie sicher, dass Sie Testschlüssel mit Testendpunkten und Live-Schlüssel mit Produktionsendpunkten verwenden.Überprüfen Sie die UmgebungsvariableVerifizieren Sie, dass
DODO_PAYMENTS_ENVIRONMENT korrekt gesetzt ist (live_mode für Produktion).Anmeldedaten neu generierenWenn Probleme weiterhin bestehen, generieren Sie einen neuen API-Schlüssel über Ihr Dashboard.Tool execution failures
Tool execution failures
Eingabeparameter validierenStellen Sie sicher, dass der KI-Assistent korrekt formatierte Parameter für jedes Tool bereitstellt.Fehlermeldungen überprüfenÜberprüfen Sie die Fehlermeldung der API, um spezifische Hinweise darauf zu erhalten, was schiefgelaufen ist.Direkt mit der API testenVerifizieren Sie die Funktion, indem Sie die Dodo Payments API direkt über curl oder Postman aufrufen.
Warum Code Mode
Traditionelle MCP-Implementierungen leiden oft unter “Tool Proliferation”, bei der jeder API-Endpunkt als separates Tool exponiert wird. Code Mode ist eine überlegene Herangehensweise aus mehreren Gründen:LLMs sind besser im Schreiben von Code als im Aufrufen von Tools
LLMs wurden mit Millionen von Zeilen realer Codes trainiert, was sie natürlich kompetent im Schreiben von Skripten macht. Im Gegensatz dazu basiert das Aufrufen von Tools oft auf synthetischen Beispielen.“Ein LLM dazu zu bringen, Aufgaben mit Tool-Aufrufen zu erledigen ist, wie Shakespeare in einem Monat Chinesisch-Unterricht zu geben und ihn dann zu bitten, ein Stück darin zu schreiben.” — Cloudflare