Mit KI-Coding-Agenten entwickeln

Installieren Sie das Dodo Agent Plugin, um Ihrem Coding-Agent zwei MCP-Server und siebzehn Skills zum Erstellen von Dodo Payments-Integrationen bereitzustellen. Beschreiben Sie nach der Installation, was Sie erstellen möchten, und Ihr Agent plant und schreibt die Integration. Das Plugin funktioniert mit Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro und OpenCode. Gemini CLI erhält nur die beiden MCP-Server.

Plugin installieren

Wählen Sie unten Ihren Coding-Agent aus. Jede Installation fügt beide MCP-Server hinzu. Alle Agents außer Gemini CLI fügen außerdem die siebzehn Skills hinzu. OpenCode benötigt eine zusätzliche Einstellung, um sie zu laden; diese wird im entsprechenden Abschnitt beschrieben.

Claude Code

Aus dem Marketplace installieren:

claude plugins marketplace add dodopayments/dodo-agent-plugin
claude plugins install dodopayments@dodopayments

Der API-MCP-Server verwendet standardmäßig Browser-OAuth – bei der Installation sind keine Schlüssel erforderlich. Wenn Ihr Agent erstmals ein Dodo-Tool aufruft, werden Sie aufgefordert, sich anzumelden.

Dodo Agent Plugin on GitHub

Quellcode, Konfigurationsoptionen und Anweisungen für die lokale Entwicklung

Codex CLI

Registrieren Sie den Marketplace und installieren Sie anschließend aus der Codex-TUI.

codex plugin marketplace add dodopayments/dodo-agent-plugin

Install from the Codex TUI

Öffnen Sie Codex und führen Sie /plugins aus:

codex

Geben Sie /plugins ein, wechseln Sie zum Dodo Payments-Marketplace, wählen Sie das dodopayments-Plugin aus und wählen Sie Install plugin.

Beide MCP-Server und alle siebzehn Skills werden automatisch registriert.Wenn das Plugin unter /plugins nicht angezeigt wird, aktualisieren Sie es:

codex plugin marketplace upgrade dodopayments

Um stattdessen aus Ihrer Shell und nicht aus der TUI zu installieren, führen Sie nach der Registrierung des Marketplaces codex plugin add dodopayments@dodopayments aus. Codex CLI verfügt über kein codex plugin install-Subcommand. Siehe die offizielle Codex-Plugin-Dokumentation.

Cursor

Klonen Sie das Repository in Cursors lokales Plugin-Verzeichnis:

git clone https://github.com/dodopayments/dodo-agent-plugin.git ~/.cursor/plugins/local/dodo-agent-plugin

Starten Sie Cursor neu. Das Plugin lädt Skills aus skills/ und MCP-Server aus .mcp.json.Aktuelle Cursor-Builds erkennen Agent Plugins 1.0.0 direkt und akzeptieren .claude-plugin/marketplace.json als Marketplace-Quelle. Das generierte .cursor-plugin/plugin.json bleibt für ältere Builds erhalten.Wenn Sie eine Version vor 0.5.0 installiert haben, löschen Sie das Verzeichnis und klonen Sie es erneut – Skills werden jetzt als echte Dateien und nicht als symbolische Links bereitgestellt.

OpenCode

Installieren Sie das Plugin-Paket in Ihrem Projekt und fügen Sie es sowie seinen Skills-Pfad zu opencode.json hinzu:

npm install --save-dev @dodopayments/opencode-plugin

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@dodopayments/opencode-plugin"],
  "skills": {
    "paths": ["node_modules/@dodopayments/opencode-plugin/skills"]
  }
}

Starten Sie OpenCode neu. Beide MCP-Server werden automatisch registriert. Für Skills ist der zusätzliche Eintrag skills.paths erforderlich, da OpenCode installierte Pakete nicht nach Skills durchsucht.Relative Pfade werden relativ zum Projektverzeichnis aufgelöst. Daher muss das Paket in node_modules dieses Projekts vorhanden sein. Ein absoluter Pfad funktioniert ebenfalls und macht die lokale Installation überflüssig.Überprüfen Sie, ob die Skills geladen wurden:

opencode run "List every skill available to you by name."

Sie sollten alle siebzehn sehen. Ein nicht vorhandener Skills-Pfad wird stillschweigend ignoriert. Überprüfen Sie daher das Ergebnis, statt es anzunehmen.

VS Code / GitHub Copilot

Klonen Sie das Repository und registrieren Sie es:

git clone https://github.com/dodopayments/dodo-agent-plugin.git ~/dodo-agent-plugin

Öffnen Sie die Chat-Ansicht, gehen Sie zu Plugins und fügen Sie den geklonten Ordner hinzu. Alternativ können Sie ihn in settings.json registrieren:

