Collega HubSpot a Claude con MCP

HubSpotPiano gratuitoFlussi di queryClaude

Chiedi a Claude informazioni sul tuo account HubSpot in linguaggio semplice: l’Agent già presente nella tua rete esegue le query SQL in sola lettura e il tuo client AI non conserva mai le tue credenziali di accesso. Bastano circa dieci minuti e il piano Free è sufficiente.

Inizia gratis

Quello che otterrai alla fine

Un Claude in grado di rispondere alle domande sul tuo account HubSpot con query in tempo reale e di sola lettura, spiegare il significato delle colonne e fornire ulteriori informazioni quando ne chiedi, senza mai dover accedere al database e senza modificare il firewall: l'agente già presente nella tua rete esegue le query SQL e restituisce solo le righe. Una volta installato l'agente, la connessione di Claude richiede circa 90 secondi se hai familiarità con la schermata delle impostazioni. Ecco un esempio:

Claude ChatGPT Cursore Codice Claude VS Code Windsurf Interfaccia a riga di comando Gemini JetBrains Codice+5 in piùSola lettura

Cosa c'è dentro hubspot.offerte nel mio account HubSpot? Mostrami alcune righe e spiegami cosa rappresenta ogni colonna.

qs_get_table_schema query_di_esecuzione_qs schema_intelligence

Ho prima esaminato la struttura della tabella, poi ho eseguito una query in sola lettura tramite il tuo agente. Ecco tre righe della tabella hubspot.deals:

contratto	fase di negoziazione	quantità
1042	Northwind Traders	Seattle
1057	Alpine Outfitters	Denver
1063	Harbour Foods	Halifax

contratto identifica la riga. fase di negoziazione e quantità sono descritti nel tuo modello di Intelligenza Semantica, quindi posso filtrarli per nome.

Quali tre quantità Quali sono stati i valori che hanno generato il maggior fatturato in questo trimestre e come si confrontano con quelli del trimestre precedente? C'è qualcosa che dovrei approfondire?

qs_get_relationships query_di_esecuzione_qs query_di_esecuzione_qs

Mi sono unito hubspot.offerte a ordini Sulla relazione individuata dall'Intelligenza Semantica, è stata quindi eseguita un'aggregazione per ogni trimestre. Entrambe le query erano di sola lettura e restituivano 3 righe ciascuna:

quantità	Questo trimestre	Ultimo trimestre	Modifica
Denver	184,200	133,900	+38%
Seattle	171,650	168,400	+2%
Halifax	96,300	129,700	-26%

Denver Ecco la storia: il fatturato è aumentato del 38% con quasi lo stesso numero di clienti, quindi il valore medio degli ordini è cresciuto. Halifax Le vendite sono diminuite del 26%, e il calo è dovuto a due clienti che ordinavano ogni mese nel trimestre precedente e non hanno effettuato alcun ordine in questo trimestre: vale la pena chiamarli prima della fine del mese. A Seattle la situazione è stabile. Volete i nomi dei due clienti di Halifax?

SELEZIONA soltanto, controllato dall'agente accesso effettuato nella scheda Attività MCP 9 righe restituite da 3 query Stessa connessione in 14 client MCP

Preferiresti non configurare affatto un client di intelligenza artificiale? Nel piano aziendale, Nova è l'assistente integrato direttamente in Query Streams. Utilizza lo stesso set di strumenti Agent disponibile per il tuo client AI, con in più funzionalità aggiuntive rispetto ai client esterni: crea e convalida la query SQL rispetto al tuo modello di Intelligenza Semantica, trasforma la risposta in un grafico e salva il risultato come query eseguibile dal tuo team tramite Excel, Fogli Google o API REST, senza bisogno di chiavi, connettori o installazioni. Utilizza MCP se i tuoi utenti lavorano già con Claude, Cursor o ChatGPT; utilizza Nova se desideri ottenere le risposte direttamente all'interno del Portale.

HubSpot protegge i tuoi dati tramite la sua API. Claude, d'altro canto, opera in un browser o in un terminale e non ne sa nulla. Il metodo tradizionale consiste nell'incollare uno schema nella chat e sperare che funzioni, oppure nel fornire la propria password di HubSpot a un server MCP open source. Query Streams funziona diversamente: l'agente già presente nel tuo account HubSpot esegue le query SQL scritte da Claude, in sola lettura, e il server MCP, nel frattempo, verifica chi sta effettuando la richiesta, cosa può fare e con quale frequenza. Claude riceve le risposte, ma non ottiene mai le credenziali.

