Collega Query Streams a Claude e poni domande sui tuoi database in linguaggio naturale. Claude legge in tempo reale il tuo schema, le query salvate e il modello Schema Intelligence, esegue query SQL in sola lettura tramite il tuo Network Agent e non ha mai accesso alla password del database. Questa guida illustra claude.ai, Claude Desktop e Claude Code, oltre a tutti gli altri client MCP.
Versione breve. Query Streams is in the Anthropic Connectors Directory. In claude.ai open Settings → Connectors → Browse connectors, Trovare Flussi di query, clicca Collegare, approva le autorizzazioni nella schermata di consenso di Query Streams e chiedi a Claude “A quali database ho accesso?” That’s it.
Prima di iniziare
Ti servono quattro cose. La maggior parte degli account ha già le prime tre.
Un piano che include MCP
MCP è disponibile in tutti i piani, incluso quello gratuito. Ciò che varia a seconda del piano è il numero di tasti o app connesse che è possibile utilizzare e il numero di chiamate al minuto che Claude può effettuare; il piano gratuito consente un tasto o un'app connessa e 30 chiamate al minuto.
Un agente di rete che è online
L'agente è il piccolo servizio che si trova accanto al database e stabilisce una connessione in uscita con Query Streams. Se il tuo team esegue già query nel Portale, in Excel o in Fogli Google, è già installato. Guida all'installazione →
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.
Mettiti in contatto con Claude
Esistono due modalità di accesso. Le app di chat utilizzano OAuth e non necessitano di chiavi. Gli strumenti per sviluppatori utilizzano una chiave MCP. Entrambe accedono allo stesso server e agli stessi strumenti.
Opzione A: claude.ai e Claude Desktop (OAuth, senza chiave)
Listed in the Anthropic Connectors Directory. Query Streams is an approved connector: claude.ai/directory/query-streams. On claude.ai and in Claude Desktop you can connect it with one click from Sfoglia i connettori; no server URL needed. The custom-connector route below still works and is what to use if your Claude organization restricts directory connectors.
- SU claude.ai aprire Settings → Connectors → Browse connectors, cerca Flussi di query e clicca Collegare (or open the directory listing directly). In Claude Desktop the same option is under Impostazioni → Connettori. Can’t see it? Your organization may restrict directory connectors: click Aggiungi connettore personalizzato instead, name it Flussi di query and paste
https://mcp.querystreams.com/mcp. - Apri una chat qualsiasi, fai clic su + pulsante accanto alla casella di messaggio, scegli 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 → App connesse tab.
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 Impostazioni → Connettori → Aggiungi.
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 → Le mie chiavi e clicca Genera chiave. Assegnagli il nome dello strumento e della macchina, ad esempio laptop claude-codee selezionarne gli ambiti.
- Copia la chiave ora. Puoi visualizzarla e copiarla di nuovo più tardi da Le mie chiavi. Le chiavi hanno questo aspetto
qsmcp_seguito da 43 caratteri. - Per il codice Claude, eseguire:
claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp --header "X-MCP-Key: qsmcp_INSERISCI_QUI_LA_CHIAVE" - Per Cursor, VS Code, Windsurf, Zed, JetBrains, Gemini CLI, Codex CLI, Continue e Cline, apri il MCP → Connetti scheda nel Portale. Mostra una configurazione pronta per essere incollata per ogni client con la tua chiave già inserita.
Per verificare, chiedi “Quali connettori Query Streams ho a disposizione?” Il cliente dovrebbe chiamare qs_list_connectors e la chiave ultimo utilizzo L'ora viene aggiornata nella scheda "Le mie chiavi" 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 | Visualizza i connettori e gli agenti, esplora lo schema, leggi le descrizioni di Schema Intelligence, visualizza le query salvate e le regole di avviso. | Sempre. Tutto il resto si basa su questo. |
| analizzare | Profila le tabelle (valori campione, distribuzioni, tipi semantici), scopri le relazioni implicite e metti in coda un'esecuzione di Schema Intelligence. | Consigliato. Questo permette a Claude di comprendere la struttura dei dati prima di scrivere le join. |
| eseguire | Esegui query SQL in sola lettura e query salvate e trasmetti in streaming le righe. | 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 una concessione o di una chiave ha effetto entro circa cinque minuti. Gli amministratori possono visualizzare tutte le concessioni e le chiavi attive per l'organizzazione nella pagina MCP.
Cosa può fare Claude una volta connesso
Claude ha a disposizione un piccolo set di strumenti. Non li elenchi mai tu; Claude sceglie quello giusto per la tua domanda. In parole semplici:
Comprendi 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.
Utilizza le query salvate
Elenca le query parametrizzate salvate dalla tua organizzazione ed eseguile con parametri diversi. Le query federate che coinvolgono più origini dati vengono eseguite lato server e restituiscono righe già unite.
Eseguire query SQL ad hoc
Scrivi ed esegui query SQL di sola lettura nel dialetto corretto per il connettore. I risultati predefiniti includono 1.000 righe e un timeout di 60 secondi, entrambi personalizzabili.
Controlla gli avvisi
Visualizza l'elenco delle regole di avviso, il loro stato attuale e le attivazioni recenti. Claude può proporre una nuova regola in modalità di prova; un utente può attivarla nella pagina Avvisi.
Migliorare il modello
Verifica la copertura di Schema Intelligence per ciascun database e, con il tuo consenso, metti in coda un'esecuzione dell'analisi per ottenere risultati migliori in futuro.
Perché l'intelligenza dello schema è 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 |
|---|---|---|
| Schema Intelligence | 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 Schema Intelligence una sola volta. Per i database di grandi dimensioni, limita l'analisi alle tabelle effettivamente utilizzate dalle tue query. Come funziona Schema Intelligence →
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 Schema Intelligence?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 approfondimento sullo stesso thread. 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 nello stesso budget di risorse dati condiviso da Excel, Fogli Google, Portale e Nova. Poiché MCP funziona tramite HTTP senza compressione end-to-end, viene misurato in byte non compressi, quindi un risultato di 1 MB costa circa 1 MB, mentre lo stesso risultato in Excel costa in genere da 150 a 250 KB.
limite_anteprimaadatto per domande esplorative. - Esecuzione di Schema 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 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. | 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 | La chiave è limitata a connettori specifici e questo non è uno di quelli. | Modifica l'elenco dei connettori consentiti della chiave in Le mie chiavi oppure utilizza una chiave diversa. |
MCP_DATABASE_NON_ACQUISITO | Il database non è presente nell'opzione di acquisizione dello schema del connettore, pertanto non sono disponibili informazioni sullo schema né relazioni memorizzate da leggere. Le query funzionano comunque. | Aggiungi il database alla selezione di acquisizione sul connettore nel portale, quindi, facoltativamente, esegui Schema Intelligence. |
MCP_RATE_LIMITED | Troppe chiamate al minuto per il tuo piano tariffario. | Aspetta un attimo. Le sessioni intensive traggono vantaggio da Schema Intelligence, che consente a Claude di rispondere con 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 importante per essere consegnato a Claude in una sola risposta. | Chiedi di ridurre il numero di colonne o righe. Di solito sarà Claude stesso a suggerirlo. |
| 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? Apri un ticket su my.querystreams.com/support oppure inviare un'e-mail [email protected].
Sicurezza e privacy
- Claude riceve i metadati dello schema, le descrizioni di Schema Intelligence, inclusi i valori di esempio, e i risultati delle query richieste. Tali risultati vengono trasmessi al provider di intelligenza artificiale scelto per la connessione, secondo i termini e le condizioni di tale provider.
- 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 Schema 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 programma che supporti MCP: ChatGPT, Cursor, Claude Code, Windsurf, Zed, VS Code Copilot, JetBrains AI, Gemini CLI, Codex CLI, Continue, Cline e molti altri. La pagina MCP del portale contiene una configurazione predefinita per ciascuno di essi.
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 Schema Intelligence. 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 in circa un minuto
Nessuna chiave, nessun file di configurazione, nessuna VPN. Sola lettura per impostazione predefinita.
Apri la pagina MCP Come funziona MCP
English 
Spanish 
German 
French 
Portuguese 
Japanese 
Korean 
Chinese 
Italian 
Dutch 
Indonesian 
Polish