Membangun dengan AI Coding Agents

Instal Dodo Agent Plugin untuk memberi coding agent Anda dua server MCP dan tujuh belas skill untuk membangun integrasi Dodo Payments.

Instal Dodo Agent Plugin untuk memberi coding agent Anda dua server MCP dan tujuh belas skill untuk membangun integrasi Dodo Payments. Setelah menginstalnya, jelaskan apa yang ingin Anda bangun, lalu agent Anda akan merencanakan dan menulis integrasinya. Plugin ini bekerja dengan Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro, dan OpenCode. Gemini CLI hanya mendapatkan dua server MCP.

​

Instal Plugin

Pilih coding agent Anda di bawah. Setiap instalasi menambahkan kedua MCP server. Semua agent kecuali Gemini CLI juga menambahkan tujuh belas skill. OpenCode memerlukan satu pengaturan tambahan untuk memuatnya, yang dijelaskan di bagiannya.

Claude Code

Instal dari marketplace:

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

API MCP server menggunakan browser OAuth secara default — tidak memerlukan key saat instalasi. Saat pertama kali agent Anda memanggil tool Dodo, Anda akan diminta untuk masuk.

Dodo Agent Plugin on GitHub

Kode sumber, opsi konfigurasi, dan petunjuk pengembangan lokal

Codex CLI

Daftarkan marketplace, lalu instal dari Codex TUI.

1. Register the marketplace

   codex plugin marketplace add dodopayments/dodo-agent-plugin
   
2. Install from the Codex TUI

   Buka Codex dan jalankan /plugins:

   codex
   

   Ketik /plugins, pilih marketplace Dodo Payments, pilih plugin dodopayments, lalu pilih Install plugin.

Kedua MCP server dan ketujuh belas skill terdaftar secara otomatis.

Jika plugin tidak muncul di bawah /plugins, segarkan:

codex plugin marketplace upgrade dodopayments

Untuk menginstal dari shell, bukan TUI, jalankan codex plugin add dodopayments@dodopayments setelah mendaftarkan marketplace. Codex CLI tidak memiliki subcommand codex plugin install. Lihat dokumentasi plugin Codex resmi.

Cursor

Clone repo ke direktori plugin lokal Cursor:

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

Mulai ulang Cursor. Plugin memuat skill dari skills/ dan MCP server dari .mcp.json.

Build Cursor terbaru mengenali Agent Plugins 1.0.0 secara langsung dan menerima .claude-plugin/marketplace.json sebagai sumber marketplace. .cursor-plugin/plugin.json yang dihasilkan dipertahankan untuk build yang lebih lama.

Jika Anda menginstal versi sebelum 0.5.0, hapus direktori tersebut lalu clone ulang — skill kini dikirim sebagai file nyata, bukan symlink.

OpenCode

Instal paket plugin di project Anda, lalu tambahkan plugin dan path skill-nya ke opencode.json:

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"]
  }
}

Mulai ulang OpenCode. Kedua MCP server terdaftar secara otomatis. Skill memerlukan entri skills.paths tambahan karena OpenCode tidak memindai paket yang terinstal untuk mencari skill.

Path relatif diselesaikan terhadap direktori project, jadi paket harus berada di node_modules project tersebut. Path absolut juga dapat digunakan dan menghindari kebutuhan instalasi lokal.

Verifikasi skill yang dimuat:

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

Anda seharusnya melihat ketujuh belas skill. Path skill yang tidak ada akan diabaikan secara diam-diam, jadi lakukan verifikasi dan jangan hanya berasumsi.

VS Code / GitHub Copilot

Clone repo dan daftarkan:

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

Buka tampilan Chat, buka Plugins, lalu tambahkan folder yang telah di-clone. Atau daftarkan di settings.json:

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

Key adalah path, sedangkan value mengaktifkannya. Path absolut dan ~/ sama-sama dapat digunakan; path relatif diselesaikan terhadap setiap folder workspace. Pengaturan dibaca secara live, sehingga window yang sedang berjalan akan mengambilnya tanpa perlu dimulai ulang.

chat.pluginLocations ditandai sebagai eksperimental dan merupakan restricted setting, sehingga workspace harus dipercaya. Dukungan agent-plugin adalah fitur pratinjau yang diatur oleh chat.plugins.enabled, yang aktif secara default.

Kiro

Kiro membaca manifest Agent Plugins secara native.

1. Clone the repository

   git clone https://github.com/dodopayments/dodo-agent-plugin.git
   
2. Open the Powers panel

   Di Kiro, buka panel Powers (ikon Ghosty dengan petir).

3. Import the folder

   Pilih Add Custom Power → Import power from a folder, pilih direktori yang telah di-clone (yang berisi plugin.json), lalu klik Install.

