Collegare una cartella di file CSV a Claude tramite MCP.

Cartella CSVPiano gratuitoFlussi di queryClaude

Cartella CSV → Claude · con Query Streams

Con Query Streams, chiedi a Claude informazioni sul tuo file nella Cartella CSV in linguaggio naturale: l’Agent già presente nella tua rete esegue le query SQL in sola lettura e nessuna password del database arriva mai all’IA. Bastano circa dieci minuti e il piano Free è sufficiente.

Inizia gratis

Quello che otterrai alla fine

Un Claude in grado di rispondere a domande su una cartella di file CSV con query in tempo reale e di sola lettura sulle tabelle che l'Agent crea dai tuoi file, e di indicarti da quale file proviene ogni risposta, senza mai dover accedere o visualizzare il percorso del file e senza modificare il firewall: l'Agent già presente nella tua rete legge la cartella e restituisce solo le righe. Una volta installato l'Agent, la connessione di Claude richiede circa 90 secondi se hai familiarità con la schermata delle impostazioni. Come questa:

Claude · connesso a Query Streams Sola lettura

Quali file alimentano fileset.sales e quante righe aggiunge ciascuno di essi?

qs_get_table_schema query_di_esecuzione_qs schema_intelligence

Tre file CSV alimentano fileset.salesL'esportazione di settembre è la più consistente, con poco più di 18.000 file.

_source_file	conteggio_righe	first_row_id
exports/sales_2026_09.csv	18422	exports/sales_2026_09.csv:0000000
exports/sales_2026_08.csv	17305	exports/sales_2026_08.csv:0000000
exports/sales_2026_07.csv	16988	exports/sales_2026_07.csv:0000000

Vuoi che ti calcoli il totale delle vendite mensili per tutti e tre i file?

Quali regioni hanno registrato la maggiore crescita questo mese rispetto al mese scorso e quali hanno subito un calo?

query_di_esecuzione_qs query_di_esecuzione_qs

Ogni CSV è già una tabella, quindi ho sommato quantità di regione per ogni mese direttamente da fileset.salesDue query di sola lettura:

regione	Questo mese	Il mese scorso	Modifica
Ovest	412,300	348,900	+18%
Centrale	388,120	391,000	-1%
Est	201,450	262,800	-23%

Ovest è in aumento per quanto riguarda gli ordini, non per quelli più grandi. Est È calato del 23%, e si tratta di un solo cliente: Harbour Foods ha effettuato ordini ogni settimana il mese scorso e non ne ha effettuato nemmeno uno questo mese. La regione centrale è rimasta invariata. Volete sapere gli ordini della regione orientale suddivisi per cliente?

SELEZIONA soltanto, controllato dall'agente accesso effettuato nella scheda Attività MCP 6 righe restituite da 3 query

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.

IL Cartella CSV Card unisce tutti i file CSV presenti in una cartella in un'unica tabella SQL che Claude può interrogare, e associa a ogni riga il nome del file di provenienza. Non è necessario caricare file nella chat. Basta indicare all'agente la cartella una sola volta, l'agente copia le righe in una cache locale sul proprio computer e mantiene la tabella aggiornata man mano che i file vengono aggiunti o modificati.

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.

L'agente su un computer che può aprire la cartella

Versione 2.6.0 o successiva. La cartella può trovarsi su quel computer o su una condivisione file accessibile. L'agente viene eseguito come servizio, quindi digita le condivisioni come \\server\condiviso\cartella, non come lettera di unità mappata. Su Windows è possibile accedere a una condivisione con un login memorizzato; su Linux o Mac, montare prima la condivisione (Linux sotto /mnt o /media, un Mac sotto /VolumiSei nuovo dell'agente? Installalo su Windows, macOS o Linux.

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

Claude sul web, Claude Desktop o le app mobili di Claude si connettono senza bisogno di password. Funzionano anche Claude Code, Cursor, ChatGPT e una decina di altri strumenti; il Portale offre una configurazione predefinita per ognuno di essi.

