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. 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:
  1. Alat Pencarian Dokumen: Mengajukan pertanyaan tentang dokumentasi API dan SDK Dodo Payments untuk memahami operasi dan parameter yang tersedia
  2. Alat Eksekusi Kode: Menulis kode TypeScript terhadap SDK yang dieksekusi dalam lingkungan sandbox yang aman tanpa akses web atau sistem file
Arsitektur ini memungkinkan agen AI untuk melakukan operasi pembayaran yang kompleks dan multi-langkah secara deterministik dan berulang.
Dengan menggunakan Code Mode, agen dapat menghubungkan beberapa panggilan API, menangani logika bersyarat, dan melakukan perhitungan—semua dalam satu pemanggilan alat.

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:
Tambahkan ke ~/.cursor/mcp.json:
{
  "mcpServers": {
    "dodo-knowledge": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://knowledge.dodopayments.com/mcp"]
    }
  }
}
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:
ServerTujuanKasus Penggunaan
Dodo Knowledge MCPPencarian dokumentasi”Bagaimana cara menangani webhook?”, “Metode pembayaran apa yang didukung?”
Dodo Payments MCPOperasi APIMembuat pembayaran, mengelola langganan, menangani pengembalian dana
{
  "mcpServers": {
    "dodo-knowledge": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://knowledge.dodopayments.com/mcp"]
    },
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}
Dengan kedua server dikonfigurasi, asisten AI Anda dapat terlebih dahulu mencari dokumentasi untuk memahami cara mengimplementasikan fitur, kemudian mengeksekusi panggilan API yang sebenarnya—semua dalam satu percakapan.

Memecahkan Masalah Knowledge MCP

Jika Anda mengalami masalah koneksi:
  1. Bersihkan cache otentikasi MCP: rm -rf ~/.mcp-auth
  2. Mulai ulang aplikasi klien Anda
  3. Periksa log klien untuk pesan kesalahan
  4. 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.
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

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
Jaga agar kunci API Anda tetap aman. Gunakan kunci mode uji selama pengembangan.
4

Selesaikan pengaturan

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

Paket NPM

Instal dan jalankan server MCP secara lokal menggunakan NPM.
# Set your environment variables
export DODO_PAYMENTS_API_KEY="dodo_test_..."
export DODO_PAYMENTS_WEBHOOK_KEY="your_webhook_key"
export DODO_PAYMENTS_ENVIRONMENT="live_mode"

# 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_..." \
  -e DODO_PAYMENTS_WEBHOOK_KEY="your_webhook_key" \
  -e DODO_PAYMENTS_ENVIRONMENT="live_mode" \
  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 memungkinkan akses percakapan ke data pembayaran Anda.Instalasi Satu KlikGunakan tombol di bawah ini untuk menginstal server MCP langsung di Cursor:[Tambahkan ke 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 Manual
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:Server Jarak Jauh (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_...",
        "DODO_PAYMENTS_WEBHOOK_KEY": "your_webhook_key"
      }
    }
  }
}
4

Simpan dan mulai ulang

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

Variabel Lingkungan

Konfigurasikan perilaku server MCP menggunakan variabel lingkungan.
VariabelDeskripsiDiperlukan
DODO_PAYMENTS_API_KEYKunci API Pembayaran Dodo AndaYa
DODO_PAYMENTS_WEBHOOK_KEYKunci penandatangan webhook AndaTidak
DODO_PAYMENTS_ENVIRONMENTAtur ke live_mode untuk produksiTidak

Menjalankan Secara Jarak Jauh

Terapkan server MCP sebagai server HTTP jarak jauh untuk klien berbasis web atau alur kerja agentic.
# Start as remote server
npx -y dodopayments-mcp --transport=http

# Specify a custom port
npx -y dodopayments-mcp --transport=http --port=3000

Konfigurasi Server Jarak Jauh

Setelah diterapkan, klien dapat terhubung menggunakan URL server:
{
  "mcpServers": {
    "dodopayments_api": {
      "url": "http://localhost:3000",
      "headers": {
        "Authorization": "Bearer your_api_key"
      }
    }
  }
}

Header Otorisasi

Server jarak jauh menerima otentikasi melalui header berikut:
HeaderDeskripsi
AuthorizationAutentikasi token Bearer
x-dodo-payments-api-keyHeader 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.
# Auto-detect client (default)
npx dodopayments-mcp --client=infer

# Configure for specific clients
npx dodopayments-mcp --client=cursor
npx dodopayments-mcp --client=claude
npx dodopayments-mcp --client=claude-code
npx dodopayments-mcp --client=openai-agents

Preset Klien yang Tersedia

KlienDeskripsi
inferKlien deteksi otomatis (default)
cursorEditor Cursor
claudeClaude AI web atau desktop
claude-codeClaude Code CLI
openai-agentsPlatform agen OpenAI

Konfigurasi Kemampuan Manual

Untuk klien yang tidak terdaftar di atas, konfigurasikan kemampuan secara manual:
# Disable $ref pointer support and set max tool name length
npx dodopayments-mcp --no-capability=refs --capability=tool-name-length=40
Kemampuan yang tersedia:
  • top-level-unions - Dukungan untuk tipe union tingkat atas
  • valid-json - Parsing argumen string JSON yang benar
  • refs - Dukungan untuk pointer $ref dalam skema
  • unions - Dukungan untuk tipe union (anyOf)
  • formats - Dukungan untuk validasi format
  • tool-name-length=N - Panjang nama alat maksimum
Jalankan npx dodopayments-mcp --describe-capabilities untuk informasi kemampuan yang lebih rinci.

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.
# 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 tidak sengaja 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

# Use wildcards for resource groups
npx dodopayments-mcp --resource=subscription*

Sertakan atau kecualikan alat tertentu

Sesuaikan alat individu 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

# Disable the docs search tool
npx dodopayments-mcp --no-tools=docs

# 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

Penyaringan Parameter Kuery URL (Server Jarak Jauh)

Saat menggunakan server jarak jauh, terapkan filter melalui parameter kuery URL:
https://mcp.dodopayments.com/?operation=read
https://mcp.dodopayments.com/?resource=payments

Mode Alat Dinamis

Untuk API besar, memuat semua alat sekaligus dapat membebani jendela konteks AI. Mode alat dinamis memberikan alternatif yang lebih efisien.
npx dodopayments-mcp --tools=dynamic
Dalam mode dinamis, tiga meta-alat menggantikan alat API individu:
  1. list_api_endpoints - Menemukan metode yang tersedia dengan penyaringan opsional
  2. get_api_endpoint_schema - Mendapatkan skema rinci untuk metode tertentu
  3. invoke_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.
# Use both dynamic tools and specific resources
npx dodopayments-mcp --tools=dynamic --resource=payments

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 tetap 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 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.
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

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://test.dodopayments.com/payments
Periksa koneksi jaringan AndaVerifikasi Anda dapat mengakses 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 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.
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.
Coba preset klien yang berbedaJika alat tidak berfungsi dengan benar, coba tentukan klien Anda secara eksplisit:
npx dodopayments-mcp --client=cursor
Periksa dukungan kemampuanBeberapa klien tidak mendukung semua fitur skema JSON. Gunakan --describe-capabilities untuk memahami apa yang didukung.

Sumber Daya