Connectez HubSpot à Claude avec MCP

HubSpotPlan gratuitFlux de requêtesClaude

Interrogez Claude sur votre compte HubSpot en langage clair : l’Agent déjà présent dans votre réseau exécute le SQL en lecture seule, et votre client IA ne détient jamais vos identifiants de connexion. Environ dix minutes, et le forfait Free suffit.

Commencez gratuitement

Ce que vous obtiendrez

Un Claude capable de répondre à vos questions sur votre compte HubSpot grâce à des requêtes en lecture seule, d'expliquer la signification des colonnes et de vous fournir des informations complémentaires, sans jamais accéder à votre base de données ni modifier votre pare-feu : l'agent déjà présent sur votre réseau exécute les requêtes SQL et renvoie uniquement les résultats. Une fois l'agent installé, la connexion à Claude prend environ 90 secondes si vous êtes à l'aise avec une interface de configuration. Voici un exemple :

Claude ChatGPT Curseur Code Claude VS Code planche à voile Gemini CLI JetBrains Manuscrit+5 autresLecture seule

Qu'y a-t-il dans hubspot.offres Dans mon compte HubSpot ? Montrez-moi quelques lignes et expliquez-moi ce que signifie chaque colonne.

qs_get_table_schema qs_run_query intelligence de schéma

J'ai d'abord examiné la structure de la table, puis j'ai exécuté une requête en lecture seule via votre agent. Voici trois lignes de hubspot.deals :

nom de l'accord	stage de négociation	montant
1042	Commerçants du Vent du Nord	Seattle
1057	Pourvoyeurs alpins	Denver
1063	Harbour Foods	Halifax

nom de l'accord identifie la ligne. stage de négociation et montant sont décrites dans votre modèle d'intelligence sémantique, je peux donc les filtrer par nom.

Lesquels trois montant Quelles sont les valeurs qui ont généré le plus de revenus ce trimestre ? Comment cela se compare-t-il au trimestre précédent ? Y a-t-il des points à examiner ?

qs_get_relationships qs_run_query qs_run_query

J'ai rejoint hubspot.offres à commandes Semantic Intelligence a identifié une relation, puis a effectué une agrégation pour chaque trimestre. Les deux requêtes étaient en lecture seule et ont renvoyé 3 lignes chacune :

montant	Ce trimestre	dernier trimestre	Changement
Denver	184,200	133,900	+38%
Seattle	171,650	168,400	+2%
Halifax	96,300	129,700	−26%

Denver Voici le constat : le chiffre d'affaires a augmenté de 38 % avec un nombre de clients quasiment identique, ce qui a entraîné une hausse de la valeur moyenne des commandes. Halifax Le chiffre d'affaires a chuté de 26 %, et cette baisse concerne deux clients qui passaient commande tous les mois le trimestre dernier et pas du tout ce trimestre ; il serait judicieux de les contacter avant la fin du mois. À Seattle, le chiffre est stable. Pourriez-vous me donner les coordonnées des deux clients d'Halifax ?

Sélection uniquement, vérifiée par l'agent connecté à l'onglet Activité MCP 9 lignes ont été renvoyées en 3 requêtes. Même connexion dans 14 clients MCP

Vous préférez ne pas du tout connecter de client IA ? Concernant le plan d'affaires, Nova Nova est l'assistant intégré à Query Streams. Il utilise les mêmes outils que votre client IA, ainsi que des fonctionnalités supplémentaires : il génère et valide la requête SQL par rapport à votre modèle d'intelligence sémantique, transforme la réponse en graphique et enregistre le résultat sous forme de requête exécutable par votre équipe depuis Excel, Google Sheets ou l'API REST, sans clé, sans connecteur ni installation. Utilisez MCP si vos équipes utilisent déjà Claude, Cursor ou ChatGPT ; utilisez Nova si vous souhaitez que les réponses soient intégrées au portail.

HubSpot stocke vos données derrière son API. Claude, en revanche, s'exécute dans un navigateur ou un terminal et n'en a aucune connaissance. La méthode habituelle consiste à coller un schéma dans la conversation et à croiser les doigts, ou à fournir votre mot de passe HubSpot à un serveur MCP open source. Query Streams fonctionne différemment : l'agent déjà associé à votre compte HubSpot exécute la requête SQL écrite par Claude, en lecture seule, et le serveur MCP vérifie, entre les requêtes, qui est à l'origine de la demande, ce qu'il est susceptible de faire et à quelle fréquence. Claude obtient des réponses. Il n'a jamais accès aux identifiants.

