Langsung ke konten utama

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.

Kemampuan Utama

  • Operasi Pembayaran: Buat, ambil, dan kelola pembayaran dan pengembalian dana
  • Manajemen Langganan: Tangani penagihan berulang, peningkatan, dan pembatalan
  • Administrasi Pelanggan: Kelola data pelanggan dan akses portal
  • Katalog Produk: Buat dan perbarui produk, harga, dan diskon
  • Manajemen Lisensi: Aktifkan, validasi, dan kelola lisensi perangkat lunak
  • Penagihan Berdasarkan Penggunaan: Lacak dan tagih untuk penggunaan terukur

Instalasi

Pilih metode instalasi yang paling sesuai dengan alur kerja Anda.

Remote MCP Server (Direkomendasikan)

Akses server MCP yang dihosting tanpa pengaturan atau instalasi lokal. Ini adalah cara tercepat untuk memulai.
1

Akses server jarak jauh

Navigasikan ke https://mcp.dodopayments.com di browser Anda.
2

Konfigurasi klien MCP Anda

Salin konfigurasi JSON yang disediakan untuk klien spesifik Anda. Untuk Cursor atau Claude Desktop, tambahkan ini ke pengaturan MCP Anda:
{
  "mcpServers": {
    "dodopayments_api": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}
3

Autentikasi 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
Jaga keamanan kunci API Anda. Gunakan kunci mode uji selama pengembangan.
4

Selesaikan pengaturan

Klik Login dan Setujui untuk mengotorisasi koneksi.
Setelah terhubung, asisten AI Anda dapat berinteraksi dengan Dodo Payments API atas nama Anda.

Paket NPM

Instal dan jalankan server MCP secara lokal menggunakan NPM.
# Set your API key
export DODO_PAYMENTS_API_KEY="dodo_test_..."

# Run the latest version
npx -y dodopayments-mcp@latest
Gunakan @latest untuk selalu menarik versi terbaru, atau pin ke versi tertentu seperti @1.0.0 untuk stabilitas.

Docker

Jalankan server MCP dalam lingkungan terkontainer untuk penyebaran yang konsisten.
# Pull the latest image
docker pull ghcr.io/dodopayments/mcp:latest

# Run the container
docker run -e DODO_PAYMENTS_API_KEY="dodo_test_..." \
  -p 3000:3000 \
  ghcr.io/dodopayments/mcp:latest
Gambar Docker tersedia di GitHub Container Registry.

Konfigurasi Klien

Konfigurasikan server Dodo Payments MCP di klien AI pilihan Anda.
Atur server Dodo Payments MCP di Cursor untuk mengaktifkan akses percakapan ke data pembayaran Anda.
1

Buka pengaturan Cursor

Navigasikan ke Pengaturan Cursor > Fitur > Model Context Protocol atau tekan Cmd/Ctrl + Shift + P dan cari “Pengaturan MCP”.
2

Edit konfigurasi

Klik Edit Config untuk membuka file mcp_config.json.
3

Tambahkan konfigurasi Dodo Payments

Pilih salah satu konfigurasi berikut:Remote Server (Direkomendasikan)
{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}
Local NPX
{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "dodopayments-mcp@latest"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "dodo_test_..."
      }
    }
  }
}
4

Simpan dan restart

Simpan file konfigurasi dan restart Cursor.
Verifikasi koneksi dengan menanyakan asisten AI tentang data Dodo Payments Anda.

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 operasi tulis.
# Only expose read operations (GET requests)
npx dodopayments-mcp --operation=read

# Only expose write operations (POST, PUT, DELETE)
npx dodopayments-mcp --operation=write
Gunakan --operation=read selama pengembangan untuk mencegah modifikasi yang tidak disengaja pada data Anda.

Filter berdasarkan sumber daya

Batasi alat ke sumber daya API tertentu.
# Only expose payment-related tools
npx dodopayments-mcp --resource=payments

# Expose multiple resources
npx dodopayments-mcp --resource=payments --resource=customers

