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. 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. Plugin ini mengikuti spesifikasi Agent Plugins 1.0.0. Client dengan dukungan native akan memuatnya secara langsung; client lainnya menggunakan manifest kompatibilitas yang dibuat secara otomatis. Yang Anda dapatkan:

Dodo Payments API MCP server — akses langsung ke pembayaran, subscription, customer, produk, refund, lisensi, dan penggunaan. Melakukan autentikasi melalui browser OAuth (tidak memerlukan key lokal).
Dodo Knowledge MCP server — pencarian semantik di seluruh dokumentasi Dodo Payments. Tidak memerlukan kredensial.
Tujuh belas agent skill — lembar ringkasan yang dimuat agent sesuai kebutuhan untuk checkout, subscription, webhook, billing berbasis penggunaan dan kredit, license key, katalog produk, diskon, harga terlokalisasi, checkout mobile, refund dan sengketa, manajemen customer, adapter framework, BillingSDK, Better Auth, pengujian dan peluncuran, serta praktik terbaik.

Instal Plugin

Pilih coding agent Anda di bawah. Setiap instalasi menambahkan kedua server MCP. Semua agent selain 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 ada key yang diperlukan saat instalasi. Saat pertama kali agent Anda memanggil tool Dodo, Anda akan diminta untuk masuk.

Dodo Agent Plugin on GitHub

Source code, opsi konfigurasi, dan instruksi pengembangan lokal

Codex CLI

Daftarkan marketplace, lalu instal dari Codex TUI.

codex plugin marketplace add dodopayments/dodo-agent-plugin

Install from the Codex TUI

Buka Codex dan jalankan /plugins:

codex

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

Kedua server MCP dan ketujuh belas skill akan 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 subperintah 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 server MCP 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 dibuat secara otomatis tetap tersedia untuk build lama.Jika Anda menginstal versi sebelum 0.5.0, hapus direktori tersebut lalu clone ulang — skill kini dikirim sebagai file sungguhan, bukan symlink.

OpenCode

Instal paket plugin di project Anda, lalu tambahkan plugin tersebut 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 server MCP akan terdaftar secara otomatis. Skill memerlukan entri skills.paths tambahan karena OpenCode tidak memindai paket yang terinstal untuk mencari skill.Path relatif diselesaikan berdasarkan direktori project, sehingga paket harus ada di node_modules project tersebut. Path absolut juga dapat digunakan dan menghindari persyaratan 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-nya adalah path, sedangkan value mengaktifkannya. Path absolut dan ~/ sama-sama dapat digunakan; path relatif diselesaikan berdasarkan setiap folder workspace. Pengaturan ini dibaca secara live, sehingga window yang sedang berjalan akan menggunakannya tanpa perlu dimulai ulang.chat.pluginLocations ditandai sebagai eksperimental dan merupakan pengaturan terbatas, 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.

Clone the repository

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

Open the Powers panel

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

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 server MCP dimuat dari mcp.json. Kiro mengelola server MCP 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 server MCP yang tersedia. dodo-knowledge mencakup sebagian besar hal yang disediakan skill dan selalu 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 server MCP dan tujuh belas skill.

Server MCP

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

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

Agent Skill

Skill	Deskripsi
`dodo-best-practices`	Penyiapan SDK, environment, API key, dan arsitektur checkout-to-webhook kanonis
`framework-adapters`	Handler route `@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 production
`checkout-integration`	Checkout Sessions, payment link, serta checkout overlay atau inline
`subscription-integration`	Siklus hidup subscription, trial, perubahan plan, proration, dan biaya sesuai permintaan
`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 kredit, saldo, ledger, rollover, overage, dan pengurangan berbasis meter
`usage-based-billing`	Meter, ingestion event, agregasi, dan harga per unit
`license-keys`	Aktivasi dan validasi license key serta manajemen instance
`product-catalog-management`	Produk, harga, add-on, koleksi, gambar, dan distribusi produk digital
`discounts-and-promotions`	Kode diskon, aturan eligibility, stacking, dan batas siklus subscription
`localized-pricing`	Harga terlokalisasi, Adaptive Currency, dan purchasing power parity
`customer-management`	Customer, portal mandiri, metode pembayaran tersimpan, dan wallet
`refunds-and-disputes`	Menerbitkan refund, menangani sengketa dan chargeback, serta mencocokkan akses
`billing-sdk`	Komponen React BillingSDK 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 ketika mendeteksi tugas yang relevan. Lihat Agent Skills untuk daftar lengkap dan instalasi individual.

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 mengikuti spesifikasi Standard Webhooks.

