Serveur MCP HubSpot : quelle voie choisir, ce qu’il sait faire, où il s’arrête

Serveur MCP HubSpot : quelle voie choisir, ce qu’il sait faire, où il s’arrête

Oui, HubSpot a un serveur MCP officiel. Le serveur distant à l’adresse https://mcp.hubspot.com permet à Claude, à ChatGPT et à d’autres clients MCP de lire et de modifier les enregistrements de votre compte HubSpot, et il est disponible pour tous les comptes HubSpot depuis le 13 avril 2026. Si vous utilisez Claude ou ChatGPT, vous n’avez rien à construire : vous installez le connecteur prêt à l’emploi de HubSpot et vous vous connectez. Vous ne créez votre propre connecteur MCP dans HubSpot que pour connecter un autre client.

HubSpot fournit aussi un second serveur, sans rapport avec le premier, destiné aux développeurs et qui s’exécute en local via la CLI HubSpot. La plupart des confusions autour de « HubSpot MCP » viennent du mélange entre les deux, ou entre le serveur de HubSpot et les nombreux serveurs communautaires de GitHub.

Transparence : Customermates, un CRM open source doté de son propre serveur MCP, publie ce guide. Les informations sur HubSpot ont été vérifiées le 8 octobre 2026 auprès des pages de HubSpot, liées dans la ligne de sources à la fin.

En bref

Serveur distant

Hébergé par HubSpot sur mcp.hubspot.com. Lit et écrit les enregistrements du CRM, les activités et les contenus marketing, toujours dans les limites des autorisations HubSpot de l’utilisateur connecté.

Voie la plus rapide

Claude et ChatGPT : installez le connecteur de HubSpot et connectez-vous avec OAuth. HubSpot indique que le connecteur Claude est gratuit sur toutes les formules HubSpot.

Autres clients

Créez un connecteur MCP sous Development dans HubSpot, puis utilisez son ID client et son secret dans un client compatible OAuth avec PKCE.

Principales limites

Les données d’activité et de conversation sont bloquées quand Sensitive Data est activé, l’accès en écriture documenté ne prévoit pas de suppression, et certains outils exigent des hubs payants.

Choisissez d’abord votre voie

La question « comment connecter HubSpot MCP » a quatre réponses différentes, selon le client et la tâche.

Les serveurs tiers sont une cinquième option. Zapier, par exemple, propose des actions HubSpot via son propre serveur MCP sur mcp.zapier.com, et GitHub héberge plusieurs serveurs HubSpot créés par la communauté que vous exploitez vous-même. Ils sont utiles quand vous voulez un seul serveur MCP pour de nombreuses applications. Ce ne sont pas des serveurs de HubSpot : leur périmètre, leur maintenance et leur traitement des données dépendent de leur mainteneur.

Ce que le serveur distant peut lire et écrire

Le guide d’intégration de HubSpot détaille les accès. En résumé :

Deux détails comptent pour la planification. Le serveur repose sur l’API de recherche CRM de HubSpot, qui n’a pas de recherche vectorielle selon HubSpot : l’IA trouve donc les enregistrements par des filtres et des propriétés, pas par le sens. Et quand un enregistrement est créé ou mis à jour, le serveur applique la logique conditionnelle des champs et les validations d’étape de pipeline du compte, si bien que l’IA ne peut pas sauter un champ obligatoire qu’un humain ne pourrait pas sauter non plus.

Les limites documentées par HubSpot

• Sensitive Data bloque les activités. Si Sensitive Data est activé sur votre compte, les appels, e-mails, réunions, notes, tâches et conversations sont bloqués via le serveur MCP. HubSpot précise que cela ne concerne que MCP, pas ses API CRM standard.
• Pas de suppression. L’accès en écriture documenté couvre la création, la modification, la consignation et la publication. La suppression d’enregistrements n’est pas indiquée, le nettoyage reste donc un travail manuel dans HubSpot.
• Les autorisations se transmettent. Chaque appel s’exécute au nom de l’utilisateur connecté et respecte ses autorisations HubSpot. L’accès à une boîte de réception restreinte à certains utilisateurs ou équipes l’est aussi via MCP.
• Les périmètres sont fixés à l’installation. Vous ne choisissez pas vous-même les périmètres (scopes). Ils viennent des outils disponibles à l’installation et des autorisations accordées par l’utilisateur. Quand HubSpot ajoute des outils, les utilisateurs existants doivent réinstaller pour accorder les nouveaux périmètres.
• Certains outils exigent des hubs payants. Les métriques AEO et les prompts suivis exigent Marketing Hub Professional ou Enterprise ; les devis exigent Revenue Hub Professional ou Enterprise.
• L’analyse est limitée. L’outil de requête SQL gère le filtrage, l’agrégation et le tri, mais HubSpot indique qu’il n’a ni jointures, ni sous-requêtes, ni parcours des associations, ni conversion de devises. Des questions comme « taux de gain par transition d’étape le trimestre dernier » peuvent demander plusieurs appels ou un rapport construit dans HubSpot.

La connexion pas à pas : la voie personnalisée

Pour Claude et ChatGPT, le connecteur gère tout ce qui suit. Pour tout autre client, le guide de HubSpot décrit ces étapes :

1. Créez un connecteur MCP

   Dans HubSpot, allez dans Development, puis MCP Connectors, puis Create MCP connector. Saisissez un nom, une description facultative et l’URL de redirection utilisée par votre client. Pour des tests avec MCP Inspector, HubSpot demande d’ajouter http://localhost:6274/oauth/callback/debug.

2. Copiez les identifiants

   La page de détails du connecteur affiche l’ID client, le secret client et les URL de redirection. L’URL de redirection doit correspondre exactement à celle configurée dans votre client.

