Zum Hauptinhalt springen

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:
  1. Docs Search Tool: Queries documentation about the Dodo Payments API and SDK to understand available operations and parameters.
  2. Code Execution Tool: Writes TypeScript code against the SDK that executes in a secure sandbox environment.
This architecture allows agents to perform complex, multi-step operations in a single invocation. For example, an agent can list all active subscriptions, filter them based on specific criteria, and apply a discount to each—all within one script.
Using Code Mode, agents can chain multiple API calls, handle conditional logic, and perform calculations without requiring multiple round-trips to the LLM.

Quick Setup

Connect to the Dodo Payments MCP Server in your AI client:
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:
Hinzufügen zu ~/.cursor/mcp.json:
{
  "mcpServers": {
    "dodo-knowledge": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://knowledge.dodopayments.com/mcp"]
    }
  }
}
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:
ServerZweckAnwendungsfall
Dodo Knowledge MCPDokumentationssuche”Wie gehe ich mit Webhooks um?”, “Welche Zahlungsmethoden werden unterstützt?”
Dodo Payments MCPAPI-OperationenZahlungen erstellen, Abonnements verwalten, Rückerstattungen bearbeiten
{
  "mcpServers": {
    "dodo-knowledge": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://knowledge.dodopayments.com/mcp"]
    },
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}
Mit beiden konfigurierten Servern kann Ihr KI-Assistent zuerst die Dokumentation durchsuchen, um zu verstehen, wie eine Funktion implementiert wird, und dann die tatsächlichen API-Aufrufe ausführen - alles in einem einzigen Gespräch.

Fehlerbehebung bei Knowledge MCP

Wenn Sie Verbindungsprobleme haben:
  1. MCP-Authentifizierungs-Cache leeren: rm -rf ~/.mcp-auth
  2. Ihre Client-Anwendung neu starten
  3. Kundentools überprüfen auf Fehlermeldungen
  4. 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.
1

Access the remote server

Navigieren Sie zu https://mcp.dodopayments.com in Ihrem Browser.
2

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:
{
  "mcpServers": {
    "dodopayments_api": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}
3

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
Halten Sie Ihren API-Schlüssel sicher. Verwenden Sie Testmodus-Schlüssel während der Entwicklung.
4

Complete setup

Klicken Sie auf Anmelden und Genehmigen, um die Verbindung zu autorisieren.
Sobald die Verbindung hergestellt ist, kann Ihr KI-Assistent mit der Dodo Payments API in Ihrem Namen interagieren.

NPM-Paket

Installieren und führen Sie den MCP-Server lokal mit NPM aus.
# Set your environment variables
export DODO_PAYMENTS_API_KEY="dodo_test_..."
export DODO_PAYMENTS_WEBHOOK_KEY="your_webhook_key"
export DODO_PAYMENTS_ENVIRONMENT="live_mode"

# Run the latest version
npx -y dodopayments-mcp@latest
Verwenden Sie @latest, um immer die neueste Version zu holen, oder fixieren Sie auf eine bestimmte Version wie @1.0.0 für Stabilität.

Docker

Führen Sie den MCP-Server in einer containerisierten Umgebung für einen konsistenten Einsatz aus.
# Pull the latest image
docker pull ghcr.io/dodopayments/mcp:latest

# Run the container
docker run -e DODO_PAYMENTS_API_KEY="dodo_test_..." \
  -e DODO_PAYMENTS_WEBHOOK_KEY="your_webhook_key" \
  -e DODO_PAYMENTS_ENVIRONMENT="live_mode" \
  ghcr.io/dodopayments/mcp:latest
Docker-Images sind unter GitHub Container Registry verfügbar.

Client-Konfiguration

Konfigurieren Sie den Dodo Payments MCP-Server in Ihrem bevorzugten KI-Client.
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:[Add to Cursor](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 Konfiguration
1

Open 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”.
2

Edit configuration

Klicken Sie auf Konfiguration bearbeiten, um die mcp_config.json Datei zu öffnen.
3

Add Dodo Payments configuration

Wählen Sie eine der folgenden Konfigurationen:Remote-Server (Empfohlen)
{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}
Lokale NPX
{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "dodopayments-mcp@latest"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "dodo_test_...",
        "DODO_PAYMENTS_WEBHOOK_KEY": "your_webhook_key"
      }
    }
  }
}
4