Dukungan Client

Agent dengan Instalasi Plugin

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

Agent	Instalasi	Skill	Server MCP
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 tujuh belas skill-nya dimuat. Gemini CLI tidak memiliki primitive agent-skill, sehingga skill memang tidak tersedia.

Client Lain yang Kompatibel dengan MCP

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

Agent	Server MCP	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 terinstal, coding agent Anda dapat:

Membuat checkout session dan payment link — Pembayaran satu kali dan subscription
Menyiapkan billing subscription dan berbasis penggunaan secara menyeluruh — Subscription, billing berbasis penggunaan, billing berbasis kredit
Membuat handler yang sesuai dengan Standard Webhooks dengan verifikasi signature — Webhook
Memasang handler route di framework Anda menggunakan adapter resmi — Adapter framework
Menghubungkan komponen React BillingSDK untuk tabel harga dan manajemen subscription — BillingSDK
Membuat alur license key untuk produk digital — License key
Mengimplementasikan billing berbasis kredit dengan entitlement, saldo, rollover, dan overage — Kredit
Membangun dan mengelola katalog produk dengan add-on dan koleksi — Produk, Add-on, Koleksi 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, sengketa, dan layanan mandiri customer — Refund, Sengketa, Portal customer
Menguji integrasi dan melakukan peluncuran dengan aman — Test mode vs live mode

Keamanan dan Praktik Terbaik

Jangan pernah 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 live. Lihat Test Mode vs Live Mode.
OAuth adalah default. Agent Plugin melakukan autentikasi melalui browser OAuth (tanpa secret lokal). Gunakan mode API key hanya jika diperlukan.
Tinjau kode yang dibuat agent. Selalu pastikan handler webhook menyertakan verifikasi signature sesuai spesifikasi Standard Webhooks.

Konfigurasi dengan API Key

Secara default, Agent Plugin menggunakan server MCP remote 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 — secret penandatanganan webhook Anda
dodo_environment — test_mode atau live_mode

Kemudian edit .mcp.json agar dodopayments-api mengarah 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 server remote 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 server MCP — semua client yang didukung, konfigurasi, dan tool yang tersedia

Agent Skills

Instalasi skill individual, referensi skill, dan instruksi penyiapan per agent

API Reference

Referensi OpenAPI lengkap untuk semua endpoint Dodo Payments

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Instal Plugin

Dodo Agent Plugin on GitHub

Yang Anda Dapatkan

Server MCP

Agent Skill

Coba Prompt Ini Terlebih Dahulu

Dukungan Client

Agent dengan Instalasi Plugin

Client Lain yang Kompatibel dengan MCP

Dokumentasi yang Dibuat untuk Agent

Yang Dapat Dilakukan Agent Anda

Keamanan dan Praktik Terbaik

Konfigurasi dengan API Key

Langkah Berikutnya

MCP Server

Agent Skills

API Reference

​Instal Plugin

Dodo Agent Plugin on GitHub

​Yang Anda Dapatkan

​Server MCP

​Agent Skill

​Coba Prompt Ini Terlebih Dahulu

​Dukungan Client

​Agent dengan Instalasi Plugin

​Client Lain yang Kompatibel dengan MCP

​Dokumentasi yang Dibuat untuk Agent

​Yang Dapat Dilakukan Agent Anda

​Keamanan dan Praktik Terbaik

​Konfigurasi dengan API Key

​Langkah Berikutnya

MCP Server

Agent Skills

API Reference

Instal Plugin

Yang Anda Dapatkan

Server MCP

Agent Skill

Coba Prompt Ini Terlebih Dahulu

Dukungan Client

Agent dengan Instalasi Plugin

Client Lain yang Kompatibel dengan MCP

Dokumentasi yang Dibuat untuk Agent

Yang Dapat Dilakukan Agent Anda

Keamanan dan Praktik Terbaik

Konfigurasi dengan API Key

Langkah Berikutnya