Claude HubSpot : guide complet du connecteur natif et du MCP

Pourquoi connecter Claude à HubSpot change réellement quelque chose

L'usage classique d'un CRM se résume souvent à la même boucle : un commercial veut une info, il ouvre HubSpot, navigue dans une fiche, regarde l'historique, fait un export pour aller plus loin. Le marketing demande un rapport, attend qu'on lui construise un dashboard custom, ou exporte la donnée dans un tableur pour la croiser à la main.

Le branchement de Claude sur HubSpot fait sauter cette mécanique. La donnée ne change pas de place, elle reste dans HubSpot. Mais la couche d'analyse devient conversationnelle. On pose une question en français, Claude lit les fiches concernées, compose une réponse structurée, propose une visualisation, ou exécute une action.

Le résultat : on passe d'un CRM qui stocke à un CRM qu'on interroge comme un collègue, et avec le MCP, on va encore plus loin...

Les deux portes d'entrée : connecteur natif vs serveur MCP

Le connecteur natif Claude × HubSpot

C'est l'intégration officielle développée conjointement par HubSpot et Anthropic. HubSpot est le premier CRM à avoir lancé un connecteur pour Claude, mis à disposition en juillet 2025.

Concrètement, c'est une intégration disponible directement depuis l'interface Claude, sur les versions web, desktop et mobile. L'utilisateur ouvre Claude, ouvre une conversation, active HubSpot dans ses outils, et peut interroger ses données. Le connecteur ajoute aussi une couche d'expérience visuelle : génération de graphiques inline, suggestions structurées, rendus tabulaires, visibles directement dans la conversation.

C'est l'option zéro code, zéro configuration technique avancée. Elle vise les utilisateurs métier.

Le serveur MCP HubSpot

Le MCP (Model Context Protocol) est le standard ouvert publié par Anthropic pour permettre à un modèle d'IA de se brancher de façon sécurisée à un système externe. HubSpot a publié son propre serveur MCP, accessible à n'importe quel client compatible : Claude Desktop, Claude Code, Cursor, etc.

HubSpot propose deux serveurs MCP distincts : un serveur Remote pour connecter n'importe quel outil ou agent IA compatible MCP au CRM, et un serveur Developer pour interagir avec la plateforme de développement HubSpot.

C'est l'option qui ouvre la porte aux usages avancés : agents personnalisés, automatisations à grande échelle, intégration dans un workflow de développement. Le MCP donne un accès programmatique aux données et aux outils HubSpot, sans la couche d'expérience visuelle du connecteur natif. À la sortie, c'est du JSON brut que le client MCP utilise comme bon lui semble.

Tableau de comparaison

Le connecteur natif Claude × HubSpot en pratique

Ce que le connecteur permet de faire

Le connecteur donne à Claude un accès en lecture et en écriture aux objets standards du CRM. Il couvre les contacts, entreprises, transactions, tickets, utilisateurs, lignes de produits, devis, factures, commandes, paniers, produits, abonnements, et listes d'objets, ainsi que leurs associations.

Côté actions, le connecteur peut créer et mettre à jour des fiches CRM, logger des activités directement depuis la fenêtre Claude. Cela inclut la création de contacts et de transactions, la mise à jour des propriétés des fiches, l'ajout de notes, la création de tâches et de relances. Toutes les actions sont attribuées dans le journal d'audit HubSpot à la fois à l'utilisateur et au connecteur Claude.

Voici le type de demande qu'un utilisateur peut poser :

• "Donne-moi un résumé des transactions ouvertes sur ce trimestre, triées par date de clôture, et identifie celles à risque"
• "Quels contacts ont ouvert la dernière campagne sans cliquer ? Crée-moi un graphique en camembert"
• "Résume les 12 derniers échanges avec ce compte et propose un plan de relance"
• "Crée un contact avec ces informations et associe-le à l'entreprise XYZ"

Ce que le connecteur ne permet pas de faire

Trois limites importantes à avoir en tête avant de promettre quoi que ce soit en interne.

Pas de suppression de données. Le connecteur peut créer et mettre à jour, mais pas supprimer. C'est une limite délibérée pour protéger l'intégrité du CRM.

