# FineProxy Agent Pack

Version: 2026-09-22

Verwenden Sie diese Datei, um zu beurteilen, ob eine bestehende Proxy-Integration zu FineProxy migriert werden kann. Sie enthält weder API-Key noch Kontodaten oder private Endpunkte.

## Verbindliche Quellen

- Interaktive Client-API-Dokumentation: `https://fineproxy.org/account_new/docs`
- MCP-Einrichtung: `https://fineproxy.org/account_new/mcp`
- Aktuelle Client-OpenAPI-Spezifikation: Laden Sie sie aus der API-Dokumentation im Kunden-Dashboard herunter.
- API-Keys erstellen und verwalten: `https://fineproxy.org/account_new/settings`
- MCP-Endpunkt: `https://fineproxy.org/account_new/api/v1/mcp`

Erfinden Sie niemals einen Endpunkt anhand dieser Übersicht. Verwenden Sie für Request-Pfade, Schemas, Parameter und Responses die aktuelle OpenAPI-Spezifikation.

## Plattformübersicht

- REST API: OpenAPI 3.1, 49 dokumentierte Kundenoperationen.
- MCP: 49 Tools über zustandsloses JSON-RPC 2.0 und Streamable HTTP.
- Authentifizierung: Bearer-API-Keys, die im Kunden-Dashboard erstellt werden.
- API und MCP verwenden dieselben Berechtigungs-Scopes.
- Die Partner-API-Dokumentation ist nur für Konten mit aktivem Partnerstatus sichtbar.

## Unterstützte Workflows

### Kauf und Bereitstellung

- Länder und aktuellen IP-Bestand auflisten.
- Ein exaktes Paket für mehrere Länder kalkulieren, ohne es zu kaufen.
- Über das Guthaben im Dashboard mit Preisabsicherung und Idempotenzschlüssel kaufen.

Die Standardsequenz für einen MCP-Kauf lautet:

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

### Dienstverwaltung

- Dienste lesen und verwalten.
- Verlängern, sperren, wiederherstellen oder kündigen, sofern unterstützt.
- Automatische Verlängerung aktivieren oder deaktivieren.
- IP-Adressen ersetzen oder hinzufügen.
- Zugangsdaten eines Dienstes ändern.
- Allowlist-Limits lesen und verwalten.
- Kompatible Add-ons auflisten, kaufen und kündigen.

### Analysen und Diagnosen

- Nutzungsübersicht und Zeitreihen.
- Häufigste Ziele.
- Fehlerkategorien.
- Operative Empfehlungen.

### Abrechnung und Support

- Rechnungen einsehen und Rechnungs-PDFs herunterladen.
- Zahlungs-Gateways auflisten.
- Eine Guthabeneinzahlung starten und ihren Status abrufen.
- Support-Tickets erstellen, lesen, beantworten und schließen.

### Proxy-Zugriff und Konto

- Verbindungskonfiguration für rotierende Proxys abrufen.
- Login und Passwort eines Dienstes ändern.
- Verbindungslimits pro IP in der Allowlist verwalten.
- Profilinformationen, aufrufende IP und Anmeldeverlauf abrufen.
- Webhooks konfigurieren.

## Berechtigungs-Scopes

- `customer:read` — Kunden- und Kontoinformationen lesen.
- `customer:write` — Kundeninformationen aktualisieren.
- `wallet:read` — Guthabendaten lesen.
- `wallet:deposit` — Einzahlungen erstellen und überwachen.
- `wallet:spend` — Guthaben ausgeben. Als finanzielle Berechtigung behandeln.
- `services:read` — Dienste und Proxy-Einstellungen lesen.
- `services:write` — Dienste und Add-ons erstellen oder ändern.
- `tickets:read` — Support-Tickets lesen.
- `tickets:write` — Tickets erstellen, beantworten, aktualisieren oder schließen.
- `catalog:read` — Produkte, Optionen, Länder und Bestand lesen.
- `usage:read` — Nutzung und Diagnosen lesen.
- `webhooks` — Webhook-Abonnements verwalten.

Beginnen Sie ein Migrationsaudit mit reinen Leseberechtigungen. Fügen Sie Schreib- oder Finanzberechtigungen erst hinzu, nachdem die vorgeschlagenen Änderungen geprüft wurden.

## Sicherheitsverhalten

- Finanz-Tools erfordern `wallet:spend`.
- Käufe enthalten den erwarteten angebotenen Gesamtbetrag. Bei einer Preisabweichung wird der Vorgang abgelehnt.
- Unumkehrbare Vorgänge erfordern eine ausdrückliche Bestätigung.
- Wiederholte Finanz-Requests verwenden einen Idempotenzschlüssel, damit derselbe Vorgang nicht doppelt berechnet wird.
- Der aktuelle Bestand, die Tarifeignung und Kontoberechtigungen können einen ansonsten gültigen Vorgang verhindern.
- FineProxy MCP verwaltet das Kundenkonto. Es erhält keinen Zugriff auf Quellcode, sofern der Nutzer dem Coding-Agenten nicht separat Zugriff auf ein Repository gewährt.

## MCP-Konfigurationsvorlage

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

Speichern Sie den echten Key in einer Umgebungsvariable oder Geheimnisverwaltung. Checken Sie ihn nicht zusammen mit der MCP-Konfiguration ein.

## Checkliste zur Migrationskompatibilität

Prüfen Sie die bestehende Integration auf:

1. Initialisierung des Anbieter-Clients und alle anbieterspezifischen Imports.
2. Authentifizierungs-Header, Zugangsdaten, Umgebungsvariablen und Geheimnisverwaltung.
3. Workflows für Kauf, Verlängerung, Kündigung und IP-Austausch.
4. Länderkennungen und Annahmen zum Bestand.
5. Formate von Proxy-Listen, Protokolle, Ports, Benutzernamen, Passwörter und IP-Allowlists.
6. Paginierung und Filterung.
7. Retry-Verhalten, Timeout-Behandlung und Idempotenz.
8. Fehlermodelle und Rate-Handling.
9. Nutzungsanalysen und Diagnosen.
10. Abrechnung, Rechnungen und Einzahlungen.
11. Support-Ticket-Integration.
12. Webhooks und Annahmen zu Event-Payloads.
13. Tests, Fixtures, Mocks und CI-Secrets, die an den aktuellen Anbieter gebunden sind.

Ordnen Sie jeden Workflow einer der folgenden Kategorien zu:

- Ohne Änderungen kompatibel.
- Durch eine Konfigurationsänderung kompatibel.
- Erfordert einen Adapter oder eine Datentransformation.
- Erfordert einen anderen operativen Workflow.
- Nicht unterstützt oder durch die aktuelle Dokumentation nicht bestätigt.

## Erforderliche Audit-Ausgabe

Das Audit sollte Folgendes enthalten:

1. Ein Verzeichnis aller Abhängigkeiten vom aktuellen Anbieter.
2. Eine Bewertung der Kompatibilität für jeden Workflow.
3. Erforderliche FineProxy-Scopes.
4. Exakte Dateien und Codepfade, die geändert würden.
5. Änderungen bei Authentifizierung und Geheimnisverwaltung.
6. Offene Fragen, für die die aktuelle OpenAPI-Spezifikation oder eine Bestätigung des Supports erforderlich ist.
7. Einen stufenweisen Migrationsplan mit Rollback.
8. Vor der Umstellung erforderliche Integrationstests.

Ändern Sie beim ersten Audit-Durchlauf keinen Code.