ALPNAI / FIELD NOTES / 14.09.2026
Intégrer un agent MCP avec un budget et des achats rejouables
Le contrat du pilote ALPNAI : accès autorisé, budget fictif, clé d’idempotence et reçus persistants. Comprendre le parcours avant toute connexion commerciale.
Commencer par l’accès de test
Le parcours d’inscription utilise la connexion ChatGPT et un consentement explicite au pilote. Un compte inscrit reçoit une clé de test et un budget total de 1 USDC fictif. La clé est affichée lors de son émission et conservée sous forme d’empreinte. Renouveler une clé ne recrée pas le budget ; cette séparation évite de confondre rotation des accès et nouveau crédit.
Découvrir avant de commander
Le point d’entrée MCP est /api/mcp. Les outils get_catalog et get_free_sample présentent gratuitement le catalogue et la collection datée. Les outils purchase_snapshot, purchase_changes et purchase_evidence utilisent les mêmes contrôles de budget et d’autorisation que REST. Transmettez la clé dans Authorization: Bearer. Le mode sandbox est utilisé par défaut. Une demande explicite de mode live rejoint le parcours commercial et ses vérifications ; les encaissements restent fermés tant que ce parcours n’est pas activé.
Conserver l’identité du même achat
Chaque achat MCP demande idempotency_key : entre 8 et 100 lettres, chiffres, tirets ou traits de soulignement. Réutilisez la même valeur et les mêmes paramètres après une interruption. Le serveur retourne le reçu existant sans second débit fictif. Réutiliser cette valeur pour d’autres paramètres produit un conflit. Pour Change Set, since accepte une date valide au format YYYY-MM-DD.
Lire le reçu et les refus
Le reçu indique mode sandbox, settled: false et un revenu réel nul. Une clé inconnue ou révoquée, un budget insuffisant et une date invalide sont des refus à traiter. Un appel REST commercial reste indisponible tant que le paiement n’est pas activé. Les essais locaux du MCP et de l’inscription ont réussi ; ils ne prouvent ni une disponibilité publique ni un encaissement opérationnel.
Sources
ALPNAI — Contrat OpenAPI du pilote
Model Context Protocol — Publishing Remote Servers