Ce dont vous aurez besoin

Un compte Query Streams

MCP est inclus dans tous les forfaits, même le forfait gratuit. Le forfait gratuit permet une clé ou une application connectée, ce qui est suffisant pour ce guide. Inscrivez-vous sur mon.querystreams.com.

HubSpot s'est connecté via l'agent.

L'agent est installé sur n'importe quel ordinateur toujours allumé, avec la connexion HubSpot ajoutée dans les agents de données. Pas encore terminé ? Connectez d'abord HubSpot; cela prend environ dix minutes.

MCP activé pour vous

Les créateurs, propriétaires et administrateurs y ont accès dès le départ. Tous les autres ont besoin d'un administrateur pour activer le contrôle parental. MCP interrupteur à côté de leur nom sous Compte → Contrôle d'accèsEn attendant, la page MCP indique « MCP est désactivé pour votre compte ».

Un client IA

Les applications de messagerie instantanée telles que claude.ai, Claude Desktop et ChatGPT se connectent sans clé. Claude Code, Cursor, VS Code et une dizaine d'autres outils utilisent une clé ; celle du portail Connectez un client IA Le guide configure chacun d'eux.

Configurez-le en quatre étapes

1. Ouvrez MCP dans le portail

   Connectez-vous à mon.querystreams.com et ouvert Flux → En direct → MCPLa page comporte quatre onglets : Connexions, Contexte, Outils et, pour les administrateurs, ActivitéConsultez le panneau Intelligence sémantique sur Connexions Pendant que vous êtes ici : cette section liste votre connecteur HubSpot et indique si l’analyse sémantique a été effectuée dessus. C’est grâce à cette couverture complète que Claude peut écrire du code SQL HubSpot correct du premier coup.

   Open MCP

   Vous voyez le message « MCP est désactivé pour votre compte » ? Votre organisation dispose de MCP, mais votre compte utilisateur est désactivé. Un administrateur l'active à l'aide de la commande suivante : MCP interrupteur à côté de votre nom sous Compte → Contrôle d'accèsLes créateurs, les propriétaires et les administrateurs sont présents dès le début.

2. Choisissez votre mode de connexion

   Il y a deux entrées, et elles mènent au même endroit :

   Applications de messagerie instantanée · sans clé

   claude.ai, Claude Desktop, ChatGPT

   Dans claude.ai et Claude Desktop, ouvrez le Liste des flux de requêtes dans le répertoire des connecteurs d'Anthropic, cliquez Connecter et approuver. L'ajouter par URL, https://mcp.querystreams.com/mcpIl s'agit de la solution de repli. Dans ChatGPT, vous ajoutez des flux de requêtes depuis l'application (en mode développeur pour le moment) et vous vous connectez avec les flux de requêtes. Dans les deux cas, une page de flux de requêtes s'ouvre : choisissez l'organisation et les autorisations, puis cliquez sur Approuver la connexionRien à copier. La connexion apparaît sur le Connexions onglet et peut être révoqué à cet endroit.

   Outils de développement · une clé

   Claude Code, Curseur, VS Code et amis

   Sur la page MCP, cliquez Connectez un client IALe guide demande Comment votre client IA se connectera-t-il ?: choisir Utilisez une clé dans un fichier de configuration, choisissez votre outil, puis Générer une clé pour il : un Nom de la clé, Lire et Exécuter des requêtes coché, un Expiration (Jamais, 30 jours, 90 jours ou 1 an). Configurez-le affiche l'extrait avec la légende renseignée, et Vérifiez la connexion attend le premier appel.

   Les deux méthodes utilisent les mêmes trois autorisations, que vous choisissez sur l'écran de consentement ou sur la clé :

   Lire

   Consultez les connecteurs, parcourez les tables et les colonnes, lisez vos requêtes enregistrées et vos règles d'alerte. Ne renvoie jamais les données des lignes.

   Exécuter des requêtes

   Exécutez des requêtes SQL en lecture seule et des requêtes enregistrées via votre agent et renvoyez les lignes. Sans cela, votre client IA peut décrire vos données, mais pas y répondre.

   Analyser

   Créez des profils de tables, découvrez les relations et lancez une analyse d'intelligence sémantique. Cette opération consomme des crédits Nova AI et des données ; l'écran de consentement n'est donc jamais pré-coché.

   Vous avez perdu la clé ? Il est répertorié sur le Connexions languette: Afficher la clé complète le montre à nouveau et Copier la clé complète Il est copié. Révoquez-le à cet endroit si un ordinateur portable est perdu ; chaque client l’utilisant échoue à son prochain appel, dans un délai d’environ cinq minutes.

