Articles dans cette section

Afficher plus

MCP Hotmart : comment consulter mes données et effectuer des actions sur mon compte avec l’IA ?

Avatar
PAULA S.
  • Mise à jour
S’abonner

Le MCP Hotmart vous permet de connecter votre compte Hotmart à des outils d’intelligence artificielle compatibles, comme Claude Desktop et ChatGPT Desktop.

Une fois MCP Hotmart configuré, vous pouvez consulter les informations de votre compte directement depuis l’assistant, notamment vos ventes, abonnements, produits, élèves et commissions. L’intégration permet également d’effectuer certaines actions, comme créer des coupons ou modifier des abonnements, toujours selon les autorisations de votre profil.

Dans cet article, vous découvrirez comment fonctionne MCP Hotmart, ce que vous pouvez faire avec lui et comment le configurer dans l’assistant que vous utilisez.

 

Qu’est-ce que MCP Hotmart ?

MCP signifie Model Context Protocol (protocole de contexte de modèle). Ce protocole permet aux assistants d’intelligence artificielle de se connecter à des sources de données externes, comme des systèmes, des applications et des plateformes.

Dans le cas de Hotmart, MCP Hotmart établit cette connexion entre l’assistant d’IA et votre compte. Une fois l’intégration configurée, vous pouvez poser des questions et faire des demandes en utilisant un langage simple, sans avoir à utiliser de commandes techniques. Par exemple, vous pouvez demander combien vous avez vendu sur une période donnée ou demander des informations sur un abonnement.

Lorsque vous envoyez une demande, l’assistant consulte les informations directement dans Hotmart et utilise ces données pour répondre. Les requêtes sont effectuées en temps réel et dépendent d’une clé d’accès personnelle créée et autorisée par vous.

Pour le fonctionnement de l’intégration, Hotmart n’envoie ni ne stocke les données de votre compte dans une base externe.

MCP Hotmart est compatible avec :

  • Claude Desktop (macOS et Windows)
  • ChatGPT Desktop (macOS et Windows)
  • Autres clients MCP, comme les IDE et les agents personnalisés, via une configuration manuelle.

 

Que puis-je faire avec MCP Hotmart ?

MCP Hotmart accepte deux principaux types de commandes : requêtes, utilisées pour rechercher et analyser des informations, et actions, qui modifient des données ou exécutent des opérations sur le compte.

❯ Consulter des données et des indicateurs

Vous pouvez demander des informations liées aux activités de votre compte, notamment les ventes, abonnements, produits, élèves, coupons et commissions.

Par exemple, vous pouvez faire des demandes comme :

  • « Combien ai-je vendu aujourd’hui ? »
  • « Comparez mes ventes de ce mois avec celles du mois dernier. »
  • « Quel produit a le taux de conversion le plus élevé ? »
  • « Combien d’élèves ont rejoint le groupe cette semaine ? »
  • « Affichez l’historique de l’abonné abonne@email.com. »
  • « Créez un résumé hebdomadaire de mes ventes. »

Vous pouvez également demander des analyses combinant différents types d’informations, comme la comparaison entre périodes, le produit le plus vendu, le panier moyen ou le taux de remboursement. Dans ce cas, l’assistant peut organiser les données trouvées et présenter une réponse en fonction de votre demande.

Pour obtenir des résultats plus proches de ce que vous recherchez, incluez dans votre demande des informations comme la période, le produit et l’indicateur. Par exemple, au lieu de demander seulement « comment se passent mes ventes ? », vous pouvez préciser le produit et la plage de dates à analyser.

❯ Effectuer des actions sur mon compte

En plus des requêtes, MCP Hotmart peut effectuer certaines opérations, comme :

  • Créer et supprimer des coupons de réduction
  • Annuler et réactiver des abonnements
  • Modifier la date d’échéance d’un abonnement
  • Annuler des ventes et émettre des remboursements

 

Attention: les actions qui modifient les données de votre compte doivent être confirmées avant leur exécution. L’assistant présente ce qui sera fait et attend votre autorisation. Vérifiez donc les informations affichées avant de confirmer.

 

Comment configurer MCP Hotmart ?

La configuration dépend de l’assistant ou du client MCP que vous utilisez. Vous pouvez également accéder à la page MCP Hotmart pour consulter les options disponibles et suivre les étapes d’installation selon l’outil utilisé.

Vous trouverez ci-dessous les instructions pour chaque option :

❯ Comment le configurer dans Claude Desktop ?

Avant l’installation, assurez-vous d’avoir Claude Desktop installé sur votre ordinateur. Sous Windows, vous devez également avoir Node.js installé pour que le connecteur fonctionne.

