# FineProxy Agent Pack

Versioon: 2026-09-22

Kasutage seda faili, et hinnata, kas olemasoleva proksiintegratsiooni saab FineProxyle migreerida. See ei sisalda API-võtit, kontoandmeid ega privaatset lõpp-punkti.

## Alusallikad

- Interaktiivne kliendi API dokumentatsioon: `https://fineproxy.org/account_new/docs`
- MCP seadistus: `https://fineproxy.org/account_new/mcp`
- Praegune kliendi OpenAPI spetsifikatsioon: laadige see alla kliendi juhtpaneeli API dokumentatsioonist.
- API-võtmete loomine ja haldamine: `https://fineproxy.org/account_new/settings`
- MCP lõpp-punkt: `https://fineproxy.org/account_new/api/v1/mcp`

Ärge mõelge selle ülevaate põhjal lõpp-punkte välja. Päringute teede, skeemide, parameetrite ja vastuste jaoks kasutage praegust OpenAPI spetsifikatsiooni.

## Platvormi kokkuvõte

- REST API: OpenAPI 3.1, 49 dokumenteeritud klienditoimingut.
- MCP: 49 tööriista olekuta JSON-RPC 2.0 ja Streamable HTTP kaudu.
- Autentimine: kliendi juhtpaneelil loodud bearer API-võtmed.
- API ja MCP kasutavad samu piiratud õigusi.
- Partneri API dokumentatsiooni näevad ainult aktiivse partneri staatusega kontod.

## Toetatud töövood

### Ostmine ja kasutuselevõtt

- Loetlege riigid ja reaalajas IP-varu.
- Koostage täpsele mitme riigi paketile hinnapakkumine ilma ostu tegemata.
- Ostke juhtpaneeli rahakotist hinnakaitse ja idempotentsusvõtmega.

Standardne MCP ostujärjestus on:

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

### Teenuste haldamine

- Vaadake ja hallake teenuseid.
- Pikendage, peatage, taastage või tühistage teenuseid, kui see on toetatud.
- Lubage või keelake automaatne pikendamine.
- Asendage või lisage IP-aadresse.
- Muutke teenuse autentimisandmeid.
- Vaadake ja hallake lubaloendi piiranguid.
- Loetlege, ostke ja tühistage ühilduvaid lisasid.

### Analüütika ja diagnostika

- Kasutuse ülevaade ja aegread.
- Populaarseimad sihtkohad.
- Veakategooriad.
- Tegevussoovitused.

### Arveldamine ja klienditugi

- Vaadake arveid ja laadige alla arvete PDF-faile.
- Loetlege makselüüsid.
- Alustage rahakoti sissemakset ja vaadake selle olekut.
- Looge, lugege, vastake ja sulgege klienditoe pileteid.

### Juurdepääs proksidele ja kontole

- Vaadake roteeruva proksi ühenduse konfiguratsiooni.
- Muutke teenuse kasutajanime ja parooli.
- Hallake IP-põhiseid ühendusepiiranguid lubaloendis.
- Vaadake profiiliteavet, päringu esitaja IP-aadressi ja sisselogimisajalugu.
- Seadistage veebihaake.

## Õiguste ulatused

- `customer:read` — kliendi- ja kontoteabe lugemine.
- `customer:write` — klienditeabe uuendamine.
- `wallet:read` — rahakotiteabe lugemine.
- `wallet:deposit` — sissemaksete loomine ja jälgimine.
- `wallet:spend` — rahakoti vahendite kulutamine. Käsitlege seda finantsõigusena.
- `services:read` — teenuste ja proksiseadete lugemine.
- `services:write` — teenuste ja lisade loomine või muutmine.
- `tickets:read` — klienditoe piletite lugemine.
- `tickets:write` — piletite loomine, neile vastamine, nende uuendamine või sulgemine.
- `catalog:read` — toodete, valikute, riikide ja varu lugemine.
- `usage:read` — kasutuse ja diagnostika lugemine.
- `webhooks` — veebihaagi tellimuste haldamine.

Alustage migratsiooniauditit ainult lugemisõigustega. Lisage kirjutamis- või finantsõigused alles pärast pakutud muudatuste ülevaatamist.

## Turvakäitumine

- Finantstööriistad nõuavad õigust `wallet:spend`.
- Ostudele lisatakse hinnapakkumises toodud eeldatav kogusumma. Hinna erinevuse korral lükatakse toiming tagasi.
- Pöördumatud toimingud nõuavad selgesõnalist kinnitust.
- Finantspäringute kordamisel kasutatakse idempotentsusvõtit, et sama toimingu eest ei saaks kaks korda tasu võtta.
- Reaalajas IP-varu, paketi sobivus ja konto õigused võivad muidu kehtiva toimingu takistada.
- FineProxy MCP haldab kliendikontot. See ei saa juurdepääsu lähtekoodile, kui kasutaja ei anna programmeerimisagendile eraldi juurdepääsu repositooriumile.

## MCP konfiguratsioonimall

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

Hoidke tegelikku võtit keskkonnamuutujas või saladuste halduris. Ärge salvestage seda koos MCP konfiguratsiooniga repositooriumisse.

## Migratsiooni ühilduvuse kontroll-loend

Kontrollige olemasolevas integratsioonis järgmist:

1. Teenusepakkuja kliendi initsialiseerimine ja kõik teenusepakkujapõhised impordid.
2. Autentimispäised, autentimisandmed, keskkonnamuutujad ja saladuste talletamine.
3. Ostmise, pikendamise, tühistamise ja IP-aadresside asendamise töövood.
4. Riigitunnused ja eeldused IP-varu kohta.
5. Proksiloendite vormingud, protokollid, pordid, kasutajanimed, paroolid ja IP-lubaloend.
6. Lehekülgjaotus ja filtreerimine.
7. Korduskatsete käitumine, ajalõppude käsitlemine ja idempotentsus.
8. Veamudelid ja päringusageduse piirangute käsitlemine.
9. Kasutusanalüütika ja diagnostika.
10. Arveldamine, arved ja sissemaksed.
11. Klienditoe piletite integratsioon.
12. Veebihaagid ja eeldused sündmuste andmestruktuuri kohta.
13. Praeguse teenusepakkujaga seotud testid, testandmed, imitatsioonid ja CI saladused.

Liigitage iga töövoog järgmiselt:

- Ühildub muudatusteta.
- Ühildub konfiguratsioonimuudatusega.
- Vajab adapterit või andmete teisendamist.
- Vajab teistsugust töövoogu.
- Praeguse dokumentatsiooni põhjal toetamata või kinnitamata.

## Auditi nõutav väljund

Audit peaks sisaldama järgmist:

1. Kõigi praeguse teenusepakkuja sõltuvuste loend.
2. Iga töövoo ühilduvuse hinnang.
3. Vajalikud FineProxy õigused.
4. Täpsed failid ja kooditeed, mida tuleks muuta.
5. Autentimise ja saladuste haldamise muudatused.
6. Lahtised küsimused, mis vajavad praeguse OpenAPI spetsifikatsiooni või klienditoe kinnitust.
7. Etapiviisiline migratsiooniplaan koos tagasipööramise võimalusega.
8. Enne üleminekut vajalikud integratsioonitestid.

Ärge muutke auditi esimeses etapis koodi.