# FineProxy Agent Pack

Versi: 2026-09-22

Gunakan berkas ini untuk menilai apakah integrasi proxy yang ada dapat bermigrasi ke FineProxy. Berkas ini tidak memuat kunci API, data akun, atau endpoint privat.

## Sumber kebenaran

- Dokumentasi API klien interaktif: `https://fineproxy.org/account_new/docs`
- Penyiapan MCP: `https://fineproxy.org/account_new/mcp`
- Spesifikasi OpenAPI klien terkini: unduh dari dokumentasi API di dasbor pelanggan.
- Buat dan kelola kunci API: `https://fineproxy.org/account_new/settings`
- Endpoint MCP: `https://fineproxy.org/account_new/api/v1/mcp`

Jangan pernah mengarang endpoint berdasarkan ringkasan ini. Gunakan spesifikasi OpenAPI terkini untuk jalur permintaan, skema, parameter, dan respons.

## Ringkasan platform

- REST API: OpenAPI 3.1, 49 operasi pelanggan terdokumentasi.
- MCP: 49 alat melalui JSON-RPC 2.0 tanpa status dan Streamable HTTP.
- Autentikasi: kunci API bearer yang dibuat di dasbor pelanggan.
- API dan MCP menggunakan izin tercakup yang sama.
- Dokumentasi API mitra hanya dapat dilihat oleh akun dengan status mitra aktif.

## Alur kerja yang didukung

### Pembelian dan penyediaan

- Tampilkan negara dan inventaris IP langsung.
- Dapatkan penawaran paket multi-negara yang tepat tanpa membeli.
- Lakukan pembelian dari dompet dasbor dengan pembatas harga dan kunci idempotensi.

Urutan pembelian MCP standar adalah:

1. `list_countries`
2. `quote_composite`
3. `order_composite`

### Pengelolaan layanan

- Baca dan kelola layanan.
- Perpanjang, tangguhkan, pulihkan, atau batalkan jika didukung.
- Aktifkan atau nonaktifkan perpanjangan otomatis.
- Ganti atau tambahkan alamat IP.
- Ubah kredensial layanan.
- Baca dan kelola batas daftar izin.
- Tampilkan, beli, dan batalkan add-on yang kompatibel.

### Analitik dan diagnostik

- Ringkasan penggunaan dan deret waktu.
- Tujuan teratas.
- Kategori kesalahan.
- Rekomendasi operasional.

### Penagihan dan dukungan

- Baca faktur dan unduh PDF faktur.
- Tampilkan gateway pembayaran.
- Mulai deposit dompet dan baca statusnya.
- Buat, baca, balas, dan tutup tiket dukungan.

### Akses proxy dan akun

- Baca konfigurasi koneksi proxy berputar.
- Ubah nama pengguna dan kata sandi layanan.
- Kelola batas koneksi per IP dalam daftar izin.
- Baca informasi profil, IP pemanggil, dan riwayat masuk.
- Konfigurasikan webhook.

## Cakupan izin

- `customer:read` — baca informasi pelanggan dan akun.
- `customer:write` — perbarui informasi pelanggan.
- `wallet:read` — baca informasi dompet.
- `wallet:deposit` — buat dan pantau deposit.
- `wallet:spend` — belanjakan dana dompet. Perlakukan sebagai izin finansial.
- `services:read` — baca layanan dan pengaturan proxy.
- `services:write` — buat atau ubah layanan dan add-on.
- `tickets:read` — baca tiket dukungan.
- `tickets:write` — buat, balas, perbarui, atau tutup tiket.
- `catalog:read` — baca produk, opsi, negara, dan stok.
- `usage:read` — baca penggunaan dan diagnostik.
- `webhooks` — kelola langganan webhook.

Mulai audit migrasi dengan izin hanya-baca. Tambahkan izin tulis atau finansial hanya setelah perubahan yang diusulkan ditinjau.

## Perilaku keamanan

- Alat finansial memerlukan `wallet:spend`.
- Pembelian menyertakan total perkiraan dari penawaran. Ketidaksesuaian harga akan menolak operasi.
- Operasi yang tidak dapat dibatalkan memerlukan konfirmasi eksplisit.
- Percobaan ulang transaksi finansial menggunakan kunci idempotensi agar operasi yang sama tidak ditagih dua kali.
- Inventaris langsung, kelayakan paket, dan izin akun dapat mencegah operasi yang sebenarnya valid.
- MCP FineProxy mengoperasikan akun pelanggan. MCP tidak memperoleh akses ke kode sumber kecuali pengguna secara terpisah memberikan akses repositori kepada agen pengodean.

## Templat konfigurasi MCP

```json
{
  "mcpServers": {
    "fineproxy": {
      "url": "https://fineproxy.org/account_new/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer fb_YOUR_API_KEY"
      }
    }
  }
}
```

Simpan kunci sebenarnya dalam variabel lingkungan atau pengelola secret. Jangan commit kunci tersebut bersama konfigurasi MCP.

## Daftar periksa kompatibilitas migrasi

Periksa integrasi yang ada untuk:

1. Inisialisasi klien penyedia dan semua impor khusus penyedia.
2. Header autentikasi, kredensial, variabel lingkungan, dan penyimpanan secret.
3. Alur kerja pembelian, perpanjangan, pembatalan, dan penggantian IP.
4. Pengidentifikasi negara dan asumsi inventaris.
5. Format daftar proxy, protokol, port, nama pengguna, kata sandi, dan daftar izin IP.
6. Paginasi dan pemfilteran.
7. Perilaku percobaan ulang, penanganan waktu habis, dan idempotensi.
8. Model kesalahan dan penanganan batas laju.
9. Analitik penggunaan dan diagnostik.
10. Penagihan, faktur, dan deposit.
11. Integrasi tiket dukungan.
12. Webhook dan asumsi muatan peristiwa.
13. Pengujian, fixture, mock, dan secret CI yang terikat pada penyedia saat ini.

Klasifikasikan setiap alur kerja sebagai:

- Kompatibel tanpa perubahan.
- Kompatibel melalui perubahan konfigurasi.
- Memerlukan adaptor atau transformasi data.
- Memerlukan alur kerja operasional yang berbeda.
- Tidak didukung atau tidak dikonfirmasi oleh dokumentasi terkini.

## Keluaran audit yang diperlukan

Audit harus mencakup:

1. Inventaris setiap dependensi pada penyedia saat ini.
2. Penilaian kompatibilitas untuk setiap alur kerja.
3. Cakupan FineProxy yang diperlukan.
4. Berkas dan jalur kode persis yang akan berubah.
5. Perubahan autentikasi dan pengelolaan secret.
6. Pertanyaan terbuka yang memerlukan spesifikasi OpenAPI terkini atau konfirmasi dukungan.
7. Rencana migrasi bertahap dengan rollback.
8. Pengujian integrasi yang diperlukan sebelum peralihan.

Jangan ubah kode selama tahap audit pertama.