Votre compte et votre accès API¶
Connectez-vous avec votre adresse e-mail et votre mot de passe, Google ou votre compte Orvel. Votre espace affiche votre quota et les opérations restantes. Les achats effectués depuis cet espace sont liés à votre compte ; une nouvelle connexion ne réinitialise ni l’essai ni les crédits achetés.
Connexion par compte¶
Ajoutez https://facturx.orvel.dev/mcp/account à un client MCP compatible OAuth, choisissez Authenticate, connectez-vous et autorisez la connexion. Une session Orvel existante peut éviter une nouvelle saisie des identifiants. La connexion utilise le quota sélectionné dans votre espace. Consultez la configuration MCP pour les étapes propres à chaque client.
API REST et clés existantes¶
Utilisez le bouton d’affichage de la clé API dans votre espace pour obtenir une clé destinée à l’API REST. Une nouvelle connexion peut être demandée avant son affichage. Gardez cette clé privée.
Les clés existantes restent utilisables. La section ci-dessous prend également en charge les anciens liens de retour de paiement, dont l’accès est limité dans le temps ; elle n’est pas nécessaire pour la connexion par compte.
Utilisation¶
REST : https://facturx.orvel.dev/v1/... — MCP : https://facturx.orvel.dev/mcp. Exemples : Démarrage rapide, MCP.
Consommation : GET /v1/usage avec le même en-tête.
Gérer l’abonnement¶
Pour un abonnement mensuel, ouvrez la gestion de facturation depuis votre espace : plan, résiliation, factures et moyen de paiement. Si plusieurs quotas sont enregistrés, sélectionnez d’abord l’abonnement. Une clé d’abonnement existante peut aussi être utilisée dans le formulaire ci-dessous.
Les crédits prépayés n’ont ni abonnement ni recharge automatique. Chaque achat de 10 EUR ajoute 100 opérations au même solde, sans expiration. L’abonnement mensuel dispose d’un quota distinct ; changer de plan ne supprime pas les crédits prépayés inutilisés. Les clés API statiques restent liées à leur quota d’origine.
Les anciens packs évaluation de 3 EUR conservent leurs 25 opérations et leur expiration à 30 jours. Ils ne sont plus proposés à l’achat. Pour un reçu ou une question de facturation : antoine.le.borgne@orvel.dev.
Clients utilisant une clé API statique¶
Si un ancien lien de retour de paiement affiche une clé ci-dessus, ses boutons copient la configuration pour Cursor (.cursor/mcp.json), VS Code (.vscode/mcp.json) ou Claude Desktop (claude_desktop_config.json, avec Node.js installé). Gardez ces fichiers contenant la clé privés. Reconnectez votre client après enregistrement. Pour la connexion par compte, utilisez /mcp/account comme indiqué ci-dessus.
Cliquez sur Vérifier la clé et la connexion MCP : contrôle du quota et découverte des outils sans consommer d’opération. Demandez ensuite à l’assistant d’appeler get_invoice_example puis de générer cet exemple en cii-xml. Ce premier document utilise une opération. Voir la configuration MCP.