Pas d'accès aux Sensitive Data Properties. Le connecteur HubSpot pour Claude ne fournit pas d'accès aux propriétés de données sensibles personnalisées, y compris les informations médicales personnelles et autres formes de données hautement sensibles. Si la fonctionnalité Sensitive Data est activée sur le compte HubSpot, le connecteur n'aura pas accès aux données d'engagement.

Pas d'application des règles de validation custom. Lors de la création ou mise à jour de fiches via le connecteur, les règles de validation personnalisées (y compris les validations de phases de pipeline et les labels d'association) ne sont pas appliquées. C'est un point critique pour les organisations qui ont mis en place une gouvernance stricte du CRM. Une fiche créée par Claude peut bypasser certaines règles métier configurées dans HubSpot. Sur nos missions d'intégration, c'est l'un des points qu'il faut systématiquement remonter aux directions data avant ouverture large.

Prérequis et activation

Trois conditions doivent être réunies.

1. Un abonnement Claude payant. Le connecteur HubSpot pour Claude est disponible pour tous les clients HubSpot, tous niveaux d'abonnement confondus, à condition de disposer d'un abonnement Anthropic payant (Pro, Max, Team ou Enterprise).
2. Une activation par le Super Admin HubSpot. Le Super Admin (ou un utilisateur avec les permissions App Marketplace) connecte le compte en premier, puis ouvre l'accès aux autres utilisateurs.
3. Une configuration individuelle par chaque utilisateur. Chaque membre de l'équipe doit ensuite connecter son compte HubSpot personnel à son compte Claude.

Aucune installation locale, aucune clé API, aucun développement à prévoir.

10 prompts Claude prêts à l'emploi pour HubSpot

Les exemples qui suivent sont des prompts opérationnels que vous pouvez copier-coller dans Claude une fois le connecteur HubSpot actif. Ils sont structurés pour donner à Claude le bon niveau de contexte et la bonne forme de sortie.

Pour le marketing

1. Identifier un segment d'activation pour une relance

À partir de mes contacts HubSpot, identifie ceux qui :
- ont ouvert au moins un email marketing dans les 30 derniers jours
- mais n'ont cliqué sur aucun lien
- et qui ne sont pas encore passés en MQL.