Cosa ti servirà

Un account Query Streams

MCP è disponibile in tutti i piani, incluso quello gratuito. Il piano gratuito consente una chiave o un'app connessa, che è tutto ciò di cui questa guida ha bisogno. Registrati su my.querystreams.com.

HubSpot connesso tramite l'agente

L'agente è installato su qualsiasi computer sempre acceso, con la connessione HubSpot aggiunta in Agenti dati. Non hai ancora finito? Collega prima HubSpotCi vogliono circa dieci minuti.

MCP attivato per te

I creatori, i proprietari e gli amministratori ce l'hanno fin dall'inizio. Tutti gli altri hanno bisogno di un amministratore per ribaltare il MCP interruttore accanto al loro nome sotto Account → Controllo accessiFino ad allora, la pagina MCP visualizza il messaggio "MCP è disabilitato per il tuo account".

Un client IA

Le app di chat come claude.ai, Claude Desktop e ChatGPT si connettono senza tasto. Claude Code, Cursor, VS Code e circa altri dieci strumenti utilizzano un tasto; il Portale Connetti un client AI la guida configura ciascuno.

Configuralo in quattro passaggi

1. Apri MCP nel portale

   Accedi a my.querystreams.com e aperto Streaming → In diretta → MCPLa pagina presenta quattro schede: Connessioni, Contesto, Utensili e, per gli amministratori, Attività. Controlla il pannello Intelligenza semantica su Connessioni Mentre sei qui: viene visualizzato il tuo connettore HubSpot e se l'Intelligenza Semantica è stata eseguita su di esso. Una copertura completa è ciò che permette a Claude di scrivere codice SQL HubSpot corretto al primo tentativo.

   Apri MCP

   Visualizzate il messaggio "MCP è disabilitato per il vostro account"? La tua organizzazione ha MCP ma il tuo utente è disattivato. Un amministratore lo attiva con il MCP interruttore accanto al tuo nome sotto Account → Controllo accessiCreatori, proprietari e amministratori sono attivi fin dall'inizio.

2. Scegli come ti connetterai

   Ci sono due vie d'accesso, ed entrambe conducono allo stesso punto:

   App di chat · nessuna chiave

   claude.ai, Claude Desktop, ChatGPT

   In claude.ai e Claude Desktop, apri il Elenco dei flussi di query nella directory dei connettori di Anthropic, fai clic su Collegare e approvare. Aggiungendolo tramite URL, https://mcp.querystreams.com/mcp, è il ripiego. In ChatGPT aggiungi Query Streams dall'app (modalità sviluppatore per ora) e accedi con Query Streams. In entrambi i casi si apre una pagina di Query Streams: seleziona l'organizzazione e le autorizzazioni e fai clic Approva la connessione. Nulla da copiare. La connessione appare su Connessioni scheda e può essere revocato lì.

   strumenti per sviluppatori · una chiave

   Claude Code, Cursor, VS Code e amici

   Nella pagina MCP fare clic Connetti un client AILa guida chiede Come si connetterà il tuo client AI?: scegliere Utilizzare una chiave in un file di configurazione, scegli il tuo strumento, poi Genera una chiave per esso: un Nome chiave, Leggere e Eseguire query spuntato, un Scadenza (Mai, 30 giorni, 90 giorni o 1 anno). Configuralo mostra il frammento con la chiave inserita e Verifica la connessione attende la prima chiamata.

   Entrambi i metodi utilizzano le stesse tre autorizzazioni, che è possibile selezionare nella schermata di consenso o nella chiave:

   Leggere

   Elenca i connettori, sfoglia tabelle e colonne, leggi le query salvate e le regole di avviso. Non restituisce mai dati di riga.

   Eseguire query

   Esegui query SQL di sola lettura e query salvate tramite il tuo agente e restituisci le righe. Senza questo passaggio, il tuo client AI può descrivere i dati, ma non essere in grado di fornire risposte.

   Analizzare

   Crea tabelle di profili, scopri le relazioni e metti in coda un'esecuzione di Intelligenza Semantica. Questo processo consuma crediti Nova AI e traffico dati, quindi la schermata di consenso non richiede mai una spunta preliminare.

   Hai perso le chiavi? È elencato su Connessioni tab: Mostra la chiave completa lo mostra di nuovo e Copia la chiave completa Lo copiano. Revocatelo lì se un portatile viene smarrito; ogni client che lo utilizza fallisce alla successiva chiamata, entro circa cinque minuti.

