La documentation de l’API CoinsSend est désormais prête pour les agents IA

Les assistants de programmation IA ne peuvent accélérer une intégration que s’ils s’appuient sur des sources précises et à jour. Nous avons entièrement remanié la documentation publique de l’API CoinsSend afin que les développeurs et les agents de programmation compatibles utilisent le même contrat vérifié, les mêmes exemples et les mêmes consignes de sécurité.

Cette version réunit un serveur MCP public en lecture seule, un document OpenAPI 3.1 canonique, un index de documentation adapté aux LLM, des vecteurs de test pour les signatures de requêtes et des contrôles automatisés renforcés. Elle permet d’explorer plus rapidement l’API et de préparer le code d’intégration, tout en laissant les identifiants et les opérations de paiement sous le contrôle du développeur.

Une source vérifiée pour les développeurs et les agents

La nouvelle couche documentaire fournit à chaque outil le format qui lui convient le mieux :

• MCP pour les agents de programmation. Un client compatible peut rechercher dans la documentation publique, récupérer une page précise, examiner une opération OpenAPI ou charger un schéma de composant.
• OpenAPI 3.1 pour les outils. Le contrat public peut servir à la génération de code, à la validation, à l’exploration de l’API et aux tests d’intégration.
• llms.txt et un manifeste de documentation. Les agents qui n’utilisent pas MCP peuvent découvrir les pages publiques canoniques sans parcourir des contenus sans rapport.
• Des vecteurs de test de signature exécutables. Les équipes peuvent vérifier le JSON canonique, les anciennes signatures MD5 et les signatures HMAC horodatées des retraits à l’aide de jeux de données publiés.
• Des exemples côté serveur et des prompts encadrés. La documentation comprend des exemples en PHP, JavaScript/Node.js et Python, ainsi que des prompts pour les tâches de paiement, de webhook et de sécurisation avant production.

Le contrat OpenAPI couvre volontairement un ensemble vérifié d’opérations publiques au lieu d’exposer les routes internes de l’application. Cette limite permet de conserver une interface lisible par machine qui soit utile et auditable.

Connecter un agent de programmation en quelques minutes

Le serveur de documentation distant est disponible à l’adresse https://api.coinssend.com/v1/docs/mcp. Les utilisateurs de Codex peuvent, par exemple, l’ajouter avec la commande suivante :

codex mcp add coinssend-docs --url https://api.coinssend.com/v1/docs/mcp

Aucune clé API CoinsSend n’est nécessaire pour cette connexion, car le serveur fournit uniquement de la documentation publique. Les autres clients MCP compatibles peuvent utiliser le même endpoint selon leur propre procédure de connexion. Toutes les instructions de configuration figurent dans le guide MCP.

Ce qu’un agent peut vous aider à faire

Une fois le serveur de documentation connecté, un agent de programmation peut :

1. rechercher le parcours pertinent, par exemple les factures, les portefeuilles statiques, les webhooks, les retraits, les frais, les soldes ou les taux des cryptomonnaies ;
2. récupérer la page exacte de la documentation publique au lieu de s’appuyer sur une recherche web générale ;
3. rechercher une opération par son operationId et examiner ses schémas de requête, de réponse, d’authentification et d’erreur ;
4. utiliser les jeux de données de signature publiés pour tester l’implémentation de signature de l’application ;
5. préparer du code d’intégration côté serveur et des tests qu’un ingénieur pourra ensuite vérifier et exécuter.

Si vous devez choisir entre plusieurs modèles de paiement avant l’implémentation, notre guide comparant les portefeuilles statiques et les factures explique les compromis à considérer selon le produit. La documentation conçue pour les agents fournit ensuite le contrat API exact correspondant au parcours choisi.

Une limite de sécurité clairement définie

Le serveur MCP fonctionne en lecture seule. Il ne peut ni créer une facture, ni générer un portefeuille, ni déclencher un retrait, ni accéder à un compte marchand, ni recevoir des identifiants marchands. Ses outils sont limités à un corpus vérifié de documentation publique et sont conçus pour être non destructifs et idempotents.

Le code d’intégration doit toujours résider sur un serveur de confiance. Conservez les clés marchandes dans des variables d’environnement protégées ou dans un gestionnaire de secrets, signez les requêtes côté serveur, vérifiez les signatures des webhooks à partir du corps brut de la requête et relisez le code généré avant de l’exécuter. Les requêtes d’écriture doivent respecter la stratégie de nouvelle tentative documentée et ne doivent jamais être relancées à l’aveugle.

OpenAPI, vecteurs de test et accès direct

Les mêmes sources sont disponibles sans MCP :

• le contrat OpenAPI 3.1 pour les opérations et les schémas lisibles par machine ;
• llms.txt pour un index compact destiné aux agents ;
• le manifeste de documentation pour le corpus public canonique ;
• les vecteurs de test de signature pour des contrôles de signature interopérables ;
• les prompts d’intégration IA pour structurer les tâches d’implémentation et de vérification.

Une équipe peut ainsi utiliser un agent compatible MCP, importer OpenAPI dans sa chaîne d’outils existante ou travailler directement à partir de la documentation, tout en conservant une source de référence unique.

Des contrôles qui maintiennent le contrat aligné

Les modifications de la documentation passent désormais par des contrôles automatisés de cohérence, le linting OpenAPI, la détection des changements incompatibles et des tests du contrat d’exécution qui comparent la spécification publiée aux routes, contrôleurs et middlewares publics réels. Des tests distincts couvrent le serveur MCP, le corpus documentaire, les signatures de requêtes et la synchronisation gérée avec OpenAI Vector Store utilisée par l’assistant de documentation CoinsSend.

Le processus de synchronisation prépare et vérifie un nouveau corpus public avant de retirer les anciens fichiers gérés. Les verrous, la pagination, les délais d’expiration, les contrôles de propriété et le nettoyage réduisent le risque de publier un corpus partiel ou non souhaité.

Commencer par le parcours, puis vérifier les détails

Ouvrez le guide de démarrage, connectez le serveur de documentation si votre agent de programmation prend en charge MCP, puis décrivez le parcours de paiement que vous souhaitez mettre en place. Demandez à l’agent de citer la page de documentation exacte, l’opération OpenAPI et le schéma qu’il a utilisés. Relisez ensuite le résultat, exécutez les jeux de données de signature et les tests, puis validez l’intégration dans votre propre environnement.

Cette version ne transforme pas l’intégration des paiements en une action non vérifiée réalisable en un clic. Elle offre aux développeurs et à leurs outils un moyen plus rapide et plus fiable d’accéder au bon contrat et de développer en s’appuyant sur celui-ci.