Verbind HubSpot met Claude via MCP

HubSpotGratis planQuery-stromenClaude

Vraag Claude in gewone taal naar je HubSpot-account: de Agent die al in je netwerk staat, voert de SQL alleen-lezen uit en je AI-client krijgt je inloggegevens nooit in handen. Ongeveer tien minuten, en het Free-abonnement dekt dit.

Begin gratis

Wat je uiteindelijk overhoudt

Een Claude die vragen over je HubSpot-account kan beantwoorden met live, alleen-lezen query's, de betekenis van de kolommen kan uitleggen en je verder kan helpen wanneer je om meer informatie vraagt — zonder ooit een database-login te hoeven zien en zonder dat je je firewall hoeft aan te passen: de agent die zich al in je netwerk bevindt, voert de SQL-query's uit en stuurt alleen de rijen terug. Zodra de agent is geïnstalleerd, duurt het verbinden met Claude ongeveer 90 seconden als je vertrouwd bent met een instellingenscherm. Zoals dit:

Claude ChatGPT Cursor Claude Code VS Code Windsurf Gemini CLI JetBrains Codex+5 meerAlleen-lezen

Wat zit erin? hubspot.deals In mijn HubSpot-account? Laat me een paar rijen zien en leg uit wat elke kolom betekent.

qs_get_table_schema qs_run_query schema_intelligentie

Ik heb eerst de tabelstructuur bekeken en vervolgens een alleen-lezen query uitgevoerd via uw Agent. Hier zijn drie rijen uit hubspot.deals:

dealnaam	dealstage	hoeveelheid
1042	Noordwindhandelaren	Seattle
1057	Alpine Outfitters	Denver
1063	Havenvoedsel	Halifax

dealnaam identificeert de rij. dealstage en hoeveelheid worden beschreven in uw semantisch intelligentiemodel, zodat ik ze op naam kan filteren.

Welke drie hoeveelheid Welke producten leverden dit kwartaal de meeste omzet op? Hoe verhoudt zich dat tot het vorige kwartaal? Zijn er zaken waar ik naar zou moeten kijken?

qs_get_relationships qs_run_query qs_run_query

Ik ben lid geworden hubspot.deals naar bestellingen Op basis van de gevonden relatie heeft Semantic Intelligence vervolgens voor elk kwartaal een aggregatie uitgevoerd. Beide query's waren alleen-lezen en leverden elk 3 rijen op:

hoeveelheid	Dit kwartaal	Laatste kwartaal	Wijziging
Denver	184,200	133,900	+38%
Seattle	171,650	168,400	+2%
Halifax	96,300	129,700	-26%

Denver Het verhaal is als volgt: de omzet steeg met 38% bij vrijwel hetzelfde aantal klanten, waardoor de gemiddelde orderwaarde ook toenam. Halifax Een daling van 26%, en die daling betreft twee klanten die het afgelopen kwartaal elke maand bestelden en dit kwartaal helemaal niet meer – het is de moeite waard om ze voor het einde van de maand even te bellen. In Seattle is de situatie gelijk gebleven. Wilt u de namen van die twee klanten in Halifax weten?

Alleen SELECTEREN, gecontroleerd door de agent ingelogd op het tabblad MCP-activiteit 9 rijen geretourneerd verdeeld over 3 zoekopdrachten Dezelfde verbinding in 14 MCP-clients

Liever helemaal geen AI-client aansluiten? In het bedrijfsplan, Nova MCP is de assistent die is ingebouwd in Query Streams zelf. Het maakt gebruik van dezelfde Agent-toolset die uw AI-client hier krijgt, plus wat een externe client niet heeft: het stelt de SQL op en valideert deze aan de hand van uw Semantic Intelligence-model, zet het antwoord om in een grafiek en slaat het resultaat op als een query die uw team kan uitvoeren vanuit Excel, Google Sheets of de REST API — geen sleutel, geen connector, niets te installeren. Gebruik MCP als uw medewerkers al werken met Claude, Cursor of ChatGPT; gebruik Nova als u de antwoorden binnen het portaal wilt hebben.

HubSpot bewaart je gegevens achter zijn API. Claude daarentegen draait in een browser of terminal en weet daar niets van. De gebruikelijke manier om gegevens te verzamelen is door een schema in de chat te plakken en te hopen op een reactie, of door je HubSpot-wachtwoord aan een open-source MCP-server te geven. Query Streams doet het anders: de agent die al aan je HubSpot-account is gekoppeld, voert de SQL-query's die Claude schrijft alleen-lezen uit, en de MCP-server ertussen controleert wie de vraag stelt, wat ze mogelijk doen en hoe vaak. Claude krijgt antwoorden. Het krijgt nooit inloggegevens.

