HubSpot MCP Server : interroger le CRM HubSpot avec Claude / Cursor

Voir tout ce que les Query Streams peuvent faire au-delà de ce guide Commencer gratuitement

Soutien

+Plus d'informations

Données en direct

Remplacer les exportations par du SQL à la demande

Excel Feuilles

BI & AI Analytics

Demandez à Nova, obtenez SQL + des graphiques

Rencontre avec Nova

API REST de base de données

Une clé par partenaire. Aucun identifiant partagé.

Créer une API

+Plus d'informations

Automatisation

Synchronisation programmée sur plus de 6 plateformes

Explorer

+Plus d'informations

API à SQL

Interroger les API avec SQL, sans code

Explorer

+Plus d'informations

Base de données IA MCP

Claude, Cursor, ChatGPT et Grok interagissent avec vos données.

Connecter l'IA

Query Streams est une plateforme d'intégration de données sécurisée et en temps réel qui intègre toutes les bases de données et API SaaS de votre compte dans Claude, Cursor, ChatGPT et Grok, grâce à une seule clé MCP et sans modification du pare-feu. Ce guide vous emmène à travers le Hubspot MCP chemin spécifiquement, afin que votre outil d'IA puisse répondre à des questions en langage clair sur les contacts, les entreprises, les transactions, les tickets et les objets personnalisés sans que vous ayez à exporter des fichiers CSV depuis HubSpot ni à vous débattre avec l'API REST v3. L'agent réseau extrait les données CRM HubSpot dans un cache DuckDB local, de sorte que le LLM voit des surfaces SQL propres (contacts, sociétés, offres, billets, propriétaires, objets personnalisés) au lieu d'enveloppes REST — et Schema Intelligence gère les idiomes de HubSpot (par pipeline) stage de négociation énumérations, hs_object_id jointures de chaînes, étape du cycle de vie (énumérations, aplatissement des propriétés des objets personnalisés) pour que la requête SQL soit correcte du premier coup. Pour en savoir plus, rendez-vous sur QueryStreams.com. et Inscrivez-vous gratuitement pour commencer à poser à votre outil d'IA de vraies questions sur HubSpot CRM.

Ce que le serveur Query Streams HubSpot MCP vous offre

D'autres serveurs « HubSpot MCP » open source connectent l'outil d'IA directement à l'API REST HubSpot v3 et lui envoient des requêtes brutes, objet par objet. Cette méthode fonctionne, mais elle ajoute un jeton d'application privée HubSpot à la configuration de votre client d'IA, oblige le LLM à manipuler des ressources REST et des sélecteurs de propriétés au lieu de SQL, limite l'outil d'IA à HubSpot et ne fournit aucun historique des requêtes effectuées. Le serveur HubSpot MCP de Query Streams résout un problème plus global : une seule clé pour tous les connecteurs, un historique complet des requêtes, l'agent normalise les données HubSpot CRM en surfaces SQL multi-objets et l'outil d'IA ne stocke jamais vos identifiants HubSpot.

Comment cela fonctionne sans ouvrir les ports du pare-feu

L'agent réseau Query Streams est un petit programme à installer une seule fois sur une machine connectée à Internet (ordinateur portable, serveur ou machine virtuelle cloud – l'API HubSpot est accessible de partout). Il établit une connexion TLS sortante vers le cloud Query Streams et attend les requêtes des outils. Lorsque Claude ou Cursor pose une question, le cloud la transmet à l'agent, qui appelle l'API REST HubSpot v3 et met en cache la réponse dans une base de données DuckDB locale afin que l'IA puisse accéder à des requêtes SQL propres. contacts, sociétés, offres, billets, propriétaires, pipelinesAinsi que tous les objets personnalisés que vous avez configurés (au lieu d'enveloppes REST), le résultat est renvoyé par le même canal sortant. Aucune donnée entrante. Aucune donnée exposée. L'outil d'IA n'a jamais accès à votre jeton d'application privée HubSpot, à l'ID de votre hub ni à votre jeton d'actualisation OAuth.

La touche MCP que vous donnez à Cursor ou Claude est limitée (lire / analyser / exécuter), révocable à tout moment et limitée en nombre d'utilisations par clé. L'outil d'IA fait appel à ces outils MCP pour fonctionner :

Pourquoi Schema Intelligence rend Query Streams MCP différent