Étape 1 : Téléchargez le fichier du connecteur

  1. Accédez à la page MCP Hotmart.
  2. Sélectionnez Claude Desktop.
  3. Choisissez votre système d’exploitation : macOS ou Windows.
  4. Cliquez sur Télécharger le connecteur pour obtenir le fichier hotmart.mcpb.
  5. Sur macOS, ouvrez le fichier téléchargé. Claude Desktop se lancera pour installer le connecteur.
  6. Sous Windows, ouvrez Claude Desktop et accédez à Paramètres > Extensions > Paramètres avancés. Cliquez sur Installer l’extension et sélectionnez le fichier hotmart.mcpb.

Étape 2 : Créez votre clé d’accès Hotmart

  1. Accédez à votre compte Hotmart via le lien https://app.hotmart.com/.
  2. Dans le menu latéral, sélectionnez Outils > Tout afficher.
  3. Recherchez Identifiants Hotmart et cliquez sur Créer un identifiant.
  4. Sélectionnez MCP Hotmart.
  5. Choisissez Claude comme assistant.
  6. Donnez un nom à l’identifiant pour pouvoir l’identifier, par exemple : « MCP Claude ».
  7. Confirmez la création et copiez la clé générée.

Conservez cette clé, car elle sera utilisée pour autoriser la connexion.

Étape 3 : Ajoutez la clé à Claude Desktop

  1. Dans Claude Desktop, ouvrez Paramètres et accédez à l’onglet Connecteurs.
  2. Recherchez Hotmart.
  3. Collez votre clé dans le champ d’authentification.
  4. Cliquez sur Enregistrer.

Après cette configuration, le connecteur sera disponible dans les conversations compatibles avec Claude Desktop.

❯ Comment le configurer dans ChatGPT Desktop ?

Avant l’installation, assurez-vous d’avoir ChatGPT Desktop installé sur votre ordinateur. Le processus est le même pour macOS et Windows.

Étape 1 : Créez votre clé d’accès Hotmart

  1. Accédez à votre compte Hotmart via le lien https://app.hotmart.com/.
  2. Dans le menu latéral, sélectionnez Outils > Tout afficher.
  3. Recherchez Identifiants Hotmart et cliquez sur Créer un identifiant.
  4. Sélectionnez MCP Hotmart.
  5. Choisissez ChatGPT comme assistant.
  6. Donnez un nom à l’identifiant pour pouvoir l’identifier, par exemple : « MCP ChatGPT ».
  7. Confirmez la création et copiez la clé générée.

Conservez cette clé, car elle sera utilisée pour autoriser la connexion.

Étape 2 : Configurez le serveur MCP dans ChatGPT

  1. Dans ChatGPT Desktop, ouvrez Paramètres.
  2. Dans le menu Intégrations, sélectionnez Plugins.
  3. Cliquez sur Ajouter puis Ajouter un serveur MCP.
  4. Renseignez les champs ci-dessous :
    • Nom: MCP Hotmart ou un autre nom de votre choix
    • Type: HTTP avec streaming
    • URL: https://developers.hotmart.com/mcp/v1
    • En-tête — Clé: Authorization
    • En-tête — Valeur: Basic VOTRE_TOKEN (remplacez VOTRE_TOKEN par la clé créée dans Hotmart et conservez le préfixe Basic)
  5. Cliquez sur Enregistrer.

Après la configuration, le connecteur est disponible dans le mode Work de ChatGPT.

❯ Comment le configurer dans un IDE, un agent personnalisé ou un autre client MCP ?

Pour les autres clients MCP, la configuration est manuelle et peut nécessiter une certaine familiarité avec les fichiers de configuration.

Étape 1 : Créez votre clé d’accès Hotmart

  1. Accédez à votre compte Hotmart via le lien https://app.hotmart.com/.
  2. Dans le menu latéral, sélectionnez Outils > Tout afficher.
  3. Recherchez Identifiants Hotmart et cliquez sur Créer un identifiant.
  4. Sélectionnez MCP Hotmart.
  5. Choisissez Autres comme assistant.
  6. Donnez un nom à l’identifiant pour pouvoir l’identifier, par exemple : « MCP dans mon IDE ».
  7. Confirmez la création et copiez la clé générée.

Conservez cette clé, car elle sera utilisée pour autoriser la connexion.

Étape 2 : Déclarez le serveur dans votre client MCP

  1. Ouvrez le fichier de configuration des serveurs MCP de votre IDE ou de votre assistant.
  2. Ajoutez la configuration du serveur à l’objet correspondant. Dans de nombreux clients, il est identifié comme mcpServers.
  3. Insérez la clé créée dans Hotmart à l’emplacement indiqué, en conservant le préfixe Basic.
  4. Enregistrez le fichier.
  5. Redémarrez le client pour charger la nouvelle configuration.

 

