Collega qualsiasi file di registro a Claude con MCP

MCP · Log personalizzati per Claude

Chiedere Claude riguardo al tuo file di log personalizzato, 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 log personalizzato, scrive la query SQL, la esegue in sola lettura tramite l'agente già presente nei 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

Un Claude in grado di rispondere a domande su qualsiasi registro di testo descritto, tramite query in tempo reale e di sola lettura sulle tabelle create dall'Agent a partire dai file, e di indicare da quale file proviene ciascuna risposta, senza mai dover accedere con le credenziali o specificare il percorso del file, e senza dover modificare il firewall: l'Agent, già presente nella rete, legge la cartella e restituisce solo le righe. Una volta installato l'Agent, la connessione con Claude richiede circa 90 secondi, se si ha familiarità con la schermata delle impostazioni. Ecco un esempio:

Claude · connesso a Query Streams Sola lettura

Quali errori ha registrato il processo di backup durante la notte?

qs_get_table_schema query_di_esecuzione_qs schema_intelligence

Questo connettore ha un formato con un Timestamp definito. Claude legge le colonne di set di file.eventi, quindi esegue una query per i messaggi ERROR e WARN tra mezzanotte e le 6 del mattino, ordinati per tempo_evento:

tempo_evento	nome_file	messaggio
2026-09-26 02:14:07	backup.log	ERRORE copia non riuscita: accesso negato su /mnt/nas01/archive
2026-09-26 02:15:09	backup.log	ATTENZIONE: riprovo tra 60 secondi (tentativo 2 di 3)
2026-09-26 02:17:11	backup.log	ERRORE, rinuncia dopo 3 tentativi

Il processo ha perso l'accesso alla condivisione dell'archivio alle 02:14 e si è interrotto tre minuti dopo. Chiedi a Claude quante notti di questo mese si sono concluse allo stesso modo. La risposta copre ciò che l'agente ha letto durante la sua ultima scansione.

Con quale frequenza si verifica l'errore durante il backup e il problema è sempre lo stesso?

query_di_esecuzione_qs query_di_esecuzione_qs

Ho preso la corsa ogni notte da set di file.eventi, ha abbinato le linee di inizio e fine e ha estratto il percorso fallimentare da qualsiasi riga di ERRORE:

Notte	Risultato	Percorso fallimentare	Durata
25 settembre	OK	-	1 ora e 42 minuti
26 settembre	CAMPO	/mnt/nas01/archive	0 ore 09 minuti
27 settembre	CAMPO	/mnt/nas01/archive	0 ore 08 minuti

Due notti di seguito, stesso percorso, e si interrompe dopo nove minuti con accesso negato Invece di esaurire lo spazio. Qualcosa ha modificato i permessi sulla condivisione di archivio NAS il 26. Finché non verrà risolto, non avrai alcun backup più recente del 25.

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. Include tutti gli strumenti di Claude, oltre a quelli non presenti: crea e convalida la query SQL rispetto al modello di Semantic Intelligence, trasforma la risposta in un grafico e salva il risultato come query eseguibile dal team tramite Excel, Fogli Google o API REST, senza bisogno di chiavi, connettori o installazioni. Utilizza MCP se il tuo team lavora già con Claude, Cursor o ChatGPT; utilizza Nova se desideri ottenere le risposte direttamente all'interno del Portale.

