
16.11.2026
Brancher Claude ou ChatGPT à HubSpot via les 2 serveurs MCP officiels : procédure testée, 5 routines marketing ops, permissions à verrouiller.
Brancher Claude, ChatGPT ou Cursor sur HubSpot pour qu’ils lisent et écrivent dans le CRM pendant une conversation : c’est ce que propose le HubSpot MCP. Depuis la GA du serveur distant le 13 avril 2026, deux serveurs officiels coexistent, un connecteur natif Claude lancé le 29 juillet 2025 continue de tourner en lecture seule, et trois implémentations communautaires circulent. Cet article tranche entre ces portes d’entrée, détaille ce que le serveur distant atteint vraiment, livre la procédure que nous avons testée sur un portail HubSpot Bulldozer, et cinq routines marketing ops avec le prompt exact.
HubSpot MCP est l’implémentation par HubSpot du Model Context Protocol : un serveur officiel qu’un client MCP compatible (Claude Desktop, ChatGPT, Cursor, VS Code, Gemini CLI) appelle pendant une conversation pour lire et écrire dans votre CRM, avec OAuth et scopes.
Côté architecture : votre portail HubSpot d’un côté, un client MCP compatible de l’autre, le serveur mcp.hubspot.com au milieu. Chaque demande en langage naturel est traduite par le client en appel d’outil MCP, qui s’appuie lui-même sur l’API HubSpot. Le protocole ne tourne pas en tâche de fond : il attend que vous lanciez un prompt.
Ce schéma recouvre deux usages adjacents côté équipe marketing. Le premier : ouvrir le CRM à un assistant pour les tâches de pilotage (relances, nettoyage, prep de call). Le second : outiller des agents IA pour qu’ils tiennent des rôles plus larges, comme on l’a décrit dans notre guide IA marketing. Dans les deux cas, la clé est OAuth et des scopes serrés.
HubSpot expose deux serveurs MCP officiels distincts : le serveur distant HubSpot MCP server (Remote), GA depuis le 13 avril 2026, et le serveur développeur local Developer MCP server, GA depuis le 19 février 2026. Le premier sert à piloter le CRM. Le second sert à construire des applications et des pages CMS sur HubSpot.
| Critère | Serveur Distant | Serveur Développeur |
|---|---|---|
| Hébergement | HubSpot, URL mcp.hubspot.com | Local, via la CLI HubSpot |
| Installation | Ajout d’un connecteur URL dans le client MCP | Commande hs mcp setup dans un terminal |
| GA | 13 avril 2026 (beta publique le 1er septembre 2025) | 19 février 2026 |
| Prérequis | User-level app sur le nouveau Developer Platform, OAuth | HubSpot CLI 8.2.0 ou supérieur, Developer Platform v2025.2 |
| Public visé | RevOps, marketing, sales ops, support client | Développeurs qui créent des UI Extensions et des assets CMS |
| Clients compatibles | Tout client MCP qui gère OAuth 2.1 (Claude Desktop, ChatGPT, Cursor, VS Code, Gemini CLI) | Outils agentiques sélectionnés à l’installation (ex. Cursor, Claude Code) |
Dans 90 % des cas, une équipe marketing ou ops veut le serveur Distant. Le serveur Développeur n’a d’intérêt que si vous écrivez du code HubSpot (modules CMS, UI Extensions, workflows custom) et voulez un copilote qui lit la doc et édite des fichiers du Developer Platform.
Le serveur distant HubSpot ouvre à la fois la lecture et l’écriture sur une liste précise d’objets CRM et d’engagements, garde un périmètre lecture seule sur l’organisation et le contenu marketing, et refuse l’accès aux Sensitive Data Properties. C’est écrit noir sur blanc dans la doc officielle, puis repris par Sprites.ai dans un tableau comparable.
L’asymétrie à retenir : un agent peut créer un deal, pousser une note sur un ticket, programmer une tâche, enregistrer un meeting. Il ne peut pas modifier une campagne, dépublier une landing page, éditer un blog post. Si un cas d’usage vous demande ça, il faut passer par un workflow HubSpot ou une Private App dédiée.
La procédure est la même pour un portail de prod ou un portail sandbox : une app user-level côté HubSpot, un connecteur URL côté client MCP, OAuth, et un premier prompt pour valider la connexion. Nous l’avons jouée sur un portail Bulldozer et sur deux portails clients.
https://mcp.hubspot.com. Aucun client ID ni secret à copier dans le client : OAuth se joue dans le navigateur.https://mcp.hubspot.com, valider. La fenêtre d’OAuth HubSpot s’ouvre dans le navigateur, vous choisissez votre portail, vous validez les scopes. ~/.cursor/mcp.json), ajouter une entrée pointant sur mcp.hubspot.com, redémarrer Cursor, signer OAuth. Pour vérifier la connexion, taper « List my contacts created this week ». Une liste vide après OAuth veut dire que le token n’est pas accepté : déconnecter et reconnecter.Sur notre portail Bulldozer, le temps réel de la première connexion a été de l’ordre de quelques minutes, essentiellement passé à cocher les bons scopes.
Les scopes HubSpot sont structurés par objet : lecture et écriture sont séparées. La procédure publiée par Lomed liste exactement les scopes qui reviennent dans nos installations. Voici comment nous les répartissons pour un commercial, un marketeur et un admin RevOps, en partant du principe que l’app user-level respecte le périmètre du rôle.
| Rôle | Lecture | Écriture |
|---|---|---|
| Commercial | crm.objects.contacts.read, crm.objects.deals.read, crm.objects.owners.read, engagements (calls, emails, meetings, notes, tasks) en lecture | Engagements en écriture (notes, tasks, meetings, calls) |
| Marketeur | crm.objects.contacts.read, crm.objects.companies.read, campaigns, landing pages, website pages, blog posts (lecture seule par nature) | Aucune, sauf création de notes et tasks sur contacts |
| Admin RevOps | Lecture complète CRM + schemas + custom objects (crm.objects.custom.read, crm.schemas.*) | Écriture complète hors Sensitive Data : deals, contacts, companies, custom objects |
Deux garde-fous que nous gardons activés par défaut : jamais d’écriture sur les propriétés classées Sensitive Data (le serveur les bloque de toute façon), et toujours une app user-level par rôle. Un même token qui porte à la fois « deals.write » et « custom.write » augmente la surface d’une erreur d’agent.
Nous installons depuis la beta publique de septembre 2025 les mêmes cinq routines chez nos clients et sur notre propre portail. Elles font partie des chantiers que nous activons dans notre offre Optimisation du pipeline. Pour chacune : le prompt exact, ce que Claude renvoie, et le point à vérifier avant de lancer sur un volume.
Prompt : « Liste les deals HubSpot marqués closed-lost sur les 12 derniers mois pour un montant supérieur à 10 000 €. Pour chaque deal, vérifie le poste actuel du contact principal. Sors un tableau deal, contact, ancien poste, poste actuel, raison de perte. »
Ce que Claude renvoie : un tableau trié par montant décroissant, chaque ligne nominative avec la raison de perte prise sur le deal.
À vérifier avant volume : le poste est pris depuis la propriété contact de HubSpot, pas depuis LinkedIn en live. Pour la fraîcheur, enrichir au préalable via un job d’enrichissement, sinon la routine renvoie le poste tel qu’il était le jour de la dernière synchro.
Prompt : « Donne-moi un brief de 10 lignes sur le compte <company> : deals ouverts, dernier meeting, dernière note, dernier email, dernier appel, tickets ouverts, propriétaire du compte. Signale toute activité des 7 derniers jours. »
Ce que Claude renvoie : une synthèse au format brief, avec les 7 champs demandés, chaque ligne horodatée. Le MCP lit les engagements (calls, emails, meetings, notes, tasks) et les objets CRM d’un coup.
À vérifier avant volume : la routine ne voit que ce qui est loggé dans HubSpot. Si les commerciaux ne posent pas leurs notes dans HubSpot, le brief ressemble à un vide.
Prompt : « Liste les deals ouverts dans la pipeline principale sans activité (meeting, call, email, note, tâche) depuis 14 jours, triés par date de prochain step manquant. Crée une tâche "Revoir ou fermer" assignée à l’owner, échéance dans 2 jours ouvrés. »
Ce que Claude renvoie : la liste + la confirmation des tâches créées, avec l’ID de chaque tâche. On garde la trace pour pouvoir annuler en masse en cas d’erreur.
À vérifier avant volume : lancer d’abord en mode dry run sur 10 deals. Si l’agent se trompe de propriétaire sur un deal partagé, on le voit sur un petit échantillon.
Prompt : « Pour chaque contact HubSpot qui a interagi avec nous sur les 30 derniers jours (email ouvert, meeting, visite d’une page, formulaire), note l’activité de 0 à 100 selon le mix : visites de pages × 1, emails ouverts × 2, formulaires × 10, meetings × 20. Pose la note dans la propriété custom "activity_score_30d". »
Ce que Claude renvoie : la liste des contacts touchés, la note calculée, la confirmation de l’écriture dans la propriété custom. Le MCP écrit directement dans la fiche.
À vérifier avant volume : créer d’abord la propriété activity_score_30d (type number) dans HubSpot. Sans la propriété, l’écriture échoue silencieusement sur certains clients.
Prompt : « Donne-moi le rapport hebdo du pipeline principal : nombre de deals par stage, somme des montants par stage, variation en nombre et en montant versus la semaine précédente, top 5 deals qui ont bougé de stage, top 5 deals bloqués depuis plus de 30 jours. »
Ce que Claude renvoie : un rapport texte structuré, prêt à coller dans un Slack hebdo.
À vérifier avant volume : le mode conversation ne se déclenche pas tout seul tous les lundis. Pour automatiser, caler un rappel calendrier ou un job cron qui pingue un agent via l’API d’un client MCP qui l’expose (sinon la routine reste sur sollicitation).
Quatre portes d’entrée coexistent en 2026 pour brancher une IA sur HubSpot : le serveur officiel distant, le connecteur natif Claude × HubSpot, les serveurs communautaires et le serveur développeur. Notre choix par défaut : le serveur distant officiel. Les trois autres se justifient dans des cas précis.
| Porte d’entrée | À qui | Ce qu’on gagne | Ce qu’on perd |
|---|---|---|---|
Serveur distant officiel (mcp.hubspot.com) | RevOps, sales ops, marketing ops | Lecture + écriture sur CRM et engagements, OAuth standard, maintenance HubSpot | Pas de trigger côté HubSpot, pas de stockage vectoriel, OAuth 2.1 requis côté client |
| Connecteur natif Claude × HubSpot (lancé le 29 juillet 2025) | Équipes qui vivent dans Claude (Pro, Max, Team, Enterprise) | Installation en 1 clic depuis Claude, respect automatique des permissions HubSpot, Anthropic n’utilise pas la donnée pour l’entraînement | Lecture seule sur contacts, companies, deals, tickets, et leurs associations |
| Communautaire shinzo-labs, baryhuang, scopious | Devs qui veulent outils sur mesure, stockage vectoriel ou self-host | Code ouvert MIT, outils en plus (FAISS chez baryhuang, semantic search), install npx ou Docker | Token HubSpot statique (OAuth planifié chez shinzo-labs), maintenance à votre charge, pas de SLA |
| Serveur développeur local | Devs qui créent des UI Extensions et des assets CMS HubSpot | Contexte HubSpot complet pour un copilote de code, intégration CLI | Ne sert pas au pilotage du CRM côté marketing ops |
Pour aller plus loin dans le choix d’outils IA côté CRM, notre comparatif CRM 2026 replace HubSpot dans un marché qui s’est verticalisé depuis deux ans. Si vous hésitez entre MCP et intégration classique, notre guide stratégie CRM cadre la question de la gouvernance avant de choisir la couche d’exécution.
Le HubSpot MCP est une porte, pas un worker : il ne déclenche rien tout seul, chaque appel coûte un appel API HubSpot, et la bascule OAuth 2.1 arrive. Quatre points à verrouiller avant d’ouvrir un agent sur un portail de prod.
Dernier point de gouvernance : un MCP CRM est une couche d’exécution, pas une stratégie. Pour cadrer les cas d’usage de Claude dans une équipe B2B avant d’installer un serveur, voir notre ressource Claude pour le marketing B2B. Et pour comparer avec d’autres serveurs MCP déjà en production, voir notre guide MCP LinkedIn.
mcp.hubspot.com, GA 13 avril 2026) pour piloter le CRM, et le serveur développeur local (GA 19 février 2026) pour coder sur HubSpot.Si votre pipeline HubSpot souffre de deals qui traînent et de données qui dérivent, ces cinq routines ne tiendront que si la fondation est propre. Faire l’audit de votre pipeline HubSpot avec Bulldozer prend deux semaines et vous dit quoi brancher, dans quel ordre.
Lorem ipsum
Vous ne trouvez pas votre réponse ? Contactez-nous !
jordan@bulldozer-collective.comAccédez aux playbooks et aux retours de ceux qui façonnent la prochaine vague du marketing et de l'IA.
