Sommaire▾
Le Model Context Protocol (MCP) d'Anthropic, annoncé fin 2024 et stabilisé en 2025, est devenu en 2026 le standard de fait pour connecter un LLM à des outils externes. HubSpot — leader du CRM mid-market avec plus de 250 000 clients dans le monde — fait partie des premières plateformes à avoir un serveur MCP officiel et plusieurs serveurs communautaires production-ready. Cet article décrit l'architecture, le setup pas à pas, les cas d'usage PME B2B testés chez OKB et les pièges à éviter quand on remplace un Zapier ou un Make par une connexion MCP directe entre Claude et HubSpot. Pour le contexte général du protocole, voir notre guide MCP Protocol complet.
---Points clés
À la fin de cet article, vous saurez si MCP × HubSpot est pertinent pour votre stack 2026, comment installer un serveur MCP HubSpot en 30 minutes et quels cas d'usage déployer en premier.---
Pourquoi connecter HubSpot via MCP plutôt que via API directe ?
Avant MCP, intégrer HubSpot dans un workflow IA passait par 3 chemins typiques :
MCP ajoute un 4e chemin radicalement différent : Claude (le LLM) appelle directement des outils HubSpot exposés par un serveur MCP, à la demande, dans une conversation. Pas de workflow pré-écrit, pas de scénario à configurer. Vous demandez « cherche-moi tous les contacts qui n'ont pas répondu depuis 30 jours dans le pipeline Closed Won candidates et résume » — Claude appelle les bons outils MCP, traite la réponse, vous restitue.
Concrètement, qu'est-ce que ça change pour une PME B2B ?💡 Lecture OKB : MCP × HubSpot ne remplace pas votre orchestrateur (Make/n8n/Zapier). Il complète votre stack en couvrant les requêtes ad-hoc, le reporting conversationnel et la qualification ad-hoc. Sur 40+ déploiements OKB 2024-2026, on observe que MCP supplante 30-40 % des Zaps/scénarios Make basiques mais qu'il reste insuffisant pour 60 % des cas qui exigent un déclencheur événementiel ou un branchement conditionnel.
→ Lire aussi
MCP protocol : le guide 2026 (comprendre et déployer)
Architecture MCP × HubSpot
Le MCP repose sur 3 composants :
1. Le client MCP — c'est ce qui parle à Claude. Aujourd'hui, les clients MCP sont : Claude Desktop, Claude.ai (web), Cursor, Continue, Cline, et de plus en plus d'outils tiers. Le client envoie les requêtes au LLM avec la liste des outils disponibles. La documentation officielle MCP maintient la liste à jour des clients compatibles. 2. Le serveur MCP HubSpot — c'est lui qui expose des outils (tools) que Claude peut appeler. Exemples :search_contacts, create_contact, update_deal_stage, list_companies. Le serveur traduit les appels en API HubSpot REST sous le capot.
3. La couche d'authentification — le serveur MCP utilise une clé API HubSpot (Private App token) ou une OAuth pour accéder aux données. Cette clé est stockée localement, jamais envoyée à Claude.
[Claude Desktop / Claude.ai]
↓ MCP protocol (stdio ou HTTP)
[Serveur MCP HubSpot]
↓ API REST HubSpot avec Private App token
[HubSpot Cloud]
Cette architecture a deux conséquences majeures pour les PME B2B :
Pour les PME RGPD-strictes, l'option locale ou serveur d'entreprise est recommandée. Pour les autres, le serveur en local sur les postes Claude Desktop des utilisateurs est le plus simple à déployer.
Setup pas à pas — serveur MCP HubSpot en 30 minutes
Voici le setup minimal testé sur Claude Desktop (macOS/Windows/Linux) en 2026, avec un serveur MCP HubSpot communautaire open-source. Le serveur officiel HubSpot est encore en béta restreinte au moment de la rédaction.
Étape 1 — Créer une Private App HubSpot
Dans HubSpot : Settings → Integrations → Private Apps → Create a private app. Donnez-lui un nom explicite (« Claude MCP — read-only » par exemple) et configurez les scopes minimaux nécessaires : crm.objects.contacts.read, crm.objects.companies.read, crm.objects.deals.read. Ne donnez pas de scope write avant d'avoir testé en read-only. Récupérez le token affiché à la fin (commence par pat-na1-...). La doc officielle HubSpot Private Apps couvre les options avancées (rotation, scopes spécifiques par objet).
Étape 2 — Installer Node.js et un serveur MCP HubSpot
Plusieurs serveurs MCP HubSpot communautaires existent en 2026 (chercher mcp-server-hubspot sur GitHub et npm, ou parcourir le registre officiel des serveurs MCP). Installez celui qui a la meilleure traction (étoiles, dernière maj <30 jours, license MIT/Apache). Le pattern d'installation typique :
bash
npm install -g @<auteur>/mcp-server-hubspot
Étape 3 — Configurer Claude Desktop
Éditez le fichier claude_desktop_config.json (Settings → Developer → Edit Config) :
json
{
"mcpServers": {
"hubspot": {
"command": "npx",
"args": ["-y", "@<auteur>/mcp-server-hubspot"],
"env": {
"HUBSPOT_PRIVATE_APP_TOKEN": "pat-na1-VOTRE-TOKEN"
}
}
}
}
Redémarrez Claude Desktop. Le serveur MCP HubSpot apparaît dans la liste des outils disponibles (icône clé en bas de la zone de chat).
Étape 4 — Tester avec une requête simple
Dans Claude Desktop, demandez : « Cherche tous les contacts HubSpot avec le tag "Lead chaud" mis à jour ce mois-ci ». Claude appellera l'outil MCP correspondant (search_contacts avec filtre tag + date), récupèrera les résultats et vous les restituera en langage naturel.
⚠️ Piège classique : si Claude répond « je n'ai pas accès à HubSpot », vérifiez que le serveur MCP est bien chargé (icône clé visible) et que les scopes Private App couvrent bien la requête. C'est l'erreur n°1 chez les PME qui découvrent MCP.
Étape 5 — Étendre progressivement les permissions
Une fois le read-only validé, ajoutez les scopes write au fur et à mesure : crm.objects.contacts.write, crm.objects.deals.write, etc. Toujours en mode progressif, jamais en donnant tous les scopes d'un coup. Recommandation OKB : auditer les permissions tous les 3 mois et révoquer ce qui n'est pas utilisé.
5 cas d'usage MCP × HubSpot testés en PME B2B
Cas 1 — Qualification de leads conversationnelle
Le commercial a un nouveau lead qui vient d'arriver. Au lieu d'aller dans HubSpot, il demande à Claude : « Le lead Marie Dupont, CTO chez Acme — récupère son profil HubSpot, son historique de touchpoints, et fais un brief de 5 lignes pour mon prochain call ». Claude appelle 3 outils MCP, agrège, restitue. Gain de temps observé chez OKB : 5-10 min/lead pour les commerciaux qui faisaient ce travail manuellement.
Pour aller plus loin sur la qualification automatique, voir notre guide agent IA de qualification de leads B2B.
Cas 2 — Reporting commercial ad-hoc
Un manager demande : « Quels sont les 10 deals avec le plus gros ARR potentiel actuellement bloqués en stage Negotiation depuis plus de 30 jours ? ». Claude requête HubSpot via MCP, agrège, restitue. Ce cas remplace le tableau de bord HubSpot pour les managers qui veulent une réponse rapide sans naviguer dans l'UI.
Cas 3 — Enrichissement à la volée
Un commercial reçoit un email entrant d'un prospect inconnu. Il demande à Claude : « Récupère tout ce qu'on a sur cette adresse email dans HubSpot, et si rien, cherche dans LinkedIn ce que tu peux deviner ». Claude orchestre l'appel HubSpot MCP + outil de recherche, restitue un résumé.
Cas 4 — Maintenance et nettoyage de données
L'équipe ops demande tous les mois : « Liste les contacts HubSpot sans téléphone ni LinkedIn URL, créés depuis plus de 6 mois, jamais contactés ». Claude requête MCP, restitue la liste, propose de mettre en lifecycle stage "Other" en bulk. Cas où MCP excelle vs Make : c'est ad-hoc, pas un workflow récurrent, configurer un scénario Make pour ça serait du sur-engineering. Pour structurer un CRM HubSpot en amont de ce type d'opérations, voir notre guide pour structurer un CRM B2B.
Cas 5 — Création de contacts depuis sources externes
Un commercial vient d'ajouter 5 nouveaux contacts dans une conversation Slack. Il copie-colle dans Claude : « Crée ces 5 contacts dans HubSpot avec le tag "Event Q2 2026" ». Claude parse, appelle create_contact 5 fois via MCP, confirme. Pour des volumes <50 contacts, c'est plus rapide que de configurer un import CSV ou un workflow Make.
💡 Cas où MCP × HubSpot est PIRE qu'une alternative : workflows événementiels (« quand X se passe dans HubSpot, fais Y ») — restez sur les webhooks HubSpot + Make/n8n. Workflows à fort volume répété (>1 000 actions/jour identiques) — restez sur API directe ou Make. Workflows multi-systèmes complexes (HubSpot → Stripe → Slack avec branchements) — restez sur n8n.
MCP vs Zapier vs Make pour intégrer HubSpot : comparaison
| Critère | MCP × HubSpot | Zapier × HubSpot | Make × HubSpot |
|---|---|---|---|
| Setup initial | 30 min (local) | 5 min (UI) | 15 min (UI) |
| Coût mensuel | Tokens Claude (variable) | 30-110 €/mois | 9-29 €/mois |
| Workflows événementiels | ❌ Non (pas de trigger) | ✅ Oui (triggers natifs) | ✅ Oui (modules webhook) |
| Requêtes ad-hoc conversationnelles | ✅ Excellent | ❌ Pas du tout | ❌ Pas du tout |
| Reporting conversationnel | ✅ Excellent | ❌ Pas du tout | ❌ Pas du tout |
| Volume haut (>1000/jour) | ⚠️ Limité (tokens) | ✅ Bon (avec plan élevé) | ✅ Très bon |
| Sécurité (data flow) | ✅ Local possible | ⚠️ Cloud Zapier US | ⚠️ Cloud Make UE |
| Maintenance | Faible | Moyenne | Moyenne |
Sécurité et bonnes pratiques 2026
Règle 1 — Scopes minimaux. Ne donnez jamais à un serveur MCP HubSpot plus de scopes que nécessaire. Démarrer en read-only, ajouter le write progressivement. Auditer tous les 3 mois. Règle 2 — Token rotation. Les Private App tokens HubSpot ne expirent pas par défaut. Mettez en place une rotation manuelle tous les 6-12 mois, surtout si plusieurs personnes ont accès au config Claude Desktop. Règle 3 — Serveur MCP audité. Si vous installez un serveur MCP communautaire, lisez le code (c'est de l'open-source). Vérifiez qu'aucune donnée n'est envoyée à un endpoint tiers (analytics, télémétrie). Préférer les projets avec >100 étoiles GitHub et activité récente. Règle 4 — Logs locaux. Activez les logs serveur MCP pour tracer ce que Claude appelle. Utile pour audit et debug. Règle 5 — Mode dégradé. Si l'API HubSpot tombe ou si le rate limit est atteint, le serveur MCP doit échouer proprement, pas crasher Claude Desktop. Vérifiez la qualité de gestion d'erreur du serveur que vous utilisez. Pour un design MCP plus large dans un déploiement d'agents IA autonomes, voir notre guide agents IA autonomes pour PME B2B.Limitations actuelles à connaître
update_contact avec une mauvaise valeur, pas de rollback automatique. Sécuriser via prompt système ou via scopes restrictifs.🚀 Vous voulez tester MCP × HubSpot dans votre stack 2026 ? OKB déploie ce type de connexion en 1-2 jours sur un cas d'usage prioritaire. Si vous voulez challenger un design avant implémentation ou auditer un setup déjà en place, parlez-nous de votre situation — un cadrage de 30 minutes suffit souvent à valider la trajectoire.---
FAQ — MCP × HubSpot en 2026
MCP HubSpot remplace-t-il Zapier ou Make ?
Non, pas en remplacement total. MCP × HubSpot couvre les requêtes ad-hoc, le reporting conversationnel et la qualification ponctuelle. Pour les workflows événementiels (triggers HubSpot), les automatisations à fort volume répété, ou les chaînes multi-systèmes complexes, Zapier ou Make restent meilleurs. Sur 40+ déploiements OKB, MCP supplante 30-40 % des Zaps/scénarios Make basiques — pas plus.
Quel coût mensuel anticiper pour MCP × HubSpot en PME B2B ?
Le coût est uniquement en tokens Claude consommés par les requêtes. Pour une PME 10 personnes utilisant MCP × HubSpot 5-10 fois/jour chacun, comptez 15-50 €/mois en tokens via un abonnement Claude Pro/Team. Le serveur MCP lui-même est gratuit (open-source) ou tourne en local sans coût d'infra. Très en-dessous des 30-110 €/mois de Zapier équivalent.
Le serveur MCP HubSpot officiel d'Anthropic existe-t-il en 2026 ?
Anthropic a publié les specs MCP fin 2024 mais ne maintient pas tous les serveurs. HubSpot a annoncé son propre serveur MCP officiel en béta en 2025. Les fonctionnalités sont encore limitées par rapport aux serveurs communautaires en open-source, qui couvrent typiquement plus de scopes et d'objets HubSpot. Pour 2026, la majorité des PME utilisent encore les serveurs communautaires en attendant la GA officielle HubSpot.
Mes données HubSpot transitent-elles par Anthropic via MCP ?
Les résultats des appels MCP transitent dans le contexte de votre conversation Claude (donc sur les serveurs Anthropic le temps du tour de conversation). Aucune persistance long terme, sauf si vous activez explicitement la mémoire Claude. Pour les PME RGPD-strictes, recommandation OKB : limiter les requêtes MCP aux données non-sensibles, ou héberger un Claude API + serveur MCP en infrastructure souveraine (AWS Frankfurt, GCP Paris) avec configuration ZDR (Zero Data Retention) côté Claude API.
Peut-on utiliser MCP × HubSpot avec ChatGPT ou Mistral ?
MCP est un protocole ouvert publié par Anthropic mais pas exclusif à Claude. En 2025-2026, l'adoption MCP côté ChatGPT, Cursor, Continue et Cline progresse. Le serveur MCP HubSpot lui-même est agnostique du LLM client. Cependant, Claude Desktop reste le client MCP le plus mature au moment de la rédaction. Pour ChatGPT, l'équivalent natif sont les Custom GPTs avec Actions, qui ne sont pas du MCP standard.
Faut-il un serveur dédié pour faire tourner le serveur MCP HubSpot ?
Non, dans 80 % des cas. Le serveur MCP tourne en local sur le poste de l'utilisateur via Claude Desktop, sans serveur dédié. Pour une PME où plusieurs utilisateurs partagent le même contexte HubSpot, l'option d'un serveur MCP centralisé (Docker on-premise ou VPS Hetzner 5 €/mois) devient pertinente — surtout pour mutualiser le token et avoir des logs centraux.
Comment auditer un serveur MCP HubSpot communautaire avant de l'utiliser ?
Méthode OKB en 4 points : (1) lire le package.json ou requirements.txt pour voir les dépendances ; (2) chercher les appels HTTP sortants dans le code source (fetch, axios, requests) — il ne devrait y avoir que api.hubapi.com ; (3) vérifier que le token n'est pas loggué ou envoyé ailleurs ; (4) regarder les issues GitHub ouvertes — un projet avec >5 issues sécurité non traitées est un signal d'alarme. Comptez 1-2h d'audit pour un serveur MCP standard.
Sources et liens utiles
Questions fréquentes
À propos de l'auteur
Florent Jacques
Fondateur & CTO — OKB Agency
Fondateur et CTO d'OKB Agency, Florent conçoit des architectures d'agents IA autonomes pour les PME B2B. Expert MCP, Skills Claude et OpenClaw, il accompagne les dirigeants dans le déploiement d'IA opérationnelle qui génère du business.
✦ Pourquoi me faire confiance sur ce sujet
- ▸Fondateur & CTO d'OKB Agency (Lyon), depuis 2024
- ▸+40 déploiements d'agents IA livrés sur SEO, outreach, CRM, LinkedIn personal branding, veille et création de contenus
- ▸Architecte d'agents autonomes avec OpenClaw et Skills Claude
- ▸Intervient pour des PME B2B des secteurs service, ingénierie et finance
Articles liés
Make vs n8n vs Zapier : le comparatif 2026 (PME B2B)
Comment structurer son CRM pour scaler en B2B
Agent IA de qualification de leads B2B pour PME — Blog OKB
Agents IA autonomes pour PME B2B : le guide complet 2026
MCP protocol : le guide 2026 (comprendre et déployer)
Besoin d'un accompagnement ?
Échangeons sur vos enjeux d'acquisition et d'automatisation B2B.
Nous contacter