3. Mettiti in contatto con Claude

   Scegli la ricetta per il Claude che usi. L'indirizzo del server è lo stesso ovunque: https://mcp.querystreams.com/mcp.

   Claude sul web, Claude Desktop e mobile nessuna chiave

   1. Apri il Elenco dei flussi di query nella directory dei connettori di Anthropic e fai clic Collegare. Sul desktop si trova quindi sotto + → Connettori.
   2. Soluzione alternativa, se la tua organizzazione nasconde i connettori di directory: Impostazioni → Connettori → Aggiungi connettore personalizzato, nome Flussi di queryURL https://mcp.querystreams.com/mcp, campi OAuth vuoti, Aggiungi; poi in una chat + → Flussi di query → Collegare.
   3. Si apre una scheda Query Streams. Accedi se richiesto, scegli l'organizzazione, rivedi Leggere e Eseguire query, facoltativamente Limita a connettori specificie clicca Approva la connessione.
   4. Tornando a Claude, vedi “Connesso a Query Streams”. La prima volta che Claude usa uno strumento ti chiede; scegli Permetti sempre.

   Se lo aggiungi manualmente in Claude Desktop, usa Impostazioni → Connettori → Aggiungi, non la chat in corso Aggiungi marketplace opzione che richiede un repository Git. I connettori si sincronizzano con il tuo account Claude, quindi le app per dispositivi mobili e desktop lo rilevano automaticamente. I nomi dei menu sono di Anthropic e possono essere modificati.

   Codice Claude chiave

   Un solo comando, utilizzando il tasto che trovi nella scheda Connessioni:

   terminale

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

   Ciò scrive il progetto attuale .mcp.json. Aggiungere --scope utente per avere Query Streams in ogni progetto. Esegui /mcp All'interno di Claude Code per vedere la connessione.

   Cursore chiave

   Apri Impostazioni cursore → MCP → Aggiungi nuovo server MCP, oppure modifica .cursor/mcp.json alla base del tuo spazio di lavoro:

   .cursor/mcp.json

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

   Riavvia Cursor o esegui MCP: Riavvia i server; UN querystreams Il badge appare nella barra di stato dell'MCP.

   Usando qualcos'altro? Il portale Connetti un client AI guida ha ricette pronte da incollare per ChatGPT, VS Code, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev e JetBrains AI, oltre a Incolla e unisci strumento che lascia cadere querystreams voce in un file di configurazione che hai già. Qualsiasi client che comunica tramite MCP su HTTP funziona: server https://mcp.querystreams.com/mcpintestazione Chiave X-MCP (UN Autorizzazione: al portatore (Anche l'intestazione con la stessa chiave funziona).

4. Poni la tua prima domanda

   Iniziate con qualcosa di cui conoscete già la risposta, così potrete vedere Claude scegliere lo strumento giusto. Eccone tre che funzionano bene con il vostro account HubSpot:

   "Quali dati sono presenti nel mio account HubSpot?"

   Claude elenca le tabelle che può visualizzare, indica quali dispongono di Intelligenza Semantica e chiede cosa si desidera visualizzare.

   "Mostrami dieci righe da hubspot.deals e spiega ciascuna colonna."

   Claude legge prima la struttura della tabella (Lettura), poi esegue una SELECT tramite il tuo Agente (Esegui query) e spiega cosa significano dealstage e amount.

   "Quante righe ha hubspot.deals per ogni importo? Quale importo ne ha di più?"

   Claude scrive la clausola GROUP BY nel dialetto di HubSpot, la esegue e risponde con una frase allegando una piccola tabella. Continua la conversazione nella stessa chat; il contesto rimane invariato.

   Per confermare il cablaggio, chiedere “Quali connettori Query Streams ho a disposizione?”Claude chiama qs_list_connectors, la guida del Portale Verifica la connessione passo dice Collegatoe la chiave o l'app sul Connessioni la scheda mostra il suo Ultimo utilizzo tempo entro pochi secondi.