{
  "chat.pluginLocations": { "~/dodo-agent-plugin": true }
}

Der Schlüssel ist ein Pfad, der Wert aktiviert ihn. Absolute Pfade und ~/ funktionieren beide; relative Pfade werden relativ zu jedem Workspace-Ordner aufgelöst. Die Einstellung wird live gelesen, sodass ein laufendes Fenster sie ohne Neustart übernimmt.chat.pluginLocations ist als experimentell gekennzeichnet und eine eingeschränkte Einstellung, daher muss dem Workspace vertraut werden. Die Unterstützung für Agent-Plugins ist eine Preview-Funktion, die durch chat.plugins.enabled gesteuert wird und standardmäßig aktiviert ist.

Kiro

Kiro liest das Agent-Plugins-Manifest nativ.

Clone the repository

git clone https://github.com/dodopayments/dodo-agent-plugin.git

Open the Powers panel

Öffnen Sie in Kiro das Powers-Panel (das Ghosty-Symbol mit dem Blitz).

Import the folder

Wählen Sie Add Custom Power → Import power from a folder, wählen Sie das geklonte Verzeichnis aus (das Verzeichnis mit plugin.json) und klicken Sie auf Install.

Skills werden aus skills/ geladen, MCP-Server aus mcp.json. Kiro verwaltet MCP-Server intern – sie werden nicht in ~/.kiro/settings/mcp.json geschrieben. Kiro kann ein Power auch direkt über eine GitHub-URL installieren. Siehe die Kiro-Installationsdokumentation.

Gemini CLI (MCP only)

Gemini CLI verfügt über kein Agent-Skill-Primitiv, daher sind nur die beiden MCP-Server verfügbar. dodo-knowledge deckt einen großen Teil der von den Skills bereitgestellten Funktionen ab und bleibt automatisch aktuell.

git clone https://github.com/dodopayments/dodo-agent-plugin.git \
  ~/.gemini/extensions/dodopayments

Starten Sie Gemini CLI neu. gemini-extension.json im Stammverzeichnis des Repositorys ist das Manifest.

Verwenden Sie einen anderen Agent? Die Anleitungen zu MCP Server und Agent Skills decken Claude Desktop, Windsurf, Cline, Zed und jeden MCP-kompatiblen Client ab.

Was Sie erhalten

Nach der Installation hat Ihr Agent Zugriff auf zwei MCP-Server und siebzehn Skills.

MCP-Server

Server	Zweck	Auth
`dodopayments-api`	Live-API-Zugriff – Zahlungen, Abonnements, Kunden, Produkte, Erstattungen, Lizenzen, Nutzung	OAuth (Browser)
`dodo-knowledge`	Semantische Suche in der gesamten Dodo Payments-Dokumentation	Keine

Beide Server verwenden Streamable HTTP. Das kanonische mcp.json deklariert sie nativ, was spezifikationsnative Clients wie Codex CLI und Kiro verwenden. Das generierte Kompatibilitätsmanifest .mcp.json bindet sie über mcp-remote für Clients ein, die Streamable HTTP nicht direkt verwenden können.

Agent Skills

Skill	Beschreibung
`dodo-best-practices`	SDK-Einrichtung, Umgebungen, API-Schlüssel und die kanonische Checkout-bis-Webhook-Architektur
`framework-adapters`	Offizielle `@dodopayments/*`-Route-Handler für Next.js, Express, Hono, Astro, Remix, SvelteKit, Nuxt, Fastify, TanStack, Bun und Convex
`testing-and-go-live`	Testmodus, Testzahlungsmethoden, Webhook-Tests und die Checkliste für den Produktionsstart
`checkout-integration`	Checkout Sessions, Zahlungslinks sowie Overlay- oder Inline-Checkout
`subscription-integration`	Lebenszyklus von Abonnements, Testzeiträume, Planänderungen, anteilige Abrechnung und bedarfsgesteuerte Gebühren
`mobile-checkout`	In-App-Checkout für React Native, Flutter, iOS und Android
`webhook-integration`	Empfangen und Überprüfen von Webhooks mithilfe der Standard-Webhooks-Spezifikation
`credit-based-billing`	Credit-Entitlements, Salden, Ledger, Übertrag, Mehrverbrauch und meterbasierte Abbuchung
`usage-based-billing`	Meter, Event-Erfassung, Aggregation und Preise pro Einheit
`license-keys`	Aktivierung und Validierung von Lizenzschlüsseln sowie Instanzverwaltung
`product-catalog-management`	Produkte, Preise, Add-ons, Sammlungen, Bilder und die Bereitstellung digitaler Produkte
`discounts-and-promotions`	Rabattcodes, Berechtigungsregeln, Kombinationen und Limits für Abonnementzyklen
`localized-pricing`	Lokalisierte Preise, Adaptive Currency und Kaufkraftparität
`customer-management`	Kunden, das Self-Service-Portal, gespeicherte Zahlungsmethoden und Wallets
`refunds-and-disputes`	Ausstellen von Erstattungen, Bearbeiten von Streitfällen und Rückbuchungen sowie Abgleich des Zugriffs
`billing-sdk`	BillingSDK-React-Komponenten für Preistabellen und Billing-UIs
`better-auth-integration`	Das `@dodopayments/better-auth`-Plugin für Kundensynchronisierung, Checkout und Portalzugriff

