Collega il tuo file system a Claude con MCP

MCP · File system per Claude

Chiedere Claude riguardo al tuo file di file system, in un linguaggio semplice

Collega Claude, Claude Code, Cursor o qualsiasi client MCP a Query Streams una sola volta. Claude legge la struttura del tuo file di file system, scrive la query SQL, la esegue in sola lettura tramite l'agente già presente con i tuoi dati e restituisce le righe. Nessuna password del database raggiunge mai l'IA. Il processo richiede circa dieci minuti ed è incluso nel piano gratuito.

Circa 10 minuti Claude, ChatGPT, Cursor + altri 11 clienti Il file rimane dov'è Sempre in sola lettura

Quello che otterrai alla fine

A Claude that can answer questions about the files and folders on your computer or file share with live, read-only queries over the tables the Agent builds from your files, and tell you which file each answer came from — without ever seeing a login or a file path, and without a firewall change: the Agent already inside your network reads the folder and sends back only the rows. Once the Agent is in place, connecting Claude takes about 90 seconds if you are comfortable with a settings screen. Like this:

Claude · connesso a Query Streams Sola lettura

Quali file nel fileset.files sono stati modificati più di recente e qual è la loro dimensione?

qs_get_table_schema query_di_esecuzione_qs schema_intelligence

Ecco i tre file modificati più di recente nelle tue cartelle. Il foglio di lavoro di chiusura del trimestre è stato modificato nel tardo pomeriggio di ieri.

percorso relativo	dimensione_byte	UTC modificato
Finanza/2026/Chiusura terzo trimestre.xlsx	482113	2026-09-25 17:42:10
Contracts/Acme-renewal-2026.pdf	1893402	2026-09-25 14:05:37
Reports/weekly/ops-summary-w39.docx	96120	2026-09-25 09:18:54

Vuoi che ti mostri quali cartelle sono cresciute di più questo mese da istantanee della directory?

Which folders grew the most this month, and is anything unusually large?

query_di_esecuzione_qs query_di_esecuzione_qs

I read fileset.directory for size by folder, then fileset.files for the newest file in each. Both queries were read-only:

sentiero	file	size	newest file
Exports/daily	27	10.8 GB	2026-09-27 03:10
Finance/2026	412	2.1 GB	2026-09-27 17:42
Photos/site-visits	1,930	6.4 GB	2026-09-19 08:55

Exports/daily is the one to look at: 27 copies of the same 400 MB dump, one per night, and nothing deletes the old ones. Finance grows the way you would expect. Want the ten largest files under Exports with their dates?

SELEZIONA soltanto, controllato dall'agente accesso effettuato nella scheda Attività MCP 6 rows returned across 3 queries

Rather not wire up an AI client at all? On the Business plan, Nova is the assistant built into Query Streams itself. It has every tool Claude gets here, plus the ones Claude does not: it drafts and validates the SQL against your Schema Intelligence model, turns the answer into a chart, and saves the result as a query your team can run from Excel, Google Sheets or the REST API — no key, no connector, nothing to install. Use MCP when your people already live in Claude, Cursor or ChatGPT; use Nova when you want the answers inside the Portal.

