HubSpot MCP Server

Qu'est-ce que le Serveur HubSpot MCP ?

Le serveur HubSpot MCP est une application serveur légère qui expose les capacités CRM de HubSpot sous forme d'outils MCP standardisés. Grâce à cette intégration, des clients IA comme Claude Desktop, Cursor, et d'autres compatibles avec le protocole de modèle de contexte peuvent accéder, interroger et modifier les données HubSpot de façon sécurisée, sans nécessiter d'intégration API manuelle ou d'apprentissage des spécificités de l'API de HubSpot. Il simplifie les opérations CRM complexes en commandes faciles à utiliser pour les flux de travail pilotés par IA et l'automatisation des agents.

Comment Configurer le Serveur HubSpot MCP

Installer Node et NPM : Téléchargez et installez Node.js et npm depuis nodejs.org.
Créer une Application Privée HubSpot :
- Allez sur votre tableau de bord HubSpot : Paramètres > Intégrations > Applications Privées.
- Cliquez sur "Créer une application privée", donnez-lui un nom, définissez les autorisations requises, et copiez le token d'accès généré.
Configurer le Client MCP :
- Pour Claude Desktop :
  - Ajoutez la configuration du serveur HubSpot avec votre token d'accès dans votre fichier de configuration Claude (claude_desktop_config.json) et redémarrez l'application.
- Pour Cursor :
  - Ajoutez la configuration dans .cursor/mcp.json dans votre répertoire de projet.
- Pour d'autres clients MCP, suivez leurs instructions spécifiques pour configurer des serveurs MCP externes.
Variable d'Environnement : Assurez-vous que le PRIVATE_APP_ACCESS_TOKEN est correctement configuré.

Comment Utiliser le Serveur HubSpot MCP

Après avoir configuré le serveur, redémarrez votre client MCP (par exemple, Claude Desktop ou Cursor).
Vous pouvez maintenant accéder directement aux outils spécifiques à HubSpot depuis votre client IA. Utilisez des requêtes telles que "Obtenez la dernière mise à jour sur Acme Inc." ou "Créez un nouveau contact dans mon compte HubSpot".
L'agent IA utilisera les outils MCP pour réaliser des opérations CRM, tirer des informations, et mettre à jour des enregistrements comme demandé.
Visitez la documentation correspondante ou la page de dépannage si vous rencontrez des problèmes de configuration.

Caractéristiques Clés

Accès Unifié : Connectez-vous à HubSpot depuis n'importe quel client compatible avec MCP sans manipulation API manuelle.
Fonctionnalités Étendues : Effectuez une large gamme d'actions CRM, de la lecture et mise à jour des enregistrements à la gestion des associations, des flux de travail et des engagements.
Sécurisé et Flexible : Fonctionne de manière sécurisée en utilisant le token d'accès de votre application privée et ne nécessite pas d'exposition des identifiants HubSpot.
Extensible : Profitez d'une suite croissante d'outils MCP adaptés à votre flux de travail CRM HubSpot.
Support de Feedback : Générez instantanément des liens de feedback pour signaler ou suggérer des améliorations.

Cas d'Utilisation

Informations sur les Données CRM : Résumez les transactions, les tickets et les interactions d'entreprise pour une intelligence d'affaires instantanée.
Gestion de Contacts & Transactions : Automatisez la création, la mise à jour et l'association de contacts, entreprises, transactions et tickets.
Suivi des Activités : Ajoutez des notes ou des tâches, et suivez les actions en retard dans le CRM.
Analyse des Flux de Travail : Récupérez et analysez les flux de travail HubSpot, les inscriptions, et la planification.
Gestion des Propriétés Personnalisées : Listez, créez et mettez à jour des propriétés personnalisées sur les objets CRM de manière programmatique.

FAQ