Skill dimuat dari skills/, sedangkan MCP server dimuat dari mcp.json. Kiro mengelola MCP server secara internal — server tersebut tidak ditulis ke ~/.kiro/settings/mcp.json. Kiro juga dapat menginstal Power langsung dari URL GitHub; lihat dokumentasi instalasi Kiro.

Gemini CLI (MCP only)

Gemini CLI tidak memiliki primitive agent-skill, sehingga hanya dua MCP server yang tersedia. dodo-knowledge mencakup sebagian besar fungsi yang disediakan skill dan tetap diperbarui secara otomatis.

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

Mulai ulang Gemini CLI. gemini-extension.json di root repo adalah manifest.

Menggunakan agent yang berbeda? Panduan MCP Server dan Agent Skills mencakup Claude Desktop, Windsurf, Cline, Zed, dan client apa pun yang kompatibel dengan MCP.

​

Yang Anda Dapatkan

Setelah terinstal, agent Anda memiliki akses ke dua MCP server dan tujuh belas skill.

​

MCP Server

Server	Tujuan	Auth
dodopayments-api	Akses API live — pembayaran, subscription, customer, produk, refund, lisensi, penggunaan	OAuth (browser)
dodo-knowledge	Pencarian semantik di seluruh dokumentasi Dodo Payments	None

Kedua server menggunakan Streamable HTTP. mcp.json kanonis mendeklarasikannya secara native, yang digunakan oleh client spec-native seperti Codex CLI dan Kiro. Manifest kompatibilitas yang dihasilkan, .mcp.json, menghubungkannya melalui mcp-remote untuk client yang tidak dapat terhubung langsung ke Streamable HTTP.

​

Agent Skills