Skills werden automatisch geladen – Ihr Agent wählt den passenden Skill, sobald er eine relevante Aufgabe erkennt. Eine vollständige Liste und individuelle Installationsanweisungen finden Sie unter Agent Skills.

Diesen Prompt zuerst ausprobieren

Sobald das Plugin aktiv ist, versuchen Sie Folgendes:

Set up Dodo Payments webhook handlers in my Next.js app for payment.succeeded and subscription.active events.

Ihr Agent lädt den Skill webhook-integration, verwendet den dodo-knowledge-MCP, um die neuesten Payload-Strukturen abzurufen, und erstellt einen Handler mit Signaturüberprüfung gemäß der Standard-Webhooks-Spezifikation.

Client-Unterstützung

Das Plugin folgt der Spezifikation Agent Plugins 1.0.0. Clients mit nativer Unterstützung laden es direkt; andere verwenden generierte Kompatibilitätsmanifeste.

Agents mit Plugin-Installation

Eine Installation bindet beide MCP-Server ein sowie die Skills bei jedem Client, der über ein Skill-Primitiv verfügt.

Agent	Installation	Skills	MCP-Server
Claude Code	Marketplace-Befehl	17	2
Codex CLI	Marketplace-Befehl	17	2
Cursor	Git-Klon	17	2
VS Code / GitHub Copilot	Git-Klon	17	2
Kiro	Git-Klon	17	2
OpenCode	npm	17	2
Gemini CLI	Git-Klon	0	2

OpenCode benötigt einen zusätzlichen Eintrag skills.paths, bevor seine siebzehn Skills geladen werden. Gemini CLI verfügt über kein Agent-Skill-Primitiv, daher sind Skills designbedingt nicht verfügbar.

Andere MCP-kompatible Clients

Diese verfügen über keine Agent-Plugin-Installation. Konfigurieren Sie die beiden MCP-Server manuell und fügen Sie Skills über die Skills CLI hinzu, sofern dies unterstützt wird.

Agent	MCP-Server	Skills
Claude Desktop	MCP-Server-Anleitung	nicht unterstützt
Windsurf	MCP-Server-Anleitung	Skills CLI
Cline / Zed / andere	MCP-Server-Anleitung	Skills CLI

Für Agents erstellte Dokumentation

Jede Dodo Payments-Dokumentationsseite ist in einem für die Verarbeitung durch KI optimierten Format verfügbar:

Vollständiger Dokumentationsindex: docs.dodopayments.com/llms.txt – vollständiger Dokumentationsindex für die Kontextaufnahme
Reines Markdown: Hängen Sie .md an eine beliebige Dokumentations-URL an, um die Markdown-Rohfassung zu erhalten (z. B. /api-reference/introduction.md)
Quell-Repository: github.com/dodopayments/dodo-docs – für die Offline-Indexierung klonen

Was Ihr Agent tun kann

Mit installiertem Plugin kann Ihr Coding-Agent Folgendes:

Checkout Sessions und Zahlungslinks erstellen – Einmalzahlungen und Abonnements
Abonnement- und nutzungsbasierte Abrechnung vollständig einrichten – Abonnements, Nutzungsbasierte Abrechnung, Credit-basierte Abrechnung
Standard-Webhooks-konforme Handler mit Signaturüberprüfung generieren – Webhooks
Routen-Handler mithilfe der offiziellen Adapter in Ihrem Framework einbinden – Framework-Adapter
BillingSDK-React-Komponenten für Preistabellen und Abonnementverwaltung einbinden – BillingSDK
Abläufe für Lizenzschlüssel digitaler Produkte erstellen – Lizenzschlüssel
Credit-basierte Abrechnung mit Entitlements, Salden, Übertrag und Mehrverbrauch implementieren – Credits
Ihren Produktkatalog mit Add-ons und Sammlungen erstellen und verwalten – Produkte, Add-ons, Produktsammlungen
Rabatte und lokalisierte Preise hinzufügen – Rabattcodes, Lokalisierte Preise, Adaptive Currency
In-App-Checkout für Mobilgeräte mit React Native, Flutter, iOS und Android bereitstellen – Mobile Integration
Erstattungen, Streitfälle und Self-Service durch Kunden bearbeiten – Erstattungen, Streitfälle, Customer Portal
Die Integration testen und sicher live gehen – Testmodus und Livemodus

