MCP HubSpot : ce que voit Claude, installation et limites

Mis à jour le 20 octobre 2026.

Le MCP HubSpot en bref

• HubSpot propose deux serveurs MCP : un serveur distant, sur mcp.hubspot.com, qui connecte les outils d'IA aux données de votre CRM, et un serveur MCP développeur, installé en local, qui aide les outils de code à créer des apps HubSpot et du contenu CMS.
• Le serveur MCP HubSpot distant lit et écrit les contacts, entreprises, deals, tickets, leads, objets personnalisés et activités, dans la limite des permissions HubSpot de chaque utilisateur.
• Claude et ChatGPT s'y connectent via les connecteurs officiels de HubSpot, et tout client MCP compatible OAuth avec PKCE peut se connecter directement à mcp.hubspot.com.
• Quand le réglage Données sensibles de HubSpot (Sensitive Data dans l'interface en anglais) est activé, les appels, emails, réunions, notes, tâches et conversations sont bloqués via le serveur MCP, alors que les API CRM standard y gardent accès.
• La recherche s'appuie sur l'API de recherche CRM de HubSpot : des filtres et des mots-clés, sans recherche sémantique.
• Le serveur MCP lit ce qui est enregistré dans HubSpot. Ce que les acheteurs ont dit en appel ne lui parvient qu'une fois écrit dans une propriété, par quelqu'un ou par un outil.

Le serveur MCP HubSpot donne votre CRM à votre agent, et votre agent hérite donc de l'angle mort du CRM : il lit ce que les commerciaux ont saisi, et ce que les acheteurs ont dit en appel lui reste inaccessible tant que personne ne l'a écrit.

Demandez à Claude « quels deals mentionnent un concurrent ? » et il vous répond avec aplomb, à partir de ce que contient la propriété concurrent.

D'après nos données (données d'appels Claap et deals HubSpot, T3 2026), 53 % des deals où un acheteur a cité en appel un outil concurrent d'enregistrement d'appels n'avaient aucune valeur correspondante dans la propriété concurrent du CRM.

Dans cet article : ce que le serveur MCP HubSpot lit et écrit, comment connecter Claude à HubSpot, et ses limites, en commençant par ce que votre agent ne voit pas et comment corriger le problème à la source.

Ce que le MCP HubSpot ne voit pas : les appels que personne n'a saisis

Il lit ce que les commerciaux ont saisi

Un agent connecté à HubSpot répond à partir des propriétés des deals, des propriétés des contacts et des activités enregistrées. Chacune de ces données existe parce qu'un commercial, un formulaire ou une intégration l'a ajoutée.

L'acheteur qui a dit « on discute aussi avec un autre éditeur » pendant un appel de découverte n'a laissé aucune trace dans HubSpot, sauf si le commercial l'a saisi dans la propriété concurrent. Même chose pour la revue juridique qui ajoute deux semaines, le budget qui glisse au trimestre suivant, ou le champion qui vient de changer de poste.

Un responsable data et RevOps d'un éditeur de logiciels logistiques B2B décrit ce que son outil d'appels actuel fait d'un appel :