Skill	Deskripsi
dodo-best-practices	Penyiapan SDK, environment, API key, dan arsitektur checkout-to-webhook kanonis
framework-adapters	Route handler @dodopayments/* resmi untuk Next.js, Express, Hono, Astro, Remix, SvelteKit, Nuxt, Fastify, TanStack, Bun, dan Convex
testing-and-go-live	Test mode, metode pembayaran pengujian, pengujian webhook, dan checklist peluncuran produksi
checkout-integration	Checkout Session, payment link, dan checkout overlay atau inline
subscription-integration	Siklus hidup subscription, trial, perubahan plan, proration, dan biaya on-demand
mobile-checkout	Checkout dalam aplikasi untuk React Native, Flutter, iOS, dan Android
webhook-integration	Menerima dan memverifikasi webhook menggunakan spesifikasi Standard Webhooks
credit-based-billing	Entitlement credit, saldo, ledger, rollover, overage, dan pengurangan berbasis meter
usage-based-billing	Meter, ingestion event, agregasi, dan penetapan harga per unit
license-keys	Aktivasi dan validasi license key, serta pengelolaan instance
product-catalog-management	Produk, harga, add-on, collection, gambar, dan pengiriman produk digital
discounts-and-promotions	Kode diskon, aturan kelayakan, stacking, dan batas siklus subscription
localized-pricing	Harga terlokalisasi, Adaptive Currency, dan paritas daya beli
customer-management	Customer, portal mandiri, metode pembayaran tersimpan, dan wallet
refunds-and-disputes	Menerbitkan refund, menangani dispute dan chargeback, serta merekonsiliasi akses
billing-sdk	Komponen BillingSDK React untuk tabel harga dan UI billing
better-auth-integration	Plugin @dodopayments/better-auth untuk sinkronisasi customer, checkout, dan akses portal

Skill dimuat secara otomatis — agent Anda memilih skill yang tepat saat mendeteksi task yang relevan. Lihat Agent Skills untuk daftar lengkap dan instalasi masing-masing skill.

​

Coba Prompt Ini Terlebih Dahulu

Setelah plugin aktif, coba:

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

Agent Anda akan memuat skill webhook-integration, menggunakan MCP dodo-knowledge untuk mengambil bentuk payload terbaru, lalu menulis handler dengan verifikasi signature sesuai spesifikasi Standard Webhooks.

​

Dukungan Client

Plugin mengikuti spesifikasi Agent Plugins 1.0.0. Client dengan dukungan native memuatnya secara langsung; client lain menggunakan manifest kompatibilitas yang dihasilkan.

​

Agent dengan Instalasi Plugin

Satu instalasi menghubungkan kedua MCP server, serta skill pada setiap client yang memiliki primitive skill.

Agent	Instalasi	Skill	MCP Server
Claude Code	perintah marketplace	17	2
Codex CLI	perintah marketplace	17	2
Cursor	git clone	17	2
VS Code / GitHub Copilot	git clone	17	2
Kiro	git clone	17	2
OpenCode	npm	17	2
Gemini CLI	git clone	0	2

OpenCode memerlukan satu entri skills.paths tambahan sebelum ketujuh belas skill-nya dimuat. Gemini CLI tidak memiliki primitive agent-skill, sehingga skill tidak tersedia secara desain.

​

Client Lain yang Kompatibel dengan MCP

Client ini tidak memiliki instalasi Agent Plugin. Konfigurasikan kedua MCP server secara manual, lalu tambahkan skill melalui Skills CLI jika didukung.

Agent	MCP Server	Skill
Claude Desktop	Panduan MCP Server	tidak didukung
Windsurf	Panduan MCP Server	Skills CLI
Cline / Zed / lainnya	Panduan MCP Server	Skills CLI

​

Dokumentasi yang Dibuat untuk Agent

Setiap halaman dokumentasi Dodo Payments tersedia dalam format yang dioptimalkan untuk konsumsi AI:

• Indeks dokumentasi lengkap: docs.dodopayments.com/llms.txt — indeks dokumentasi lengkap untuk ingestion konteks
• Markdown biasa: Tambahkan .md ke URL dokumentasi apa pun untuk mendapatkan versi markdown mentah (misalnya, /api-reference/introduction.md)
• Repository sumber: github.com/dodopayments/dodo-docs — clone untuk indexing offline

​

Yang Dapat Dilakukan Agent Anda

Dengan plugin yang terinstal, coding agent Anda dapat:

• Membuat checkout session dan payment link — Pembayaran satu kali dan subscription
• Menyiapkan billing subscription dan berbasis penggunaan secara end-to-end — Subscription, Billing berbasis penggunaan, Billing berbasis credit
• Membuat handler yang sesuai dengan Standard Webhooks dengan verifikasi signature — Webhook
• Memasang route handler di framework Anda menggunakan adapter resmi — Adapter framework
• Menghubungkan komponen BillingSDK React untuk tabel harga dan pengelolaan subscription — BillingSDK
• Membuat alur license key untuk produk digital — License key
• Mengimplementasikan billing berbasis credit dengan entitlement, saldo, rollover, dan overage — Credit
• Membangun dan mengelola katalog produk dengan add-on dan collection — Produk, Add-on, Collection produk
• Menambahkan diskon dan harga terlokalisasi — Kode diskon, Harga terlokalisasi, Adaptive Currency
• Menyediakan checkout dalam aplikasi mobile untuk React Native, Flutter, iOS, dan Android — Integrasi mobile
• Menangani refund, dispute, dan layanan mandiri customer — Refund, Dispute, Customer portal
• Menguji integrasi dan meluncurkannya dengan aman — Test mode vs live mode

​

Keamanan dan Praktik Terbaik

Jangan pernah melakukan commit API key live. Gunakan test mode selama pengembangan.

• Gunakan test mode terlebih dahulu. Bangun dan uji integrasi Anda dengan API key test mode sebelum beralih ke live mode. Lihat Test Mode vs Live Mode.
• OAuth adalah default. Agent Plugin melakukan autentikasi melalui browser OAuth (tanpa secret lokal). Gunakan API-key mode hanya jika diperlukan.
• Tinjau kode yang dibuat agent. Selalu verifikasi bahwa handler webhook menyertakan verifikasi signature sesuai spesifikasi Standard Webhooks.

​

Konfigurasi dengan API Key

Secara default, Agent Plugin menggunakan remote MCP server dengan browser OAuth. Untuk menggunakan API key lokal, misalnya di CI atau server headless, beralihlah ke mode stdio.

Local API key mode — Claude Code

Buka /plugins di Claude Code, pilih Dodo Payments, lalu pilih Configure options. Isi:

• dodo_api_key — API key test mode atau live mode Anda
• dodo_webhook_key — webhook signing secret Anda
• dodo_environment — test_mode atau live_mode

Kemudian edit .mcp.json untuk mengarahkan dodopayments-api ke server stdio lokal:

{
  "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}"
      }
    }
  }
}

Jalankan /reload-plugins untuk menerapkan perubahan.

Local API key mode — OpenCode

Deklarasikan dodopayments-api sendiri di opencode.json — entri Anda akan menggantikan remote server default plugin:

{
  "$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
    }
  }
}

Mulai ulang OpenCode untuk menerapkan perubahan.

​

Langkah Berikutnya

MCP Server

Referensi lengkap untuk kedua MCP server — semua client yang didukung, konfigurasi, dan tool yang tersedia

Agent Skills

Instalasi skill individual, referensi skill, dan petunjuk penyiapan untuk setiap agent

API Reference

Referensi OpenAPI lengkap untuk semua endpoint Dodo Payments