Sicherheit und Best Practices

Committen Sie niemals Live-API-Schlüssel. Verwenden Sie während der Entwicklung den Testmodus.

Verwenden Sie zuerst den Testmodus. Erstellen und testen Sie Ihre Integration mit einem API-Schlüssel für den Testmodus, bevor Sie live gehen. Siehe Testmodus und Livemodus.
OAuth ist der Standard. Das Agent Plugin authentifiziert sich über Browser-OAuth (keine lokalen Secrets). Verwenden Sie den API-Key-Modus nur, wenn Sie ihn benötigen.
Überprüfen Sie vom Agent generierten Code. Stellen Sie immer sicher, dass Webhook-Handler eine Signaturüberprüfung gemäß der Standard-Webhooks-Spezifikation enthalten.

Mit einem API-Schlüssel konfigurieren

Standardmäßig verwendet das Agent Plugin den Remote-MCP-Server mit Browser-OAuth. Um stattdessen einen lokalen API-Schlüssel zu verwenden, beispielsweise in CI oder auf einem Headless-Server, wechseln Sie in den stdio-Modus.

Local API key mode — Claude Code

Öffnen Sie /plugins in Claude Code, wählen Sie Dodo Payments und anschließend Configure options. Füllen Sie Folgendes aus:

dodo_api_key – Ihr API-Schlüssel für den Testmodus oder Livemodus
dodo_webhook_key – Ihr Webhook-Signatur-Secret
dodo_environment – test_mode oder live_mode

Bearbeiten Sie anschließend .mcp.json, sodass dodopayments-api auf den lokalen stdio-Server verweist:

{
  "mcpServers": {
    "dodopayments-api": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "dodopayments-mcp@latest"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "${user_config.dodo_api_key}",
        "DODO_PAYMENTS_WEBHOOK_KEY": "${user_config.dodo_webhook_key}",
        "DODO_PAYMENTS_ENVIRONMENT": "${user_config.dodo_environment}"
      }
    }
  }
}

Führen Sie /reload-plugins aus, um die Änderungen anzuwenden.

Local API key mode — OpenCode

Deklarieren Sie dodopayments-api selbst in opencode.json – Ihr Eintrag hat Vorrang vor dem standardmäßigen Remote-Server des Plugins:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@dodopayments/opencode-plugin"],
  "mcp": {
    "dodopayments-api": {
      "type": "local",
      "command": ["npx", "-y", "dodopayments-mcp@latest"],
      "environment": {
        "DODO_PAYMENTS_API_KEY": "YOUR_TEST_MODE_API_KEY",
        "DODO_PAYMENTS_WEBHOOK_KEY": "whsec_...",
        "DODO_PAYMENTS_ENVIRONMENT": "test_mode"
      },
      "enabled": true
    }
  }
}

Starten Sie OpenCode neu, um die Änderung anzuwenden.

Nächste Schritte

MCP Server

Vollständige Referenz für beide MCP-Server – alle unterstützten Clients, Konfiguration und verfügbaren Tools

Agent Skills

Individuelle Skill-Installation, Skill-Referenz und Einrichtungsanweisungen für die einzelnen Agents

API Reference

Vollständige OpenAPI-Referenz für alle Dodo Payments-Endpunkte

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Plugin installieren

Dodo Agent Plugin on GitHub

Was Sie erhalten

MCP-Server

Agent Skills

Diesen Prompt zuerst ausprobieren

Client-Unterstützung

Agents mit Plugin-Installation

Andere MCP-kompatible Clients

Für Agents erstellte Dokumentation

Was Ihr Agent tun kann

Sicherheit und Best Practices

Mit einem API-Schlüssel konfigurieren

Nächste Schritte

MCP Server

Agent Skills

API Reference

​Plugin installieren

Dodo Agent Plugin on GitHub

​Was Sie erhalten

​MCP-Server

​Agent Skills

​Diesen Prompt zuerst ausprobieren

​Client-Unterstützung

​Agents mit Plugin-Installation

​Andere MCP-kompatible Clients

​Für Agents erstellte Dokumentation

​Was Ihr Agent tun kann

​Sicherheit und Best Practices

​Mit einem API-Schlüssel konfigurieren

​Nächste Schritte

MCP Server

Agent Skills

API Reference

Plugin installieren

Was Sie erhalten

MCP-Server

Agent Skills

Diesen Prompt zuerst ausprobieren

Client-Unterstützung

Agents mit Plugin-Installation

Andere MCP-kompatible Clients

Für Agents erstellte Dokumentation

Was Ihr Agent tun kann

Sicherheit und Best Practices

Mit einem API-Schlüssel konfigurieren

Nächste Schritte