Membangun dengan AI Coding Agents - Dodo Payments Documentation

Plugin Dodo Agent menghubungkan dua server MCP dan delapan keahlian integrasi ke dalam agen coding AI Anda dalam satu instalasi. Ini bekerja dengan Claude Code, Codex CLI, Cursor, dan OpenCode — dan server MCP serta keahlian CLI bekerja dengan klien yang kompatibel dengan MCP.

Tiga primitif, satu plugin. Agent Plugin mengemas semua yang Anda butuhkan:

Server MCP API — akses live ke pembayaran, langganan, pelanggan, produk, refund, lisensi, dan penggunaan. Mengautentikasi melalui browser OAuth (tanpa kunci lokal yang diperlukan).
Server MCP Pengetahuan — pencarian semantik di seluruh dokumentasi Dodo Payments. Tidak diperlukan kredensial.
Delapan keahlian agen — cheat sheets yang dimuat agen Anda sesuai permintaan untuk checkout, langganan, webhooks, penagihan berbasis penggunaan, penagihan berbasis kredit, kunci lisensi, BillingSDK, dan praktik terbaik.

Instalasi plugin

Pilih agen coding Anda di bawah ini. Instalasi akan menambahkan kedua server MCP dan semua delapan keahlian secara otomatis.

Claude Code

Instal dari marketplace:

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

Server MCP API menggunakan browser OAuth secara default — tidak diperlukan kunci saat waktu instalasi. Pertama kali agen Anda memanggil alat Dodo, Anda akan diminta untuk masuk.

Dodo Agent Plugin on GitHub

Kode sumber, opsi konfigurasi, dan petunjuk pengembangan lokal

Codex CLI

Codex menginstal plugin dalam dua langkah: mendaftarkan marketplace dari shell Anda, lalu instal plugin dari dalam Codex TUI.

codex plugin marketplace add dodopayments/dodo-agent-plugin

Install from the Codex TUI

Buka Codex dan jalankan perintah garis miring /plugins:

codex

Kemudian ketik /plugins, alihkan ke marketplace Dodo Payments, pilih plugin dodopayments, dan pilih Install plugin.

Server MCP dan delapan skills terdaftar secara otomatis setelah plugin terinstal.

Codex CLI tidak memiliki subcommand codex plugin install — pemasangan plugin selalu dilakukan melalui alur in-TUI /plugins. Lihat dokumentasi plugin Codex resmi.

Jika Anda sebelumnya sudah menambahkan marketplace dan plugin tidak muncul di bawah /plugins, refresh:

codex plugin marketplace upgrade dodopayments

Cursor

Instalasi manual — clone repo ke direktori plugin lokal Cursor:

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

Restart Cursor. Plugin memuat skills dari .claude/skills/ (melalui lapisan kompatibilitas Claude Code Cursor) dan server MCP dari .mcp.json.

Dukungan marketplace Cursor akan datang. Untuk saat ini, gunakan instalasi manual di atas.

OpenCode

OpenCode mendistribusikan melalui npm. Tambahkan plugin ke opencode.json Anda:

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

Restart OpenCode. Kedua server MCP (dodopayments-api, dodo-knowledge) terdaftar secara otomatis melalui hook konfigurasi plugin, dan delapan skill terdeteksi otomatis dari paket yang diinstal. Tidak diperlukan blok mcp manual.

Menggunakan agen yang berbeda? Panduan MCP Server dan Agent Skills mencakup Cursor, Claude Desktop, VS Code, Windsurf, Cline, Zed, dan klien yang kompatibel dengan MCP mana pun.

Apa yang Anda dapatkan

Setelah plugin terinstal, agen Anda memiliki akses ke dua server MCP dan delapan skills.

Server MCP

Server	Tujuan	Auth
`dodopayments-api`	Akses API langsung — pembayaran, langganan, pelanggan, produk, pengembalian dana, lisensi, penggunaan	OAuth (browser)
`dodo-knowledge`	Pencarian semantik di seluruh dokumentasi Dodo Payments	None

Kedua server terhubung melalui mcp-remote sehingga dapat berjalan di klien yang kompatibel dengan MCP.

Agent skills

Skill	Deskripsi
`best-practices`	Panduan lengkap integrasi Dodo Payments dengan praktik terbaik
`checkout-integration`	Membuat sesi checkout dan alur pembayaran
`subscription-integration`	Menerapkan alur penagihan langganan
`webhook-integration`	Menyiapkan dan menangani webhooks untuk peristiwa pembayaran
`usage-based-billing`	Menerapkan penagihan terukur dengan event dan meteran
`credit-based-billing`	Hak kredit, saldo, dan pengurangan kredit terukur
`license-keys`	Mengelola kunci lisensi untuk produk digital
`billing-sdk`	Menggunakan komponen BillingSDK React

Skills dimuat secara otomatis — agen Anda memilih yang tepat saat mendeteksi tugas yang relevan. Lihat dokumentasi 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.

Agen Anda akan memuat skill webhook-integration, menggunakan MCP dodo-knowledge untuk menarik bentuk payload terbaru, dan menulis handler dengan verifikasi tanda tangan sesuai spesifikasi Standar Webhooks.

Agen lain yang didukung

