Connecter un assistant IA

Heth MCP donne à un assistant un accès limité à votre propre compte, y compris aux fonctions professionnelles disponibles. Il ne donne aucun droit d’administration de la plateforme. Ouvrir une page ne donne aucune autorisation.

Connecter un assistant

Dans l’application Heth où votre portefeuille est déjà ouvert, allez dans Paramètres → Connexions IA et créez un code de connexion. Ce code à usage unique appartient exactement à ce compte et expire après cinq minutes.
Ajoutez https://mcp.heth.me/mcp dans le client IA, choisissez OAuth et démarrez la connexion.
Dans la fenêtre de connexion, saisissez uniquement le code de Heth. Il n’est pas nécessaire de se connecter au portefeuille dans ce navigateur. Le code adresse une demande au compte qui l’a créé ; il n’accorde aucun accès.
Ouvrez la notification dans Heth. Sans notification, ouvrez Paramètres → Connexions IA → Demandes de connexion. Comparez le code de vérification de la demande avec la fenêtre de connexion. Vérifiez le compte, l’identifiant du client et l’adresse du service ; le nom seul ne prouve pas l’identité.
Dans Heth, décochez les autorisations inutiles et approuvez la sélection, ou refusez l’accès. Ouvrir la notification ne confirme rien.
Revenez au client IA. Sa fenêtre termine automatiquement la connexion après votre décision. La session du portefeuille et les clés restent dans Heth.

Un code utilisé ou expiré ne peut pas être réutilisé. Créez-en un nouveau dans Heth ; il remplace le précédent code inutilisé. Une demande de connexion expirée doit être relancée depuis le client IA.

Dans ChatGPT

Ouvrez Plugins → Add → Add custom MCP server, indiquez un nom comme Heth.me et l’adresse ci-dessus, puis gardez OAuth. ChatGPT découvre automatiquement les paramètres ; aucune clé API du portefeuille, aucun client secret ni phrase de récupération ne sont nécessaires. Créez le plugin personnel, choisissez Connect Heth.me et suivez les étapes avec code et notification. Les autorisations par défaut se règlent dans Advanced OAuth settings ; le choix final est confirmé dans l’application Heth.

Sélectionnez ensuite Heth.me dans le chat et essayez : « Affiche les soldes de mes portefeuilles via Heth ». Les outils disponibles dépendent des autorisations approuvées.

Autorisations et outils

Seules les autorisations demandées et actuellement disponibles pour votre compte peuvent être accordées. Les outils sont proposés selon ces droits. Les outils couvrent les données du compte, les transferts, les modifications commerciales ordinaires, les demandes d’abonnement et OBS.

Autorisation	Outils et usage
`heth:wallets:read`	`get_wallet_balances` : soldes de vos portefeuilles
`heth:transactions:read`	`list_transactions`, `get_transaction` : votre historique et le statut original des opérations
`heth:business:read`	`list_products`, `list_business_payment_links`, `list_business_subscriptions` : vos produits, liens de paiement gérés et abonnements marchands; `get_business_subscription`, `list_business_subscription_requests` : accord individuel et demandes envoyées
`heth:payments:prepare`	`prepare_transfer`, `get_transfer_request` : préparer un transfert à confirmer dans Heth et vérifier le résultat initial
`heth:business:manage`	`create_business_product`, `update_business_product`, `delete_business_product` ; `create_business_payment_link`, `update_business_payment_link`, `delete_business_payment_link` : modifications ordinaires confirmées dans le client IA
`heth:business:manage`	`request_business_subscription` : demander l’accord du payeur dans Heth ; `prepare_business_subscription_change` : vérifier une pause, reprise ou annulation dans Heth
`heth:obs:read`	`get_obs_widget`, `list_obs_events` : réglages et événements entrants
`heth:obs:configure`	`prepare_obs_connection`, `update_obs_widget` : lien de validation dans Heth ou présentation avec confirmation dans le client IA

prepare_obs_connection n’accorde aucun accès et ne renvoie aucun jeton OBS. Une modification de présentation ne peut changer ni devise, ni réseau, ni destinataire, ni clés, ni droits d’accès. Consultez le guide OBS et personnalisation, avec le code ouvert et les instructions pour les assistants de programmation.

Durée et révocation

Votre autorisation reste valable jusqu’à sa révocation. Les jetons techniques expirent séparément : 15 minutes pour l’accès MCP ; les jetons de renouvellement sont remplacés à chaque renouvellement et expirent après 30 jours sans renouvellement. Une reconnexion peut alors être nécessaire même si le consentement reste enregistré.

