Collega Query Streams a Claude e fai domande sui tuoi database in linguaggio semplice. Claude legge il tuo schema, le tue query salvate e il tuo Intelligenza semantica Il modello è in tempo reale, esegue query SQL in sola lettura tramite il tuo Network Agent e non accede mai alla password del database. Il tuo client AI fa le richieste; il Network Agent, il suo partner all'interno della tua rete, si occupa del lavoro più complesso dove risiedono i dati. Questa guida tratta claude.ai, Claude Desktop, ChatGPT e Claude Code, oltre a tutti gli altri client MCP.
Versione breve. Installare il Agente di rete accanto al tuo database una volta (pochi minuti) e aggiungi un connettore. Quindi apri il Elenco dei flussi di query nella directory dei connettori di Anthropic, fai clic su Collegare, approva le autorizzazioni nella schermata di consenso di Query Streams e chiedi a Claude “A quali database ho accesso?” Claude può visualizzare solo i dati forniti da un agente: se si salta l'agente, verrà visualizzato un messaggio che indica l'assenza di connettori.
Prima di iniziare
Ti servono quattro cose. Se hai trovato Query Streams all'interno di Claude, l'agente e un connettore sono le due cose che devi ancora configurare.
Un piano che include MCP
MCP è incluso in tutti i piani, compreso quello gratuito. Il tuo piano determina il numero di chiavi o app connesse che puoi gestire, il numero di chiamate al minuto che il tuo client AI può effettuare, il numero di righe restituite da una query e se il set di strumenti di analisi è incluso. Cosa include ciascun piano.
Un agente di rete che è online
L'agente è il piccolo servizio che si trova accanto al tuo database e stabilisce una connessione in uscita con Query Streams. Nuovo account? Installalo ora da my.querystreams.com/download, pochi minuti dopo Finestre, macOS o LinuxSe il tuo team esegue già query nel Portale, in Excel o in Fogli Google, l'applicazione è già installata.
Almeno un connettore
Un connettore è un database o un'API registrata nel Portale. Claude può visualizzare tutti i connettori accessibili al tuo account, in base alle autorizzazioni che hai concesso.
Accesso MCP sul tuo utente
I creatori e i proprietari dell'organizzazione hanno accesso MCP automaticamente. Gli altri utenti necessitano dell'autorizzazione di un amministratore. MCP accanto al loro nome in Account → Controllo accessi.
Come funziona
Claude non si connette mai al tuo database. Comunica con il server Query Streams MCP nel nostro cloud, che inoltra ogni richiesta tramite l'unica connessione in uscita già aperta dal tuo Network Agent. L'agente esegue la query localmente e trasmette i risultati nello stesso modo. Richieste e risultati fluiscono in entrambe le direzioni attraverso quell'unico canale avviato dall'agente, quindi non è necessario aprire nulla sul tuo firewall.
OAuth, ambiti, audit, limiti di frequenza
una connessione TLS in uscita
Da questo progetto derivano tre caratteristiche:
- Nessuna credenziale a Claude. La stringa di connessione al database risiede sull'agente. Claude possiede solo un'autorizzazione OAuth o una chiave MCP, entrambe revocabili dal Portale con un solo clic.
- Sola lettura, applicata a livello dell'agente. Soltanto
SELEZIONARE,CONeSPIEGARELe dichiarazioni vengono accettate. Il controllo avviene dal tuo lato della connessione, non nel cloud e non in Claude. - Tutto viene registrato. Ogni chiamata di strumento appare nella pagina MCP Attività scheda e ogni query nella Cronologia query, attribuita all'utente che si è connesso.
Collega il tuo client AI
La pagina MCP nel Portale (Streaming → In diretta → MCP) ha quattro schede: Connessioni, Contesto, Utensili e, per gli amministratori, Attività. Su Connessioni, il Connetti un client AI Il pulsante apre una guida in quattro passaggi: Come si connetterà il tuo client AI?, Scegli il tuo client AI, Configuralo e Verifica la connessioneEsistono due modalità di accesso. Le app di chat si avvalgono dell'approvazione dell'app stessa e non necessitano di una chiave. Gli strumenti per sviluppatori utilizzano una chiave MCP. Entrambe le modalità si connettono allo stesso server e utilizzano gli stessi strumenti.
Opzione A: claude.ai, Claude Desktop e ChatGPT (approvazione dall'app, nessuna chiave)
Inserito nell'Anthropic Connectors Directory. Query Streams è un connettore approvato: claude.ai/directory/query-streams. Apri l'elenco, fai clic Collegare e approvare; non è necessario l'URL del server. L'aggiunta tramite URL è la soluzione di ripiego per le organizzazioni Claude che limitano i connettori di directory.
- Apri il Elenco dei flussi di query e clicca CollegareIl connettore si sincronizza con il tuo account Claude, quindi Claude Desktop lo mostra sotto + → Connettori. Non riesci a visualizzare l'annuncio? La tua organizzazione potrebbe limitare i connettori di directory: in Impostazioni → Connettori clic Aggiungi connettore personalizzato, chiamalo Flussi di query, impasto
https://mcp.querystreams.com/mcp, quindi nella chat fai clic +, scegliere Flussi di query e clicca Collegare. - Si aprirà una nuova scheda del browser per visualizzare la schermata di consenso di Query Streams. Accedi se richiesto, seleziona l'organizzazione, rivedi le autorizzazioni (vedi sotto) e fai clic su Approva la connessione.
- Tornato a Claude vedrai Connesso ai flussi di query. La prima volta che Claude usa uno strumento, ti chiede l'autorizzazione. Scegli Permetti sempre in modo che possa funzionare senza richiedere conferma a ogni chiamata.
Il connettore è collegato al tuo account Claude, non a un singolo dispositivo, quindi appare automaticamente nelle app mobili Claude e in Claude Desktop. Puoi gestirlo o revocarlo in qualsiasi momento dal Portale. MCP → Connessioni tab.
ChatGPT. Aggiungi flussi di query dall'app stessa: per ora ciò significa attivare la modalità sviluppatore nelle impostazioni di ChatGPT e creare la connessione lì, quindi fare clic Accedi con Query Streams e approvando nella stessa schermata di consenso. La guida del portale mostra i passaggi attuali di ChatGPT; un elenco ufficiale di ChatGPT è in arrivo.
Non è la stessa cosa di "Aggiungi marketplace". In Claude Desktop la chat in corso + → Sfoglia i connettori → Aggiungi marketplace L'opzione richiede un repository git per i marketplace dei plugin, non un URL del server MCP. Utilizzare l'elenco Collegare pulsante, o Impostazioni → Connettori → Aggiungi per il percorso URL.
Opzione B: Claude Code, Cursor e altri strumenti per sviluppatori (tasto MCP)
Gli strumenti per sviluppatori si autenticano con una chiave che generi nel Portale e passi nel Chiave X-MCP intestazione.
- Accedi a my.querystreams.com, aprire MCP e clicca Connetti un client AI. Scegliere Utilizzare una chiave in un file di configurazione e scegli il tuo strumento.
- Cliccare Genera una chiave per il tuo strumento. Dagli un nome che richiami lo strumento e la macchina, ad esempio laptop claude-code, Mantenere Leggere e Eseguire querye scegli una data di scadenza. Puoi rivelare e copiare nuovamente la chiave in seguito dal Connessioni scheda. I tasti hanno questo aspetto
qsmcp_seguito da 43 caratteri. - Configuralo Mostra la configurazione pronta per essere incollata per Cursor, VS Code, Windsurf, Zed, JetBrains, Gemini CLI, Codex CLI, Continue, Cline e altri, con la tua chiave già inserita. Per Claude Code basta un solo comando:
claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp --header "X-MCP-Key: qsmcp_INSERISCI_QUI_LA_CHIAVE" - Verifica la connessione attende la prima chiamata da quel tasto e dice Collegato.
Per verificare in qualsiasi momento, chiedi “Quali connettori Query Streams ho a disposizione?” Il cliente dovrebbe chiamare qs_list_connectorse la chiave Ultimo utilizzo L'ora nella scheda Connessioni si aggiorna in pochi secondi.
Autorizzazioni
Sia che la connessione avvenga tramite OAuth o tramite chiave, l'accesso è controllato da tre ambiti. Questi vengono visualizzati nella schermata di consenso e, insieme ad essi, viene creata la chiave.
| Ambito di applicazione | Cosa può fare Claude | Quando concederlo |
|---|---|---|
| Leggere | Elenca connettori e agenti, esplora lo schema, leggi le descrizioni di Semantic Intelligence e i profili delle colonne e le relazioni memorizzati, elenca le query salvate e le regole di avviso. | Sempre. Tutto il resto si basa su questo. |
| analizzare | Crea il profilo di una tabella o individua in tempo reale le relazioni implicite su Network Agent e accoda un’esecuzione di Semantic Intelligence. Senza di esso, il tuo client AI non vede gli strumenti che avviano un’esecuzione di Semantic Intelligence. | Consigliato. Questo permette a Claude di comprendere la struttura dei dati prima di scrivere le join. |
| eseguire | Mostrato come Esegui query (sola lettura)Esegui query SQL in sola lettura e query salvate e visualizza i risultati in streaming; conserva i risultati ed esegui su di essi gli strumenti di analisi e approfondimento. | Per chiunque debba ottenere risposte, non solo consultare la struttura. Disattivare questa opzione per una legenda di sola consultazione. |
Un'app connessa può essere limitata a connettori specifici al momento dell'approvazione; una chiave generata raggiunge tutti i connettori dell'organizzazione. La revoca di un'autorizzazione o di una chiave ha effetto entro circa cinque minuti. Gli amministratori possono visualizzare tutte le autorizzazioni e le chiavi attive per l'organizzazione nella scheda Connessioni.
Cosa può fare il tuo client AI una volta connesso
Il tuo client AI vede gli strumenti Query Streams e sceglie quello giusto per la tua domanda; non devi mai chiamarli tu. Il portale scheda Strumenti elenca tutti gli strumenti e le modalità, spiega a cosa serve ciascuno e indica quali sono inclusi nel tuo piano.
Per rispondere a una domanda sui tuoi dati, Query Streams guida il tuo client AI attraverso quattro passaggi: elencare i connettori, leggere le tabelle del database’s, leggere le colonne di ogni tabella che interrogherà, quindi eseguire una query di sola lettura. Leggere prima le colonne è ciò che gli impedisce di indovinare i nomi. In tutti i piani, incluso Free:
Mappa i tuoi dati
Elenca connettori, database e agenti. Leggi l'albero dello schema per qualsiasi database con descrizioni di tabelle e colonne, tipi semantici, valori di esempio, etichette enum e relazioni sia dichiarate che scoperte.
Profilo ed esplorazione
Analizza una tabella per visualizzare la distribuzione reale dei valori prima di scrivere un filtro. Scopri le join tra tabelle che non hanno chiavi esterne dichiarate.
Eseguire query SQL in sola lettura
Scrivi ed esegui query SQL di sola lettura nel dialetto corretto per il connettore. Timeout predefinito di 60 secondi, fino a un massimo di cinque minuti; il tuo piano definisce il numero di righe restituite da una query.
Query salvate, federate e avvisi
Esegui le query parametrizzate salvate dalla tua organizzazione con nuovi valori; le query federate che si estendono su più origini vengono restituite già unite. Leggi le regole di avviso e le relative attivazioni recenti e proponi una nuova regola in modalità di simulazione.
Il set di strumenti analitici
Nei piani a pagamento, Network Agent svolge il lavoro di base dove risiedono i tuoi dati: misura, profila, memorizza e analizza i risultati, in modo che il tuo client AI affronti ogni domanda con il contesto già preparato e possa concentrare la sua attenzione sul pensiero. Il piano gratuito funziona come sempre, con risultati standard. La guida completa è in Analizza i tuoi dati con il tuo client di intelligenza artificiale.
Gestione del contesto
Personale Core e superiori. Dimensiona il risultato prima di leggerlo (forma): colonne, stima della riga e costo del token, nessuna riga. Percorri un grande database area per area (schemi). Mantieni le risposte entro un budget simbolico, con solo il colonne e la lunghezza delle celle di testo necessarie.
Analisi dei risultati
Personale Core e superiori. A profilo dell'intero risultato anziché delle righe. Risultati mantenuti, con etichette, rispondere a domande di approfondimento come "suddividi per regione" o "le prossime 50 righe" senza una seconda query al database. Aggiornamenti dei dati e cambiato-da Leggi solo ciò che è nuovo.
Analisi più approfondita
Business Core e superiori. Un dato qualità rapporto, innovativi, segmenti, una statistica confrontare e un diff tra due risultati confermati.
Tu mantieni il controllo. IL scheda di contesto Imposta i valori predefiniti: il limite delle celle di testo, la visualizzazione dello schema per database di grandi dimensioni, la dimensione dei risultati e i valori predefiniti dell'analisi e mostra cosa riceve il tuo client AI. Elenca anche i risultati che ogni agente possiede. Ogni chiave può sovrascrivere i valori predefiniti, ogni chiamata è nella scheda Attività e un amministratore può attivare Analisi locale via per un agente sotto Dati → Agenti dati.
Cosa include il tuo piano
MCP è incluso in tutti i piani, compreso quello gratuito, e il piano gratuito non scade mai.
| Piano | Chiavi per utente | Chiavi per organizzazione | Chiamate al minuto | Righe per query | Strumenti analitici | Risultati mantenuti |
|---|---|---|---|---|---|---|
| Gratuito | 1 | 1 | 30 | 1,000 | Risultati standard | Nessuno |
| Nucleo personale | 1 | 1 | 60 | 2,500 | Gestione del contesto, analisi dei risultati | 15 minuti, 128 MB |
| Plus personale | 1 | 1 | 90 | 5,000 | Gestione del contesto, analisi dei risultati | 15 minuti, 128 MB |
| Nucleo aziendale | 2 | 3 | 120 | 10,000 | Gestione del contesto, analisi dei risultati, analisi più approfondita | 60 minuti, 512 MB |
| Business Plus | 3 | 5 | 150 | 25,000 | Tutti e tre | 60 minuti, 512 MB |
| Gestione massima | 5 | 10 | 240 | 50,000 | Tutti e tre | 60 minuti, 512 MB |
| Nucleo aziendale | 5 | 25 | 300 | 100,000 | Tutti e tre | 8 ore, 4.096 MB |
| Enterprise Plus | 8 | 50 | 450 | 100,000 | Tutti e tre | 8 ore, 4.096 MB |
| Enterprise Max | 10 | 100 | 600 | 100,000 | Tutti e tre | 8 ore, 4.096 MB |
Un'app connessa conta come una chiave. Su ogni piano, ogni chiave esegue al massimo 10 query al minuto. Il numero di righe per query rappresenta il numero massimo di righe che una query restituisce al client AI; richiederne di più restituisce il limite del piano e lo segnala, senza mai generare un errore. Un risultato viene conservato per domande successive fino al limite di tempo e dimensione del piano, entro i limiti della capacità del computer dell'agente. Tutti i piani a confronto: determinazione dei prezzi.
Perché l'intelligenza semantica è importante in questo contesto
Ogni risposta che Claude riceve viene etichettata con il livello di provenienza (su tre possibili) e Claude regola di conseguenza il grado di fiducia che ripone in ciò che vede.
| Livello | Ciò che vede Claude | Risultato |
|---|---|---|
| Intelligenza semantica | Descrizioni per ogni tabella e colonna, tipi semantici, etichette enum, valori di esempio, classificazione dei fatti e delle dimensioni, join dichiarati e rilevati. | Claude scrive codice SQL di qualità professionale al primo tentativo e spiega i dati utilizzando un linguaggio comprensibile per la tua azienda. |
| Schema acquisito | Nomi di tabelle e colonne, tipi, chiavi primarie, indici, chiavi esterne dichiarate. | Claude funziona, ma deve dedurre il significato dai nomi e potrebbe aver bisogno di una domanda di approfondimento. |
| Schema live | Il database non è presente nell'opzione di acquisizione del connettore, pertanto la struttura viene letta in tempo reale dal catalogo a ogni richiesta. | Le query sono ancora in esecuzione. Claude esplora con selezioni di esempio quando sono necessarie ulteriori informazioni. |
Se un database è importante per il tuo team, esegui l'analisi di Intelligenza Semantica su di esso una sola volta. Per i database di grandi dimensioni, limita l'analisi alle tabelle effettivamente utilizzate dalle tue query. Come funziona l'intelligenza semantica →
Esempi di richieste
Inizia con qualcosa di cui conosci già la risposta. Poi fai domande di approfondimento; Claude mantiene il contesto.
A quali database e tabelle ho accesso e quali di essi dispongono di intelligenza semantica?Mappa i tuoi connettori e ti indica dove le risposte saranno più efficaci. Mostrami come i clienti sono collegati agli ordini nel database delle vendite e analizza la colonna relativa allo stato dell'ordine.Utilizza relazioni e profilazione delle colonne. Claude ti mostrerà i codici di stato effettivi e il loro significato. Esegui la query salvata "Ricavi mensili per regione" relativa al secondo trimestre di quest'anno.Esegue una query salvata e affidabile con parametri, anziché generare una query SQL personalizzata. I 10 prodotti con il fatturato più alto negli ultimi 90 giorni. Successivamente, un'analisi dettagliata per canale di vendita.SQL ad hoc nel dialetto del connettore, seguito da un'ulteriore query sullo stesso thread. Nei piani con analisi dei risultati, l'ulteriore query può provenire dal risultato memorizzato, senza necessità di una seconda query. Quali regole di avviso sono configurate e qualcuna di esse si è attivata questa settimana?Legge le regole di allerta e il loro stato recente.Consigli per risposte migliori
- Utilizzare un progetto Claude. Collega il connettore Query Streams a un progetto e inserisci le tue regole aziendali nelle istruzioni del progetto: quale database utilizzare per impostazione predefinita, quali query salvate rappresentano le definizioni ufficiali, le convenzioni di denominazione. Claude continua a leggere lo schema in tempo reale, quindi le istruzioni rimangono brevi.
- Salva le query che consideri canoniche. Claude accede prima alle query salvate, quindi "clienti attivi" ha il significato che il tuo team gli attribuisce.
- Concedi l'ambito di analisi. La profilazione di una colonna prima di applicare un filtro fa la differenza tra indovinare un codice di stato e utilizzare quello corretto.
- Richiedi un grafico. claude.ai genera grafici a partire dalle righe che Claude riceve in risposta.
Quanto costa
MCP di per sé non prevede costi aggiuntivi in nessun piano tariffario. Due elementi vengono misurati:
- Volume dei dati. I risultati delle query restituiti a Claude vengono conteggiati sullo stesso budget del realm di dati condiviso da Excel, Google Sheets, Portal e Nova. Tramite MCP, vengono conteggiati tutti i byte consegnati a Claude — risultati, letture dello schema e pagine dei risultati mantenuti — prima di qualsiasi compressione del trasporto, perché un client di IA li riceve non compressi; i risultati di fogli di calcolo, Portal e API vengono conteggiati nella forma compressa consegnata dal Network Agent. Una risposta non riuscita non viene conteggiata. Mantieni brevi le domande esplorative; nei piani con la gestione del contesto, chiedere prima a Claude di dimensionare un risultato (mode: shape) evita di recuperare righe di cui non ha bisogno.
- Esecuzione di Semantic Intelligence. L'avvio di un'analisi tramite Claude addebita alla tua organizzazione i crediti AI, esattamente come avviene per l'esecuzione dal Portale. Claude richiede la tua autorizzazione prima di procedere.
Risoluzione dei problemi
| Ciò che vedi | Cosa significa | Aggiustare |
|---|---|---|
| Claude dice che non ci sono connettori, né alcun agente di rete. | Nel tuo account non è ancora in esecuzione alcun agente oppure all'agente non è stata aggiunta alcuna origine dati. | Installa l'agente da my.querystreams.com/download, aggiungi un connettore sotto Dati → Agenti dati → Aggiungi connettore, quindi chiedi di nuovo. |
| Claude non mostra alcuno strumento di Query Streams | Il connettore è stato aggiunto ma non è stato possibile stabilire una connessione tramite chat, oppure l'approvazione OAuth non è mai stata completata. | Apri una chat, fai clic +, scegli Flussi di query, Collegaree completare la schermata di consenso. |
MCP_KEY_REQUIRED o 401 | Nessuna chiave o concessione ha raggiunto il server. Per i client che utilizzano le chiavi, di solito si tratta di un errore di copia-incolla, come un'interruzione di riga finale, oppure la chiave si trova nell'intestazione sbagliata. | Ricopia la chiave nel Chiave X-MCP Intestazione. Per claude.ai, riconnettiti dal menu +. |
MCP_TOKEN_SCADUTO | Il token OAuth è scaduto dopo un periodo di inattività. | Claude di solito si aggiorna automaticamente. In caso contrario, scollegare e ricollegare il connettore. |
MCP_KEY_REVOCATA o MCP_USER_DISABLED | La chiave è stata revocata oppure l'accesso a MCP è stato disattivato per il tuo utente. | Genera una nuova chiave oppure chiedi a un amministratore di riattivare MCP su Account → Controllo accessi. |
MCP_SCOPE_REQUIRED | La concessione o la chiave non ha la portata per tale azione, il più delle volte eseguire (Esegui query). | Riconnettiti e approva l'ambito mancante oppure genera una chiave che lo includa. |
MCP_PLAN_SCADUTO | L'abbonamento della tua organizzazione è scaduto. | La pagina MCP nel Portale mostra lo stato attuale del piano e le fasi successive. |
MCP_AGENT_NON_CONNESSO | L'agente di rete proprietario del connettore non è attualmente connesso. | Controllo Agenti dati nel Portale. Avviare il servizio agente sul relativo host. |
MCP_CONNECTOR_NOT_ALLOWED | L'app connessa era limitata a connettori specifici al momento dell'approvazione, e questo non è uno di quelli. | Ricollega l'app e autorizza un accesso più ampio nella schermata di consenso di Query Streams. |
MCP_DATABASE_NON_ACQUISITO | Il database non è presente nell'opzione di acquisizione dello schema del connettore, pertanto non sono disponibili informazioni semantiche o relazioni memorizzate da leggere. Le query funzionano comunque. | Aggiungi il database alla selezione di acquisizione sul connettore nel portale, quindi, facoltativamente, esegui l'analisi semantica. |
MCP_RATE_LIMITED | Troppe chiamate al minuto per il tuo piano tariffario. | Aspetta un attimo. Le sessioni intensive traggono vantaggio dall'Intelligenza Semantica, che consente a Claude di rispondere in un minor numero di chiamate. |
MCP_QUERY_TIMEOUT | La query ha superato il tempo limite, impostato di default a 60 secondi. | Chiedi a Claude di aggiungere un filtro o un limite inferiore di righe, oppure aumenta timeout_secondi fino a 300. |
MCP_OUTPUT_TOO_LARGE | Il risultato era troppo complesso per essere fornito al tuo client di intelligenza artificiale in un'unica risposta. | Richiedi un numero inferiore di colonne o righe. Nei piani con gestione del contesto, richiedi che venga prima dimensionato il risultato. |
MCP_FEATURE_NON_INCLUSA | Il tuo piano non include la gestione del contesto, l'analisi dei risultati o l'analisi approfondita; oppure lo strumento è disattivato per questa chiave o organizzazione. | Chiedi al tuo client AI di continuare senza, di passare a un piano superiore o di chiedere a un amministratore di attivare lo strumento. |
MCP_RESULT_EXPIRED | Il risultato memorizzato non è più memorizzato: è scaduto, è stato rilasciato (a volte in anticipo, per fare spazio a un risultato più recente) oppure l'agente è stato riavviato. | Chiedi al tuo client di intelligenza artificiale di eseguire nuovamente la query con hold. |
MCP_WINDOW_BUDGET | L'agente non può conservare un risultato di quelle dimensioni in questo momento, oppure un'operazione successiva richiede più memoria di quella disponibile per i risultati memorizzati. | Rilascia un risultato in sospeso oppure restringi la query con un filtro o riducendo il numero di colonne. |
ANALISI DELL'AGENTE MCP DISABILITATA | I risultati e le analisi in sospeso sono disattivati per quell'agente o per quel connettore. | Chiedi a un amministratore di attivare Analisi locale per l'agente nella pagina Agenti dati oppure consentire l'analisi sul connettore. |
MCP_WINDOW_SQL_REJECTED | Un'operazione successiva non consisteva in una singola query SELECT di sola lettura sulle tabelle del risultato memorizzato, oppure specificava una colonna che il risultato non possedeva. | Richiedi un'unica query SELECT su quel risultato, utilizzando i nomi delle colonne. |
MCP_AGENT_VERSION_TOO_OLD | L'agente necessita di un aggiornamento prima di poter modellare, profilare, memorizzare o analizzare i risultati. | Aggiorna l'agente da Dati → Agenti datiNel frattempo, le query semplici continuano a funzionare. |
| Una query non riesce a causa del nome di una colonna o di una tabella | Il tuo client AI ha indovinato un nome invece di leggere prima la tabella. | Di solito, nulla. L’errore ricevuto elenca le colonne effettive della tabella o le tabelle con un nome simile, così può correggere la query al tentativo successivo. Se continua a indovinare, chiedigli di leggere prima le colonne della tabella. |
| violazione di sola lettura | La query SQL conteneva qualcosa di diverso da SELEZIONARE, CON o SPIEGARE. | Per scelta. Le richieste di scrittura non vengono mai accettate tramite MCP. |
Ancora bloccato? Invia un'e-mail [email protected].
Sicurezza e privacy
- Claude riceve i metadati dello schema, le descrizioni di intelligenza semantica, inclusi i valori di esempio, e i risultati delle query richieste. Con il set di strumenti analitici, spesso riceve invece una stima delle dimensioni, un profilo o una risposta con risultati parziali, mentre il risultato completo rimane all'agente. Ciò che riceve viene trasmesso al provider di intelligenza artificiale scelto per la connessione, secondo i termini di quest'ultimo.
- Query Streams non riceve né memorizza la tua conversazione con Claude.
- Le autorizzazioni e le chiavi OAuth sono specifiche per utente e per organizzazione. Un amministratore può visualizzare e revocare ogni autorizzazione e chiave dalla pagina MCP.
- I dettagli completi sono disponibili nel nostro Informativa sulla privacy e Condizioni di servizio.
Domande frequenti
Devo aprire una porta o usare una VPN?
No. L'agente effettua una connessione TLS in uscita sulla porta 443. Se la connessione HTTPS in uscita funziona, MCP funziona.
Claude può modificare i miei dati?
No. L'agente accetta solo istruzioni di lettura. Claude può mettere in coda un'esecuzione di Semantic Intelligence e proporre una regola di avviso in modalità di simulazione; entrambe scrivono nei metadati di Query Streams, mai nel database.
Quali altri strumenti di intelligenza artificiale funzionano?
Qualsiasi cosa che parli MCP: ChatGPT, Cursor, Claude Code, Windsurf, Zed, VS Code Copilot, JetBrains AI, Gemini CLI, Codex CLI, Continue, Cline e altro ancora. Il portale Connetti un client AI La guida ha una configurazione predefinita per ciascuno.
Che cos'è un risultato sospeso?
Nei piani con analisi dei risultati, il client AI può chiedere all'agente di conservare un risultato completo per un certo periodo di tempo. Le domande successive, come ad esempio una ripartizione per regione o la pagina successiva di righe, vengono quindi elaborate a partire da tale copia senza dover eseguire una seconda query al database. La durata e le dimensioni del risultato conservato variano in base al piano scelto.
Quali piani includono il set di strumenti analitici?
La gestione del contesto e l'analisi dei risultati sono incluse nei pacchetti Personal Core e superiori; l'analisi più approfondita è disponibile nei pacchetti Business Core e superiori. La tabella dei piani ha i dettagli.
Questo modifica il piano gratuito?
No. Il piano gratuito funziona come sempre, con risultati standard.
Funziona con diverse organizzazioni?
Ogni sovvenzione o chiave è associata a una singola organizzazione. Effettua la connessione una sola volta per ogni organizzazione di cui hai bisogno.
Qual è la differenza tra questo e Nova?
Nova è l'assistente integrato nel portale Query Streams e condivide lo stesso modello di intelligenza semantica. Utilizza Nova quando desideri ottenere risposte direttamente in Query Streams; utilizza MCP quando vuoi visualizzare i tuoi dati in Claude insieme a tutte le altre attività che svolgi lì.
Guide specifiche per i connettori
Ciascuna guida illustra la stessa connessione con esempi relativi a quella fonte.
Database: Microsoft SQL Server · PostgreSQL · MySQL · MariaDB · Oracolo · Fiocco di neve · Google BigQuery · SQLite · Microsoft Access · DuckDB · Supabase
API: Striscia · Shopify · HubSpot · Annunci Google · Google Analytics 4 · Google Search Console · ShipStation · iTick
Cartelle di file e registri (L'agente analizza una cartella e trasforma i file in tabelle): Sistema di file · Cartella CSV · Cartella Parquet · Cartella Excel · Cartella SQLite · Cartella JSONL · File CSV multi-record · Registri delle macchine · Registri del server web · Registri dei container · Registri delle applicazioni · Registri di sistema · Registri personalizzati
Database ospitati (gestisce PostgreSQL, MySQL, MariaDB e SQL Server, raggiungibili dall'agente tramite TLS): Neon · Amazon RDS · Azure Database per PostgreSQL · Database Azure per MySQL · Azure SQL · Google Cloud SQL · Google AlloyDB · Database gestiti da DigitalOcean · Aiven · Ponte croccante · Heroku Postgres · Render · Ferrovia · Fly.io Postgres · Database gestiti da Vultr · Database gestiti da OVHcloud · Database gestiti da Scaleway · Database OCI con PostgreSQL · MySQL HeatWave · Database IBM Cloud per PostgreSQL · MariaDB SkySQL · Xata · Nuvola di scala temporale · PlanetScale Postgres · Prisma Postgres · Koyeb · Nilo
Collega Claude ai tuoi dati
Installa l'agente una sola volta, in pochi minuti. Dopodiché, connettere Claude è questione di un clic: nessuna chiave, nessun file di configurazione, nessuna VPN. Sola lettura per impostazione predefinita.
Installare l'agente Apri la pagina MCP Come funziona MCP
English 
Spanish 
German 
French 
Portuguese 
Japanese 
Korean 
Chinese 
Italian 
Dutch 
Indonesian 
Polish