Sertakan atau kecualikan alat tertentu

Sesuaikan alat individu mana yang tersedia.
# Include only specific tools
npx dodopayments-mcp --tool=create_payments --tool=list_payments

# Exclude specific tools
npx dodopayments-mcp --no-tool=delete_products

# List all available tools
npx dodopayments-mcp --list

Gabungkan filter

Terapkan beberapa filter secara bersamaan untuk kontrol yang tepat.
# Only payment and subscription read operations
npx dodopayments-mcp --operation=read --resource=payments --resource=subscriptions

Penggunaan Lanjutan

Integrasi programatik

Bangun server MCP kustom atau perluas yang sudah ada secara programatik.
import { server, endpoints, init } from "dodopayments-mcp/server";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

// Initialize with all default endpoints
init({ server, endpoints });

// Start the server
const transport = new StdioServerTransport();
await server.connect(transport);

Pengembangan alat kustom

Perluas server MCP dengan alat dan logika bisnis Anda sendiri.
import { server, init } from "dodopayments-mcp/server";
import createPayments from "dodopayments-mcp/tools/payments/create-payments";
import { zodToJsonSchema } from "zod-to-json-schema";
import { z } from "zod";

// Define a custom tool
const customTool = {
  tool: {
    name: 'calculate_payment_total',
    description: 'Calculate payment total with tax and fees',
    inputSchema: zodToJsonSchema(
      z.object({
        amount: z.number().describe('Base amount in cents'),
        tax_rate: z.number().describe('Tax rate as decimal'),
      })
    ),
  },
  handler: async (client, args) => {
    const total = args.amount * (1 + args.tax_rate);
    return {
      content: [{
        type: 'text',
        text: JSON.stringify({ total, currency: 'usd' }),
      }],
    };
  },
};

// Initialize with custom tools
init({ 
  server, 
  endpoints: [createPayments, customTool] 
});

Praktik Terbaik Keamanan

Lindungi kredensial API Anda dan jaga integrasi yang aman.
Jangan pernah mengkomit kredensial ke kontrol versiSimpan kunci API dalam variabel lingkungan atau sistem manajemen rahasia yang aman.
# Use environment variables
export DODO_PAYMENTS_API_KEY="dodo_test_..."

# Use a .env file (add to .gitignore)
echo "DODO_PAYMENTS_API_KEY=dodo_test_..." > .env
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.
Terapkan penyaringan alat di produksiBatasi operasi yang diekspos hanya pada apa yang dibutuhkan asisten AI Anda.
# Production: read-only access
npx dodopayments-mcp --operation=read

# Development: full access
npx dodopayments-mcp
Terapkan autentikasi untuk endpoint kustomValidasi permintaan dan tegakkan otorisasi di pengendali alat kustom Anda.Pantau penggunaan APILacak aktivitas server MCP melalui dasbor Dodo Payments Anda dan atur peringatan untuk pola yang tidak biasa.
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.

Pemecahan Masalah

Verifikasi kunci API AndaPastikan kunci API Anda diatur dengan benar dan memiliki izin yang diperlukan.
# Test your API key
curl -H "Authorization: Bearer dodo_test_..." \
  https://api.dodopayments.com/payments
Periksa koneksi jaringan AndaVerifikasi Anda dapat mencapai endpoint API Dodo Payments.Tinjau log klienAktifkan logging verbose di klien MCP Anda untuk mendiagnosis masalah koneksi.
Konfirmasi lingkungan kunci APIPastikan Anda menggunakan kunci uji dengan endpoint uji dan kunci langsung dengan endpoint produksi.Periksa izin kunciVerifikasi kunci API Anda memiliki izin untuk operasi yang Anda coba lakukan.Buat ulang kredensialJika masalah berlanjut, buat kunci API baru melalui dasbor Anda.
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 langsung dengan APIVerifikasi operasi berfungsi saat memanggil Dodo Payments API secara langsung melalui curl atau Postman.

Sumber Daya