Comment fonctionnent la sécurité et les autorisations de MCP Hotmart ?

L’accès à MCP Hotmart se fait au moyen d’un identifiant créé dans votre compte. Cette clé est personnelle et doit être traitée comme un mot de passe ; elle ne doit donc pas être partagée.

Les autorisations de MCP suivent les autorisations déjà existantes dans votre profil Hotmart. Cela signifie que l’intégration n’étend pas les accès de votre compte : si votre profil n’a pas l’autorisation de consulter une information ou d’effectuer une action, MCP ne pourra pas non plus l’exécuter.

Si vous travaillez avec des collaborateurs, chaque personne doit créer et utiliser son propre identifiant. Partager une clé signifie permettre à une autre personne d’utiliser les accès associés à ce profil.

De plus, certains contrôles permettent de sécuriser l’utilisation de l’intégration :

  • Clé révocable : vous pouvez révoquer un identifiant à tout moment depuis la Plateforme Hotmart, par exemple lorsque vous changez d’ordinateur ou lorsque vous ne l’utilisez plus. Pour cela, accédez à Identifiants Hotmart, repérez la clé que vous souhaitez révoquer et supprimez l’identifiant. La révocation est immédiate et interrompt l’accès de l’assistant à votre compte.
  • Confirmation des actions : chaque fois qu’une opération modifie des données du compte, comme la création d’un coupon, l’annulation d’un abonnement ou l’émission d’un remboursement, l’assistant présente ce qui sera fait et vous demande de confirmer avant l’exécution.
  • Identifiants séparés : si vous utilisez MCP sur plusieurs appareils ou outils, privilégiez la création d’un identifiant pour chaque usage. Cela facilite l’identification et la révocation du seul accès nécessaire.

 

Quelles précautions dois-je prendre lorsque j’utilise MCP Hotmart ?

Pour utiliser MCP Hotmart de manière plus sûre et obtenir des réponses plus précises, tenez compte des recommandations ci-dessous :

  • Faites des demandes précises. Dans la mesure du possible, indiquez la période, le produit et le type d’information que vous souhaitez consulter. Au lieu de demander simplement « comment se passent mes ventes ? », par exemple, vous pouvez demander « combien de ventes ai-je réalisées pour le produit X entre le 1er et le 31 août ? ». Plus vous fournissez de détails, plus l’assistant saura clairement quelles données doivent être prises en compte.
  • Vérifiez les informations importantes dans Hotmart. L’assistant consulte les données disponibles dans Hotmart, mais il peut interpréter les filtres, périodes ou critères différemment de ce qui est attendu. Si l’information doit être utilisée pour une décision financière, comptable ou liée aux versements, consultez également les données directement dans votre compte Hotmart.
  • Vérifiez les informations avant de confirmer une action. Lorsque vous demandez une opération qui modifie les données du compte, vérifiez le résumé présenté par l’assistant avant d’autoriser l’exécution. Cela est particulièrement important pour les actions comme les remboursements, les annulations d’abonnements et la création de coupons.
  • Maintenez l’assistant à jour. Utilisez des versions à jour de Claude Desktop, ChatGPT Desktop ou du client MCP choisi. Les mises à jour peuvent inclure des corrections et améliorations qui affectent le fonctionnement de l’intégration.

 

Questions fréquentes

❯ Dois-je savoir programmer pour utiliser MCP Hotmart ?

Non. Il n’est pas nécessaire de savoir programmer pour utiliser MCP Hotmart dans Claude Desktop ou ChatGPT Desktop. En revanche, la configuration dans des IDE, des agents personnalisés ou d’autres clients MCP peut nécessiter une certaine familiarité avec les fichiers de configuration.

❯ Mes collaborateurs peuvent-ils utiliser MCP Hotmart ?

Oui. Chaque collaborateur doit créer son propre identifiant sur la Plateforme Hotmart. MCP utilise les autorisations liées au profil de chaque personne ; un collaborateur pourra donc uniquement consulter les informations ou effectuer les actions auxquelles il a déjà accès dans le compte.

Les identifiants sont personnels et ne doivent pas être partagés. Si un collaborateur utilise l’identifiant d’un autre profil, il aura accès aux autorisations associées à cette clé.

Si un collaborateur n’a plus besoin d’utiliser MCP, il peut supprimer lui-même son identifiant sur la Plateforme Hotmart. Si le Producteur doit couper immédiatement l’accès d’un collaborateur, il doit dissocier de son compte l’accès collaborateur de cette personne. Cette action suffit pour que son identifiant cesse d’accorder des autorisations de consultation et d’exécution dans MCP.