Q1 : Quelles autorisations ai-je besoin pour mon application privée HubSpot pour utiliser le serveur MCP ?
R : Il est recommandé de commencer avec des autorisations en lecture seule pour la configuration initiale. Au fur et à mesure de votre utilisation, accordez uniquement les autorisations nécessaires pour les opérations souhaitées (par exemple, lecture/écriture d'objet CRM, accès aux engagements, gestion des propriétés).

Q2 : Mes données HubSpot sont-elles en sécurité lors de l'utilisation du serveur MCP ?
R : Oui. Le serveur MCP fonctionne entièrement dans votre infrastructure et n'utilise que le token d'accès de votre application privée configurée. Aucun identifiant HubSpot ou données sensibles ne sont stockés ou exposés en dehors de votre configuration.

Q3 : Puis-je utiliser le Serveur HubSpot MCP avec plusieurs applications clientes MCP ?
R : Oui, vous pouvez ajouter la configuration du serveur à tout client compatible MCP, tel que Claude Desktop ou Cursor, et accéder aux outils HubSpot dans chacun.

Q4 : Comment puis-je fournir des retours ou signaler un problème avec les outils MCP ?
R : Utilisez l'outil hubspot-generate-feedback-link pour générer une URL de feedback, ou utilisez la requête dédiée dans votre client MCP.

Q5 : Quel type d'actions puis-je automatiser en utilisant des agents IA avec ce serveur ?
R : Vous pouvez automatiser tout, de la création massive d'enregistrements aux générations de rapports, en passant par la gestion des associations et le suivi des engagements — tout cela via des requêtes en langage naturel.

Nom du Protocole	Description
hubspot-get-user-details	Authentifie le token d'accès de l'application privée HubSpot et récupère les informations d'utilisateur, les détails du portail, les autorisations autorisées et les métadonnées du compte.
hubspot-list-objects	Récupère une liste paginée des enregistrements CRM pour un type d'objet spécifié (par exemple, contacts, entreprises, transactions ou tickets).
hubspot-search-objects	Effectue des recherches filtrées sur votre CRM HubSpot en utilisant des critères personnalisés et des filtres basés sur les propriétés à travers différents types d'enregistrements.
hubspot-batch-create-objects	Crée plusieurs enregistrements CRM d'un même type en une seule appel, optimisant ainsi la saisie massive et les workflows d'intégration.
hubspot-batch-update-objects	Met à jour plusieurs enregistrements CRM existants avec de nouvelles valeurs de propriété dans une seule opération.
hubspot-batch-read-objects	Récupère plusieurs enregistrements CRM par leurs IDs en une seule appel, optimisant les performances pour les requêtes en lot.
hubspot-get-schemas	Liste les schémas d'objets personnalisés disponibles, affichant les objectTypeIds et leurs définitions pour une personnalisation avancée du CRM.
hubspot-list-properties	Liste toutes les définitions de propriétés pour n'importe quel type d'objet CRM HubSpot, offrant un aperçu du schéma et des champs personnalisés.
hubspot-get-property	Récupère des métadonnées détaillées sur une définition de propriété CRM spécifique.
hubspot-create-property	Crée une nouvelle propriété personnalisée pour un type d'objet CRM spécifié.
hubspot-update-property	Met à jour les paramètres et la configuration d'une propriété personnalisée existante.
hubspot-create-association	Établit ou met à jour des relations entre des enregistrements CRM (comme associer un contact à une entreprise).
hubspot-list-associations	Récupère toutes les associations entre un enregistrement CRM spécifique et tout enregistrement associé.
hubspot-get-association-definitions	Fournit une liste des types et étiquettes d'association valides entre les types d'objets CRM spécifiés.
hubspot-create-engagement	Crée un nouvel engagement, tel qu'une note ou une tâche, en l'associant à des contacts, entreprises, transactions ou tickets pertinents.
hubspot-get-engagement	Récupère les détails d'un engagement pour un ID d'engagement spécifique.
hubspot-update-engagement	Met à jour les détails ou propriétés d'un engagement existant.
hubspot-list-workflows	Récupère et liste les workflows disponibles configurés dans votre compte HubSpot.
hubspot-get-workflow	Obtient des informations détaillées sur un workflow spécifique, y compris les déclencheurs, actions et planification inscrits.
hubspot-generate-feedback-link	Génère une URL de feedback pour signaler des problèmes, suggérer de nouvelles fonctionnalités d'outil, ou fournir d'autres retours concernant les outils MCP.
hubspot-get-link	Génère une URL directe de l'interface utilisateur HubSpot pour afficher des enregistrements CRM spécifiques dans votre portail.