La cartella di log personalizzata è per qualsiasi log di testo che le schede integrate non conoscono. Descrivi il formato una volta, oppure lascia che Nova ne suggerisca uno, e ogni riga diventa una riga SQL che Claude può interrogare. Questa è l'analisi dei log AI sui tuoi file, senza bisogno di caricare nulla. L'agente segue ogni file man mano che cresce, riconosce i file ruotati in modo che nulla venga letto due volte, legge ogni .gz Archivia una sola volta e, alla prima lettura, riempie lo spazio con i dati degli ultimi 30 giorni.

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 Cartella di registro personalizzata 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.

   • Aggiungi la cartella dei log sotto Cartelle radice e impostare Includi modelli per abbinare i tuoi file.
   • Scegli un CodificaÈ obbligatorio e non ha un valore predefinito.
   • Descrivi il formato: Limite di record, Grammatica (delimitato, chiave=valore, grok, righe JSON, intestazione #Campi o larghezza fissa), Timestamp, Colonne tipizzate e Colonna IdentitàOppure fai clic Lascia che Nova ti suggerisca un formato, che prevede un limite giornaliero.
   • SU ControlloL'agente legge un campione e mostra il numero di file, le dimensioni, una stima del numero di righe e le tabelle che creerà. Non viene ancora creato nulla. Verifica la connessione offre anche il tipo di registro integrato più vicino quando è compatibile.

2. Guarda quali tavoli ti vengono assegnati

   Le righe analizzate atterrano in set di file.eventi, o nel Nome della tabella hai scelto. L'agente mantiene le righe in una cache locale sul computer dell'agente e le serve come SQL. Ogni riga indica da quale file proviene in _source_file. Finché non definisci un formato, ogni riga è una messaggio etichettato con nome_file.

   Tavolo	Cosa contiene
   eventi	Una riga per record: tempo_evento, le colonne definite dal formato e messaggio. Senza ancora un formato, tempo_evento è l'ora di modifica del file.
   eventi_grezzi	Le righe il cui formato non corrispondeva sono state mantenute linea con un motivo ad esempio nessuna corrispondenza grammaticaleNon viene lasciato cadere nulla.
   file	Ogni file di registro nella cartella in questo momento, con percorso relativo, dimensione_byte e UTC modificato.
   file_eventi	La cronologia di ciascun file: apparso, modificato, ruotato, troncato e deriva righe, cronometrate da evento_al.
   cursori_di_log	La posizione di lettura e lo stato di ciascun file. Un file messo da parte mostra lo stato parcheggiato con il motivo in ultimo_errore.

   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 è nel Elenco dei connettori antropici: sfoglia i connettori, fai clic Collegare. Altrove incolli un indirizzo nell'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

   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? 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 è elencato nel Elenco dei connettori antropici: Trovare Flussi di query e clicca Collegare(Oppure apri direttamente l'elenco della directory e fai clic Collegare Là.)
   2. Se la tua organizzazione nasconde i connettori di directory, fai clic Aggiungi connettore personalizzato invece. Dagli un nome Flussi di query, impasto https://mcp.querystreams.com/mcp, lascia vuoti i campi OAuth, fai clic Aggiungi, quindi in qualsiasi chat fai clic + → 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.

   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, 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 esempi che funzionano bene con qualsiasi registro di testo tu descriva:

   "Quali file di registro stai leggendo e quando è stata effettuata l'ultima modifica in ciascuno di essi?"

   Claude chiede fileset.files per percorso relativo, dimensione_byte e UTC modificato, dal più recente al più vecchio.

   "Mostrami tutti gli ERRORI dell'ultima ora."

   Filtri Claude set di file.eventi SU messaggio e l'ultima ora di tempo_evento, dal più recente al più vecchio.

   "Quali righe il mio formato non è riuscito ad analizzare e perché?"

   Claude legge fileset.events_raw_lines, gruppi per motivo e mostra degli esempi, in modo che tu possa adattare il formato.

   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 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 Le mie chiavi 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 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 spazio Data Realm, lo stesso utilizzato dalle query di Excel e Fogli Google, e il costo MCP viene calcolato prima della compressione, quindi un risultato ampio costa di più rispetto alle stesse righe in un foglio di calcolo. Le esecuzioni di Semantic 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

• Regola il formato chiedendo a Claude quali linee sono atterrate in eventi_grezzi, quindi modifica il connettore. Salvando una modifica, l'agente esegue un nuovo campionamento.
• Attiva la cartella "Watch" per visualizzare le modifiche (quasi in tempo reale). per rilevare nuove righe in pochi secondi su un disco locale. La scansione programmata rimane garantita.
• Richiedi un tipo integrato Se il formato è comune, il portale dice: "Hai bisogno di un tipo di log non presente nell'elenco? Apri una richiesta di supporto e lo aggiungeremo entro pochi giorni."

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
• Connettere Query Streams a Claude tramite MCP: configurazione, autorizzazioni e risoluzione dei problemi
• Tutte le guide MCP