La plupart des serveurs « MCP pour HubSpot » open source transmettent à votre outil d'IA la même référence de propriété v3 que HubSpot publie pour les développeurs, ou pire, la version brute. schéma_information du cache qu'ils conservent. Noms des propriétés. Types de données. Peut-être une clé primaire. Le LLM doit deviner cela. stage de négociation est à valeurs d'énumération et les valeurs d'énumération varient par pipeline, que hs_object_id est une chaîne de caractères (et non numérique), les jointures nécessitent donc une comparaison de chaînes. étape du cycle de vie L'orthographe de « on contacts » diffère de celle d'une colonne portant le même nom dans la section « deals », ou encore les propriétés d'objets personnalisés sont protégées par des identifiants d'API. 2_ id __nom_propriété Ces données doivent être aplaties avant que SQL puisse y accéder. C'est pourquoi la première requête SQL que la plupart des responsables de la relation client (LLM) écrivent sur un schéma HubSpot brut est erronée : non pas parce que le LLM est incompétent, mais parce qu'il ne dispose pas des données nécessaires pour fonctionner correctement (et un filtre par étape du pipeline qui manque silencieusement la moitié de vos transactions est le genre d'erreur qui se traduit par une erreur de prévision trimestrielle).

Query Streams MCP renvoie ce même schéma HubSpot mis en cache, enrichi de ce que nous appelons Intelligence schématique (IS) — Métadonnées sélectionnées par l'IA, générées en exécutant des requêtes de profilage sur votre vrai Les données CRM HubSpot sont disponibles avant même que le client IA ne les demande. Lorsque l'intégration système est activée sur le connecteur HubSpot, chaque outil de schéma appelé par l'IA (qs_get_connector_schema, qs_get_table_schema, table de profils qs, qs_get_relationships) renvoie le schéma mis en cache de base, ainsi que six couches de connaissances organisées. Le LLM cesse de deviner.

Pour concrétiser cela, voici ce que le client IA récupère d'une seule requête. qs_get_table_schema appel contre le connecteur HubSpot offres tableau — l'objet central du pipeline de revenus qui génère 80 % des questions de reporting CRM — d'abord sans Schema Intelligence, puis avec.

Les six couches de l'intelligence schématique ajoutent

Chaque niveau aborde une catégorie spécifique de questions auxquelles le LLM devrait autrement répondre par supposition. L'intégration de SI est optionnelle. (connecteur, base de données) Pair et s'exécute comme une passe de profilage unique sur vos données — il ne modifie pas votre schéma, n'écrit pas dans votre base de données et s'actualise de manière incrémentielle lorsque votre schéma change.

Même invite de commande, requête SQL différente

La preuve se trouve dans le code SQL que l'outil d'IA écrit réellement. Même session Cursor, même modèle Claude, même invite. « Montrez-moi les contrats conclus au cours des 90 derniers jours, avec le propriétaire du contact et l'entreprise, uniquement via des pipelines activés. » Sans intelligence schématique, le LLM doit deviner. Avec elle, le LLM sait. stage de négociation Les valeurs varient selon le pipeline. hs_object_id est une chaîne de caractères, et le graphe de jointure est compatible avec les objets personnalisés.

Comparaison de Query Streams MCP, HubSpot Breeze AI et des interfaces d'IA officielles de HubSpot.

HubSpot intègre sa propre IA : IA BreezeHubSpot est un assistant intégré qui rédige des textes marketing, suggère les actions les plus pertinentes pour les transactions et prépare des e-mails pour les commerciaux directement depuis l'interface utilisateur. Une interface officielle de type MCP, en constante évolution, permet également d'exposer certains objets HubSpot à des clients externes via des appels de fonction spécifiques à chaque objet. Ce sont des produits concrets qui répondent à un besoin réel : une IA performante pour les créateurs HubSpot. à l'intérieur HubSpot. Query Streams HubSpot MCP se présente sous une forme différente : une interface SQL programmatique au-dessus de complet Modèle de données CRM (chaque objet standard et chaque objet personnalisé) pour les outils d'IA en fonctionnement dehors HubSpot, avec des jointures multi-objets, une portée inter-connecteurs et le même audit + application de la lecture seule avec chaque connecteur Query Streams MCP.

Ils coexistent bien. Breeze AI est conçu pour les créateurs HubSpot : commerciaux, spécialistes marketing et agents du support travaillant dans l’interface HubSpot et souhaitant un assistant intégré pour la génération de contenu, les suggestions d’actions optimales et la rédaction d’e-mails. La couverture officielle du MCP HubSpot s’étend et convient parfaitement aux agents IA ayant besoin d’accéder à certains objets HubSpot spécifiques via des appels de fonction. Query Streams HubSpot MCP est destiné aux outils d’IA. dehors HubSpot — Claude, Cursor, ChatGPT, Grok, Windsurf, Zed et autres — nécessite une interface SQL programmatique pour l'ensemble de votre modèle de données CRM, avec des jointures multi-objets, une connectivité croisée vers vos données Stripe/Postgres/Snowflake/Shopify et un plan d'accès unique en lecture seule et auditable. La plupart des équipes qui acquièrent Query Streams HubSpot MCP continuent d'utiliser Breeze AI au sein de HubSpot. Le choix se fait par outil et par agent d'IA, et non par organisation.

MCP ne vous convient pas ? Essayez plutôt Nova AI.

Si la modification des fichiers de configuration JSON et l'installation des clients de bureau AI vous semblent représenter plus de travail que prévu, vous pouvez tout à fait ignorer MCP. Nova AI est intégrée directement au portail web Query Streams — aucune installation, aucune configuration et aucun abonnement supplémentaire à un fournisseur d'IA en plus de votre forfait Query Streams. Connectez-vous, cliquez Demandez à Novaet posez le même genre de questions en langage clair : «Quel est le taux de conversion du pipeline en revenus par étape et quelle étape connaît la plus forte baisse ?" ou "Afficher les 20 premiers comptes par ARR avec une date de renouvellement dans les 90 prochains jours, classés par score de risque de désabonnementNova connaît déjà tous les connecteurs que vous avez ajoutés (HubSpot, vos bases de données, Stripe, Shopify, Google Ads, etc.). Aucune configuration n'est donc nécessaire. Même agent réseau, même application du mode lecture seule, même intelligence de schéma pour les requêtes SQL. Seule l'infrastructure MCP est à votre charge. Chaque abonnement Query Streams inclut des crédits Nova AI ; leur utilisation est déduite de votre forfait, comme pour Excel, Sheets et le générateur de requêtes.

Découvrez Nova AI

Conditions préalables

Avant de commencer, assurez-vous d'avoir :

1. Un compte Query Streams gratuit sur mon.querystreams.com.
2. L'agent réseau Query Streams installé sur une machine ayant accès à Internet — voir Téléchargez l'agent Query StreamsL'API HubSpot est accessible de partout, l'agent n'a donc pas besoin d'être connecté à un réseau spécifique.
3. Un connecteur HubSpot configuré avec l'agent — voir l'existant Configuration du connecteur API Guides pour l'association de jetons d'application privée (recommandé) ou applications de contexte utilisateur OAuth. L'agent conserve le jeton d'application privée HubSpot, votre ID de hub et les jetons d'actualisation OAuth ; l'outil d'IA n'y a jamais accès.
4. Tout client d'IA compatible MCP. Ce guide présente Cursor, Claude Desktop, ChatGPT et Grok ; si vous utilisez Windsurf, Zed, Continue, Cline, VS Code Copilot, Codex ou Goose, la configuration reste globalement la même.
5. Cinq minutes.

Étape 1 : Générer une clé MCP dans les flux de requêtes

Connectez-vous à Query Streams et ouvrez le page MCP (ou connectez-vous d'abord à mon.querystreams.com et cliquez MCP (dans le menu de navigation de gauche). Cliquez Générer une clé, donnez à la clé un nom reconnaissable (quelque chose comme curseur-ordinateur portable ou bureau de Claude), et choisissez les portées que vous souhaitez associer à cette clé :

• lire — L'IA peut parcourir les connecteurs et lire les schémas. Indispensable pour tout le reste.
• analyser L'IA peut profiler les tables et découvrir les relations (valeurs d'exemple, distributions, types sémantiques). Cette fonctionnalité est optionnelle, mais fortement recommandée pour les applications CRM, où il est essentiel de comprendre la structure des données de vos transactions et les énumérations par étape du pipeline.
• exécuter — L'IA peut effectivement exécuter des requêtes SQL. Sans cela, elle ne peut lire que les métadonnées du schéma.

Pour un flux de travail classique du type « laisser Claude analyser mes données HubSpot CRM », les trois niveaux de portée conviennent. En revanche, pour une donnée clé que vous confiez à un collègue ou à un client moins digne de confiance, évitez d'en confier une autre. exécuter et autorisez-les uniquement à consulter. Vous pouvez révoquer n'importe quelle clé à tout moment depuis cette même page ; le client IA le verra. CLÉ_MCP_RÉVOQUÉE Lors de son prochain appel, le fonctionnement s'arrête immédiatement. Il n'y a pas de délai de propagation.

Copiez la clé maintenant : Query Streams l’affiche une seule fois, puis ne conserve qu’un hachage. Si vous la perdez, générez-en une nouvelle. La clé ressemble à ceci : qsmcp_ suivi de 48 caractères aléatoires, ce que votre client IA envoie dans le Clé X-MCP En-tête de requête.

Étape 2 : Ajoutez Query Streams MCP à votre client d’IA

La configuration est identique pour tous les clients compatibles MCP : une entrée de serveur MCP pointant vers https://mcp.querystreams.com avec votre clé dans le Clé X-MCP En-tête. Choisissez votre client ci-dessous.

Curseur ~/.cursor/mcp.json

// Modifier ~/.cursor/mcp.json
{
  "mcpServers": {
    "flux de requêtes": {
      "url": "https://mcp.querystreams.com",
      "en-têtes": {
        "Clé X-MCP": "qsmcp_CLÉ_PASSER_ICI"
      }
    }
  }
}

Claude Desktop claude_desktop_config.json

// Paramètres → Développeur → Modifier la configuration
{
  "mcpServers": {
    "flux de requêtes": {
      "url": "https://mcp.querystreams.com",
      "en-têtes": {
        "Clé X-MCP": "qsmcp_CLÉ_PASSER_ICI"
      }
    }
  }
}

ChatGPT Applications et connecteurs

// Paramètres → Applications et connecteurs → Ajouter un MCP
URL du serveur  https://mcp.querystreams.com
En-tête d'authentification Clé X-MCP
Valeur d'en-tête qsmcp_COLLER_LA_CLÉ_ICI

Nécessite un abonnement ChatGPT payant
// (Plus / Pro / Team / Enterprise).

Grok Outils MCP distants

// Grok → Paramètres → Outils
{
  "mcp_servers": [{
    "nom": "flux de requêtes",
    "url": "https://mcp.querystreams.com",
    "auth_header": "Clé X-MCP",
    "auth_value": "qsmcp_..."
  }]
}

Redémarrez votre client IA. Au prochain démarrage, il détectera les huit outils Query Streams MCP mentionnés ci-dessus et les affichera dans sa palette d'outils. Dans Cursor et Claude Desktop, vous pouvez le vérifier en saisissant : « liste des connecteurs » — l'IA devrait appeler qs_list_connectors et renvoyez votre connecteur HubSpot ainsi que tout autre élément que vous avez configuré.

Étape 3 : Poser une question HubSpot à l’IA

Vous n'écrivez pas de SQL : c'est l'IA qui s'en charge. Vous posez une question, l'IA choisit l'outil MCP approprié, l'agent exécute la requête sur vos données HubSpot mises en cache et la réponse s'affiche sous forme de texte et de tableaux. Voici trois exemples de requêtes à tester :

Lors du premier appel à un outil par l'IA, votre client peut afficher une fenêtre de confirmation vous demandant d'approuver cet appel. Il s'agit du flux de consentement standard de MCP, et non d'une fonctionnalité ajoutée par Query Streams. Une fois l'approbation donnée, l'IA poursuivra la conversation sans problème. Vous pouvez modifier ce consentement à tout moment dans les paramètres de votre client.

Foire aux questions

Commencer

Guides associés : Téléchargez l'agent Query Streams | Configuration du connecteur API | Tous les guides du serveur MCP | Nova AI text-to-SQL

Catégorie : Serveur MCP

Mots-clés : mcp, Claude, curseur, HubSpot, connecteur API, CRM, analyse des ventes, analyse marketing, Breeze AI, MCP en lecture seule

Description : Interrogez HubSpot CRM avec Claude ou Cursor via MCP. Jointures SQL multi-objets, objets personnalisés, aucune faille de sécurité au niveau du pare-feu. Gratuit.