❯ Mes collaborateurs doivent-ils suivre les mêmes étapes pour utiliser MCP Hotmart ?

Oui. Le processus de configuration est exactement le même. Chaque collaborateur doit suivre les étapes d’installation et de création de l’identifiant dans son propre compte d’accès sur la Plateforme Hotmart. La seule différence concerne le niveau d’autorisation : MCP respecte les autorisations liées au profil de chaque personne. Autrement dit, un collaborateur ne pourra consulter que les informations ou effectuer que les actions auxquelles il a déjà accès dans le compte sur lequel il intervient.

❯ Comment déconnecter MCP Hotmart de mon compte ?

Le processus varie selon l’assistant utilisé :

  • Dans Claude Desktop, supprimez l’extension MCP Hotmart dans les paramètres.
  • Dans ChatGPT Desktop, supprimez le serveur MCP dans Paramètres > Intégrations > Plugins.

Pour interrompre également l’autorisation d’accès à votre compte, accédez à Outils > Tout afficher > Identifiants Hotmart dans Hotmart, repérez l’identifiant utilisé par MCP et supprimez-le. La révocation est immédiate et interrompt l’accès de l’assistant à votre compte.

❯ MCP Hotmart est-il gratuit ?

Oui, MCP Hotmart est gratuit pour les Producteurs disposant d’un compte Hotmart. La seule condition est d’avoir Claude Desktop ou ChatGPT Desktop installé sur votre ordinateur.

❯ Dois-je avoir un compte payant auprès de l’assistant d’IA (ChatGPT, Claude, etc.) pour utiliser MCP Hotmart ?

Cela dépend de l’assistant :

  • Claude Desktop : fonctionne avec les comptes gratuits.
  • ChatGPT Desktop : nécessite un forfait payant donnant accès au mode Work, dans lequel la configuration du serveur MCP est effectuée.

Si vous utilisez d’autres clients MCP (comme des IDE ou des agents personnalisés), les conditions d’utilisation suivent les politiques de chaque outil.

❯ Hotmart stocke-t-il les données de mes conversations avec l’assistant d’IA ?

Les conversations sont stockées uniquement par l’assistant lui-même (Claude ou ChatGPT), conformément aux politiques de chaque plateforme. Vous pouvez conserver ou supprimer librement l’historique dans les paramètres de l’IA. Hotmart n’a pas accès au contenu des conversations, uniquement aux appels effectués vers son API, enregistrés dans les journaux standard de la Plateforme.

❯ Est-il sûr de connecter mon compte Hotmart à un assistant d’IA ?

L’accès se fait au moyen d’un identifiant personnel créé dans votre compte Hotmart et peut être révoqué à tout moment. De plus, MCP respecte les autorisations de votre profil.

Lorsque vous demandez une action qui modifie des informations du compte, comme créer un coupon, annuler un abonnement ou émettre un remboursement, l’assistant présente ce qui sera fait et demande votre confirmation avant d’exécuter l’opération.

❯ Puis-je utiliser MCP Hotmart avec d’autres assistants d’IA ?

MCP Hotmart dispose d’instructions de configuration documentées pour Claude Desktop et ChatGPT Desktop. Il est également possible de l’utiliser dans des IDE, des agents personnalisés et d’autres clients compatibles avec MCP via une configuration manuelle.

❯ J’ai plusieurs comptes Hotmart. Puis-je utiliser MCP avec chacun d’eux ?

Oui, mais MCP se connecte à un seul compte Hotmart à la fois. Pour utiliser un autre compte, vous devez remplacer, dans les paramètres de l’assistant, l’identifiant lié au compte actuel par celui de l’autre compte.

❯ Puis-je consulter des informations sur les Affiliés et les Coproducteurs via MCP Hotmart ?

MCP permet de consulter certaines informations liées aux commissions et aux participants aux ventes, comme les données de commission et les participants à une transaction. Toutes les fonctionnalités liées à la Coproduction et à l’Affiliation ne sont pas disponibles via MCP.

❯ Comment mes données sont-elles traitées lorsque j’utilise MCP Hotmart ?

Les requêtes effectuées via MCP ont lieu en temps réel à partir des données disponibles dans Hotmart. Pour le fonctionnement de l’intégration, Hotmart ne réplique ni ne stocke ces données dans une base externe.

Selon les règles de l’intégration, les données Hotmart envoyées à l’assistant pour répondre à une demande ne sont pas non plus utilisées pour entraîner des modèles tiers.

Commentaires

0 commentaire

Cet article n'accepte pas de commentaires.