IL Sistema di file Card trasforma le cartelle del tuo computer o della condivisione di file in tabelle SQL che descrivono i tuoi file: ogni nome, percorso, dimensione e data, oltre a una cronologia delle modifiche e alle dimensioni delle cartelle. Indicizza solo i metadati dei file e non legge il contenuto dei file, quindi non è un lettore di file come il server del filesystem di riferimento di Anthropic, e Claude non può aprire, modificare o eliminare file tramite esso. Devi indicare all'Agent le cartelle anziché un server di database, e questo creerà e aggiornerà le tabelle autonomamente.

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. Nuovo utente di Agent? 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 Sistema di file 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.

   • Non c'è Nome della tabella campo. Il file system crea solo le tabelle di inventario.
   • Inserisci una cartella per riga Cartelle radiceI percorsi si trovano sul computer dell'agente. Digitare una condivisione di rete come \\server\condiviso\cartella, non come lettera di unità mappata come Z:, perché l'agente viene eseguito come servizio e non può vedere le unità mappate al momento dell'accesso.
   • Includi modelli inizia come **/*.csvAggiungi modelli per ogni tipo di file che desideri elencare e utilizza Escludi modelli per qualsiasi cosa tu voglia escludere.
   • SU ControlloL'agente legge un campione e mostra quante cartelle sono raggiungibili, quanti file corrispondono e la loro dimensione totale. Non viene ancora creato nulla.

2. Guarda quali tavoli ti vengono assegnati

   Il file system non ha una tabella dati. Tutto si trova in un unico schema chiamato set di fileche l'Agente memorizza nella cache del suo computer e aggiorna a ogni scansione. Claude visualizza descrizioni integrate per ciascuna di queste tabelle senza bisogno di eseguire Schema Intelligence.

   Tavolo	Cosa contiene
   fileset.files	Attualmente è presente una riga per ogni file: percorso relativo, nome, estensione, dimensione_byte, creato_utc, UTC modificato e proprietario (Solo per Windows).
   set di file, file ed eventi	La cronologia delle modifiche. Ogni riga ha un tipo_evento come appariva, modificava o scompariva, il tempo in evento_ale la dimensione precedente.
   fileset.directory	Una riga per cartella con il conteggio dei file, subtree_bytes, il file più vecchio e quello più recente, e un salta_motivo quando una cartella non è stata letta.
   fileset_directory_snapshots	È consentita al massimo una sola istantanea delle dimensioni per cartella al giorno, in modo da poter visualizzare quali cartelle stanno crescendo.
   fileset.volumes	Capacità e spazio libero di ogni unità, con capacità_byte e byte_liberi.

   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, Query Streams is in the Anthropic Connectors Directory: browse connectors, click Collegare. Elsewhere you paste one address into the app, https://mcp.querystreams.com/mcpe connettersi da una chat. Si apre una pagina Query Streams, si seleziona l'organizzazione e le autorizzazioni e si fa clic Approva la connessione. Niente da copiare, niente da tenere segreto. La connessione appare sotto App connesse e può essere revocato lì.

   strumenti per sviluppatori · una chiave

   Claude Code, Cursor, VS Code e amici

   SU Le mie chiavi clic Genera chiave. Dagli un Nome chiave come “Claude Code sul mio laptop”, mantieni Leggere e Eseguire spuntato, scegli un Scadenza (Mai, 30 giorni, 90 giorni o 1 anno) e fai clic Genera chiaveCopialo, quindi Continua l'installazione: IL Collegare La scheda mostra il frammento esatto del tuo strumento con la chiave già inserita.

   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

   Esegui query SQL di sola lettura e query salvate tramite il tuo agente e restituisci le righe. Senza di esso, Claude può descrivere i tuoi dati, ma non può fornire risposte in base ad essi.

   Analizzare

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

   Hai perso le chiavi? Apri Le mie chiavi: l'icona dell'occhio 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 Impostazioni → Connettori e clicca Sfoglia i connettori. Query Streams is listed in the Anthropic Connectors Directory: find Flussi di query e clicca Collegare. (Or open the directory listing directly and click Collegare there.)
   2. If your organization hides directory connectors, click Aggiungi connettore personalizzato instead. Name it Flussi di query, impasto https://mcp.querystreams.com/mcp, leave the OAuth fields empty, click Aggiungi, then in any chat click + → Sfoglia i connettori → Flussi di query → Collegare.
   3. Si apre una scheda Query Streams. Accedi se richiesto, scegli l'organizzazione, rivedi Leggere e Eseguire, 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.

   If you do add it by hand in Claude Desktop, use Impostazioni → Connettori → Aggiungi, non la chat in corso Aggiungi marketplace option, which expects a git repository. Connectors sync to your Claude account, so the mobile apps and Desktop pick it up automatically. Menu names are Anthropic’s and can move.

   Codice Claude chiave

   Un solo comando, con il tuo tasto da Le mie chiavi:

   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 Collegare scheda 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

   Inizia con qualcosa che puoi verificare aprendo la cartella, così vedrai Claude allungare la mano verso il tavolo giusto. Tre soluzioni che funzionano bene con i file e le cartelle del tuo computer o della condivisione file:

   “Che tipo di file sono presenti in questa cartella e quanto spazio occupa ciascun tipo di file?”

   Claude legge il fileset.files schema (lettura), quindi esegue una query che raggruppa per estensione e somme dimensione_byte (Esegui). Ottieni un conteggio e la dimensione totale per ogni tipo di file.

   “Quali sono le cartelle più grandi e quali sono state saltate?”

   Claude chiede fileset.directory (Esegui), ordina per subtree_bytes e elenca qualsiasi cartella con un salta_motivo, come ad esempio un passato Profondità massima.

   “Cosa è stato eliminato dalla condivisione negli ultimi sette giorni?”

   Claude chiede set di file, file ed eventi per righe scomparse, filtrate e ordinate per evento_al (Esegui). Ottieni ogni file mancante e quando la scansione lo ha rilevato.

   Per confermare il cablaggio, chiedere “Quali connettori Query Streams ho a disposizione?”Claude chiama qs_list_connectorse su Le mie chiavi la chiave Ultimo utilizzo L'ora si aggiorna in pochi secondi.

Come vengono visualizzati i file nuovi, modificati ed eliminati

Cosa può fare Claude una volta connesso

Claude vede diciannove piccoli strumenti. Non devi mai nominarli tu; Claude sceglie quello giusto per la tua domanda. In parole semplici:

Perché l'intelligenza dello schema è 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 Schema Intelligence su di esso una volta da Nova → Intelligenza. IL Le mie chiavi La scheda mostra un pannello di copertura per ciascun connettore. Come funziona Schema Intelligence.

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 utilizzare e il numero di chiamate al minuto che Claude può effettuare:

Un'app connessa conta come una chiave. Oltre al limite al minuto, ogni chiave può eseguire al massimo 10 query al minuto. Una query restituisce fino a 1.000 righe e viene eseguita per un massimo di 60 secondi, a meno che Claude non richieda di più, fino a un massimo di 50.000 righe e cinque minuti. Le righe ricevute da Claude vengono conteggiate nel tuo Data Realm, lo stesso pool utilizzato dalle query di Excel e Fogli Google, e MCP viene misurato prima della compressione, quindi un risultato ampio costa di più qui rispetto alle stesse righe in un foglio di calcolo. Le esecuzioni di Schema Intelligence avviate da Claude consumano crediti Nova AI, esattamente come avviene dal Portale. Consulta la pagina dei prezzi per le indennità.

Tenerlo al sicuro

Buone mosse successive

• Attiva la cartella "Controlla" per visualizzare le modifiche. se desideri che i nuovi file vengano visualizzati in pochi secondi su un disco locale.
• Chiedi quanto sono aggiornati i dati. Claude risponde dal più recente ultimo_visualizzato_utc In file_correnti e il più recente evento_al In file_eventi.
• Leggi la guida completa al file system A Indicizzare un file system ed eseguire query su di esso con SQL per ogni contesto.

Quando qualcosa non funziona

Domande che le persone si pongono

Guide correlate

• Collegare una cartella di file CSV a Claude tramite MCP.
• 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
• Guida al connettore del file system
• Connettere Query Streams a Claude tramite MCP: configurazione, autorizzazioni e risoluzione dei problemi
• Tutte le guide MCP