# Pek Ejen FineProxy

Versi: 2026-09-22

Gunakan fail ini untuk menilai sama ada integrasi proksi sedia ada boleh bermigrasi ke FineProxy. Fail ini tidak mengandungi kunci API, data akaun atau titik akhir peribadi.

## Sumber kebenaran

- Dokumentasi API klien interaktif: `https://fineproxy.org/account_new/docs`
- Persediaan MCP: `https://fineproxy.org/account_new/mcp`
- Spesifikasi OpenAPI klien semasa: muat turunnya daripada dokumentasi API dalam papan pemuka pelanggan.
- Cipta dan urus kunci API: `https://fineproxy.org/account_new/settings`
- Titik akhir MCP: `https://fineproxy.org/account_new/api/v1/mcp`

Jangan sekali-kali mereka titik akhir berdasarkan gambaran keseluruhan ini. Gunakan spesifikasi OpenAPI semasa untuk laluan 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 keadaan dan Streamable HTTP.
- Pengesahan: kunci API bearer yang dicipta dalam papan pemuka pelanggan.
- API dan MCP menggunakan kebenaran berskop yang sama.
- Dokumentasi API rakan kongsi hanya dapat dilihat oleh akaun dengan status rakan kongsi aktif.

## Aliran kerja yang disokong

### Pembelian dan penyediaan

- Senaraikan negara dan inventori IP langsung.
- Dapatkan sebut harga pakej berbilang negara yang tepat tanpa membuat pembelian.
- Buat pembelian daripada dompet papan pemuka dengan kawalan harga dan kunci idempotensi.

Urutan pembelian MCP standard ialah:

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

### Pengurusan perkhidmatan

- Baca dan urus perkhidmatan.
- Perbaharui, gantung, pulihkan atau batalkan apabila disokong.
- Dayakan atau nyahdayakan pembaharuan automatik.
- Ganti atau tambah alamat IP.
- Tukar kelayakan perkhidmatan.
- Baca dan urus had senarai dibenarkan.
- Senaraikan, beli dan batalkan tambahan yang serasi.

### Analitik dan diagnostik

- Gambaran keseluruhan penggunaan dan siri masa.
- Destinasi teratas.
- Kategori ralat.
- Cadangan operasi.

### Pengebilan dan sokongan

- Baca invois dan muat turun PDF invois.
- Senaraikan gerbang pembayaran.
- Mulakan deposit dompet dan baca statusnya.
- Cipta, baca, balas dan tutup tiket sokongan.

### Akses proksi dan akaun

- Baca konfigurasi sambungan proksi berputar.
- Tukar log masuk dan kata laluan perkhidmatan.
- Urus had sambungan bagi setiap IP dalam senarai dibenarkan.
- Baca maklumat profil, IP pemanggil dan sejarah log masuk.
- Konfigurasikan webhook.

## Skop kebenaran

- `customer:read` — baca maklumat pelanggan dan akaun.
- `customer:write` — kemas kini maklumat pelanggan.
- `wallet:read` — baca maklumat dompet.
- `wallet:deposit` — cipta dan pantau deposit.
- `wallet:spend` — belanjakan dana dompet. Anggap ini sebagai kebenaran kewangan.
- `services:read` — baca perkhidmatan dan tetapan proksi.
- `services:write` — cipta atau ubah perkhidmatan dan tambahan.
- `tickets:read` — baca tiket sokongan.
- `tickets:write` — cipta, balas, kemas kini atau tutup tiket.
- `catalog:read` — baca produk, pilihan, negara dan stok.
- `usage:read` — baca penggunaan dan diagnostik.
- `webhooks` — urus langganan webhook.

Mulakan audit migrasi dengan kebenaran baca sahaja. Tambahkan kebenaran tulis atau kewangan hanya selepas perubahan yang dicadangkan disemak.

## Tingkah laku keselamatan

- Alat kewangan memerlukan `wallet:spend`.
- Pembelian menyertakan jumlah jangkaan daripada sebut harga. Ketidakpadanan harga akan menolak operasi.
- Operasi yang tidak boleh dipulihkan memerlukan pengesahan jelas.
- Percubaan semula kewangan menggunakan kunci idempotensi supaya operasi yang sama tidak dicaj dua kali.
- Inventori langsung, kelayakan pelan dan kebenaran akaun boleh menghalang operasi yang sebaliknya sah.
- MCP FineProxy mengendalikan akaun pelanggan. Ia tidak mendapat akses kepada kod sumber melainkan pengguna memberikan akses repositori kepada ejen pengekodan secara berasingan.

## Templat konfigurasi MCP

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

Simpan kunci sebenar dalam pemboleh ubah persekitaran atau pengurus rahsia. Jangan komitkannya bersama konfigurasi MCP.

## Senarai semak keserasian migrasi

Periksa integrasi sedia ada untuk:

1. Pemulaan klien penyedia dan semua import khusus penyedia.
2. Pengepala pengesahan, kelayakan, pemboleh ubah persekitaran dan penyimpanan rahsia.
3. Aliran kerja pembelian, pembaharuan, pembatalan dan penggantian IP.
4. Pengecam negara dan andaian inventori.
5. Format senarai proksi, protokol, port, nama pengguna, kata laluan dan penyenaraian IP dibenarkan.
6. Penomboran halaman dan penapisan.
7. Tingkah laku percubaan semula, pengendalian tamat masa dan idempotensi.
8. Model ralat dan pengendalian kadar.
9. Analitik penggunaan dan diagnostik.
10. Pengebilan, invois dan deposit.
11. Integrasi tiket sokongan.
12. Webhook dan andaian muatan peristiwa.
13. Ujian, lekapan, objek olok-olok dan rahsia CI yang terikat kepada penyedia semasa.

Kelaskan setiap aliran kerja sebagai:

- Serasi tanpa perubahan.
- Serasi melalui perubahan konfigurasi.
- Memerlukan penyesuai atau transformasi data.
- Memerlukan aliran kerja operasi yang berbeza.
- Tidak disokong atau tidak disahkan oleh dokumentasi semasa.

## Output audit yang diperlukan

Audit perlu merangkumi:

1. Inventori setiap kebergantungan pada penyedia semasa.
2. Penilaian keserasian bagi setiap aliran kerja.
3. Skop FineProxy yang diperlukan.
4. Fail dan laluan kod tepat yang akan berubah.
5. Perubahan pengesahan dan pengurusan rahsia.
6. Soalan terbuka yang memerlukan spesifikasi OpenAPI semasa atau pengesahan sokongan.
7. Pelan migrasi berperingkat dengan pengembalian semula.
8. Ujian integrasi yang diperlukan sebelum peralihan.

Jangan ubah kod semasa semakan audit pertama.