# FineProxy Agent Pack

Versie: 2026-09-22

Gebruik dit bestand om te beoordelen of een bestaande proxy-integratie naar FineProxy kan migreren. Het bevat geen API-sleutel, accountgegevens of privé-endpoint.

## Gezaghebbende bronnen

- Interactieve API-documentatie voor klanten: `https://fineproxy.org/account_new/docs`
- MCP-configuratie: `https://fineproxy.org/account_new/mcp`
- Huidige OpenAPI-specificatie voor klanten: download deze via de API-documentatie in het klantdashboard.
- API-sleutels maken en beheren: `https://fineproxy.org/account_new/settings`
- MCP-endpoint: `https://fineproxy.org/account_new/api/v1/mcp`

Verzin nooit een endpoint op basis van dit overzicht. Gebruik de huidige OpenAPI-specificatie voor aanvraagpaden, schema's, parameters en antwoorden.

## Platformoverzicht

- REST API: OpenAPI 3.1, 49 gedocumenteerde klantbewerkingen.
- MCP: 49 tools via stateless JSON-RPC 2.0 en Streamable HTTP.
- Authenticatie: bearer-API-sleutels die in het klantdashboard worden gemaakt.
- API en MCP gebruiken dezelfde machtigingen met scopes.
- API-documentatie voor partners is alleen zichtbaar voor accounts met een actieve partnerstatus.

## Ondersteunde workflows

### Aankoop en inrichting

- Landen en actuele IP-voorraad weergeven.
- Een exact pakket voor meerdere landen offreren zonder het aan te schaffen.
- Aankopen vanuit de dashboardwallet met een prijsbeveiliging en idempotentiesleutel.

De standaard MCP-aankoopvolgorde is:

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

### Dienstbeheer

- Diensten uitlezen en beheren.
- Verlengen, opschorten, herstellen of opzeggen indien ondersteund.
- Automatische verlenging in- of uitschakelen.
- IP-adressen vervangen of toevoegen.
- Inloggegevens van diensten wijzigen.
- Limieten van toelatingslijsten uitlezen en beheren.
- Compatibele add-ons weergeven, aanschaffen en opzeggen.

### Analyse en diagnose

- Verbruiksoverzicht en tijdreeksen.
- Belangrijkste doelen.
- Foutcategorieën.
- Operationele aanbevelingen.

### Facturering en ondersteuning

- Facturen uitlezen en factuur-pdf's downloaden.
- Betalingsgateways weergeven.
- Een walletstorting starten en de status ervan uitlezen.
- Supporttickets maken, lezen, beantwoorden en sluiten.

### Proxytoegang en account

- Verbindingsconfiguratie voor roterende proxy's uitlezen.
- Login en wachtwoord van een dienst wijzigen.
- Verbindingslimieten per IP in de toelatingslijst beheren.
- Profielgegevens, IP-adres van de aanroeper en inloggeschiedenis uitlezen.
- Webhooks configureren.

## Machtigingsscopes

- `customer:read` — klant- en accountgegevens uitlezen.
- `customer:write` — klantgegevens bijwerken.
- `wallet:read` — walletgegevens uitlezen.
- `wallet:deposit` — stortingen maken en volgen.
- `wallet:spend` — wallettegoed uitgeven. Behandel dit als een financiële machtiging.
- `services:read` — diensten en proxy-instellingen uitlezen.
- `services:write` — diensten en add-ons maken of wijzigen.
- `tickets:read` — supporttickets lezen.
- `tickets:write` — tickets maken, beantwoorden, bijwerken of sluiten.
- `catalog:read` — producten, opties, landen en voorraad uitlezen.
- `usage:read` — verbruik en diagnoses uitlezen.
- `webhooks` — webhookabonnementen beheren.

Begin een migratieaudit met alleen-lezen-machtigingen. Voeg schrijf- of financiële machtigingen pas toe nadat de voorgestelde wijzigingen zijn beoordeeld.

## Veiligheidsgedrag

- Financiële tools vereisen `wallet:spend`.
- Aankopen bevatten het verwachte geoffreerde totaalbedrag. Bij een prijsverschil wordt de bewerking geweigerd.
- Onomkeerbare bewerkingen vereisen expliciete bevestiging.
- Nieuwe pogingen voor financiële bewerkingen gebruiken een idempotentiesleutel, zodat dezelfde bewerking niet twee keer in rekening wordt gebracht.
- Actuele voorraad, geschiktheid van het abonnement en accountmachtigingen kunnen een anderszins geldige bewerking verhinderen.
- FineProxy MCP beheert het klantaccount. Het krijgt geen toegang tot broncode tenzij de gebruiker de coding-agent afzonderlijk toegang tot een repository geeft.

## MCP-configuratiesjabloon

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

Bewaar de echte sleutel in een omgevingsvariabele of geheimenbeheerder. Leg deze niet samen met de MCP-configuratie vast.

## Checklist voor migratiecompatibiliteit

Inspecteer de bestaande integratie op:

1. Initialisatie van de providerclient en alle providerspecifieke imports.
2. Authenticatieheaders, inloggegevens, omgevingsvariabelen en opslag van geheimen.
3. Workflows voor aankoop, verlenging, opzegging en IP-vervanging.
4. Landcodes en aannames over voorraad.
5. Indelingen van proxylijsten, protocollen, poorten, gebruikersnamen, wachtwoorden en IP-toelatingslijsten.
6. Paginering en filtering.
7. Retrygedrag, afhandeling van time-outs en idempotentie.
8. Foutmodellen en afhandeling van limieten.
9. Verbruiksanalyse en diagnoses.
10. Facturering, facturen en stortingen.
11. Integratie van supporttickets.
12. Webhooks en aannames over gebeurtenispayloads.
13. Tests, fixtures, mocks en CI-geheimen die aan de huidige provider zijn gekoppeld.

Classificeer elke workflow als:

- Compatibel zonder wijzigingen.
- Compatibel via een configuratiewijziging.
- Vereist een adapter of gegevenstransformatie.
- Vereist een andere operationele workflow.
- Niet ondersteund of niet bevestigd door de huidige documentatie.

## Vereiste audituitvoer

De audit moet het volgende bevatten:

1. Een inventaris van elke afhankelijkheid van de huidige provider.
2. Een compatibiliteitsbeoordeling per workflow.
3. Vereiste FineProxy-scopes.
4. Exacte bestanden en codepaden die zouden veranderen.
5. Wijzigingen in authenticatie en geheimenbeheer.
6. Open vragen waarvoor de huidige OpenAPI-specificatie of bevestiging door de ondersteuning nodig is.
7. Een gefaseerd migratieplan met rollback.
8. Integratietests die vóór de omschakeling vereist zijn.

Wijzig tijdens de eerste auditronde geen code.