Skip to main content

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:
  1. Docs Search Tool — Durchsucht die Dokumentation zur Dodo Payments API und zum SDK, um verfügbare Vorgänge und Parameter zu verstehen.
  2. Code Execution Tool — Schreibt TypeScript-Code für das SDK, der in einer sicheren Sandbox ausgeführt wird.
Diese Architektur ermöglicht es Agenten, komplexe Vorgänge mit mehreren Schritten in einem einzigen Aufruf auszuführen. Ein Agent kann beispielsweise alle aktiven Abonnements auflisten, sie nach Kriterien filtern und auf jedes einen Rabatt anwenden – alles in einem Skript.
Agenten können mehrere API-Aufrufe verketten, bedingte Logik verarbeiten und Berechnungen durchführen, ohne zum LLM zurückkehren zu müssen.

Quick Setup

Connect to the Dodo Payments MCP Server in your AI client:
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:
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:
Wenn beide Server konfiguriert sind, kann Ihr Agent die Dokumentation durchsuchen, um eine Funktion zu verstehen, und anschließend die API-Aufrufe zu ihrer Implementierung ausführen – alles in einer Unterhaltung.

Fehlerbehebung bei Knowledge MCP

Wenn Verbindungsprobleme auftreten, löschen Sie den MCP-Authentifizierungscache mit rm -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
Bewahren Sie Ihren API-Schlüssel sicher auf. Verwenden Sie während der Entwicklung Schlüssel für den Testmodus.
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.
Der lokale Server führt Ihren Code in einer Deno-Sandbox aus. Installieren Sie Deno 2.8 oder früher und stellen Sie sicher, dass deno auf PATH liegt; bei Deno 2.9 und höher kann die Sandbox nicht gestartet werden. Die lokale Codeausführung funktioniert nur unter macOS und Linux. Verwenden Sie unter Windows den Remote-Server oder führen Sie den lokalen Server unter WSL2 aus.
Verwenden Sie @latest, um stets die neueste Version abzurufen, oder legen Sie für mehr Stabilität eine bestimmte Version wie @2.51.0 fest.

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.
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:[Zu Cursor hinzufügen](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 Konfiguration
1

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.
Ü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.
Wenn Sie den Server remote bereitstellen, verlangen Sie immer eine Authentifizierung über den Header Authorization oder den Header x-dodo-payments-api-key.
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

Ü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.
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.
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
Zuletzt geändert am 26. September 2026