Cosa può fare Claude una volta connesso

Il tuo client AI vede gli strumenti Query Streams; sceglie quello giusto per la tua domanda. Il portale Utensili scheda elenca tutti gli strumenti e le modalità inclusi nel tuo piano. Query Streams chiede al tuo client AI di leggere le colonne di ogni tabella prima di eseguire query, così usa i nomi reali invece di tirare a indovinare. In tutti i piani, incluso Free:

Il set di strumenti analitici. Nei piani a pagamento, l'agente si occupa del lavoro preliminare nel tuo account HubSpot, così il tuo client AI può concentrarsi sull'elaborazione. La versione gratuita funziona come sempre.

Le impostazioni predefinite risiedono su Contesto scheda: limite delle celle di testo, visualizzazione dello schema, dimensione del risultato, impostazioni predefinite dell'analisi e risultati bloccati.

Perché l'intelligenza semantica è importante in questo contesto

Ogni risposta che Claude riceve è etichettata con l'indicazione della provenienza della struttura, e Claude regola di conseguenza il livello di fiducia che ripone in ciò che osserva.

Se un database è importante, esegui l'Intelligenza Semantica su di esso una volta da Nova → Intelligenza. IL Connessioni La scheda mostra un pannello di copertura per ciascun connettore. Come funziona l'intelligenza semantica.

Cosa consentono i piani

MCP è incluso in tutti i piani, compreso quello gratuito, senza costi aggiuntivi. Ogni piano definisce il numero di tasti o app connesse che è possibile gestire e il numero di chiamate al minuto che il client AI può effettuare:

Un'app connessa viene conteggiata come una chiave. Oltre al limite al minuto, ogni chiave può eseguire al massimo 10 query al minuto. Una query dura fino a 60 secondi, a meno che il client AI non richieda un tempo maggiore, fino a un massimo di cinque minuti. Il piano scelto definisce anche il numero di righe restituite da una query e, con il set di strumenti analitici, la durata e le dimensioni di un risultato memorizzato. Guida completa all'MCP elenca tutti i piani. Ciò che riceve il tuo client AI viene conteggiato nel limite del tuo Data Realm, lo stesso pool utilizzato dalle query di Excel e Sheets: l'utilizzo dell'AI agent (MCP) conteggia ogni byte inviato al tuo client AI, inclusi risultati, letture dello schema e pagine dei risultati mantenuti, prima di qualsiasi compressione del trasporto negoziata dal client; le query dei fogli di calcolo, invece, conteggiano il risultato compresso inviato dal tuo Network Agent. Le esecuzioni di Semantic Intelligence avviate dal tuo client AI consumano crediti Nova AI, proprio come quelle avviate dal Portal. Consulta la pagina dei prezzi per le indennità.

Tenerlo al sicuro

Buone mosse successive

• Salva le query che consideri canoniche In Query Builder, Claude utilizza prima le query salvate, quindi "clienti attivi" ha il significato che il tuo team gli attribuisce.
• Utilizzare un progetto Claude con Query Streams collegato e inserisci le tue regole interne nelle relative istruzioni: quale database HubSpot utilizzare per impostazione predefinita, quali query salvate sono le definizioni ufficiali.
• Grant Analyze è il servizio che offre per chi desidera risposte più approfondite. La profilazione di una colonna prima di applicare un filtro fa la differenza tra indovinare un codice di stato e utilizzare quello corretto. Questa operazione consuma crediti Nova AI, quindi rimarrà disattivata finché non la si disattiva.
• Richiedi un grafico. claude.ai genera grafici a partire dalle righe che Claude riceve in risposta.

Quando qualcosa non funziona

Domande che le persone si pongono

Guide correlate

• Collega Stripe a Claude con MCP
• Collega Shopify a Claude con MCP
• Collega Google Analytics 4 a Claude con MCP
• Collega Google Search Console a Claude tramite MCP.
• Connettere Query Streams a Claude tramite MCP: configurazione, autorizzazioni e risoluzione dei problemi
• Come collegare HubSpot a Fogli Google
• Tutte le guide MCP