Wat je nodig hebt

Een Query Streams-account

MCP is beschikbaar in alle abonnementen, ook in het gratis abonnement. Met het gratis abonnement kun je één sleutel of één gekoppelde app gebruiken, en dat is alles wat deze handleiding nodig heeft. Meld je aan via mijn.querystreams.nl.

HubSpot verbonden via de agent

De agent is geïnstalleerd op elke computer die altijd aan staat, en de HubSpot-verbinding is toegevoegd in Data Agents. Nog niet klaar? Verbind eerst met HubSpotHet duurt ongeveer tien minuten.

MCP is voor u ingeschakeld.

Makers, eigenaren en beheerders hebben het vanaf het begin. Alle anderen hebben een beheerder nodig om het te kunnen gebruiken. MCP schakelaar naast hun naam onder Account → ToegangsbeheerTot die tijd staat er op de MCP-pagina: "MCP is uitgeschakeld voor uw account".

Een AI-client

Chat-apps zoals claude.ai, Claude Desktop en ChatGPT maken verbinding zonder sleutel. Claude Code, Cursor, VS Code en ongeveer tien andere tools gebruiken een sleutel; de Portal gebruikt er een. Verbind een AI-client De handleiding beschrijft hoe ze elk afzonderlijk worden ingesteld.

Stel het in vier stappen in.

1. Open MCP in het portaal

   Meld u aan bij mijn.querystreams.nl en open Streams → Live → MCPDe pagina heeft vier tabbladen: Verbindingen, Context, Hulpmiddelen en voor beheerders, ActiviteitControleer het paneel Semantische Intelligentie op Verbindingen Nu je hier toch bent: het toont je HubSpot-connector en of Semantic Intelligence erop is uitgevoerd. Dankzij deze complete dekking kan Claude in één keer de juiste HubSpot SQL-query's schrijven.

   Open MCP

   Ziet u de melding "MCP is uitgeschakeld voor uw account"? Uw organisatie heeft MCP, maar uw gebruiker is uitgeschakeld. Een beheerder schakelt het in met de MCP schakelaar naast je naam onder Account → ToegangsbeheerMakers, eigenaren en beheerders zijn vanaf het begin betrokken.

2. Kies hoe u verbinding wilt maken.

   Er zijn twee ingangen, en ze komen allebei op dezelfde plek uit:

   Chat-apps · geen sleutel

   claude.ai, Claude Desktop, ChatGPT

   Open in claude.ai en Claude Desktop de Lijst met querystreams Klik in de Connectors Directory van Anthropic op Verbinden en goedkeuren. Toevoegen via URL, https://mcp.querystreams.com/mcpDit is de terugvaloptie. In ChatGPT voeg je querystreams toe vanuit de app (voorlopig in de ontwikkelaarsmodus) en meld je je aan met querystreams. In beide gevallen wordt een pagina voor querystreams geopend: kies de organisatie en de machtigingen en klik. Verbinding goedkeurenNiets om te kopiëren. De verbinding verschijnt op de Verbindingen tab en kan daar worden ingetrokken.

   Ontwikkelaarstools · een sleutel

   Claude Code, Cursor, VS Code en vrienden

   Klik op de MCP-pagina Verbind een AI-clientDe gids vraagt Hoe zal uw AI-client verbinding maken?: kiezen Gebruik een sleutel in een configuratiebestand, kies je gereedschap, en dan Genereer een sleutel voor het: een Sleutelnaam, Lezen en Voer query's uit aangevinkt, een Vervaldatum (Nooit, 30 dagen, 90 dagen of 1 jaar). Stel het in toont het fragment met de sleutel ingevuld, en Controleer de verbinding wacht op het eerste telefoontje.

   Beide methoden gebruiken dezelfde drie machtigingen, die u kiest op het toestemmingsscherm of in de legenda:

   Lezen

   Toont connectoren, bladert door tabellen en kolommen, leest uw opgeslagen query's en waarschuwingsregels. Geeft nooit rijgegevens terug.

   Voer query's uit

   Voer alleen-lezen SQL-query's en opgeslagen query's uit via uw agent en retourneer de rijen. Zonder dit kan uw AI-client uw gegevens wel beschrijven, maar er geen antwoorden op geven.

   Analyseren

   Profieltabellen, ontdek relaties en plan een Semantic Intelligence-run in. Het verbruikt Nova AI-credits en data, dus het toestemmingsscherm vinkt het nooit vooraf aan.

   Sleutel kwijt? Het staat vermeld op de Verbindingen tab: Onthul de volledige sleutel laat het opnieuw zien en Kopieer de volledige sleutel kopieert het. Trek het daar in als een laptop vermist raakt; elke klant die het gebruikt, faalt bij het volgende gesprek, binnen ongeveer vijf minuten.

