> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Membangun dengan AI Coding Agents

> Gunakan Dodo Agent Plugin untuk membangun integrasi dengan Claude Code, Codex CLI, Cursor, dan OpenCode — server MCP dan keahlian dalam satu instalasi.

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.

<Info>
  **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.
</Info>

## Instalasi plugin

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

<AccordionGroup>
  <Accordion title="Claude Code" defaultOpen>
    Instal dari marketplace:

    ```bash theme={null}
    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.

    <Card title="Dodo Agent Plugin on GitHub" icon="github" href="https://github.com/dodopayments/dodo-agent-plugin">
      Kode sumber, opsi konfigurasi, dan petunjuk pengembangan lokal
    </Card>
  </Accordion>

  <Accordion title="Codex CLI">
    Codex menginstal plugin dalam dua langkah: mendaftarkan marketplace dari shell Anda, lalu instal plugin dari dalam Codex TUI.

    <Steps>
      <Step title="Register the marketplace">
        ```bash theme={null}
        codex plugin marketplace add dodopayments/dodo-agent-plugin
        ```
      </Step>

      <Step title="Install from the Codex TUI">
        Buka Codex dan jalankan perintah garis miring `/plugins`:

        ```bash theme={null}
        codex
        ```

        Kemudian ketik `/plugins`, alihkan ke marketplace **Dodo Payments**, pilih plugin **dodopayments**, dan pilih **Install plugin**.
      </Step>
    </Steps>

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

    <Note>
      Codex CLI tidak memiliki subcommand `codex plugin install` — pemasangan plugin selalu dilakukan melalui alur in-TUI `/plugins`. Lihat [dokumentasi plugin Codex resmi](https://developers.openai.com/codex/plugins).
    </Note>

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

    ```bash theme={null}
    codex plugin marketplace upgrade dodopayments
    ```
  </Accordion>

  <Accordion title="Cursor">
    Instalasi manual — clone repo ke direktori plugin lokal Cursor:

    ```bash theme={null}
    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`.

    <Info>
      Dukungan marketplace Cursor akan datang. Untuk saat ini, gunakan instalasi manual di atas.
    </Info>
  </Accordion>

  <Accordion title="OpenCode">
    OpenCode mendistribusikan melalui npm. Tambahkan plugin ke `opencode.json` Anda:

    ```json theme={null}
    {
      "$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.
  </Accordion>
</AccordionGroup>

<Info>
  Menggunakan agen yang berbeda? Panduan [MCP Server](/developer-resources/mcp-server) dan [Agent Skills](/developer-resources/agent-skills) mencakup Cursor, Claude Desktop, VS Code, Windsurf, Cline, Zed, dan klien yang kompatibel dengan MCP mana pun.
</Info>

## 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](/developer-resources/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](/developer-resources/mcp-server) | [Skills CLI](/developer-resources/agent-skills) |
| Claude Desktop           | [Panduan Server MCP](/developer-resources/mcp-server) | —                                               |
| Windsurf                 | [Panduan Server MCP](/developer-resources/mcp-server) | [Skills CLI](/developer-resources/agent-skills) |
| Cline / Zed / lainnya    | [Panduan Server MCP](/developer-resources/mcp-server) | [Skills CLI](/developer-resources/agent-skills) |

## 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`](https://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`](https://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](/features/one-time-payment-products) dan [langganan](/features/subscription)
* **Menyiapkan penagihan berbasis langganan dan penggunaan end-to-end** — [Langganan](/features/subscription), [Penagihan berbasis penggunaan](/features/usage-based-billing/introduction), [Penagihan berbasis kredit](/features/credit-based-billing)
* **Hasilkan pengendali yang sesuai dengan Webhooks Standar** dengan verifikasi tanda tangan — [Webhooks](/developer-resources/webhooks)
* **Hubungkan komponen React BillingSDK** untuk tabel harga dan manajemen langganan — [BillingSDK](/developer-resources/billingsdk)
* **Buat alur kunci lisensi** untuk produk digital — [Kunci lisensi](/features/license-keys)
* **Implementasikan penagihan berbasis kredit** dengan hak, saldo, pengguliran, dan kelebihan — [Kredit](/features/credit-based-billing)

## Keamanan dan praktik terbaik

<Warning>
  **Jangan pernah mengkomit kunci API produksi.** Gunakan [mode uji](/miscellaneous/test-mode-vs-live-mode) selama pengembangan. Plugin Agen menggunakan OAuth browser secara default — hanya beralih ke kunci API lokal jika diperlukan oleh alur kerja Anda.
</Warning>

* **Gunakan mode uji terlebih dahulu.** Sandarkan integrasi Anda dengan kunci `dodo_test_...` sebelum masuk ke mode live. Lihat [Mode Uji vs Mode Langsung](/miscellaneous/test-mode-vs-live-mode).
* **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](https://standardwebhooks.com/).

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

<AccordionGroup>
  <Accordion title="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:

    ```json theme={null}
    {
      "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.
  </Accordion>

  <Accordion title="Local API key mode — OpenCode">
    Deklarasikan `dodopayments-api` sendiri di `opencode.json` — entri Anda lebih diterima daripada server remote default plugin:

    ```json theme={null}
    {
      "$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.
  </Accordion>
</AccordionGroup>

## Langkah selanjutnya

<CardGroup cols={2}>
  <Card title="MCP Server" icon="terminal" href="/developer-resources/mcp-server">
    Referensi lengkap untuk kedua server MCP — semua klien yang didukung, konfigurasi, dan alat yang tersedia
  </Card>

  <Card title="Agent Skills" icon="wand-magic-sparkles" href="/developer-resources/agent-skills">
    Instalasi skill individual, referensi skill, dan instruksi penyiapan per-agen
  </Card>

  <Card title="Sentra IDE Assistant" icon="bolt" href="/developer-resources/sentra">
    Asisten penagihan bertenaga AI untuk VS Code, Cursor, dan Windsurf — tanyakan, bangun, dan rencanakan dalam editor Anda
  </Card>

  <Card title="API Reference" icon="book" href="/api-reference/introduction">
    Referensi OpenAPI lengkap untuk semua endpoint Dodo Payments
  </Card>
</CardGroup>