--- title: "MCP HubSpot pour Claude Desktop: mission client ou plugin ouvert" description: "Ce qu’un plugin MCP HubSpot open source ne fait pas pour une PME, et ce que je construis en mission: champs, écritures confirmées, journal." canonical: "https://www.gatien.dev/fr/topics/mcp-hubspot-claude" --- # MCP HubSpot pour Claude Desktop: mission client ou plugin ouvert Ce qu’un plugin MCP HubSpot open source ne fait pas pour une PME, et ce que je construis en mission: champs, écritures confirmées, journal. Chercher « MCP HubSpot » mène à des dépôts GitHub, pas à quelqu’un qui livre ça pour une PME au Québec. Ces dépôts sont utiles. Ils montrent que l’API HubSpot peut devenir des outils qu’un client MCP, dont Claude Desktop, sait appeler. Ils ne connaissent pas votre pipeline, vos propriétés en français, ni la règle « on ne crée pas de deal sans qu’un humain clique ». La checklist générale, valable pour n’importe quel CRM, est sur [brancher Claude ou Cursor sur un CRM](/fr/topics/serveur-mcp-crm-claude-cursor). Ici, c’est HubSpot. ## Ce que le plugin ouvert fait en général - Il liste des objets standards: contacts, compagnies, deals, parfois tickets. - Il appelle l’API avec le jeton que vous collez dans la config du client. - Il vous laisse souvent lire et écrire avec les mêmes droits que la clé. C’est assez pour un essai sur un compte bac à sable. Ce n’est pas assez pour l’équipe des ventes. ## Ce que je construis en mission - La liste courte des opérations. Exemple: chercher un contact par courriel, lire le stage du deal, préparer une note. Pas « toutes les routes de l’API ». - Vos noms de propriétés, y compris les champs custom en français, mappés une fois. Le modèle n’invente pas dealstage . - Lecture par défaut. L’écriture ouvre une fiche: champs qui vont changer, bouton confirmer, puis l’appel API. - Le jeton dans un secret, avec les portées HubSpot minimales. Une clé privée super-admin n’a rien à faire dans le fichier mcp.json commité. - Un journal: outil, identifiant HubSpot, succès ou erreur. Pas le contenu complet de la note si elle contient un téléphone. ## Où les missions dérapent HubSpot refuse l’écriture quand une propriété obligatoire manque, ou quand le stage n’existe pas dans ce pipeline. Un plugin générique renvoie l’erreur JSON dans le chat. En mission, l’erreur devient une phrase: quelle propriété manque, sur quel deal. On le voit sur vos exemples, pas sur le compte démo du dépôt. Les notes HubSpot sont aussi une entrée non fiable. Une note collée depuis l’externe peut contenir une instruction au modèle. L’outil de lecture renvoie les champs prévus, pas le HTML brut de toutes les notes. ## Plugin ou mission Dépôt ouvert Mission Compte Le vôtre, si vous collez la clé. Le vôtre, clé hors du dépôt. Propriétés custom À vous de les découvrir. Mappées pour votre portail. Écriture Souvent directe, au droit de la clé. Après confirmation. Maintenance Vous suivez le dépôt, ou pas. Code dans votre Git, page de limites incluse. Si le dépôt ouvert couvre déjà votre essai bac à sable, gardez-le. Appelez-moi quand l’équipe doit s’en servir sur le vrai portail. Trois fiches HubSpot, la liste des propriétés qui comptent, et ce que le modèle n’a pas le droit de changer: [réservez 15 min](https://cal.com/gatien-boquet-x6xt0h/15min). On voit si ça tient dans [l’automatisation PME](/fr/services/automatisation-ia-pme) ou s’il faut le [prototype de 14 jours](/fr/services/prototype-ia) d’abord. ## FAQ ### Le plugin open source est-il dangereux? Il est dangereux si la clé a tous les droits et si les écritures partent sans confirmation. Le code public n’est pas le problème. La portée du jeton l’est. ### Faut-il un compte HubSpot payant précis? Il faut un portail où les objets et les propriétés de la mission existent, et une clé privée dont vous contrôlez les portées. Le palier exact se vérifie sur vos besoins d’API, pas sur cette page. ### Claude Desktop est-il obligatoire? Non. Le même serveur peut servir Claude Desktop ou Cursor. L’écran de confirmation, lui, ne devrait pas vivre seulement dans le chat. ### Pouvez-vous reprendre un dépôt MCP HubSpot déjà cloné? Oui, si la licence du dépôt le permet et que vous voulez le réduire à vos outils. Sinon je l’écris dans votre dépôt, plus court, limité à votre portail. --- Source page: https://www.gatien.dev/fr/topics/mcp-hubspot-claude Agent index: https://www.gatien.dev/llms.txt Sitemap: https://www.gatien.dev/sitemap.xml