Save and restart

Speichern Sie die Konfigurationsdatei und starten Sie Cursor neu.
Überprüfen Sie die Verbindung, indem Sie den KI-Assistenten nach Ihren Dodo Payments-Daten fragen.

Umgebungsvariablen

Konfigurieren Sie das MCP-Server-Verhalten mit Umgebungsvariablen.
VariableBeschreibungErforderlich
DODO_PAYMENTS_API_KEYIhr Dodo Payments API-SchlüsselJa
DODO_PAYMENTS_WEBHOOK_KEYIhr Webhook-SignierschlüsselNein
DODO_PAYMENTS_ENVIRONMENTSetzen Sie auf live_mode für ProduktionNein

Remote ausführen

Setzen Sie den MCP-Server als Remote-HTTP-Server für webbasierte Clients oder agentische Workflows ein.
# Start as remote server
npx -y dodopayments-mcp --transport=http

# Specify a custom port
npx -y dodopayments-mcp --transport=http --port=3000

Remote-Server-Konfiguration

Einmal bereitgestellt, können sich Clients mithilfe der Server-URL verbinden:
{
  "mcpServers": {
    "dodopayments_api": {
      "url": "http://localhost:3000",
      "headers": {
        "Authorization": "Bearer your_api_key"
      }
    }
  }
}

Autorisierungsheader

Der Remote-Server akzeptiert Authentifizierung über die folgenden Header:
HeaderBeschreibung
AuthorizationBearer-Token-Authentifizierung
x-dodo-payments-api-keyDirekter 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.
Niemals Anmeldedaten in die Versionskontrolle einfügenSpeichern Sie API-Schlüssel in Umgebungsvariablen oder sicheren Geheimverwaltungssystemen.
# Use environment variables
export DODO_PAYMENTS_API_KEY="dodo_test_..."

# Use a .env file (add to .gitignore)
echo "DODO_PAYMENTS_API_KEY=dodo_test_..." > .env
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.
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.
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

Überprüfen Sie Ihren API-SchlüsselStellen Sie sicher, dass Ihr API-Schlüssel korrekt gesetzt ist und die notwendigen Berechtigungen hat.
# Test your API key
curl -H "Authorization: Bearer dodo_test_..." \
  https://test.dodopayments.com/payments
Ü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.
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.
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

Eliminierung von Kontextfenster-Aufblähung

In einem traditionellen Ansatz verbraucht jede Tool-Definition Token, bevor das Gespräch überhaupt beginnt. Die Exposition von über 50 Tools kann leicht 55K–100K+ Token in Anspruch nehmen. Anthropic fand heraus, dass Tool-Definitionen bis zu 134K Token vor der Optimierung verbrauchen konnten. Mit Code Mode werden nur 2 Tool-Definitionen geladen (~1K Token). Der Agent sucht bei Bedarf nach der benötigten Dokumentation. Anthropics Tool-Such-Tool bewahrte 95 % des Kontextfensters, was die Overhead von 77K auf 8,7K Token reduzierte.

Reduziert Latenz durch programmatische Orchestrierung

Traditionelles Tool-Aufrufen erfordert eine komplette Modell-Inferenz-Rundreise für jede einzelne Operation. Wenn eine Aufgabe 20 API-Aufrufe erfordert, sind das 20 Rundreisen. Im Code Mode schreibt der Agent ein Skript, das alle Aufrufe ausführt und nur das Endergebnis zurückgibt. Anthropic beobachtete eine 37% Reduzierung der Token und verbesserte Genauigkeit (Wissensabruf verbesserte sich von 25,6% auf 28,5%) mit diesem programmatischen Ansatz.
Last modified on May 14, 2026