Donne-moi la liste des 50 premiers (par récence d'ouverture), avec
nom, entreprise, dernière campagne ouverte, et propose un angle de
relance pertinent pour chacun.

2. Comparer la performance de deux campagnes

Compare les performances de mes deux dernières campagnes email
marketing dans HubSpot. Donne-moi pour chacune :
- nombre d'envois, taux d'ouverture, taux de clic
- profil dominant des contacts engagés (poste, taille d'entreprise)
- taux de conversion en MQL si l'info est disponible

Termine par une analyse des écarts et 3 hypothèses pour expliquer
la différence de performance.

3. Auditer la qualité de ma base contacts

Analyse la qualité de ma base de contacts HubSpot.
Pour les 1000 contacts les plus récents, dis-moi :
- le pourcentage de fiches sans téléphone
- le pourcentage sans entreprise associée
- le pourcentage sans cycle de vie défini
- les sources d'acquisition les plus chargées en données manquantes

Présente le résultat sous forme de tableau et propose les 3 priorités
de nettoyage les plus rentables.

Pour les ventes

4. Brief avant un rendez-vous client

Je vois [Nom Prénom] de [Entreprise] dans 30 minutes.
Donne-moi un brief structuré :
- l'historique de nos échanges (derniers emails, appels, meetings)
- les transactions ouvertes ou closes avec ce contact
- les pages du site qu'il a consultées récemment si l'info est dispo
- les sujets sensibles ou les points de friction repérés
- 3 questions pertinentes à lui poser pour faire avancer le dossier

5. Identifier les deals à risque cette semaine

Liste les deals actuellement dans mon pipeline qui présentent au
moins un de ces signaux de risque :
- aucune activité loggée depuis 14 jours ou plus
- date de clôture dépassée sans changement d'étape
- contact principal n'ayant pas répondu à mon dernier email

Pour chaque deal, donne-moi le montant, l'étape, le contact, le
signal de risque, et propose une action de relance précise.

6. Prioriser mes relances pour la semaine

Sur la base de mes deals ouverts dans HubSpot, construis-moi une
priorisation pour la semaine.
Critères : montant, probabilité actuelle, fraîcheur de la dernière
interaction, étape dans le pipeline.

Donne-moi 10 deals à traiter en priorité, ordonnés, avec pour chacun
l'action concrète à mener (appel, email, relance, escalade).

Pour le service client

7. Synthèse des tickets ouverts

Donne-moi un état des tickets HubSpot actuellement ouverts qui me
sont assignés.
Trie par priorité, puis par date de création.

Pour les 5 tickets les plus critiques, ajoute :
- le contexte client (entreprise, contrat si visible)
- le résumé de l'historique de la conversation
- la prochaine action que je devrais prendre

8. Analyser les sujets récurrents sur le mois

Analyse l'ensemble des tickets résolus sur les 30 derniers jours.
Identifie :
- les 5 catégories de problèmes les plus fréquentes
- celles dont le temps moyen de résolution est anormalement long
- les produits ou modules qui génèrent le plus de tickets

Présente le résultat sous forme de graphique en camembert pour les
catégories, et propose 2 sujets prioritaires à remonter à l'équipe
produit.

Pour le RevOps

9. Audit de la qualité des fiches deals

Audite la qualité de remplissage des deals ouverts dans le pipeline
"Sales France".
Pour chaque deal, vérifie la présence des champs critiques :
- montant renseigné
- date de clôture renseignée
- contact principal associé
- entreprise associée
- prochaine étape définie

Liste les 20 deals les moins bien renseignés et donne-moi le pourcentage
global de complétude du pipeline.

10. Lecture cross-équipes de la performance

Donne-moi une lecture transverse de la performance commerciale du
trimestre dans HubSpot :
- nombre de leads générés par source (marketing)
- taux de conversion lead vers MQL puis MQL vers SQL
- pipeline créé par les ventes
- taux de closing par commercial
- ticket moyen et cycle moyen

Identifie les deux points qui me coûtent le plus de revenu et
explique pourquoi.

💡 Bonne pratique. Ces prompts sont des points de départ. Sur les déploiements que nous accompagnons, nous construisons systématiquement une bibliothèque interne de prompts validés par équipe, avec un format standardisé. Cela améliore drastiquement la cohérence des résultats entre utilisateurs.

Le serveur MCP HubSpot : ce qu'il ouvre vraiment

Pourquoi le MCP change la donne pour les usages avancés

Le connecteur natif est puissant, mais il vit dans l'interface Claude grand public. Il ne s'intègre pas à un workflow technique, à un agent personnalisé, ou à un IDE.

Le MCP HubSpot, lui, est une couche programmable. Il expose les outils CRM (lecture, écriture, recherche, association) sous forme d'endpoints standardisés que n'importe quel client compatible MCP peut consommer. Il permet aussi d'aller plus loin avec les objets personnalisés HubSpot, dès lors que les scopes adéquats sont accordés.

Trois cas concrets où ça change tout.

Brancher Claude Desktop ou Claude Code sur HubSpot. Pour un développeur ou un admin technique, c'est l'option qui permet d'avoir HubSpot directement disponible dans son outil de travail principal, en ligne de commande ou dans Claude Desktop, sans passer par le navigateur.

Construire un agent custom qui interagit avec HubSpot. Une équipe RevOps peut créer un agent dédié à une tâche précise (par exemple : qualifier les leads entrants à partir de signaux multiples, ou enrichir des fiches en lot) en s'appuyant sur le MCP comme couche d'accès.

Combiner HubSpot avec d'autres MCP dans la même conversation. Un agent peut, dans la même session, lire un email Gmail, regarder un dashboard Notion, croiser avec une fiche HubSpot, et proposer une action. Le MCP est ce qui rend cette orchestration multi-outils possible.

Les deux serveurs MCP HubSpot officiels

C'est un point que la plupart des articles français mélangent. HubSpot publie deux serveurs MCP distincts.

Le HubSpot MCP Server (Remote). Hébergé par HubSpot, accessible via OAuth à l'URL mcp.hubspot.com/anthropic. C'est celui qui sert à interroger les données CRM en lecture/écriture. Il offre un accès comparable au connecteur natif sur les données, mais sans la couche d'expérience visuelle. C'est l'option pour les organisations qui veulent un branchement officiel, sans gestion de credentials longue.

Le HubSpot Developer MCP Server (Local). Installé localement via le HubSpot CLI (version 8.2.0 ou supérieure), il fournit à un assistant IA des outils pour rationaliser les tâches de développement d'apps et de CMS HubSpot. Il s'adresse aux développeurs qui construisent des applications, des UI Extensions ou du contenu CMS HubSpot dans leur IDE.

Concrètement : un commercial ou un marketeur s'intéresse au premier. Un développeur HubSpot s'intéresse au second.

Authentification : OAuth officiel ou Private App

Avant d'aller plus loin, un point qui crée régulièrement de la confusion.

Le serveur MCP officiel HubSpot (Remote) fonctionne en OAuth. Il s'agit du standard OAuth 2.0, qui passera ultérieurement à OAuth 2.1 avec PKCE et rotation des refresh tokens, en alignement avec la spécification MCP. L'utilisateur s'authentifie une fois, et son client MCP utilise un access token qui se rafraîchit automatiquement.

Les serveurs MCP tiers ou auto-hébergés (par exemple @hubspot/mcp-server open-source ou des wrappers communautaires) fonctionnent généralement avec une Private App HubSpot. Cette approche demande de créer une Private App dans les paramètres HubSpot, de définir les scopes accordés, et de récupérer un access token statique à fournir au MCP.

Différence pratique :

• OAuth officiel : les permissions de l'utilisateur HubSpot connecté s'appliquent. Bon pour les usages utilisateurs.
• Private App : l'app a ses propres permissions, indépendantes d'un utilisateur. Bon pour les agents non-humains ou les automatisations serveur.

Comment connecter Claude à HubSpot via MCP

Le Model Context Protocol (MCP) est le standard ouvert qui permet à un modèle comme Claude de discuter directement avec une application tierce. HubSpot maintient son propre serveur MCP, distribué officiellement via le package npm @hubspot/mcp-server, qui se branche sur Claude Desktop (ou Cursor, Claude Code, et tout autre client compatible). Une fois la connexion établie, Claude peut lire et modifier ton CRM en langage naturel, sans passer par l'interface HubSpot.

Voici comment installer le tout en local. Compte une dizaine de minutes si tu n'as jamais touché à un fichier de config JSON.

Note : le package @hubspot/mcp-server est en beta publique au moment où j'écris (source : npm et changelog HubSpot Developers). Pour un usage production avec OAuth, vois la section "Variante" en fin d'article.

Avant de commencer

• Claude Desktop installé sur ton ordinateur (téléchargement ici)
• Node.js et npm installés (nodejs.org)
• un portal HubSpot sur lequel tu as les droits Super Admin pour créer une app privée
• un éditeur de texte basique (VS Code, Sublime, ou même TextEdit/Notepad)

Étape 1 : créer une App privée dans HubSpot

La Private App est l'identité technique que le serveur MCP va utiliser pour se connecter à ton portal. Elle génère un jeton qui sert de mot de passe.

1. Dans HubSpot, clique sur l'icône Paramètres en haut à droite.
2. Dans le menu de gauche, va sur Intégrations > Apps privées.
3. Clique sur Créer une app privée.
4. Onglet Informations de base, donne un nom à l'app (par exemple Claude MCP) et une courte description.
   
5. Onglet Champs d'application (Scopes), sélectionne les permissions dont tu as besoin. Les scopes minimaux pour exploiter le serveur MCP sur les objets CRM standards :
   • crm.objects.contacts.read et crm.objects.contacts.write
   • crm.objects.companies.read et crm.objects.companies.write
   • crm.objects.deals.read et crm.objects.deals.write
   • crm.objects.owners.read
   • crm.schemas.contacts.read, crm.schemas.companies.read, crm.schemas.deals.read
   Si tu travailles avec des objets custom, ajoute aussi crm.objects.custom.read, crm.objects.custom.write et crm.schemas.custom.read.
6. En haut à droite, clique sur Créer l'app et confirme.
7. HubSpot affiche alors le Private App Access Token. Clique sur Afficher le jeton, copie-le immédiatement et stocke-le dans un endroit sûr (gestionnaire de mots de passe, fichier .env sécurisé). Tu pourras le révéler à nouveau ensuite, mais autant ne pas avoir à y revenir.

Source : documentation officielle HubSpot sur les Private Apps.

Étape 2 : ouvrir le fichier de configuration de Claude Desktop

Claude Desktop se configure via un fichier JSON nommé claude_desktop_config.json. Son emplacement dépend de ton OS :

• macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows : %APPDATA%\Claude\claude_desktop_config.json

Si le fichier n'existe pas encore, crée-le. Le moyen le plus simple : ouvrir Claude Desktop, aller dans Settings > Developer, et cliquer sur Edit Config. Le fichier s'ouvrira (ou sera créé) automatiquement.

Étape 3 : ajouter le serveur MCP HubSpot dans la config

Dans le fichier claude_desktop_config.json, remplace TON_TOKEN_ICI par le token copié à l'étape 1. Sauvegarde le fichier.

Si tu as déjà d'autres serveurs MCP configurés, ajoute juste l'entrée "hubspot" à l'intérieur du bloc mcpServers existant, sans dupliquer la clé.

Étape 4 : redémarrer Claude Desktop et vérifier la connexion

1. Quitte complètement Claude Desktop (clic droit sur l'icône, Quit, ou Cmd+Q sur Mac). Sur Windows, vérifie que rien ne tourne dans la barre des tâches.
2. Relance Claude Desktop.
3. Ouvre une nouvelle conversation. En bas de la zone de saisie, clique sur Search and tools.
4. Le serveur hubspot doit apparaître dans la liste, avec ses outils disponibles.
5. Active-le si nécessaire.

Pour valider que tout marche, tape un prompt simple :

"Crée un contact test dans HubSpot."

Si Claude répond avec des données réelles de ton portail, c'est gagné.

Limites et points d'attention sur le MCP

Les limites HubSpot s'appliquent. Pour les apps OAuth publiques, la limite est de l'ordre de 100 à 110 requêtes par 10 secondes par compte HubSpot installant l'app. Pour les Private Apps, la limite est de 190 requêtes par 10 secondes (avec possibilité de monter à 250 via le capacity pack), et la limite quotidienne va de 650 000 requêtes/jour en Professional à 1 000 000 en Enterprise. Pour un agent qui interroge HubSpot en boucle, ces limites peuvent vite devenir bloquantes.

Le périmètre dépend des scopes définis. Plus on ouvre de scopes à un MCP avec Private App, plus on étend la surface d'attaque en cas de compromission des credentials. Le principe du moindre privilège s'applique strictement.

La gouvernance ne s'auto-applique pas en Private App. Là où le MCP officiel respecte les permissions HubSpot de l'utilisateur connecté, un MCP avec une Private App tourne avec les permissions de l'app, pas de l'utilisateur. C'est un changement de modèle de sécurité qu'il faut documenter.

5 use cases concrets de Claude avec le MCP HubSpot

Une fois le serveur MCP HubSpot connecté à Claude Desktop, tu peux le combiner avec d'autres briques disponibles dans le même environnement : MCP Figma, MCP Notion, HubSpot CLI, ou appels directs à l'API HubSpot. C'est cette orchestration dans une seule conversation qui transforme Claude en véritable assistant RevOps. Voici cinq exemples concrets, utilisés au quotidien chez Lomed.

1. Créer une landing page HubSpot à partir d'une maquette Figma

L'intégration d'une maquette Figma dans HubSpot CMS prend habituellement plusieurs heures : extraction des composants, traduction en HTML/HubL, création des modules, push dans le portail. Avec Claude connecté au MCP Figma et au MCP HubSpot, le workflow tient en une conversation.

Tu pointes Claude vers ton fichier Figma. Il lit la structure, récupère les tokens de design (couleurs, typographies, espacements), génère le code HubL adapté à ton thème, et déploie la page directement dans HubSpot. Tu ouvres ton portail, tu prévisualises, tu publies. Ce qui prenait une demi-journée d'intégration devient une tâche de quelques minutes.

2. Créer un workflow d'automatisation HubSpot en langage naturel

Construire un workflow HubSpot complexe demande de jongler entre l'interface visuelle, les triggers, les branches conditionnelles et les actions. Avec Claude, tu décris ton besoin métier en français et il s'occupe de la mise en oeuvre.

Exemple de prompt : "Quand un deal passe en stage Negotiation depuis plus de 14 jours sans activité, crée une tâche pour le deal owner et notifie son manager sur Slack." Claude traduit cette logique en workflow HubSpot, le crée dans le portail, et te laisse valider dans l'interface avant activation. Idéal pour prototyper rapidement une automatisation de relance, de scoring, ou de notification interne.

3. Détecter et fusionner les doublons dans HubSpot

La gestion des doublons est un classique du nettoyage CRM. L'outil natif HubSpot (Duplicate Management) plafonne à 50 paires par lot et ne couvre que contacts et companies. Avec Claude et le MCP HubSpot, tu peux pousser plus loin.

Tu définis tes règles de matching (email, nom de domaine, numéro SIREN, combinaison de champs custom) et Claude scanne ta base. Il remonte les paires détectées avec un score de confiance, te laisse arbitrer les cas ambigus, et exécute la fusion sur les doublons validés. Tu gardes le contrôle, tu gagnes en vitesse, et tu n'as pas besoin d'investir dans un outil tiers de déduplication pour les opérations ponctuelles.

4. Fusionner des entreprises en masse après une migration

Après une migration depuis Salesforce, Pipedrive ou un autre CRM, tu te retrouves souvent avec des dizaines voire des centaines d'entreprises en double dans HubSpot. Faire le ménage à la main est long et risqué.

Tu fournis la liste à Claude, tu précises tes règles de sélection du record maître (la fiche la plus complète, la plus récente, celle qui a le plus de deals associés), et il exécute les fusions une à une. À chaque opération, il garde une trace de ce qui a été fusionné et de ce qui a été conservé. Tu récupères un récapitulatif propre à la fin, prêt à archiver pour ton audit.

5. Enrichir une base de contacts HubSpot avec des données externes

Une base de contacts incomplète (industrie vide, intitulé de poste manquant, taille d'entreprise inconnue) limite la qualité de ton scoring, de ton ciblage marketing et de tes reportings. Claude peut combler les trous en croisant le MCP HubSpot avec d'autres sources de données.

Tu sélectionnes un segment de contacts à enrichir. Claude va chercher l'information manquante via une recherche web, un MCP LinkedIn ou un MCP Apollo, recoupe les sources, et met à jour les fiches HubSpot une par une. Sur plusieurs centaines de contacts, l'opération tourne en arrière-plan pendant que tu fais autre chose. Tu retrouves une base propre, exploitable pour de la segmentation fine ou de l'attribution.

Avertissement avant de te lancer

Donner à Claude un accès en écriture sur ton CRM, c'est puissant mais loin d'être anodin. Une fusion mal calibrée, un workflow déclenché trop large, un enrichissement qui écrase des données existantes : les dégâts peuvent être longs à rattraper, et certaines opérations comme la fusion de records sont irréversibles dans HubSpot.

Quelques règles de bon sens à appliquer systématiquement :

• Tester d'abord dans un sandbox HubSpot ou sur un petit échantillon avant de lancer une opération en masse.
• Garder le mode "Needs Approval" activé sur les outils d'écriture du MCP, pour que chaque action soit validée explicitement avant exécution.
• Démarrer avec une Private App en lecture seule pour les premières manipulations, puis ouvrir progressivement les scopes en écriture au fur et à mesure que tu prends confiance.
• Faire un export ou une sauvegarde des objets concernés avant toute opération de masse (fusion, enrichissement, mise à jour de pipeline).
• Relire les changements proposés par Claude avant de valider, surtout sur les fusions et les suppressions logiques.

Claude reste un LLM : il peut halluciner, mal interpréter une consigne ambiguë, ou prendre une décision technique inattendue. La supervision humaine n'est pas optionnelle, surtout sur des données clients en production.

Et la troisième couche : Claude dans les workflows HubSpot

Pour être complet, il faut mentionner une troisième couche, distincte du connecteur et du MCP : l'action native "Use a custom LLM" disponible dans l'éditeur de workflows HubSpot.

Cette action permet d'exécuter Claude (ou un autre LLM supporté : OpenAI, Gemini, Cohere, xAI) au sein d'un workflow, de récupérer la sortie, et de l'utiliser comme input d'autres actions du même workflow (mise à jour de propriété, envoi d'email, création de tâche, branchement conditionnel).

Deux contraintes fortes à connaître :

L'action "Use a custom LLM" requiert le Hub Enterprise  Elle n'est pas disponible sur les formules Starter ou Professional.

Et les actions AI workflows consomment des HubSpot Credits. Cela signifie que chaque exécution d'un workflow LLM a un coût, à anticiper dans le dimensionnement.

Cette couche workflow est complémentaire des deux autres :

• Connecteur natif = analyse conversationnelle ad hoc
• MCP = accès programmatique pour agents et automatisations externes
• Action workflow = automatisation interne déclenchée par les événements HubSpot

Sur un déploiement réel, les trois cohabitent souvent. C'est ce qui rend le sujet sérieux à cadrer en amont plutôt qu'à improviser.

Connecteur natif ou MCP : comment choisir

La question revient souvent. Voici comment trancher dans la majorité des cas. En général Claude fait le choix lui même naturellement, tout dépend du contexte.

Choisir le connecteur natif si :

• Le besoin est conversationnel, ad hoc, individuel
• Les utilisateurs sont des profils métier (commercial, marketeur, support)
• L'organisation veut activer rapidement, sans projet technique
• Les permissions HubSpot existantes doivent être strictement respectées

Choisir le MCP si :

• Il y a un besoin d'agent persistant ou d'automatisation
• Les utilisateurs sont techniques (RevOps, ops, dev)
• Il faut combiner HubSpot avec d'autres outils dans une même chaîne
• Le travail se fait depuis un IDE ou en ligne de commande

Dans la plupart des cas réels, les deux cohabitent. Les équipes métier utilisent le connecteur natif pour leurs analyses du quotidien. Les équipes RevOps ou techniques s'appuient sur le MCP pour bâtir des automatisations plus profondes.

Les conditions d'un déploiement réussi

L'IA dans un CRM ne corrige pas un CRM mal construit. Elle amplifie ce qui existe. Si la donnée est sale, les analyses seront fausses. Si les processus sont flous, l'automatisation sera erratique.

Quatre conditions à valider avant d'ouvrir Claude à toute une organisation.

1. La qualité de la donnée HubSpot. Les propriétés doivent être nommées de façon cohérente, les pipelines tenus, les engagements correctement loggés. Un CRM dont les contacts ont 60% de propriétés vides ne produira que des analyses superficielles. C'est très souvent le premier chantier sur les missions Lomed avant toute intégration IA, et nous y consacrons un guide complet pour configurer HubSpot ainsi qu'un article dédié à la gestion des doublons, deux prérequis classiques avant d'ouvrir l'IA aux équipes.

2. La gouvernance des accès. Qui dans l'organisation peut connecter son compte HubSpot à Claude ? Quels rôles ont accès à quelles données ? Cette question doit être tranchée avant l'ouverture large, en cohérence avec la matrice de permissions HubSpot existante.

3. Le cadrage des cas d'usage. Plutôt que d'ouvrir Claude à tout le monde et d'attendre que la magie opère, il vaut mieux identifier 3 à 5 cas d'usage à fort impact par équipe, les documenter, et former les utilisateurs sur ces cas précis.

4. La formation des utilisateurs sur le prompt. Claude n'est pas un moteur de recherche. Il répond mieux à un prompt structuré qu'à une question vague. La qualité des résultats varie significativement selon la qualité du prompt fourni, et la mise en place d'une bibliothèque de prompts standardisés (comme les 10 exemples ci-dessus) change radicalement l'expérience utilisateur.

Les erreurs courantes à éviter

Confondre Breeze et Claude. Breeze est l'IA native de HubSpot, intégrée dans la plateforme. Claude est un modèle externe d'Anthropic, branché à HubSpot via le connecteur ou le MCP. Les deux sont complémentaires, pas concurrents. Breeze est meilleur sur les tâches embarquées dans HubSpot (génération d'emails, suggestions inline). Claude est meilleur sur le raisonnement, la synthèse longue et l'analyse transverse. Pour un panorama complet de Breeze, voir notre guide complet de l'IA dans HubSpot.

Confier à Claude des tâches qui demandent une validation métier sans contrôle humain. Le connecteur peut mettre à jour des deals, créer des contacts, modifier des propriétés. Sans étape de validation, on prend le risque de polluer le CRM. La règle : toute action en écriture critique passe par une revue humaine sur les premières semaines.

Sous-estimer l'effort de configuration MCP en multi-clients. Connecter un MCP à un client unique est rapide. Le déployer à 50 commerciaux avec une gouvernance des credentials propre est un projet en soi.

Oublier le coût des HubSpot Credits. Sur la couche workflow, chaque exécution de Claude consomme des credits. Sans monitoring, la facture peut surprendre.

FAQ

Faut-il un abonnement Claude payant pour utiliser HubSpot avec Claude ?

Oui. Le connecteur HubSpot pour Claude nécessite un abonnement Anthropic payant : Pro, Max, Team ou Enterprise. La version gratuite de Claude n'inclut pas l'accès au connecteur.

Faut-il une formule HubSpot Enterprise ?

Non pour le connecteur natif et le MCP, qui fonctionnent sur tous les niveaux d'abonnement HubSpot. Oui en revanche pour l'action "Use a custom LLM" dans les workflows HubSpot, qui est réservée aux formules Enterprise (Enterprise Customer Platform, Marketing/Sales/Service/Ops Enterprise, ou Smart CRM Enterprise).

Quelle différence entre Claude et HubSpot Breeze ?

Breeze est l'IA propriétaire de HubSpot, embarquée dans l'interface (suggestions inline, génération de copy, agents Breeze). Claude est un modèle externe d'Anthropic, accessible via le connecteur ou le MCP. Breeze est intégré à l'expérience HubSpot. Claude apporte un raisonnement plus poussé sur des tâches d'analyse et de synthèse complexes. Les deux peuvent coexister.

Est-ce que Claude peut supprimer mes données HubSpot ?

Non. Le connecteur natif peut créer, mettre à jour, et logger, mais pas supprimer. C'est une limite volontaire qui protège l'intégrité du CRM. Via MCP avec une Private App, la suppression dépend des scopes accordés à l'app, mais c'est une mauvaise pratique d'autoriser un agent IA à supprimer.

Mes données HubSpot sont-elles utilisées pour entraîner Claude ?

Anthropic n'utilise pas les données partagées via HubSpot pour entraîner ses modèles, sauf cas particuliers comme le fait que le client choisisse de fournir un feedback ou opte explicitement pour l'entraînement.

Le connecteur respecte-t-il les permissions HubSpot ?

Oui. Un utilisateur ne voit dans Claude que les données auxquelles il est autorisé d'accéder dans HubSpot. Aucune élévation de privilèges n'est possible via le connecteur natif. Pour le MCP avec Private App, les permissions dépendent des scopes définis pour l'app.

Combien d'enregistrements peut-on traiter en une fois ?

Le connecteur natif limite à 10 enregistrements par opération bulk de création ou mise à jour. Pour des opérations massives, le MCP ou les workflows HubSpot natifs sont plus adaptés.

Combien coûte une exécution Claude dans un workflow HubSpot ?

Les actions AI dans les workflows HubSpot consomment des HubSpot Credits. Le coût exact par exécution dépend du modèle Claude utilisé et de la longueur du prompt et de la sortie. À monitorer dès le pilote pour calibrer la consommation.

Pour aller plus loin

Brancher Claude sur HubSpot, c'est passer un cap. Votre CRM ne se contente plus de stocker, il répond, analyse, agit. Les équipes y gagnent en vitesse, en clarté, en autonomie. Mais le levier est puissant, donc la chute peut l'être aussi : sans cadrage, l'IA amplifie autant les bonnes pratiques que les défauts d'organisation.

Chez Lomed, on accompagne nos clients HubSpot à tirer le maximum de cette combinaison : structuration de la donnée, calibrage des accès, identification des cas d'usage prioritaires, mise en place des bons garde-fous. L'objectif n'est pas juste de connecter Claude, c'est de le faire travailler pour vous.