3. Connectez-vous à Claude

   Choisissez la recette du Claude que vous utilisez. L'adresse du serveur est la même partout : https://mcp.querystreams.com/mcp.

   Claude sur le web, Claude Desktop et mobile pas de clé

   1. Ouvrez le Liste des flux de requêtes dans le répertoire des connecteurs d'Anthropic et cliquez ConnecterSur ordinateur de bureau, il se trouve alors sous + → Connecteurs.
   2. Solution de repli, si votre organisation masque les connecteurs d'annuaire : Paramètres → Connecteurs → Ajouter un connecteur personnalisé, nom Flux de requêtes, URL https://mcp.querystreams.com/mcp, champs OAuth vides, Ajouter; puis dans une conversation + → Flux de requêtes → Connecter.
   3. Un onglet Flux de requêtes s'ouvre. Connectez-vous si nécessaire, sélectionnez l'organisation et consultez. Lire et Exécuter des requêtes, éventuellement Limiter à des connecteurs spécifiques, et cliquez Approuver la connexion.
   4. De retour dans Claude, vous voyez « Connecté aux flux de requêtes ». La première fois que Claude utilise un outil, il vous demande de choisir. Toujours permettre.

   Si vous l'ajoutez manuellement dans Claude Desktop, utilisez Paramètres → Connecteurs → Ajouter, pas le chat intégré Ajouter une place de marché Cette option nécessite un dépôt Git. Les connecteurs se synchronisent avec votre compte Claude, ce qui permet aux applications mobiles et à l'application de bureau de la prendre en charge automatiquement. Les noms des menus sont ceux d'Anthropic et peuvent être déplacés.

   Code Claude clé

   Une seule commande, avec votre clé de l'onglet Connexions :

   Terminal

   claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp \ --header "X-MCP-Key: qsmcp_PASTE_YOUR_KEY_HERE"

   Cela décrit le projet actuel .mcp.json. Ajouter --scope utilisateur Pour avoir des flux de requêtes dans chaque projet. Exécuter /mcp À l'intérieur du code Claude, pour voir le lien.

   Curseur clé

   Ouvrir Paramètres du curseur → MCP → Ajouter un nouveau serveur MCP, ou modifier .cursor/mcp.json à la racine de votre espace de travail :

   .cursor/mcp.json

   { "mcpServers": { "querystreams": { "url": "https://mcp.querystreams.com/mcp", "headers": { "X-MCP-Key": "qsmcp_PASTE_YOUR_KEY_HERE" } } } }

   Redémarrez le curseur ou exécutez MCP : Redémarrer les serveurs; un flux de requêtes Le badge apparaît dans la barre d'état du MCP.

   Vous utilisez autre chose ? Le portail Connectez un client IA guide contient des recettes prêtes à l'emploi pour ChatGPT, VS Code, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev et JetBrains AI, ainsi qu'un Coller et fusionner l'outil qui laisse tomber le flux de requêtes Ajoutez cette entrée à un fichier de configuration existant. Tout client compatible MCP sur HTTP fonctionne : serveur https://mcp.querystreams.com/mcp, en-tête Clé X-MCP (un Autorisation : Porteur L'en-tête avec la même clé fonctionne également).

4. Posez votre première question

   Commencez par une question dont vous connaissez déjà la réponse, afin de voir Claude utiliser l'outil approprié. Voici trois outils qui fonctionnent bien avec votre compte HubSpot :

   « Quelles données ai-je dans mon compte HubSpot ? »

   Claude liste les tables qu'il peut consulter, vous indique lesquelles possèdent une intelligence sémantique et vous demande ce que vous souhaitez examiner.

   « Montrez-moi dix lignes de hubspot.deals et expliquez chaque colonne. »

   Claude lit d'abord la structure de la table (Read), puis exécute une requête SELECT via votre agent (Run queries) et décrit ce que signifient dealstage et amount.

   « Combien de lignes Hubspot.deals affiche-t-il par montant ? Quel montant en affiche le plus ? »

   Claude rédige la clause GROUP BY dans le langage HubSpot, l'exécute et répond par une phrase accompagnée d'un petit tableau. Il poursuit la conversation dans la même section ; cela permet de conserver le contexte.

   Pour confirmer le câblage, demandez « De quels connecteurs Query Streams ai-je accès ? »Claude appelle qs_list_connectors, le guide du Portail Vérifiez la connexion étape dit Connecté, et la clé ou l'application sur le Connexions L'onglet affiche son Dernière utilisation en quelques secondes.

