# FineProxy Agent Pack

Version : 2026-09-22

Utilisez ce fichier pour déterminer si une intégration proxy existante peut migrer vers FineProxy. Il ne contient aucune clé API, aucune donnée de compte ni aucun endpoint privé.

## Sources de référence

- Documentation interactive de l’API client : `https://fineproxy.org/account_new/docs`
- Configuration MCP : `https://fineproxy.org/account_new/mcp`
- Spécification OpenAPI client actuelle : téléchargez-la depuis la documentation API du tableau de bord client.
- Création et gestion des clés API : `https://fineproxy.org/account_new/settings`
- Endpoint MCP : `https://fineproxy.org/account_new/api/v1/mcp`

N’inventez jamais un endpoint à partir de cette vue d’ensemble. Utilisez la spécification OpenAPI actuelle pour les chemins de requête, les schémas, les paramètres et les réponses.

## Présentation de la plateforme

- API REST : OpenAPI 3.1, 49 opérations client documentées.
- MCP : 49 outils utilisant JSON-RPC 2.0 sans état et Streamable HTTP.
- Authentification : clés API bearer créées dans le tableau de bord client.
- L’API et le MCP utilisent les mêmes autorisations limitées.
- La documentation de l’API partenaire n’est visible que pour les comptes ayant un statut de partenaire actif.

## Workflows pris en charge

### Achat et provisionnement

- Répertorier les pays et l’inventaire d’adresses IP en temps réel.
- Obtenir un devis exact pour un forfait multipays sans effectuer d’achat.
- Acheter depuis le portefeuille du tableau de bord avec une protection de prix et une clé d’idempotence.

La séquence d’achat MCP standard est la suivante :

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

### Gestion des services

- Consulter et gérer les services.
- Renouveler, suspendre, restaurer ou résilier lorsque ces actions sont prises en charge.
- Activer ou désactiver le renouvellement automatique.
- Remplacer ou ajouter des adresses IP.
- Modifier les identifiants du service.
- Consulter et gérer les limites de la liste des IP autorisées.
- Répertorier, acheter et résilier les options compatibles.

### Analyses et diagnostics

- Vue d’ensemble et séries chronologiques de l’utilisation.
- Principales destinations.
- Catégories d’erreurs.
- Recommandations opérationnelles.

### Facturation et assistance

- Consulter les factures et télécharger leurs fichiers PDF.
- Répertorier les passerelles de paiement.
- Lancer un dépôt sur le portefeuille et consulter son statut.
- Créer, consulter, traiter et fermer des tickets d’assistance.

### Accès proxy et compte

- Consulter la configuration de connexion des proxys rotatifs.
- Modifier l’identifiant et le mot de passe du service.
- Gérer les limites de connexion par IP dans la liste des IP autorisées.
- Consulter les informations du profil, l’adresse IP de l’appelant et l’historique des connexions.
- Configurer les webhooks.

## Autorisations

- `customer:read` — consulter les informations du client et du compte.
- `customer:write` — mettre à jour les informations du client.
- `wallet:read` — consulter les informations du portefeuille.
- `wallet:deposit` — créer et suivre les dépôts.
- `wallet:spend` — dépenser les fonds du portefeuille. À traiter comme une autorisation financière.
- `services:read` — consulter les services et les paramètres proxy.
- `services:write` — créer ou modifier des services et des options.
- `tickets:read` — consulter les tickets d’assistance.
- `tickets:write` — créer, traiter, mettre à jour ou fermer des tickets.
- `catalog:read` — consulter les produits, les options, les pays et le stock.
- `usage:read` — consulter l’utilisation et les diagnostics.
- `webhooks` — gérer les abonnements aux webhooks.

Commencez un audit de migration avec des autorisations en lecture seule. Ajoutez des autorisations en écriture ou financières uniquement après examen des modifications proposées.

## Comportement de sécurité

- Les outils financiers nécessitent `wallet:spend`.
- Les achats incluent le total prévu indiqué dans le devis. Une différence de prix entraîne le rejet de l’opération.
- Les opérations irréversibles nécessitent une confirmation explicite.
- Les nouvelles tentatives d’opérations financières utilisent une clé d’idempotence afin que la même opération ne soit pas facturée deux fois.
- L’inventaire en temps réel, l’éligibilité de l’offre et les autorisations du compte peuvent empêcher une opération par ailleurs valide.
- Le MCP FineProxy gère le compte client. Il n’obtient pas accès au code source, sauf si l’utilisateur accorde séparément à l’agent de programmation un accès à un dépôt.

## Modèle de configuration MCP

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

Stockez la véritable clé dans une variable d’environnement ou un gestionnaire de secrets. Ne la versionnez pas avec la configuration MCP.

## Liste de contrôle de compatibilité pour la migration

Examinez les éléments suivants dans l’intégration existante :

1. L’initialisation du client du fournisseur et tous les imports propres à ce fournisseur.
2. Les en-têtes d’authentification, les identifiants, les variables d’environnement et le stockage des secrets.
3. Les workflows d’achat, de renouvellement, de résiliation et de remplacement des IP.
4. Les identifiants de pays et les hypothèses relatives à l’inventaire.
5. Les formats de listes de proxys, les protocoles, les ports, les noms d’utilisateur, les mots de passe et l’autorisation des adresses IP.
6. La pagination et le filtrage.
7. Le comportement des nouvelles tentatives, la gestion des délais d’expiration et l’idempotence.
8. Les modèles d’erreur et la gestion des limites de débit.
9. Les analyses d’utilisation et les diagnostics.
10. La facturation, les factures et les dépôts.
11. L’intégration des tickets d’assistance.
12. Les webhooks et les hypothèses relatives aux charges utiles des événements.
13. Les tests, les données de test, les objets simulés et les secrets CI liés au fournisseur actuel.

Classez chaque workflow dans l’une des catégories suivantes :

- Compatible sans modification.
- Compatible moyennant une modification de configuration.
- Nécessite un adaptateur ou une transformation de données.
- Nécessite un workflow opérationnel différent.
- Non pris en charge ou non confirmé par la documentation actuelle.

## Résultat attendu de l’audit

L’audit doit inclure :

1. Un inventaire de chaque dépendance au fournisseur actuel.
2. Une évaluation de la compatibilité workflow par workflow.
3. Les autorisations FineProxy requises.
4. Les fichiers et chemins de code exacts à modifier.
5. Les modifications de l’authentification et de la gestion des secrets.
6. Les questions ouvertes nécessitant la spécification OpenAPI actuelle ou une confirmation de l’assistance.
7. Un plan de migration par étapes avec retour arrière.
8. Les tests d’intégration requis avant la mise en production.

Ne modifiez pas le code lors de la première passe d’audit.