3. Verbind Claude

   Kies het recept voor de Claude die je gebruikt. Het serveradres is overal hetzelfde: https://mcp.querystreams.com/mcp.

   Claude op het web, Claude voor desktop en mobiel geen sleutel

   1. Open de Lijst met querystreams in de Connectors Directory van Anthropic en klik VerbindenIn de desktopversie bevindt het zich dan onder + → Connectors.
   2. Terugvaloptie, als uw organisatie directory-connectoren verbergt: Instellingen → Connectoren → Aangepaste connector toevoegen, naam Query-stromen, URL https://mcp.querystreams.com/mcp, OAuth-velden leeg, Toevoegen; vervolgens in een chat + → Query-stromen → Verbinden.
   3. Er wordt een tabblad 'Query Streams' geopend. Meld u aan als daarom wordt gevraagd, selecteer de organisatie en bekijk de resultaten. Lezen en Voer query's uit, optioneel Beperk tot specifieke connectorenen klik Verbinding goedkeuren.
   4. In Claude zie je 'Verbonden met querystreams'. De eerste keer dat Claude een tool gebruikt, wordt er om een keuze gevraagd; kies Altijd toestaan.

   Als je het handmatig toevoegt in Claude Desktop, gebruik dan het volgende: Instellingen → Connectoren → Toevoegen, niet de chatfunctie Voeg een marktplaats toe Deze optie vereist een Git-repository. Connectors synchroniseren met je Claude-account, waardoor de mobiele apps en de desktopversie deze automatisch herkennen. Menunamen zijn van Anthropic en kunnen worden gewijzigd.

   Claude Code sleutel

   Eén commando, met uw sleutel uit het tabblad Verbindingen:

   Terminal

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

   Dat schrijft het huidige project. .mcp.json. Toevoegen --scope gebruiker Om querystreams in elk project te hebben. Uitvoeren /mcp Kijk binnen in de Claude-code om te zien hoe het werkt.

   Cursor sleutel

   Open Cursorinstellingen → MCP → Nieuwe MCP-server toevoegenof bewerken .cursor/mcp.json aan de basis van je werkruimte:

   .cursor/mcp.json

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

   Cursor opnieuw starten of uitvoeren MCP: Servers opnieuw opstarten; A querystreams Het badge verschijnt in de statusbalk van het MCP.

   Gebruik je iets anders? De portal Verbind een AI-client gids Bevat kant-en-klare recepten voor ChatGPT, VS Code, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev en JetBrains AI, plus een Plakken en samenvoegen gereedschap dat de querystreams een invoer in een configuratiebestand dat je al hebt. Elke client die MCP via HTTP ondersteunt, werkt: server https://mcp.querystreams.com/mcp, koptekst X-MCP-sleutel (een Autorisatie: Houder Een header met dezelfde sleutel werkt ook.