Configuralo in quattro passaggi

1. Indica all'agente la cartella

   Nel portale aperto Dati → Agenti dati, trova l'agente che può aprire la cartella e fai clic sul suo Aggiungi connettore pulsante. Sotto il File e cartelle la pillola clicca sul Cartella CSV carta. Il mago ti guida quindi attraverso Cartelle, Controllo, Impostazioni, Regno e Revisione:

   Cartelle

   Digita il Cartelle radice, uno per riga, come percorsi sul computer dell'agente. Scansiona le sottocartelle è acceso, Profondità massima è 8. Includi modelli inizia con il glob corretto per questo tipo di file; aggiungi Escludi modelli se la cartella contiene file che non desideri. Una lettera di unità mappata mostra un avviso arancione: l'agente non può vederlo, quindi usa il \\server\share percorso invece.

   Controllo

   L'agente legge un campione di massimo 64 file e mostra cosa creerà. Per ora non viene creato nulla. Pronto a creare significa che ogni file campionato è compatibile. Un banner arancione, "{n} di {m} file(s) saranno messi da parte", elenca i file che non sono compatibili con Mostra quali file e perché; puoi comunque creare il connettore e correggerli in seguito. Se la cartella mescola layout, viene visualizzato un pannello blu Passa a una tabella per layout.

   Impostazioni

   Intervallo di scansione (ogni ora per impostazione predefinita, da ogni 5 minuti a giornalmente) è la frequenza con cui l'agente cerca file nuovi, modificati o scomparsi. Controlla la cartella per eventuali modifiche reagisce in pochi secondi sui dischi locali. Quando un file scompare È Abbassa le sue righe per impostazione predefinita.

   Regno, Recensione

   Seleziona l'area dati rispetto alla quale vengono conteggiate le righe, controlla il riepilogo e fai clic Crea connettore. La prima scansione inizia subito; il connettore Manifesto La scheda mostra cosa è stato compilato e i file che sono stati messi da parte.

   • Digita un Nome della tabella, Per esempio venditeÈ richiesto su questa carta.
   • Includi modelli inizia come **/*.csv.
   • Scegli un Disposizione della tabella. Un layout fisso (predefinito) Adatto per esportazioni ricorrenti che condividono tutte un'unica intestazione. Un tavolo per ogni disposizione Cartelle per abiti che le persone assemblano a mano, fino a 25 modelli.
   • SU Controllo, l'agente legge un campione e mostra il numero di file, una stima delle righe e le tabelle che creerà. Se la cartella contiene layout misti, un pannello blu lo indica. Fare clic Passa a una tabella per layout.
   • Un banner arancione elenca i file che verranno messi da parte. Apri Mostra quali file e perché per vedere il motivo di ciascuno.

2. Guarda quali tavoli ti vengono assegnati

   Tutto sta nel set di file schema. La tabella dati prende il nome che digiti in Nome della tabellaLe sue colonne provengono dall'intestazione CSV, più _source_file e _row_id su ogni riga.

   Tavolo	Cosa contiene
   fileset.sales	Con Un layout fissato, una tabella denominata dal tuo Nome della tabella, contenente le righe di ogni file CSV corrispondente.
   fileset.orders, fileset.returns	Con Un tavolo per ogni disposizioneuna tabella per layout, denominata in base alla parte condivisa dei nomi dei file. ordini_2026_01.csv a ordini_2026_03.csv diventare ordini.
   fileset.files	Una riga per ogni file CSV attualmente presente, con il relativo percorso, dimensione e data di ultima modifica.
   set di file, file ed eventi	La cronologia delle modifiche, incluso un deriva riga per ogni file che è stato messo da parte, con il motivo in dettaglio.

   Ogni connettore di cartella fornisce inoltre a Claude le stesse tabelle contabili, tutte nel set di file schema:

   Tavolo	Cosa contiene
   file	Ogni file attualmente presente nella cartella: percorso, nome, estensione, dimensione, data di creazione e di modifica. Chiedi "cosa c'è in questa cartella?" e Claude leggerà queste informazioni.
   file_eventi	Cronologia delle modifiche: una riga per ogni file che è apparso, è stato modificato, è scomparso o è stato messo da parte (deriva), con il tempo in evento_al e il motivo in dettaglio.
   elenchi, volumi	Dimensioni e numero delle cartelle, e dischi o condivisioni su cui risiedono le directory principali.
   _source_file, _row_id	Due colonne su ogni riga di dati: il file da cui proviene la riga e un ID di riga stabile all'interno di quel file. Raggruppa per _source_file per confrontare i file.

3. Mettiti in contatto con Claude

   Apri Streaming → In diretta → MCPCi 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 profili delle tabelle, individua relazioni e accoda un’esecuzione di Semantic Intelligence. La profilazione e l’individuazione sono gratuite; un’esecuzione di Semantic Intelligence consuma crediti Nova AI e la quota dati, quindi nella schermata di consenso non è mai preselezionata.

   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.

   Quindi 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 che potete verificare aprendo la cartella, in modo da vedere Claude che cerca la tabella giusta. Tre soluzioni che funzionano bene con una cartella di file CSV:

   “Quali file CSV sono presenti nella cartella e quando è stata modificata l'ultima volta ciascuno di essi?”

   Claude chiede fileset.files (Esegui query) e elenca ogni file con dimensione_byte e UTC modificato, dal più recente al più vecchio.

   "Sommare il totale della colonna importo nel fileset.sales per mese."

   Claude legge prima lo schema della tabella per trovare i nomi reali delle colonne (Read), quindi esegue un DuckDB GRUPPO PER Tramite il tuo agente (Esegui query). Otterrai una piccola tabella con i totali mensili.

   "Sono stati messi da parte dei file CSV e, in caso affermativo, perché?"

   Claude chiede set di file, file ed eventi per deriva e rifiutato righe, ordinate per evento_al (Esegui query). Ottieni ogni file e il motivo in dettaglio.

   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.

Accesso a un file su una condivisione di rete

L'agente apre i file come servizio in background, non come utente diretto, quindi per aprire un file su un altro computer è necessario un passaggio aggiuntivo. Il tipo di passaggio dipende dal computer su cui è in esecuzione l'agente.

Se il test non riesce ad accedere alla condivisione, cerca queste parole nel risultato: irraggiungibile significa che il computer dell'agente non ha ricevuto risposta dal server. Su Linux o Mac, non montato significa che la condivisione deve ancora essere montata e il messaggio include il comando di montaggio esatto per il tuo server.

Come vengono visualizzati i file nuovi, modificati ed eliminati

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 nella cartella in cui si trova il file CSV, in modo che il client AI possa 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

• Esegui l'Intelligenza Semantica sul connettore in modo che Claude veda le descrizioni delle tue colonne CSV, non solo le tabelle del file.
• Aggiungi un secondo connettore nella stessa cartella se contiene anche file Parquet o Excel. Un connettore legge un solo tipo di file.
• Leggi la guida sulla cartella CSV A Unire più file CSV in un'unica tabella per ogni contesto.

Quando qualcosa non funziona

Domande che le persone si pongono

Guide correlate

• Collegare una cartella di file Excel a Claude tramite MCP
• Collega una cartella di database SQLite a Claude tramite MCP.
• Collegare una cartella di file Parquet a Claude tramite MCP
• Collega una cartella di file JSONL a Claude tramite MCP.
• Guida al connettore per cartelle CSV
• Connettere Query Streams a Claude tramite MCP: configurazione, autorizzazioni e risoluzione dei problemi
• Tutte le guide MCP