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. Quel que soit son token, l’agent peut uniquement recevoir des paiements par le serveur MCP (voir plus bas).

Pour transmettre ce token au serveur MCP, ajoutez le serveur dans les paramètres de connexion de votre client avec l’en-tête TgPayCrypto-API-Token: <token> (ou Authorization: Bearer <token>). L’étape d’approbation n’est alors pas nécessaire. Tous les clients n’ont pas de champ pour des en-têtes personnalisés (les connecteurs de claude.ai et de ChatGPT n’en ont pas, et le serveur ne propose pas de connexion OAuth) ; dans ce cas, utilisez l’approbation décrite plus bas. L’agent peut aussi fournir un token dans l’argument api_token d’un appel d’outil, si son client lui permet d’envoyer un argument que l’outil ne déclare pas.

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.

L’application et le token de l’agent sont créés lorsque l’agent consulte à nouveau la demande après votre approbation — en général en quelques secondes. La demande reste valable 10 minutes à partir du moment où l’agent la crée : si l’agent ne la consulte pas à temps, rien n’est créé, même si le bot a déjà confirmé votre choix, et l’agent doit recommencer. La création d’une application nécessite un compte admissible ; si une vérification est nécessaire, l’agent reçoit une erreur lors de cette consultation — effectuez la vérification et demandez à l’agent de consulter à nouveau la demande dans les mêmes 10 minutes, ou de recommencer.

En approuvant la demande, vous acceptez les conditions d’utilisation de l’API marchand pour l’application ainsi créée, comme lorsque vous créez une application dans la Mini App.

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. Tant que vous n’avez touché aucun bouton, rouvrir le lien affiche la même demande ; après ✅ Créer l’app et émettre le token ou ❌ Refuser, ou au bout de 10 minutes, le lien cesse de fonctionner. 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.

Aucun token ne permet d’effectuer des transferts, de créer des chèques ni de rembourser des paiements par le serveur MCP, y compris celui émis après cette approbation (voir plus bas). 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 et supprimer des factures, créer et archiver des formules d’abonnement, résilier l’abonnement d’un abonné, lire votre solde, les taux de change et vos statistiques, et modifier l’URL du webhook et le nom de l’application.
Il ne peut pas effectuer de transferts, émettre des chèques ni rembourser des paiements : le token n’a aucune des permissions payouts, checks ou refunds.

Le serveur MCP impose aussi sa propre restriction : les outils qui permettent de débiter le solde de l’application — transfer, transferBatch, createCheck et refundInvoice — sont actuellement désactivés. L’agent ne les voit pas et tout appel est rejeté, même avec le token principal donnant un accès complet. Ainsi, ni un token de l’agent divulgué ni une instruction malveillante cachée dans un texte qu’il lit, par exemple le commentaire d’un payeur, ne permettent de débiter le solde de votre application par MCP.

Les transferts, les chèques et les remboursements restent disponibles directement par l’API : appelez /pay/api depuis le code de votre serveur avec un token ayant la permission payouts, checks ou refunds, selon l’opération. Pour envoyer des paiements, vous pouvez aussi ouvrir Plus → API marchand, choisir votre application, puis Paiements.

Gardez ce token secret : ses permissions permettent de modifier les factures, les formules d’abonnement, les abonnements, l’URL du webhook et le nom de l’application. 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. Confirmez le renouvellement avec votre PIN ou Face ID. Une application créée par l’agent peut appartenir à un compte sans PIN, mais le renouvellement exige un PIN actif. Définissez-le d’abord dans Sécurité, puis attendez son activation.

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.