Zum Hauptinhalt springen

Ü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.

Hauptfunktionen

  • Zahlungsoperationen: Erstellen, Abrufen und Verwalten von Zahlungen und Rückerstattungen
  • Abonnementverwaltung: Verwaltung von wiederkehrenden Abrechnungen, Upgrades und Stornierungen
  • Kundenverwaltung: Verwaltung von Kundendaten und Portalzugriff
  • Produktkatalog: Erstellen und Aktualisieren von Produkten, Preisen und Rabatten
  • Lizenzverwaltung: Aktivieren, Validieren und Verwalten von Softwarelizenzen
  • Nutzungsbasierte Abrechnung: Verfolgen und Abrechnen von gemessener Nutzung

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.
1

Zugriff auf den Remote-Server

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

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

Authentifizieren und konfigurieren

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 während der Entwicklung Testmodus-Schlüssel.
4

Einrichtung abschließen

Klicken Sie auf Anmelden und Genehmigen, um die Verbindung zu autorisieren.
Sobald Sie verbunden sind, kann Ihr KI-Assistent im Auftrag von Ihnen mit der Dodo Payments API interagieren.

NPM-Paket

Installieren und führen Sie den MCP-Server lokal mit NPM aus.
# Set your API key
export DODO_PAYMENTS_API_KEY="dodo_test_..."

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

Docker

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

# Run the container
docker run -e DODO_PAYMENTS_API_KEY="dodo_test_..." \
  -p 3000:3000 \
  ghcr.io/dodopayments/mcp:latest
Docker-Images sind auf 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 konversationellen Zugriff auf Ihre Zahlungsdaten zu ermöglichen.
1

Öffnen Sie die Cursor-Einstellungen

Navigieren Sie zu Cursor-Einstellungen > Funktionen > Model Context Protocol oder drücken Sie Cmd/Ctrl + Shift + P und suchen Sie nach “MCP-Einstellungen”.
2

Konfiguration bearbeiten

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

Dodo Payments-Konfiguration hinzufügen

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

Speichern und neu starten

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.

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 Lese- oder Schreiboperationen einschränken.
# Only expose read operations (GET requests)
npx dodopayments-mcp --operation=read

# Only expose write operations (POST, PUT, DELETE)
npx dodopayments-mcp --operation=write
Verwenden Sie --operation=read während der Entwicklung, um versehentliche Änderungen an Ihren Daten zu verhindern.

Nach Ressource filtern

Begrenzen Sie Tools auf spezifische API-Ressourcen.
# Only expose payment-related tools
npx dodopayments-mcp --resource=payments

# Expose multiple resources
npx dodopayments-mcp --resource=payments --resource=customers

Bestimmte Tools ein- oder ausschließen

Feinabstimmung, welche einzelnen Tools verfügbar sind.
# Include only specific tools
npx dodopayments-mcp --tool=create_payments --tool=list_payments

# Exclude specific tools
npx dodopayments-mcp --no-tool=delete_products

# List all available tools
npx dodopayments-mcp --list

Filter kombinieren

Wenden Sie mehrere Filter gleichzeitig für präzise Kontrolle an.
# Only payment and subscription read operations
npx dodopayments-mcp --operation=read --resource=payments --resource=subscriptions

Erweiterte Nutzung

Programmgesteuerte Integration

Erstellen Sie benutzerdefinierte MCP-Server oder erweitern Sie den vorhandenen programmgesteuert.
import { server, endpoints, init } from "dodopayments-mcp/server";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

// Initialize with all default endpoints
init({ server, endpoints });

// Start the server
const transport = new StdioServerTransport();
await server.connect(transport);

Entwicklung benutzerdefinierter Tools

Erweitern Sie den MCP-Server mit Ihren eigenen Tools und Geschäftslogik.
import { server, init } from "dodopayments-mcp/server";
import createPayments from "dodopayments-mcp/tools/payments/create-payments";
import { zodToJsonSchema } from "zod-to-json-schema";
import { z } from "zod";

// Define a custom tool
const customTool = {
  tool: {
    name: 'calculate_payment_total',
    description: 'Calculate payment total with tax and fees',
    inputSchema: zodToJsonSchema(
      z.object({
        amount: z.number().describe('Base amount in cents'),
        tax_rate: z.number().describe('Tax rate as decimal'),
      })
    ),
  },
  handler: async (client, args) => {
    const total = args.amount * (1 + args.tax_rate);
    return {
      content: [{
        type: 'text',
        text: JSON.stringify({ total, currency: 'usd' }),
      }],
    };
  },
};

// Initialize with custom tools
init({ 
  server, 
  endpoints: [createPayments, customTool] 
});

Sicherheitsbest Practices

Schützen Sie Ihre API-Anmeldeinformationen und gewährleisten Sie sichere Integrationen.
Geben Sie niemals Anmeldeinformationen in die Versionskontrolle einSpeichern Sie API-Schlüssel in Umgebungsvariablen oder sicheren Geheimnisverwaltungssystemen.
# 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
Schlüssel regelmäßig rotierenGenerieren 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.
Wenden Sie Tool-Filterung in der Produktion anBegrenzen Sie die exponierten Operationen auf das, was Ihr KI-Assistent benötigt.
# Production: read-only access
npx dodopayments-mcp --operation=read

# Development: full access
npx dodopayments-mcp
Implementieren Sie Authentifizierung für benutzerdefinierte EndpunkteValidieren Sie Anfragen und erzwingen Sie die Autorisierung in Ihren benutzerdefinierten Tool-Handlern.Ü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.
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.Netzwerkzugang einschränkenKonfigurieren Sie Firewall-Regeln, um zu begrenzen, welche Clients sich mit Ihrem MCP-Server verbinden können.

Fehlersuche

Überprüfen Sie Ihren API-SchlüsselStellen Sie sicher, dass Ihr API-Schlüssel korrekt gesetzt ist und die erforderlichen Berechtigungen hat.
# Test your API key
curl -H "Authorization: Bearer dodo_test_..." \
  https://api.dodopayments.com/payments
Ü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ührliche Protokollierung in Ihrem MCP-Client, um Verbindungsprobleme zu diagnostizieren.
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 SchlüsselberechtigungenStellen Sie sicher, dass Ihr API-Schlüssel Berechtigungen für die Operationen hat, die Sie versuchen.Generieren Sie Anmeldeinformationen neuWenn Probleme weiterhin bestehen, generieren Sie einen neuen API-Schlüssel über Ihr Dashboard.
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.

Ressourcen