Plugin Agen mencakup Claude Code, Codex CLI, Cursor, dan OpenCode. Jika Anda menggunakan agen lain, hubungkan ke Dodo Payments melalui server MCP dan skills CLI:

Agen	Jalur tercepat	Juga mendukung
Claude Code	Plugin Agen (satu perintah)	Server MCP, skill individu
Codex CLI	Plugin Agen (satu perintah)	Server MCP
Cursor	Plugin Agen (git clone)	Konfigurasi server MCP, skills CLI
OpenCode	Plugin Agen (npm)	Konfigurasi server MCP, skills CLI
GitHub Copilot (VS Code)	Panduan Server MCP	Skills CLI
Claude Desktop	Panduan Server MCP	—
Windsurf	Panduan Server MCP	Skills CLI
Cline / Zed / lainnya	Panduan Server MCP	Skills CLI

Dokumentasi dibangun untuk agen

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

Indeks dokumen lengkap: docs.dodopayments.com/llms.txt — menyajikan indeks dokumentasi lengkap untuk konsumsi konteks.
Plain markdown: Tambahkan .md ke URL dokumentasi mana pun untuk mendapatkan versi markdown mentah (misalnya, /api-reference/introduction.md).
Repositori Sumber: github.com/dodopayments/dodo-docs — clone untuk pengindeksan offline.

Apa yang bisa dilakukan agen Anda

Dengan plugin terinstal, agen pemrograman Anda dapat:

Buat sesi checkout dan tautan pembayaran — Pembayaran sekali saja dan langganan
Menyiapkan penagihan berbasis langganan dan penggunaan end-to-end — Langganan, Penagihan berbasis penggunaan, Penagihan berbasis kredit
Hasilkan pengendali yang sesuai dengan Webhooks Standar dengan verifikasi tanda tangan — Webhooks
Hubungkan komponen React BillingSDK untuk tabel harga dan manajemen langganan — BillingSDK
Buat alur kunci lisensi untuk produk digital — Kunci lisensi
Implementasikan penagihan berbasis kredit dengan hak, saldo, pengguliran, dan kelebihan — Kredit

Keamanan dan praktik terbaik

Jangan pernah mengkomit kunci API produksi. Gunakan mode uji selama pengembangan. Plugin Agen menggunakan OAuth browser secara default — hanya beralih ke kunci API lokal jika diperlukan oleh alur kerja Anda.

Gunakan mode uji terlebih dahulu. Sandarkan integrasi Anda dengan kunci dodo_test_... sebelum masuk ke mode live. Lihat Mode Uji vs Mode Langsung.
OAuth adalah defaultnya. Plugin Agen mengautentikasi via OAuth browser (tanpa rahasia lokal). Hanya gunakan mode API-key jika Anda memerlukannya — lihat bagian Konfigurasi di bawah.
Tinjau kode yang dihasilkan oleh agen. Selalu verifikasi bahwa handler webhook menyertakan verifikasi tanda tangan sesuai dengan spesifikasi Standar Webhooks.

Konfigurasi dengan kunci API

Secara default, Plugin Agen menggunakan server MCP jarak jauh dengan OAuth browser — tidak memerlukan kredensial lokal. Jika alur kerja Anda memerlukan kunci API lokal (misalnya, lingkungan CI, server tanpa kepala), Anda dapat beralih ke mode stdio.

Local API key mode — Claude Code

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

dodo_api_key — kunci dodo_test_... atau dodo_live_... Anda
dodo_webhook_key — rahasia tanda tangan webhook 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 ke sesi Anda saat ini.

Local API key mode — OpenCode

Deklarasikan dodopayments-api sendiri di opencode.json — entri Anda lebih diterima daripada 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": "dodo_test_...",
        "DODO_PAYMENTS_WEBHOOK_KEY": "whsec_...",
        "DODO_PAYMENTS_ENVIRONMENT": "test_mode"
      },
      "enabled": true
    }
  }
}

Restart OpenCode untuk menerapkan.

Langkah selanjutnya

MCP Server

Referensi lengkap untuk kedua server MCP — semua klien yang didukung, konfigurasi, dan alat yang tersedia

Agent Skills

Instalasi skill individual, referensi skill, dan instruksi penyiapan per-agen

Sentra IDE Assistant

Asisten penagihan bertenaga AI untuk VS Code, Cursor, dan Windsurf — tanyakan, bangun, dan rencanakan dalam editor Anda

API Reference

Referensi OpenAPI lengkap untuk semua endpoint Dodo Payments

Documentation Index

​Instalasi plugin

Dodo Agent Plugin on GitHub

​Apa yang Anda dapatkan

​Server MCP

​Agent skills

​Coba prompt ini terlebih dahulu

​Agen lain yang didukung

​Dokumentasi dibangun untuk agen

​Apa yang bisa dilakukan agen Anda

​Keamanan dan praktik terbaik

​Konfigurasi dengan kunci API

​Langkah selanjutnya

MCP Server

Agent Skills

Sentra IDE Assistant

API Reference

Instalasi plugin

Apa yang Anda dapatkan

Server MCP

Agent skills

Coba prompt ini terlebih dahulu

Agen lain yang didukung

Dokumentasi dibangun untuk agen

Apa yang bisa dilakukan agen Anda

Keamanan dan praktik terbaik

Konfigurasi dengan kunci API

Langkah selanjutnya