4. Stel je eerste vraag

   Begin met iets waarvan je het antwoord al weet, zodat je kunt zien hoe Claude de juiste tool kiest. Drie tools die goed werken met je HubSpot-account:

   Welke gegevens heb ik in mijn HubSpot-account?

   Claude geeft een lijst van de tabellen die het kan zien, vertelt je welke tabellen semantische intelligentie hebben en vraagt wat je wilt bekijken.

   "Laat me tien rijen zien van hubspot.deals en leg elke kolom uit."

   Claude leest eerst de tabelstructuur (Lezen), voert vervolgens één SELECT-query uit via uw agent (Query's uitvoeren) en beschrijft wat dealstage en amount betekenen.

   "Hoeveel rijen heeft hubspot.deals per bedrag? Welk bedrag heeft de meeste rijen?"

   Claude schrijft de GROUP BY-query in de HubSpot-taal, voert deze uit en beantwoordt met een zin en een kleine tabel. Ga verder in dezelfde chat; zo blijft de context behouden.

   Om de bedrading te controleren, kunt u vragen Welke Query Streams-connectoren heb ik?Claude belt qs_list_connectors, de Portal-gids Controleer de verbinding stap zegt Aangeslotenen de sleutel of app op de Verbindingen tab toont zijn Laatst gebruikt tijd binnen enkele seconden.

Wat Claude kan doen zodra hij verbonden is.

Uw AI-client ziet de Query Streams-tools en kiest de juiste tool voor uw vraag. Het portaal Hulpmiddelen tabblad geeft een overzicht van alle tools en modi die bij je abonnement zijn inbegrepen. Query Streams vraagt je AI-client om de kolommen van elke tabel te lezen voordat deze een query uitvoert, zodat de echte namen worden gebruikt in plaats van te gokken. Bij elk abonnement, ook Free:

De analytische hulpmiddelen. Bij betaalde abonnementen doet de Agent het voorbereidende werk op de locatie van je HubSpot-account, zodat je AI-client zich kan concentreren op het denkwerk. De gratis versie werkt zoals altijd.

De standaardinstellingen bevinden zich op de Context tabblad: limiet voor tekstcellen, schemaweergave, resultaatgrootte, standaardinstellingen voor analyse en vastgehouden resultaten.

Waarom semantische intelligentie hier van belang is

Elk antwoord dat Claude ontvangt, is voorzien van een label dat aangeeft waar de structuur vandaan komt, en Claude past vervolgens aan in hoeverre hij de informatie die hij ziet vertrouwt.

Als een database van belang is, voer er dan eenmaal een Semantic Intelligence-test op uit. Nova → IntelligentieDe Verbindingen Het tabblad toont een overzichtspaneel per connector. Hoe werkt semantische intelligentie?.

Wat de plannen toestaan

MCP is bij elk abonnement inbegrepen, ook bij het gratis abonnement, zonder extra kosten. Elk abonnement bepaalt hoeveel sleutels of verbonden apps je kunt vasthouden en hoeveel gesprekken je AI-client per minuut mag voeren.

Een gekoppelde app telt als een sleutel. Naast het bedrag per minuut mag één sleutel maximaal 10 query's per minuut uitvoeren. Een query duurt maximaal 60 seconden, tenzij uw AI-client om meer vraagt, tot maximaal vijf minuten. Uw abonnement bepaalt ook hoeveel rijen één query retourneert en, met de Analytic-toolset, hoe lang en hoe groot een vastgehouden resultaat mag zijn. de volledige MCP-handleiding geeft alle plannen weer. Wat je AI-client ontvangt, telt mee voor je Data Realm-limiet, dezelfde limiet die je Excel- en Sheets-query's gebruiken: bij AI-agentgebruik (MCP) telt elke byte die aan je AI-client wordt geleverd mee, zowel resultaten, schemalezingen als pagina's met vastgehouden resultaten, vóór eventuele transportcompressie die je client onderhandelt; bij spreadsheetquery's telt het gecomprimeerde resultaat dat je Network Agent levert. Semantic Intelligence-runs die vanuit je AI-client worden gestart, verbruiken Nova AI-tegoed, net als wanneer ze vanuit de Portal worden gestart. Bekijk de prijspagina. voor de toeslagen.

Het veilig bewaren

Goede volgende stappen

• Bewaar de query's die u als canoniek beschouwt. In de querybuilder zoekt Claude eerst naar opgeslagen query's, dus "actieve klanten" betekent wat jouw team eronder verstaat.
• Gebruik een Claude-project Voeg Query Streams toe en stel je eigen regels in de instructies in: welke HubSpot-database standaard moet worden gebruikt en welke opgeslagen query's de officiële definities zijn.
• Gebruik Grant Analyze als je diepere antwoorden wilt. Het profileren van een kolom vóórdat je erop filtert, maakt het verschil tussen het raden van een statuscode en het gebruiken van de juiste. Het verbruikt Nova AI-credits, dus het is uitgeschakeld totdat je het uitschakelt.
• Vraag om een schema. claude.ai maakt grafieken van de rijen die Claude terugkrijgt.

Als iets niet werkt

Vragen die mensen stellen

Gerelateerde handleidingen

• Verbind Stripe met Claude via MCP
• Verbind Shopify met Claude via MCP
• Verbind Google Analytics 4 met Claude via MCP
• Verbind Google Search Console met Claude via MCP.
• Querystreams verbinden met Claude via MCP: configuratie, machtigingen en probleemoplossing
• Hoe verbind je HubSpot met Google Sheets?
• Alle MCP-handleidingen