3. Pointez le client vers le serveur

   Configurez votre client avec https://mcp.hubspot.com et les identifiants. Le client doit exécuter le flux OAuth avec PKCE. MCP Inspector le fait automatiquement ; dans une intégration sur mesure, vous l’implémentez vous-même.

4. Autorisez et vérifiez

   Choisissez le compte HubSpot, accordez les autorisations et validez. Appelez ensuite get_user_details : HubSpot le recommande pour voir quels outils et quels objets votre compte peut réellement utiliser.

Si un client cesse de fonctionner après une période d’inactivité, la cause habituelle est le renouvellement du jeton. Le client doit utiliser le jeton d’actualisation de la première connexion ; s’il a lui aussi expiré, relancez le flux OAuth.

Le serveur MCP développeur de HubSpot

Le serveur MCP développeur s’exécute sur votre machine et se configure avec hs mcp setup (CLI HubSpot 8.2.0 ou ultérieure). Il fonctionne avec Claude Code, Codex CLI, Cursor, Gemini CLI, VS Code et Windsurf et y apparaît sous le nom « HubSpotDev ». HubSpot le décrit comme des outils pour les tâches de développement d’applications et de CMS. Ce n’est pas la voie pour une équipe commerciale qui veut travailler avec les enregistrements du CRM ; c’est le rôle du serveur distant.

Une checklist de déploiement pour une petite équipe

1. Vérifiez d’abord Sensitive Data. S’il est activé, MCP ne verra ni les activités ni les conversations, ce qui supprime la plupart des questions utiles sur une affaire. Mieux vaut le savoir avant que quelqu’un essaie.
2. Passez en revue les autorisations des utilisateurs dans HubSpot. L’IA voit exactement ce que voit l’utilisateur. Si un utilisateur peut modifier toutes les affaires, son client connecté le peut aussi.
3. Commencez par la lecture. De bons premiers prompts : « Résumez les cinq dernières activités de l’affaire Acme », « Quelles affaires ouvertes à l’étape Proposition n’ont eu aucune activité depuis 14 jours ? », « Listez les contacts chez Acme et leur dernière réunion. »
4. Autorisez ensuite la consignation. « Consigne une note sur l’affaire Acme : appel mardi, budget validé, envoyer le projet de contrat. » Vérifiez ensuite la note dans HubSpot.
5. Gardez la publication entre des mains humaines. Le serveur peut publier des pages d’atterrissage et des articles de blog. Décidez qui peut demander cela à une IA avant que quelqu’un ne le fasse par accident.
6. Restreignez les comptes là où c’est possible. HubSpot souligne que les administrateurs de Claude Enterprise peuvent limiter le connecteur aux comptes fournis par l’entreprise, avec des restrictions de domaine vérifiées.

Un point de plus pour les équipes de l’UE : tout ce que le client IA lit dans HubSpot est traité par le fournisseur d’IA de ce client. Vos conditions de traitement des données HubSpot ne couvrent pas ce maillon : vérifiez donc les conditions du fournisseur d’IA et votre propre registre des traitements avant de connecter des données clients. La fiche ChatGPT de HubSpot précise aussi que le chat dans le connecteur n’est actuellement pas disponible avec la formule ChatGPT Pro pour les utilisateurs de l’EEE, de la Suisse et du Royaume-Uni.

Quand le CRM lui-même a un serveur MCP

Si vous choisissez un CRM plutôt que d’en connecter un existant, un serveur MCP intégré au CRM est l’alternative. Customermates en est un exemple : le point d’accès /api/v1/mcp fait partie de chaque formule cloud et des installations auto-hébergées. Dans Claude et ChatGPT, vous l’ajoutez comme connecteur personnalisé et vous vous connectez (guide de configuration) ; Claude Code, Codex, Cursor et Gemini CLI se connectent avec une clé API (configuration en ligne de commande). Un client connecté découvre 58 outils, et vous pouvez restreindre l’ensemble avec un paramètre d’URL, comme décrit dans la référence MCP.

Pouvoir supprimer et envoyer coupe dans les deux sens. Le serveur Customermates indique aux clients connectés de demander une confirmation avant de supprimer ou d’envoyer, mais c’est une consigne donnée au client, pas une barrière dans le serveur : dès qu’un client autorisé appelle un outil, celui-ci s’exécute. Vérifiez comment votre client gère les approbations d’outils, et commencez par la lecture et les brouillons, comme avec HubSpot.

Le coût fonctionne aussi différemment. MCP est inclus à partir de Starter à 12 € par utilisateur et par mois ; les outils de la boîte de réception exigent Pro à 29 €. Un client IA externe utilise votre propre abonnement IA, pas les crédits de Customermates. Customermates Cloud a aussi Mate, un assistant intégré qui utilise des crédits IA hébergés, si vous préférez ne connecter aucun client externe (documentation de Mate).

Customermates n’est pas le bon choix si vous vous appuyez sur les outils marketing, le help desk ou les objets de revenus de HubSpot ; il n’en a aucun. Si vous restez sur HubSpot, utilisez le serveur de HubSpot. Si vous envisagez de changer, la comparaison avec les alternatives à HubSpot présente les compromis, et le guide du MCP Salesforce explique les serveurs équivalents chez Salesforce.

Questions fréquentes

Sources : informations sur HubSpot vérifiées le 8 octobre 2026 auprès du guide d’intégration du serveur MCP distant, du journal des modifications sur la disponibilité générale, du guide de configuration du MCP développeur, de la page du connecteur Claude de HubSpot, de la fiche du connecteur ChatGPT de HubSpot, de HubSpot AI tools et de la page HubSpot MCP de Zapier.