Ce que Claude peut faire une fois connecté

Votre client IA visualise les outils Query Streams et sélectionne celui qui convient le mieux à votre question. Le portail Outils onglet répertorie tous les outils et modes inclus dans votre forfait. Query Streams demande à votre client IA de lire les colonnes de chaque table avant d’effectuer une requête, afin qu’il utilise les noms réels au lieu de les deviner. Dans tous les forfaits, y compris Free :

L'ensemble d'outils analytiques. Avec les abonnements payants, l'Agent se charge de la configuration de votre compte HubSpot, permettant ainsi à votre client IA de se concentrer sur la réflexion. La version gratuite fonctionne comme d'habitude.

Les valeurs par défaut sont disponibles sur le Contexte onglet: limite de cellules de texte, vue du schéma, taille des résultats, paramètres d'analyse par défaut et résultats mis en attente.

Pourquoi l'intelligence sémantique est importante ici

Chaque réponse que reçoit Claude est étiquetée avec l'origine de la structure, et Claude ajuste son degré de confiance envers ce qu'il voit.

Si une base de données est importante, exécutez l'analyse sémantique une seule fois. Nova → Intelligence. Le Connexions L'onglet affiche un panneau de couverture par connecteur. Comment fonctionne l'intelligence sémantique.

Ce que les plans permettent

MCP est inclus dans tous les forfaits, même le forfait gratuit, sans frais supplémentaires. Chaque forfait définit le nombre de touches ou d'applications connectées que vous pouvez gérer et le nombre d'appels par minute que votre client IA peut effectuer.

Une application connectée compte comme une clé. En plus du débit par minute, chaque clé peut exécuter au maximum 10 requêtes par minute. Une requête s'exécute pendant 60 secondes maximum, sauf si votre client IA en demande davantage (jusqu'à cinq minutes). Votre plan définit également le nombre de lignes renvoyées par une requête et, avec l'ensemble d'outils analytiques, la durée et la taille maximales des résultats conservés. le guide complet du MCP répertorie tous les forfaits. Ce que votre client IA reçoit est décompté de votre quota Data Realm, le même quota que celui utilisé par vos requêtes Excel et Sheets : l’utilisation par l’agent IA (MCP) comptabilise chaque octet transmis à votre client IA, qu’il s’agisse de résultats, de lectures de schéma ou de pages de résultats conservées, avant toute compression de transport négociée par votre client. Les requêtes de feuilles de calcul, quant à elles, comptabilisent le résultat compressé transmis par votre Network Agent. Les exécutions de Semantic Intelligence lancées depuis votre client IA consomment des crédits Nova AI, exactement comme celles lancées depuis le Portal. Consultez la page des prix pour les indemnités.

Le garder en sécurité

Bonnes prochaines étapes

• Enregistrez les requêtes que vous considérez comme canoniques Dans Query Builder, Claude utilise d'abord les requêtes enregistrées ; par conséquent, « clients actifs » signifie ce que votre équipe définit.
• Utiliser un projet Claude avec les flux de requêtes connectés et intégrez vos règles internes dans ses instructions : quelle base de données HubSpot utiliser par défaut, quelles requêtes enregistrées constituent les définitions officielles.
• Grant Analyze vous permet d'obtenir des réponses plus approfondies. Le profilage d'une colonne avant le filtrage fait toute la différence entre deviner un code d'état et utiliser le bon. Cette opération consomme des crédits Nova AI ; elle est donc désactivée par défaut.
• Demandez un graphique. claude.ai génère des graphiques à partir des lignes renvoyées par Claude.

Quand quelque chose ne fonctionne pas

Questions que se posent les gens

Guides associés

• Connectez Stripe à Claude avec MCP
• Connectez Shopify à Claude avec MCP
• Connectez Google Analytics 4 à Claude avec MCP
• Connectez Google Search Console à Claude avec MCP
• Connexion des flux de requêtes à Claude via MCP : configuration, autorisations et dépannage
• Comment connecter HubSpot à Google Sheets
• Tous les guides MCP