Ikhtisar
Model Context Protocol (MCP) adalah standar terbuka yang memungkinkan aplikasi AI untuk terhubung dengan aman ke sumber data dan API eksternal. Dodo Payments MCP Server menyediakan akses terstruktur ke infrastruktur pembayaran Anda bagi asisten AI seperti Claude, Cursor, dan klien lain yang kompatibel dengan MCP. Server MCP Dodo Payments dibangun dengan Stainless dan menggunakan arsitektur Code Mode, yang memungkinkan agen AI untuk menulis dan mengeksekusi kode TypeScript terhadap SDK Dodo Payments dalam lingkungan sandbox yang terisolasi.Kemampuan Utama
- Operasi Pembayaran: Membuat, mengambil, dan mengelola pembayaran dan pengembalian dana
- Manajemen Langganan: Menangani penagihan berulang, peningkatan, dan pembatalan
- Administrasi Pelanggan: Mengelola data pelanggan dan akses portal
- Katalog Produk: Membuat dan memperbarui produk, harga, dan diskon
- Manajemen Lisensi: Mengaktifkan, memvalidasi, dan mengelola lisensi perangkat lunak
- Penagihan Berdasarkan Penggunaan: Melacak dan menagih penggunaan yang terukur
Cara Kerja Code Mode
Server MCP Dodo Payments menggunakan Code Mode, memberikan agen AI Anda dua alat yang kuat:- Alat Pencarian Dokumen: Mengajukan pertanyaan tentang dokumentasi API dan SDK Dodo Payments untuk memahami operasi dan parameter yang tersedia
- Alat Eksekusi Kode: Menulis kode TypeScript terhadap SDK yang dieksekusi dalam lingkungan sandbox yang aman tanpa akses web atau sistem file
Dodo Knowledge MCP
Selain Dodo Payments MCP Server (untuk mengeksekusi operasi API), kami menyediakan Dodo Knowledge MCP - server pencarian semantik yang memberikan asisten AI akses instan ke dokumentasi dan basis pengetahuan Dodo Payments.Dibangun dengan ContextMCP.ai: Dodo Knowledge MCP didukung oleh ContextMCP, memungkinkan pencarian semantik cepat di seluruh dokumentasi kami menggunakan embedding vektor.
Apa itu Dodo Knowledge MCP?
Dodo Knowledge MCP adalah server MCP jarak jauh yang menyediakan:- Pencarian Dokumentasi Semantik: Temukan dokumentasi yang relevan menggunakan kueri bahasa alami
- Jawaban Kontekstual: Asisten AI mendapatkan informasi yang akurat dan terkini tentang Dodo Payments
- Tanpa Pengaturan: Tidak diperlukan kunci API atau instalasi lokal - cukup sambungkan dan mulai melakukan kueri
Pengaturan Cepat
Sambungkan ke Dodo Knowledge MCP di klien AI Anda:- Cursor
- Claude Desktop
- Windsurf
- Claude Code
Tambahkan ke
~/.cursor/mcp.json:Memerlukan Node.js 18 atau lebih tinggi. Paket
mcp-remote menangani koneksi ke server MCP jarak jauh.Menggunakan Kedua Server MCP Bersama-sama
Untuk pengalaman pengembangan yang dibantu AI terbaik, kami merekomendasikan menggunakan kedua server MCP:| Server | Tujuan | Kasus Penggunaan |
|---|---|---|
| Dodo Knowledge MCP | Pencarian dokumentasi | ”Bagaimana cara menangani webhook?”, “Metode pembayaran apa yang didukung?” |
| Dodo Payments MCP | Operasi API | Membuat pembayaran, mengelola langganan, menangani pengembalian dana |
Memecahkan Masalah Knowledge MCP
Jika Anda mengalami masalah koneksi:- Bersihkan cache otentikasi MCP:
rm -rf ~/.mcp-auth - Mulai ulang aplikasi klien Anda
- Periksa log klien untuk pesan kesalahan
- Verifikasi versi Node.js: Memerlukan Node.js 18+
Knowledge MCP Server
Akses halaman konfigurasi Dodo Knowledge MCP
Instalasi
Pilih metode instalasi yang paling sesuai dengan alur kerja Anda.Server MCP Jarak Jauh (Direkomendasikan)
Akses server MCP yang dihosting tanpa pengaturan atau instalasi lokal. Ini adalah cara tercepat untuk memulai.Akses server jarak jauh
Navigasikan ke https://mcp.dodopayments.com di browser Anda.
Konfigurasi klien MCP Anda
Salin konfigurasi JSON yang disediakan untuk klien spesifik Anda. Untuk Cursor atau Claude Desktop, tambahkan ini ke pengaturan MCP Anda:
Otentikasi dan konfigurasi
Alur OAuth akan meminta Anda untuk:
- Masukkan kunci API Dodo Payments Anda
- Pilih lingkungan Anda (uji coba atau langsung)
- Pilih jenis klien MCP Anda
Paket NPM
Instal dan jalankan server MCP secara lokal menggunakan NPM.- NPX (Tanpa Instalasi)
- Konfigurasi Klien MCP
Docker
Jalankan server MCP dalam lingkungan terkontainer untuk penyebaran yang konsisten.Gambar Docker tersedia di GitHub Container Registry.
Konfigurasi Klien
Konfigurasikan server Dodo Payments MCP di klien AI pilihan Anda.- Cursor
- Claude Desktop
- Claude Code
- VS Code
- Cline (VS Code)
- Zed
- Klien Lain
Atur server Dodo Payments MCP di Cursor untuk memungkinkan akses percakapan ke data pembayaran Anda.Instalasi Satu KlikGunakan tombol di bawah ini untuk menginstal server MCP langsung di Cursor:[
](https://cursor.com/en-US/install-mcp?name=dodopayments-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRvZG9wYXltZW50cy1tY3AiXSwiZW52Ijp7IkRPRE9fUEFZTUVOVFNfQVBJX0tFWSI6IlNldCB5b3VyIERPRE9fUEFZTUVOVFNfQVBJX0tFWSBoZXJlLiIsIkRPRE9fUEFZTUVOVFNfV0VCSE9PS19LRVkiOiJTZXQgeW91ciBET0RPX1BBWU1FTlRTX1dFQkhPT0tfS0VZIGhlcmUuIn19)Setelah mengklik, atur variabel lingkungan Anda di
mcp.json melalui Pengaturan Cursor > Alat & MCP > Server MCP Baru.Konfigurasi ManualBuka pengaturan Cursor
Navigasikan ke Pengaturan Cursor > Fitur > Model Context Protocol atau tekan
Cmd/Ctrl + Shift + P dan cari “Pengaturan MCP”.Tambahkan konfigurasi Dodo Payments
Pilih salah satu konfigurasi berikut:Server Jarak Jauh (Direkomendasikan)Local NPX
Variabel Lingkungan
Konfigurasikan perilaku server MCP menggunakan variabel lingkungan.| Variabel | Deskripsi | Diperlukan |
|---|---|---|
DODO_PAYMENTS_API_KEY | Kunci API Pembayaran Dodo Anda | Ya |
DODO_PAYMENTS_WEBHOOK_KEY | Kunci penandatangan webhook Anda | Tidak |
DODO_PAYMENTS_ENVIRONMENT | Atur ke live_mode untuk produksi | Tidak |
Menjalankan Secara Jarak Jauh
Terapkan server MCP sebagai server HTTP jarak jauh untuk klien berbasis web atau alur kerja agentic.Konfigurasi Server Jarak Jauh
Setelah diterapkan, klien dapat terhubung menggunakan URL server:Header Otorisasi
Server jarak jauh menerima otentikasi melalui header berikut:| Header | Deskripsi |
|---|---|
Authorization | Autentikasi token Bearer |
x-dodo-payments-api-key | Header kunci API langsung |
Kemampuan Klien
Klien MCP yang berbeda memiliki tingkat dukungan yang bervariasi untuk spesifikasi MCP. Server dapat secara otomatis menyesuaikan skema alat untuk mengatasi keterbatasan ini.Preset Klien yang Tersedia
| Klien | Deskripsi |
|---|---|
infer | Klien deteksi otomatis (default) |
cursor | Editor Cursor |
claude | Claude AI web atau desktop |
claude-code | Claude Code CLI |
openai-agents | Platform agen OpenAI |
Konfigurasi Kemampuan Manual
Untuk klien yang tidak terdaftar di atas, konfigurasikan kemampuan secara manual:top-level-unions- Dukungan untuk tipe union tingkat atasvalid-json- Parsing argumen string JSON yang benarrefs- Dukungan untuk pointer $ref dalam skemaunions- Dukungan untuk tipe union (anyOf)formats- Dukungan untuk validasi formattool-name-length=N- Panjang nama alat maksimum
Penyaringan Alat
Kontrol operasi API mana yang diekspos ke asisten AI Anda untuk mengoptimalkan kinerja dan menjaga keamanan.Filter berdasarkan jenis operasi
Batasi akses ke operasi baca saja atau tulis.Filter berdasarkan sumber daya
Batasi alat ke sumber daya API tertentu.Sertakan atau kecualikan alat tertentu
Sesuaikan alat individu yang tersedia.Gabungkan filter
Terapkan beberapa filter secara bersamaan untuk kontrol yang tepat.Penyaringan Parameter Kuery URL (Server Jarak Jauh)
Saat menggunakan server jarak jauh, terapkan filter melalui parameter kuery URL:Mode Alat Dinamis
Untuk API besar, memuat semua alat sekaligus dapat membebani jendela konteks AI. Mode alat dinamis memberikan alternatif yang lebih efisien.list_api_endpoints- Menemukan metode yang tersedia dengan penyaringan opsionalget_api_endpoint_schema- Mendapatkan skema rinci untuk metode tertentuinvoke_api_endpoint- Menjalankan metode apa pun dengan parameter yang sesuai
Alat dinamis secara otomatis diaktifkan untuk API dengan lebih dari 50 metode. Ganti dengan
--tools=all untuk menyertakan semua alat.Penggunaan Lanjutan
Integrasi programatik
Bangun server MCP kustom atau perluas yang sudah ada secara programatik.Pengembangan alat kustom
Perluas server MCP dengan alat dan logika bisnis Anda sendiri.Praktik Terbaik Keamanan
Lindungi kredensial API Anda dan jaga integrasi tetap aman.Manajemen Kunci API
Manajemen Kunci API
Jangan pernah mengkomit kredensial ke kontrol versiSimpan kunci API dalam variabel lingkungan atau sistem manajemen rahasia yang aman.Putar kunci secara teraturBuat kunci API baru secara berkala dan cabut yang lama melalui dasbor Dodo Payments Anda.Gunakan kunci uji untuk pengembanganSelalu gunakan kunci API mode uji selama pengembangan untuk menghindari mempengaruhi data produksi.
Kontrol Akses
Kontrol Akses
Terapkan penyaringan alat di produksiBatasi operasi yang diekspos hanya pada apa yang dibutuhkan asisten AI Anda.Terapkan otentikasi untuk server jarak jauhSaat menerapkan secara jarak jauh, selalu memerlukan otentikasi melalui header
Authorization atau header x-dodo-payments-api-key.Pantau penggunaan APILacak aktivitas server MCP melalui dasbor Dodo Payments Anda dan atur peringatan untuk pola yang tidak biasa.Keamanan Jaringan
Keamanan Jaringan
Gunakan HTTPS untuk server jarak jauhSelalu terapkan server MCP jarak jauh di belakang endpoint HTTPS.Terapkan pembatasan lajuLindungi dari penyalahgunaan dengan menerapkan batasan laju di tingkat server MCP dan API.Batasi akses jaringanKonfigurasikan aturan firewall untuk membatasi klien mana yang dapat terhubung ke server MCP Anda.
Memecahkan Masalah
Masalah koneksi
Masalah koneksi
Verifikasi kunci API AndaPastikan kunci API Anda diatur dengan benar dan memiliki izin yang diperlukan.Periksa koneksi jaringan AndaVerifikasi Anda dapat mengakses endpoint API Dodo Payments.Tinjau log klienAktifkan logging verbose di klien MCP Anda untuk mendiagnosis masalah koneksi.
Kesalahan otentikasi
Kesalahan otentikasi
Konfirmasi lingkungan kunci APIPastikan Anda menggunakan kunci uji dengan endpoint uji dan kunci langsung dengan endpoint produksi.Periksa variabel lingkunganVerifikasi
DODO_PAYMENTS_ENVIRONMENT telah diatur dengan benar (live_mode untuk produksi).Buat ulang kredensialJika masalah berlanjut, buat kunci API baru melalui dasbor Anda.Kegagalan eksekusi alat
Kegagalan eksekusi alat
Validasi parameter inputPastikan asisten AI memberikan parameter yang diformat dengan benar untuk setiap alat.Tinjau pesan kesalahanPeriksa respons kesalahan dari API untuk panduan spesifik tentang apa yang salah.Uji dengan API secara langsungVerifikasi operasi berfungsi saat memanggil API Dodo Payments secara langsung melalui curl atau Postman.
Masalah kompatibilitas klien
Masalah kompatibilitas klien
Coba preset klien yang berbedaJika alat tidak berfungsi dengan benar, coba tentukan klien Anda secara eksplisit:Periksa dukungan kemampuanBeberapa klien tidak mendukung semua fitur skema JSON. Gunakan
--describe-capabilities untuk memahami apa yang didukung.