Connecter un agent IA · TgPay Crypto API

Connectez un agent de développement IA compatible avec les serveurs MCP distants à https://app.tgpaycrypto.com/mcp. Il peut lire la documentation de l’API, demander la création d’une application marchande, configurer les webhooks et vous aider à écrire l’intégration. Vous approuvez la création dans le bot ; l’agent reçoit un token restreint sans que vous ayez à le recopier. Vérifiez et testez l’intégration avant d’accepter des paiements réels.

Cette URL est un serveur MCP (Model Context Protocol — la manière standard de connecter un service à un agent IA). Ouvrez-la dans un navigateur : elle décrit elle-même sa configuration.

Connecter le serveur

Utilisez la ligne qui correspond à votre outil :

Agent compatible avec les serveurs MCP distants — collez cette instruction :
```
Connecte le serveur MCP (https://app.tgpaycrypto.com/mcp) et intègre les paiements via l’API marchand.
```
Elle est prête à être copiée dans l’app, sous Plus → API marchand → Connecter un agent IA.
Claude Code — claude mcp add --transport http tgpay https://app.tgpaycrypto.com/mcp
claude.ai et Claude Desktop — ajoutez l’URL comme connecteur personnalisé en suivant les instructions de Claude.
ChatGPT et les autres clients MCP — ajoutez l’URL comme serveur MCP personnalisé si votre compte et votre espace de travail le permettent. Pour ChatGPT, suivez les instructions de configuration actuelles.

Pour commencer sur le testnet, utilisez https://testnet.tgpaycrypto.com/mcp. Le lien d’approbation ouvre @tgpaycrypto_testnet_bot et la documentation de l’API utilise l’URL de base du testnet.

Pas besoin d’un token d’API au préalable : l’agent obtient le sien à l’étape suivante. Si vous avez déjà créé une application à la main, créez un token restreint avec les seules permissions nécessaires dans “Accès et tokens”, puis utilisez-le pour l’intégration. Gardez le token principal sur votre serveur. Les permissions du token fourni manuellement déterminent ce que l’agent peut faire.

Approuver l’application

Demandez à l’agent de mettre en place les paiements. Il lit la documentation, puis demande votre approbation.
L’agent vous donne un lien t.me. Ouvrez-le — le bot affiche ce qui est demandé — et touchez ✅ Créer l’app et émettre le token.
Revenez à l’agent pour qu’il récupère son token et poursuive l’intégration. La création d’une application nécessite un compte admissible ; effectuez la vérification si elle vous est demandée.

Le lien vient toujours de votre agent, jamais du bot de sa propre initiative : tant que vous ne l’avez pas ouvert, le bot ignore de quel compte l’agent parle. Chaque lien ne sert qu’une fois. S’il cesse de fonctionner avant que vous ne l’ouvriez, demandez à l’agent de recommencer — rien n’est créé tant que vous n’avez pas approuvé.

Si vous touchez ❌ Refuser, rien n’est créé non plus et la demande est close : si vous changez d’avis, il faudra que l’agent en formule une nouvelle.

⚠️ N’approuvez qu’une demande que vous avez déclenchée

Une demande de connexion est une demande de création d’application sur votre compte. Ne l’approuvez que si vous venez de demander à votre propre agent de mettre en place les paiements. Si un lien vous parvient par un autre chemin — une discussion, un message transféré, une prétendue “assistance” — refusez-le.

Le token émis après cette approbation ne permet pas d’effectuer des transferts, de créer des chèques ni de rembourser des paiements (voir plus bas). Un token fourni manuellement peut avoir d’autres permissions. Une application que vous n’avez pas demandée n’a rien à faire sur votre compte.

Ce que l’agent peut faire, et ce qu’il ne peut pas

Le token émis par la procédure d’approbation ci-dessus est un token restreint :

Il peut créer des factures et des formules d’abonnement, lire votre solde, les taux de change et vos statistiques, et définir l’URL du webhook.
Il ne peut pas effectuer de transferts, émettre des chèques ni rembourser des paiements. Ces opérations exigent les permissions payouts, checks ou refunds correspondantes, ou un token principal avec accès complet. Le token émis par cette procédure n’a aucune de ces permissions.

Gardez ce token secret : ses permissions permettent de modifier les factures, les formules d’abonnement et l’URL du webhook. Le bot vous écrit chaque fois qu’un token est émis pour un agent et chaque fois que l’URL de webhook d’une application change.

Pour consulter les permissions du token de l’agent ou révoquer son accès, ouvrez Plus → API marchand, ouvrez l’application, puis Accès et tokens et Tokens restreints : Révoquer le désactive instantanément. L’application elle-même, son solde et son historique de paiements sont conservés. La valeur du token ne peut pas être consultée de nouveau. Un token ayant une date d’expiration cesse aussi de fonctionner à cette date.

Les signatures de webhook exigent votre token principal

L’agent peut faire pointer l’URL du webhook vers votre serveur, mais il ne peut pas vérifier ce qui y arrive : les livraisons sont signées avec le token principal de votre application, que l’agent ne voit jamais. Demandez à l’agent d’écrire le code de vérification et de laisser une valeur à remplacer — quelque chose comme TGPAY_WEBHOOK_TOKEN.

Pour le remplir : ouvrez Plus → API marchand, trouvez l’application créée par l’agent, ouvrez Accès et tokens, puis touchez Renouveler le token et copiez ce qui s’affiche — il n’est affiché qu’une seule fois. Placez-le dans les variables d’environnement de votre serveur, jamais dans la configuration de l’agent ni dans votre dépôt de code. Le renouvellement ne touche pas au token restreint de l’agent : l’intégration continue de fonctionner.

Les signatures basculent sur le nouveau token dès le renouvellement — faites-le donc avant la mise en production, plutôt qu’après votre premier vrai paiement.

Et ensuite

Démarrer en tant que développeur — la voie manuelle, et comment gérer une application une fois qu’elle existe.
Référence de l’API : webhooks — la forme des charges utiles, les nouvelles tentatives et le contrôle de signature.
Référence de l’API marchand — toutes les méthodes, y compris celles qu’un agent ne peut pas appeler.