Chaque requête vérifie le consentement et les droits actuels du compte. Heth utilise un jeton API distinct et limité, valable au maximum 60 secondes ; la session complète du portefeuille n’est pas transmise à MCP. Une révocation ou un retrait de droits bloque les requêtes suivantes, même avec des jetons non expirés. Les données déjà reçues par le client ne peuvent être rappelées.

Dans Heth, ouvrez Paramètres → Connexions IA, vérifiez l’identifiant du client, l’adresse, les droits et le statut. Révoquez l’accès et confirmez dans Heth. Cela n’annule ni les paiements terminés ni les mandats de prélèvement des abonnements ; gérez-les séparément dans les paramètres des abonnements.

Si une reconnexion est demandée, relancez l’autorisation depuis le client IA. Une révocation, des jetons expirés, un retrait de droits ou la réutilisation détectée d’un jeton de renouvellement peuvent arrêter l’accès. Ne transmettez jamais de phrase de récupération, de clés du portefeuille ou de session du navigateur pour réparer la connexion. Un service indisponible est une erreur, pas un compte vide ni une autorisation réussie.

Paiements et modifications

Heth impose une confirmation distincte dans Heth pour chaque opération monétaire. L’autorisation de connexion ne permet pas les prélèvements automatiques.

Les modifications ordinaires des produits et liens de paiement nécessitent une confirmation dans le client IA. Les droits, destinataires de versements et autorisations de futurs prélèvements exigent une confirmation dans Heth. La présentation OBS suit la confirmation du client. Une annotation d’outil seule ne prouve pas que le consentement a été recueilli.

Vous pouvez aussi utiliser l’application Heth ou une intégration API prise en charge.

Effectuer un transfert avec un assistant

Indiquez le type, le destinataire, la devise, le réseau et le montant. hot_hot transfère entre comptes internes, hot_cold vers une adresse blockchain, cold_hot depuis la blockchain vers votre propre compte interne et cold_cold entre adresses blockchain. Pour cold_hot, le destinataire est self.
prepare_transfer enregistre les conditions et renvoie un lien de vérification Heth, sans créer de paiement. Le montant et max_debit sont des chaînes entières exactes en unités minimales du jeton. max_debit limite le débit du jeton, frais de plateforme compris. Pour une source blockchain, max_network_fee limite les frais de gaz en wei (ETH/Base) ou sun (TRON). Base peut aussi facturer des frais de données L1.
Dans Heth, vérifiez le compte, le client IA, le destinataire, la source, le montant, le réseau et les plafonds de frais. Choisissez Confirmer et envoyer dans Heth seulement si tout est correct. Ouvrir le lien n’autorise ni n’envoie rien. La demande expire après 15 minutes.
Heth signe l’instruction affichée et utilise son transfert habituel. La transaction blockchain est signée sur votre appareil ou un appareil de signature connecté. Ouvrez Heth là où la source peut être signée. L’assistant ne reçoit jamais vos clés privées.
L’assistant utilise get_transfer_request pour lire la transaction initiale. Une approbation ou un traitement en cours ne signifie pas que les fonds sont arrivés. Après un délai d’attente, vérifiez le résultat initial. Réutilisez la même request_id et les mêmes conditions pour répéter une préparation ; ne créez pas un second transfert pour vérifier le premier.

La révocation bloque le démarrage de nouveaux transferts. Une transaction déjà acceptée pour exécution peut encore aboutir : révoquer la connexion IA n’annule pas un transfert blockchain accepté.

Produits, liens et abonnements

L’assistant présente les modifications ordinaires de produits ou de liens de paiement pour confirmation dans le client IA. Prix et montants sont des chaînes entières en unités minimales ; les quantités sont des entiers positifs. Une request_id stable évite les modifications en double lors d’une nouvelle tentative. Ces outils ne modifient ni routage, ni bénéficiaires de versements, ni clés, ni droits d’accès. Supprimer un produit ou un lien ne rembourse pas un paiement antérieur.

request_business_subscription crée une demande à vérifier par le payeur dans Heth. La demande seule ne donne aucun droit de prélèvement futur et ne crée aucun paiement. Avant de signer, le payeur vérifie montant, fréquence et premier prélèvement. list_business_subscription_requests affiche les demandes ; get_business_subscription et list_business_subscriptions lisent les accords existants.

prepare_business_subscription_change renvoie l’écran Heth pour suspendre, reprendre ou annuler un accord. Rien ne change avant la confirmation du propriétaire. La reprise permet les prélèvements programmés couverts par l’autorisation existante. L’annulation arrête les prélèvements futurs sans rembourser ceux déjà effectués. De nouvelles conditions nécessitent un nouvel accord du payeur.