• "It takes the transcript, it just creates a summary and then push the summary to HubSpot. It doesn't do more than that." (Traduit de l'anglais : « Il prend le transcript, il crée juste un résumé et il pousse le résumé dans HubSpot. Il ne fait rien de plus. »)

Un résumé collé dans une note, c'est du texte qu'un agent peut lire un deal à la fois. Il ne donne rien à filtrer à la propriété concurrent, à la prochaine étape ou à la date de closing.

Alors quand vous demandez à Claude « quels deals ouverts sont à risque ? », il raisonne sur les champs qui ont été remplis. Un pipeline dont une bonne partie du contenu des appels n'a jamais été saisie obtient une réponse assurée, construite sur une partie de l'histoire.

Le réglage Données sensibles coupe l'accès aux activités

HubSpot ajoute un deuxième angle mort pour certaines équipes. Si le réglage Données sensibles est activé sur votre compte, « activity (e.g., calls, emails, meetings, notes, and tasks) and conversation data will be blocked from access through the MCP server », d'après la documentation du serveur MCP de HubSpot. Autrement dit, les activités (appels, emails, réunions, notes et tâches) et les conversations sont bloquées via le serveur MCP.

La même note précise que cette restriction est propre au serveur MCP et ne s'applique pas aux API CRM standard. Le connecteur HubSpot pour Claude dit la même chose à sa façon : avec le réglage Données sensibles activé, Claude n'a accès à aucune donnée d'engagement.

Les équipes de la santé, des services financiers et d'autres marchés réglementés activent ce réglage pour de bonnes raisons. Pour elles, les notes d'appel saisies qui auraient pu combler le manque deviennent elles aussi inaccessibles. Ce qui reste lisible, c'est la fiche elle-même : les propriétés des deals, des contacts et des entreprises.

La recherche trouve des champs, et un résumé dans une note reste enfoui

L'outil de recherche du serveur MCP repose sur l'API de recherche CRM de HubSpot. Il accepte jusqu'à cinq groupes de filtres de six filtres chacun et renvoie au maximum 200 résultats par page, selon la référence de l'outil search_crm_objects.

La documentation de HubSpot indique aussi que le serveur « currently doesn't include vector search capabilities » : il ne propose pas, pour l'instant, de recherche vectorielle. Les filtres fonctionnent bien sur des propriétés typées : l'étape, le montant, la date de closing, une valeur de liste déroulante. Une objection d'acheteur enfouie au troisième paragraphe d'une note d'appel, elle, se filtre mal.

En résumé : plus l'histoire de vos deals se trouve dans des propriétés, plus le MCP HubSpot devient utile.

Remplissez les propriétés depuis l'appel, et le MCP HubSpot les lit

La solution se trouve en amont du MCP. Faites entrer ce qui s'est dit en appel dans les propriétés HubSpot après chaque appel, et tout ce qui lit HubSpot en profite d'un coup : le serveur MCP, vos rapports, vos workflows et vos commerciaux.

Précision : Claap est notre produit. Claap enregistre les appels commerciaux, et ses champs IA écrivent après chaque appel une valeur typée dans la propriété HubSpot que vous choisissez : le concurrent cité, la date de décision, l'objection principale, la prochaine étape. Les valeurs arrivent sur les contacts, entreprises, deals, réunions, appels et leads HubSpot, sous forme de paragraphe, de sélection, de date, de nombre ou de note, selon la page Remplissage CRM de Claap.

Quelques détails rendent ce fonctionnement compatible avec un agent qui lit à l'autre bout :

• Chaque champ a son propre mode de synchro : « Seulement si vide » (une valeur saisie par un commercial reste en place), « Compléter si possible » (les objections s'ajoutent d'un appel à l'autre dans une liste) ou « Toujours écraser » (la dernière prochaine étape l'emporte).
• L'exécution automatique écrit la valeur dans le CRM dès que l'enregistrement est traité, sans que personne n'ait à ouvrir la fiche.
• Une fois la valeur dans une propriété de deal, le serveur MCP de HubSpot la lit comme n'importe quel autre champ, et le blocage des activités par le réglage Données sensibles la laisse en place. Gardez ces propriétés hors de la catégorie des propriétés sensibles de HubSpot : la FAQ MCP de HubSpot indique que les propriétés sensibles personnalisées sont exclues.

Choisissez cette approche quand votre équipe travaille déjà dans HubSpot et veut une seule source de vérité, parce que les mêmes propriétés alimentent alors vos dashboards et votre agent. Pour le fonctionnement côté enregistrement, voyez notre page sur l'enregistrement des appels dans HubSpot.

Ou laissez l'agent lire directement les appels

La deuxième approche ajoute un second connecteur à côté de celui de HubSpot. Le serveur MCP de Claap donne à Claude ou à ChatGPT les appels, les transcripts, les emails synchronisés et les vues enregistrées, chaque vue renvoyant toutes ses lignes avec les valeurs des champs IA et le raisonnement derrière chacune.

Cette approche convient aux questions qui portent sur les appels eux-mêmes : « qu'est-ce que les acheteurs ont dit de nos prix ce trimestre ? » Le MCP HubSpot répond à partir de HubSpot, le MCP Claap répond à partir des conversations, et Claude peut utiliser les deux dans le même chat. Le MCP Claap est inclus dans toutes les offres Claap, y compris l'offre gratuite, selon la page MCP de Claap.

Ce conseil est faux si vos commerciaux saisissent déjà chaque appel en détail et que le réglage Données sensibles est désactivé sur votre compte. Dans ce cas, les activités HubSpot portent l'histoire, et le MCP HubSpot seul peut suffire.

Qu'est-ce que le serveur MCP HubSpot ?

Le MCP (Model Context Protocol) est le standard ouvert qu'utilisent les assistants IA pour se connecter à des outils externes. HubSpot publie deux serveurs MCP officiels, présentés côte à côte sur la page MCP de HubSpot :

• Le serveur MCP HubSpot distant est hébergé par HubSpot, sur mcp.hubspot.com. Il connecte Claude, ChatGPT, Cursor et d'autres clients MCP aux données CRM d'un compte HubSpot. C'est celui dont parle une équipe commerciale ou RevOps quand elle dit « MCP HubSpot ».
• Le serveur MCP développeur s'exécute en local via la CLI HubSpot. Il aide les outils de code comme Claude Code, Cursor, Codex CLI, Gemini CLI, VS Code et Windsurf à créer et déployer des apps HubSpot et du contenu CMS. Il s'installe avec hs mcp setup, à partir de la version 8.2.0 de la CLI, selon le guide d'installation du MCP développeur.

Le serveur distant est disponible pour tous les comptes HubSpot depuis le 13 avril 2026, date à laquelle HubSpot a ajouté l'écriture, l'historique des activités et le contenu marketing (changelog HubSpot).

Ce que le serveur MCP HubSpot lit et écrit

Tout ce qui suit vient de la documentation du serveur MCP distant de HubSpot, qui liste les données et les outils pris en charge. Chaque action respecte les permissions HubSpot de l'utilisateur connecté.

Source : documentation du serveur MCP distant de HubSpot, dernière modification le 30 septembre 2026. Certains guides plus anciens disent que les objets personnalisés sont hors de portée ; la documentation actuelle liste les fiches d'objets personnalisés en lecture comme en écriture.

Les outils qu'une équipe commerciale utilise le plus :

• search_crm_objects filtre les fiches, avec jusqu'à cinq groupes de six filtres et 200 résultats par page (documentation HubSpot).
• get_crm_objects récupère jusqu'à 100 fiches par ID en une seule requête, selon la même référence des outils.
• query_crm_data exécute du SQL avec des extensions HubSpot pour les comptages et les agrégats ; la référence des outils de HubSpot précise qu'il ne gère ni les jointures, ni les sous-requêtes, ni le parcours des associations.
• manage_crm_objects crée ou met à jour des fiches et des activités, et affiche un résumé des modifications proposées que l'utilisateur confirme avant toute écriture.
• get_user_details indique les objets et les outils auxquels votre compte a accès. Lancez-le en premier.

Comment connecter Claude à HubSpot

Il y a deux façons de faire, selon l'endroit où vous travaillez.

Avec le connecteur HubSpot pour Claude (la plupart des équipes commerciales)

C'est la voie à suivre pour Claude sur le web, sur ordinateur ou sur mobile. Les étapes ci-dessous suivent l'article de la base de connaissances HubSpot :

1. Un Super Admin, ou un utilisateur disposant de l'accès App Marketplace, approuve le connecteur dans HubSpot, choisit les permissions de données qu'il obtient et qui peut l'installer.
2. Dans Claude, ouvrez votre profil, puis Settings, puis Connectors.
3. Cherchez HubSpot et sélectionnez-le.
4. Connectez-vous au compte HubSpot à utiliser, choisissez les permissions et cliquez sur Connect app.
5. Dans un chat, cliquez sur +, puis Connectors, activez HubSpot et posez votre question.

Le connecteur demande un abonnement Claude payant (Pro, Max, Team ou Enterprise), et les créations ou mises à jour en masse passent par lots de 10 fiches, deux points précisés dans l'article de la base de connaissances HubSpot. Les écritures apparaissent dans le journal d'audit de HubSpot, au nom de l'utilisateur et du connecteur Claude.

Commencez par une seule fiche avant toute modification en masse, parce que chaque écriture est une vraie modification de votre CRM.

HubSpot propose un connecteur équivalent pour ChatGPT, à configurer depuis les réglages de ChatGPT avec la même approbation par un Super Admin (article HubSpot sur le connecteur ChatGPT).

Avec n'importe quel client MCP (Claude Code, Cursor, un agent maison)

Pour les autres clients, vous vous connectez vous-même au serveur distant :

1. Dans HubSpot, allez dans Développement, puis Connecteurs MCP (Development > MCP Connectors dans l'interface en anglais), et créez un connecteur avec un nom et une URL de redirection. HubSpot génère l'ID client et le secret OAuth.
2. Configurez votre client MCP avec l'adresse https://mcp.hubspot.com et ces identifiants. Le client doit gérer OAuth avec PKCE, que HubSpot exige pour chaque connexion.
3. Connectez-vous, choisissez le compte HubSpot, accordez les permissions, puis appelez get_user_details pour vérifier ce à quoi vous avez accès.

Quand HubSpot ajoute des outils, les scopes changent, et les utilisateurs existants doivent réinstaller le connecteur pour en profiter, selon la documentation MCP de HubSpot.

Les limites du MCP HubSpot à connaître avant le déploiement

• Données sensibles. Les activités et les conversations sont bloquées via le serveur MCP quand le réglage est activé, et les propriétés sensibles personnalisées restent inaccessibles (FAQ MCP de HubSpot).
• Recherche. Des filtres et des mots-clés uniquement, sans recherche vectorielle : les questions marchent mieux quand elles citent une propriété ou une valeur.
• Taille des pages. La recherche renvoie au maximum 200 résultats par page (référence des outils HubSpot) : sur une question qui porte sur tout le pipeline, l'agent doit parcourir les résultats page par page.
• Limites d'API. Tout ce que fait le connecteur Claude compte dans les limites d'utilisation de l'API HubSpot, selon l'article de la base de connaissances HubSpot sur le connecteur.
• Un seul CRM. Le serveur voit HubSpot et rien d'autre : vos appels, votre Slack et vos autres outils ont besoin de leurs propres connexions.

Quelle configuration pour votre équipe

• Choisissez le connecteur HubSpot pour Claude quand vos commerciaux veulent des réponses rapides et des mises à jour de fiches depuis un chat, parce qu'il s'installe en cinq clics et reprend les permissions de chaque utilisateur.
• Utilisez le serveur distant avec votre propre client MCP si vous construisez des agents ou travaillez dans Claude Code ou Cursor, parce que vous gardez la main sur le client et pouvez combiner HubSpot avec d'autres serveurs.
• Utilisez le serveur MCP développeur seulement si vous créez des apps ou des thèmes CMS HubSpot. Il ne lit pas les fiches de votre CRM.
• Ajoutez les données d'appels en amont quand l'histoire de vos deals se joue en appel : remplissez les propriétés HubSpot depuis chaque appel avec un outil comme Claap, parce que le MCP HubSpot, vos rapports et votre agent lisent alors les mêmes champs.

Pour aller plus loin sur le remplissage des propriétés, notre guide de la saisie CRM automatique détaille la démarche étape par étape, et notre comparatif entre le notetaker intégré de HubSpot et les outils externes montre ce que HubSpot capte de lui-même.