Kategorien anzeigen

Verbinden Sie einen Ordner mit JSONL-Dateien mit Claude mithilfe von MCP.

JSONL-OrdnerKostenloser PlanAbfrageströmeClaude

JSONL-Ordner → Claude · mit Query Streams

Mit Query Streams kannst du Claude auf Deutsch zu deiner JSONL-Ordnerdatei befragen: Der Agent, der sich bereits in deinem Netzwerk befindet, führt die SQL-Abfrage schreibgeschützt aus, und kein Datenbankpasswort gelangt jemals zur KI. Das dauert etwa zehn Minuten, und der Free-Tarif reicht dafür aus.

Kostenlos starten
Isometrische Bibliothek mit Datenbankregalen, in der ein Agent eine Karte auf einem Rollwagen zu einem Chat-Bedienfeld an einer Theke bringt
Sie kommen an irgendeiner Stelle nicht weiter? Fragen Sie uns einfach. Öffnen Unterstützung Gehen Sie zu „Abfrageströme“ (Menü oben rechts → Support) und senden Sie uns eine Nachricht. Echte Menschen lesen sie, und „Ich verstehe nicht, was dieser Bildschirm von mir verlangt“ ist eine völlig berechtigte Frage.

Was am Ende dabei herauskommt

JSONL-OrdnersymbolEin Agent namens Claude kann Fragen zu einem Ordner mit JSON-Dateien beantworten. Er führt dazu Live-Abfragen (nur lesend) über die Tabellen durch, die er aus Ihren Dateien erstellt, und gibt an, aus welcher Datei die jeweilige Antwort stammt – ohne jemals einen Login oder Dateipfad zu sehen und ohne Firewall-Änderungen: Der Agent, der sich bereits in Ihrem Netzwerk befindet, liest den Ordner und sendet nur die Zeilen zurück. Sobald der Agent eingerichtet ist, dauert die Verbindung zu Claude etwa 90 Sekunden, wenn Sie mit der Bedienung eines Einstellungsbildschirms vertraut sind. So geht's:

Nova, der Query Streams-Assistent

Lieber gar keinen KI-Client einrichten? Zum Geschäftsplan Nova Der in Query Streams integrierte Assistent nutzt dieselben Agenten-Tools wie Ihr KI-Client und bietet darüber hinaus Funktionen, die externe Clients nicht haben: Er erstellt und validiert die SQL-Abfrage anhand Ihres Semantic-Intelligence-Modells, wandelt das Ergebnis in ein Diagramm um und speichert es als Abfrage, die Ihr Team aus Excel, Google Sheets oder der REST-API ausführen kann – ganz ohne Schlüssel, Konnektor oder Installation. Nutzen Sie MCP, wenn Ihre Mitarbeiter bereits mit Claude, Cursor oder ChatGPT arbeiten; verwenden Sie Nova, wenn Sie die Ergebnisse direkt im Portal benötigen.

Der JSONL-Ordner-Connector ermöglicht das Anzeigen und Abfragen von JSONL-Dateien in Claude, ohne dass ein JSONL-Viewer geöffnet werden muss. Geben Sie einfach einen Ordner mit JSON-Zeilendateien an. Jede Zeile wird dann als separate Zeile dargestellt, verschachtelte Objekte werden in Spalten zusammengefasst. Es ist kein Datenbankserver erforderlich. Der Agent liest den Ordner auf seinem eigenen Computer und speichert die Zeilen dort als SQL-Tabelle zwischen, die Claude über MCP abfragt.

WO DIE DATEIEN GELEGT WERDENeinen Computer oder eine Dateifreigabe, die der Agent öffnen kannIhr Ordnervon DateienDie Dateien bleiben dort, wo sie sind.Abfrage-Streams-Agentdurchsucht den Ordner und erstellt Tabellen.Im lokalen Cache wird die SQL-Abfrage ausgeführt.Nur SELECT-Anweisungen, hier erzwungenAbfrageströmeMCP-ServerPrüft Schlüssel, Berechtigungen und Ratenbegrenzung · Protokolliert jeden AufrufWO SIE FRAGENclaude.ai, Claude Desktop, Claude Code, Cursor, ChatGPTIhr KI-Cliententhält einen Schlüssel oder eine Verbindung, niemals Ihre Dateien
Claude öffnet Ihre Dateien niemals. Der Agent liest den Ordner auf seinem eigenen Computer, speichert die Zeilen in einem lokalen Cache und führt die von Claude dort geschriebenen SQL-Anweisungen aus. Nur die für eine Abfrage benötigten Zeilen werden über die Abfrageströme zurückgesendet.

Was Sie benötigen

Ein Query Streams-Konto

MCP ist in allen Tarifen enthalten, auch in der kostenlosen Version. Die kostenlose Version erlaubt einen Schlüssel oder eine verbundene App – mehr benötigt dieser Leitfaden nicht. Melden Sie sich an unter mein.querystreams.de.

Der Agent auf einem Computer, der den Ordner öffnen kann

Version 2.6.0 oder höher. Der Ordner kann sich auf diesem Computer oder auf einer erreichbaren Dateifreigabe befinden. Der Agent läuft als Dienst, daher geben Sie Freigaben als … ein. \\server\share\folderNicht als zugeordneter Laufwerksbuchstabe. Unter Windows kann man sich mit einem gespeicherten Login bei einer Freigabe anmelden; unter Linux oder Mac muss die Freigabe zuerst eingebunden werden (Linux unter /mnt oder /Medien, ein Mac unter /VolumesNeu beim Agenten? Installieren Sie es unter Windows, macOS oder Linux.

MCP ist für Sie aktiviert

Ersteller, Eigentümer und Administratoren haben von Anfang an Zugriff darauf. Alle anderen benötigen einen Administrator, der die Einstellungen ändert. MCP Schalter neben ihrem Namen unter Konto → ZugriffskontrolleBis dahin heißt es auf der MCP-Seite: „MCP ist für Ihr Konto deaktiviert.“

Ein KI-Client

Claude im Web, Claude Desktop oder die Claude-Mobil-Apps verbinden sich ohne Schlüssel. Claude Code, Cursor, ChatGPT und etwa zehn weitere Tools funktionieren ebenfalls; das Portal bietet für jedes Tool eine vorkonfigurierte Konfiguration.

Wo findet die Arbeit statt? Auf dem Computer, auf dem der Agent läuft, wird der Ordner gescannt, die Zeilen werden dort in einen lokalen Cache kopiert und die von Claude geschriebenen SQL-Abfragen werden auf diesen Cache angewendet. Die Dateien selbst verlassen diesen Computer nie, und auch nichts, was Claude nicht angefordert hat.

Richten Sie es in vier Schritten ein

  1. Richten Sie den Agenten auf den Ordner aus.

    Im Portal geöffnet Daten → DatenagentenSuchen Sie den Agenten, der den Ordner öffnen kann, und klicken Sie darauf. Anschluss hinzufügen Schaltfläche. Unterhalb der Dateien und Ordner Klicken Sie auf die Pille. JSONL-Ordner Karte. Der Zauberer führt Sie dann durch Ordner, Überprüfen, Einstellungen, Reich und Rezension:

    Ordner
    Geben Sie die Stammverzeichnisse, einer pro Zeile, als Pfade auf dem Computer des Agenten. Unterordner scannen ist eingeschaltet, Maximale Tiefe ist 8. Muster einbeziehen beginnt mit dem richtigen Glob für diesen Dateityp; hinzufügen Ausschlussmuster Wenn der Ordner Dateien enthält, die Sie nicht benötigen. Ein zugeordneter Laufwerksbuchstabe wird mit einer gelben Warnung angezeigt: Der Agent kann ihn nicht erkennen, verwenden Sie daher den \\server\share stattdessen den Pfad.
    Überprüfen
    Der Agent liest eine Stichprobe von bis zu 64 Dateien und zeigt an, was er erstellen wird. Es wird noch nichts erstellt. Bereit zum Erstellen Das bedeutet, dass jede Stichprobendatei passt. Ein gelbes Banner mit der Aufschrift „{n} von {m} Dateien werden beiseitegelegt“ listet die Dateien auf, die nicht passen. Zeigen Sie, welche Dateien und warumSie können den Konnektor trotzdem erstellen und ihn später korrigieren. Wenn der Ordner verschiedene Layouts enthält, wird ein blaues Bedienfeld angezeigt. Wechseln Sie zu einer Tabelle pro Layout.
    Einstellungen
    Scanintervall (Standardmäßig stündlich, von alle 5 Minuten bis täglich) ist die Häufigkeit, mit der der Agent nach neuen, geänderten und verschwundenen Dateien sucht. Ordner auf Änderungen überwachen Reagiert innerhalb von Sekunden auf lokalen Festplatten. Wenn eine Datei verschwindet Ist Entferne die Zeilen standardmäßig.
    Realm, Rezension
    Wählen Sie den Datenbereich aus, für den die Zeilen gezählt werden, überprüfen Sie die Zusammenfassung und klicken Sie auf Konnektor erstellenDer erste Scan startet sofort; der Anschluss Manifest Der Tab zeigt an, was erstellt wurde und welche Dateien beiseitegelegt wurden.
    • Typ a Tabellenname, Zum Beispiel VeranstaltungenEs ist auf dieser Karte erforderlich.
    • Abflachungstiefe Legt fest, wie viele Ebenen verschachtelter Objekte zu Spalten werden. Der Standardwert ist 2, der Bereich liegt zwischen 1 und 8.
    • Verlassen Tabellenlayout An Ein fixiertes Layout (Standard) für wiederkehrende Exporte. Wählen Sie Ein Tisch pro Layout für Ordner, die von Hand ausgefüllt werden.
    • An ÜberprüfenDer Agent liest eine Stichprobe von bis zu 64 Dateien und zeigt die Dateianzahl, die Größe, die geschätzte Zeilenanzahl und die zu erstellende Tabelle an. Es wird noch nichts erstellt. Wenn die Dateien unterschiedliche Formate aufweisen, zeigt ein Fenster an, dass der Ordner mehrere verschiedene Dateilayouts enthält. Klicken Sie Wechseln Sie zu einer Tabelle pro Layout um jeder Form eine eigene Tabelle zu geben.
  2. Schau dir an, welche Tabellen du erhältst

    Sie erhalten eine Tabelle mit dem Namen „ Tabellenname Sie tippen beispielsweise fileset.eventsVerschachtelte Objekte werden zu Spalten bis hinunter zur Abflachungstiefeund alles, was tiefer geht, wird als JSON-Text gespeichert. Jede Zeile enthält _QuelldateiSo wissen Sie immer, aus welcher Datei es stammt.

    TischWas es enthält
    Veranstaltungen (Ihr Tischname)Eine Zeile pro JSON-Zeile aus jeder übereinstimmenden Datei, auf die Tiefe „Flatten“ reduziert, plus _Quelldatei und _row_id.
    Ein Tisch pro LayoutMit Ein Tisch pro LayoutJede einzelne Form erhält eine eigene Tabelle, benannt nach dem gemeinsamen Teil ihrer Dateinamen. Bis zu 25 Layouts.
    DateienAlle übereinstimmenden Dateien befinden sich noch im Ordner, inklusive Pfad, Größe und Änderungsdatum.
    Dateien_EreignisseÄnderungshistorie: Hinzugekommene, geänderte und verschwundene Dateien sowie Zeilen mit Abweichungen und abgelehnten Einträgen für Dateien, die nicht passten. Sortieren nach event_at.
    VerzeichnisseAnzahl und Größe der Dateien in jedem Ordner unterhalb des Stammverzeichnisses.

    Jeder Ordnerverbinder liefert Claude außerdem dieselben Buchhaltungstabellen, alle im Dateisatz Schema:

    TischWas es enthält
    DateienAlle Dateien im Ordner: Pfad, Name, Dateiendung, Größe, Erstellungs- und Änderungsdatum. Fragt man „Was befindet sich in diesem Ordner?“, liest Claude dies vor.
    Dateien_EreignisseDie Änderungshistorie: eine Zeile pro Datei, die hinzugefügt, geändert, entfernt oder beiseitegelegt wurde (Drift), mit der Zeit in event_at und der Grund dafür Detail.
    Verzeichnisse, BändeOrdnergrößen und -anzahlen sowie die Datenträger oder Freigaben, auf denen die Stammverzeichnisse liegen.
    _Quelldatei, _row_idJede Datenzeile enthält zwei Spalten: die Datei, aus der die Zeile stammt, und eine eindeutige Zeilen-ID innerhalb dieser Datei. Gruppieren nach _Quelldatei um Dateien zu vergleichen.
  3. Verbinde dich mit Claude

    Öffnen Streams → Live → MCPEs gibt zwei Wege hinein, und sie enden am selben Ort:

    Chat-Apps · keine Taste

    claude.ai, Claude Desktop, ChatGPT

    Öffnen Sie in claude.ai und Claude Desktop die Abfragestreams-Liste Klicken Sie im Connectors Directory von Anthropic darauf. Verbinden und genehmigen. Hinzufügen per URL, https://mcp.querystreams.com/mcpDies ist die Ausweichlösung. In ChatGPT fügen Sie Abfragestreams über die App hinzu (derzeit im Entwicklermodus) und melden sich mit Abfragestreams an. In beiden Fällen öffnet sich eine Abfragestreams-Seite: Wählen Sie die Organisation und die Berechtigungen aus und klicken Sie auf Verbindung genehmigenNichts zum Kopieren. Die Verbindung erscheint auf dem Verbindungen Der Tab kann dort aufgerufen und widerrufen werden.

    Entwicklertools · ein Schlüssel

    Claude Code, Cursor, VS Code und Freunde

    Klicken Sie auf der MCP-Seite Verbinden Sie einen KI-ClientDer Reiseführer fragt Wie wird Ihr KI-Client die Verbindung herstellen?: wählen Verwenden Sie einen Schlüssel in einer KonfigurationsdateiWähle dein Werkzeug aus, dann Generieren Sie einen Schlüssel für es: ein Schlüsselname, Lesen und Abfragen ausführen angekreuzt, ein Ablauf (Nie, 30 Tage, 90 Tage oder 1 Jahr). Richten Sie es ein. zeigt den Codeausschnitt mit der ausgefüllten Legende, und Überprüfen Sie die Verbindung. wartet auf den ersten Anruf.

    Beide Methoden verwenden dieselben drei Berechtigungen, die Sie entweder auf dem Zustimmungsbildschirm oder auf dem Schlüssel auswählen:

    Lesen
    Listen Sie Konnektoren auf, durchsuchen Sie Tabellen und Spalten, lesen Sie Ihre gespeicherten Abfragen und Benachrichtigungsregeln. Es werden niemals Zeilendaten zurückgegeben.
    Abfragen ausführen
    Führen Sie schreibgeschützte SQL-Abfragen und gespeicherte Abfragen über Ihren Agenten aus und geben Sie die Zeilen zurück. Andernfalls kann Ihr KI-Client Ihre Daten zwar beschreiben, aber keine Antworten darauf geben.
    Analysieren
    Erstelle Tabellenprofile, entdecke Beziehungen und stelle einen Semantic-Intelligence-Lauf in die Warteschlange. Profiling und Discovery sind kostenlos; ein Semantic-Intelligence-Lauf verbraucht Nova-AI-Credits und Datenkontingent und wird daher auf dem Zustimmungsbildschirm nie vorab ausgewählt.

    Schlüssel verloren? Es ist aufgeführt auf der Verbindungen Tab: Vollständigen Schlüssel anzeigen zeigt es erneut und Vollständigen Schlüssel kopieren Kopiert es. Entzieht es dort, wenn ein Laptop verloren geht; jeder Client, der es benutzt, schlägt beim nächsten Anruf innerhalb von etwa fünf Minuten fehl.

    Wählen Sie dann das Rezept für den Claude aus, den Sie verwenden möchten. Die Serveradresse ist überall dieselbe: https://mcp.querystreams.com/mcp.

    Claude im Web, Claude Desktop und Mobilgeräte kein Schlüssel

    1. Öffnen Sie die Abfragestreams-Liste im Connectors Directory von Anthropic und klicken Sie VerbindenIn der Desktop-Umgebung befindet es sich dann unter + → Connectoren.
    2. Ausweichlösung, falls Ihre Organisation Verzeichnisverbindungen ausblendet: Einstellungen → Konnektoren → Benutzerdefinierten Konnektor hinzufügen, Name Abfrageströme, URL https://mcp.querystreams.com/mcp, OAuth-Felder leer, Hinzufügendann in einem Chat + → Abfrageströme → Verbinden.
    3. Es öffnet sich ein Tab „Abfrageströme“. Melden Sie sich gegebenenfalls an, wählen Sie die Organisation aus und überprüfen Sie die Abfrage. Lesen und Abfragen ausführenoptional Beschränkung auf bestimmte Anschlüsseund klicken Sie Verbindung genehmigen.
    4. Zurück in Claude sehen Sie „Mit Abfrageströmen verbunden“. Wenn Claude zum ersten Mal ein Tool verwendet, werden Sie gefragt; wählen Sie Immer erlauben.

    Wenn Sie es manuell in Claude Desktop hinzufügen, verwenden Sie Einstellungen → Konnektoren → Hinzufügennicht der Chat Marktplatz hinzufügen Diese Option erfordert ein Git-Repository. Konnektoren werden mit Ihrem Claude-Konto synchronisiert, sodass die mobilen Apps und die Desktop-Version es automatisch erkennen. Die Menünamen stammen von Anthropic und können geändert werden.

    Claude Code Schlüssel

    Ein Befehl, mit Ihrem Schlüssel aus der Registerkarte „Verbindungen“:

    Terminal
    claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp \ --header "X-MCP-Key: qsmcp_PASTE_YOUR_KEY_HERE"

    Das schreibt das aktuelle Projekt. .mcp.json. Hinzufügen --scope Benutzer Query Streams in jedem Projekt haben. Ausführen /mcp Im Claude-Code sehen Sie, ob die Verbindung besteht.

    Cursor Schlüssel

    Öffnen Cursor-Einstellungen → MCP → Neuen MCP-Server hinzufügenoder bearbeiten .cursor/mcp.json im Stammverzeichnis Ihres Arbeitsbereichs:

    .cursor/mcp.json
    { "mcpServers": { "querystreams": { "url": "https://mcp.querystreams.com/mcp", "headers": { "X-MCP-Key": "qsmcp_PASTE_YOUR_KEY_HERE" } } } }

    Cursor neu starten oder ausführen MCP: Server neu starten; A Abfrageströme Das Symbol erscheint in der MCP-Statusleiste.

    Etwas anderes verwenden? Das Portal Verbinden Sie einen KI-Client Führung enthält sofort einsatzbereite Rezepte für ChatGPT, VS Code, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev und JetBrains AI sowie ein Einfügen und Zusammenführen Werkzeug, das die Abfrageströme Eintrag in eine bereits vorhandene Konfigurationsdatei. Jeder Client, der MCP über HTTP unterstützt, funktioniert: Server https://mcp.querystreams.com/mcp, Kopfzeile X-MCP-Schlüssel (ein Autorisierung: Inhaber (Auch eine Kopfzeile mit demselben Schlüssel funktioniert.)

  4. Stelle deine erste Frage

    Beginnen Sie mit etwas, das Sie überprüfen können, indem Sie den Ordner öffnen, sodass Sie sehen können, wie Claude die richtige Tabelle auswählt. Drei Beispiele, die gut mit einem Ordner mit JSON-Zeilendateien funktionieren:

    „Welche JSONL-Dateien haben sich in den letzten 24 Stunden geändert?“
    Claude fragt fileset.files nach relativem Pfad, Größe in Bytes und geänderter UTC ab, wobei die neueste Datei zuerst angezeigt wird.
    „Wie viele Ereignisse jedes Ereignistyps haben wir diese Woche pro Tag verzeichnet?“
    Claude gruppiert die Datentabelle nach Tag und Ereignistyp. Verschachtelte Felder sind bereits Spalten, sodass direkt danach gefiltert werden kann.
    „Wurden JSONL-Dateien separat abgelegt, und warum?“
    Claude liest die Drift- und Refused-Zeilen in files_events, beginnend mit dem neuesten event_at, und benennt jede Datei und ihren Grund.

    Um die Verkabelung zu überprüfen, fragen Sie „Welche Query Streams-Konnektoren habe ich?“Claude ruft an qs_list_connectors, der Portal-Leitfaden Überprüfen Sie die Verbindung. Schritt sagt Verbundenund der Schlüssel oder die App auf dem Verbindungen Der Tab zeigt seine Zuletzt verwendet Zeit innerhalb weniger Sekunden.

Das war’s. Legen Sie eine neue Datei in den Ordner, und nach dem nächsten Scan kann Claude daraus antworten. Die Dateien haben den Computer, auf dem sie sich befanden, nie verlassen, und niemand hat ein Passwort in eine KI eingegeben.

Auf eine Datei in einer Netzwerkfreigabe zugreifen

Der Agent öffnet Dateien als Hintergrunddienst, nicht als Sie. Daher ist für eine Datei auf einem anderen Computer ein zusätzlicher Schritt erforderlich. Welcher Schritt, hängt vom Computer ab, auf dem der Agent ausgeführt wird.

Fenster

Geben Sie den Netzwerkpfad ein, zum Beispiel \\server\share\folderniemals ein zugeordneter Laufwerksbuchstabe wie S:, die der Agent nicht sehen kann. Wenn die Freigabe nur namentlich genannte Personen zulässt, klicken Sie hier. Dienstidentität (der Chip unter dem Pfad oder ein Ordner) Berechtigung Spalte) und speichern Sie einen Login für diesen Server: ein Firmendomänenkonto oder ein Konto, das auf dem Server selbst erstellt wurde mit Domain Das Feld bleibt leer. Der Agent meldet sich dann an diesem Server an und liest die dortige Datei. Jeder Connector auf diesem Agent, der auf denselben Server zugreift, muss dasselbe Login verwenden. Ohne Login liest er mit seinem eigenen Dienstkonto, das von einer Unternehmensdomäne als der Computer selbst erkannt wird. Schritt für Schritt unter Windows

Linux

Die im Portal gespeicherten Freigabeanmeldungen werden unter Linux nicht verwendet: Ein Administrator bindet die Freigabe zunächst auf dem Computer des Agenten in einem Ordner unter ein. /mnt oder /Medienweil der Dienst des Agenten dies nicht sehen kann /heim oder /run/userIm Stecker sollte Folgendes beibehalten werden: \\server\share Pfad, den der Agent dem Mount zuordnet, oder geben Sie stattdessen den Mount-Pfad ein, z. B. /mnt/fileserver-shared/Accounts. Wie man eine Freigabe unter Linux einbindet

Mac

Die im Portal gespeicherten Freigabe-Logins werden auf einem Mac nicht verwendet: Binden Sie die Freigabe zuerst über das Terminal ein. sudo, in einem Ordner unter /VolumesDamit der Hintergrunddienst des Agenten darauf zugreifen kann. Im Connector muss Folgendes beibehalten werden: \\server\share Pfad, den der Agent dem Mount zuordnet, oder geben Sie stattdessen den Mount-Pfad ein, z. B. /Volumes/fileserver-shared/Accounts. So binden Sie eine Freigabe auf einem Mac ein

Falls der Test die Aktie nicht erreichen kann, suchen Sie in seinem Ergebnis nach folgenden Wörtern: nicht erreichbar Das bedeutet, dass der Computer des Agenten keine Antwort vom Server erhalten hat. Unter Linux oder einem Mac, nicht montiert Das bedeutet, dass die Freigabe noch eingebunden werden muss, und diese Meldung enthält den genauen Mount-Befehl für Ihren Server.

Ordner auf einer Netzwerkfreigabe? Unter Windows deckt ein einziger Login alle Ordner ab, die Sie vom selben Server hinzufügen. Ordner auf Änderungen überwachen Funktioniert auch bei geteilten Daten, nach dem besten Bemühen; der geplante Scan stellt sicher, dass jede Änderung erfasst wird.

Wie neue, geänderte und gelöschte Dateien angezeigt werden

Neue und geänderte Dateien

Auf jedem Scanintervall Der Agent vergleicht die Größe und Änderungszeit jeder Datei mit dem zugehörigen Ledger. Eine neue, passende Datei wird hinzugefügt; eine geänderte Datei wird vollständig neu eingelesen, sodass eine Tabelle niemals zwei Versionen derselben Datei enthält. Aktivieren Ordner auf Änderungen überwachen um innerhalb von Sekunden auf einer lokalen Festplatte zu reagieren.

Gelöschte Dateien

Eine Datei, die verschwindet, verliert ihre Zeilen, es sei denn, Sie haben dies anders ausgewählt. Zeilen beibehalten, gelöschte Zeilen als gelöscht markierenWenn eine Freigabe offline geht und die meisten Dateien auf einmal verschwinden, behält der Agent den zuletzt intakten Bestand bei, anstatt alles zu löschen.

Beiseite gelegte Dateien

Eine Datei, die nicht dem Layout entspricht, nicht geöffnet werden kann oder gesperrt ist, wird beiseitegelegt: Keine ihrer Zeilen wird geladen, und Dateien_Ereignisse Es wird protokolliert, welche Datei und warum. Der Scan wird beim nächsten Ändern automatisch wiederholt. Es gibt keine Schaltfläche „Erneut scannen“.

Was Claude sieht

Die Daten stammen vom letzten Scan. Da kein MCP-Tool einen Scan auslöst, fragen Sie: „Wann wurde dies zuletzt aktualisiert?“ und Claude liest die neuesten Daten vor. event_at In Dateien_Ereignisse für dich.

Was Claude tun kann, sobald er verbunden ist

Ihr KI-Client erkennt die Abfragestream-Tools und wählt das passende für Ihre Frage aus. Das Portal Werkzeuge Registerkarte listet alle Tools und Modi auf, die in deinem Tarif enthalten sind. Query Streams fordert deinen KI-Client auf, vor einer Abfrage die Spalten jeder Tabelle auszulesen, damit er die tatsächlichen Namen verwendet, statt zu raten. In jedem Tarif, auch im kostenlosen:

Ordnen Sie Ihre Daten zu.

Konnektoren, Datenbanken und Agenten; die Tabellen und Spalten Ihrer JSONL-Ordnerdatei mit Beschreibungen, Beispielwerten und Verknüpfungen, sobald Semantic Intelligence ausgeführt wurde.

Profil erstellen und erkunden

Erstelle ein Profil einer Spalte, bevor du sie filterst; entdecke Joins, die niemand deklariert hat. Für Live-Ausführungen ist Analyze erforderlich.

Führe schreibgeschütztes SQL aus

Eine SELECT-Anweisung im richtigen Dialekt für den JSONL-Ordner, standardmäßig 60 Sekunden, maximal fünf Minuten. Ihr Ausführungsplan legt die maximale Anzahl der Zeilen fest, die eine Abfrage zurückgibt. (Abfragen ausführen)

Gespeicherte Abfragen, föderierte Abfragen und Benachrichtigungen

Führen Sie die gespeicherten Abfragen, denen Ihr Team vertraut, mit neuen Werten aus; föderierte Abfragen werden als bereits verknüpft zurückgegeben. Lesen Sie die Alarmregeln und erstellen Sie eine als Testlauf.

Das Analyse-Toolset. Bei kostenpflichtigen Tarifen übernimmt der Agent die Vorarbeit im Verzeichnis Ihrer JSONL-Ordnerdatei, sodass sich Ihr KI-Client auf die eigentliche Verarbeitung konzentrieren kann. Die kostenlose Version funktioniert wie gewohnt.

Kontextmanagement

Persönlicher Kern und darüber hinaus

Größe des Ergebnisses vor dem Lesen (Form), durchlaufen Sie eine große Datenbank Bereich für Bereich (Ebenen), und die Antworten innerhalb eines Token-Budgets mit nur den Spalten und die benötigten Zelllängen.

Ergebnisanalyse

Persönlicher Kern und darüber hinaus

A Profil des gesamten Ergebnisses anstelle von Zeilen. Ergebnisse mit Labels, die Folgefragen beantworten und nach Summen gruppieren, ohne eine zweite Abfrage. Datenaktualität und seit Lies nur, was neu ist.

Vertiefende Analyse

Business Core und höher

Daten Qualität Bericht, Anomalien, Segmente, eine statistische vergleichen und ein diff zwischen zwei gehaltenen Ergebnissen.

Die Standardeinstellungen befinden sich auf der Kontext Registerkarte: Textzellenlimit, Schemaansicht, Ergebnisgröße, Analysevorgaben und gespeicherte Ergebnisse.

Die Namen der Werkzeuge, falls Sie diese in den Antworten Ihres KI-Clients erkennen möchten.
ErlaubnisWerkzeuge
Lesenqs_list_organizations qs_list_agents qs_list_connectors qs_get_si_status qs_get_connector_schema qs_find_tables qs_get_table_schema qs_get_relationships qs_profile_table qs_discover_relationships qs_list_saved_queries qs_alerts qs_result (op=windows)
Analysierenqs_request_si_analysis qs_setup_si qs_get_task_status, wird nur Schlüsselinhabern mit Analyze aufgeführt; Live-Ausführungen von qs_profile_table und qs_discover_relationships
Abfragen ausführenqs_run_query qs_run_saved_query qs_data_freshness qs_result (jeder andere op) qs_result_release qs_create_alert_rule (nur Vorschläge)

Warum semantische Intelligenz hier wichtig ist

Jede Antwort, die Claude erhält, wird mit dem Hinweis versehen, woher die Struktur stammt, und Claude passt an, wie sehr er dem Gesehenen vertraut.

StufeWas Claude siehtErgebnis
Semantische IntelligenzBeschreibungen für jede Tabelle und Spalte, Beispielwerte, Bedeutungen der Aufzählungszeichen, deklarierte und erkannte Joins.Claude schreibt auf Anhieb den richtigen JSONL Folder SQL-Code und erklärt die Daten in Ihren Geschäftsbegriffen.
Erfasstes SchemaTabellen- und Spaltennamen, Datentypen, Schlüssel.Claude arbeitet, erschließt aber die Bedeutung aus den Namen und fragt möglicherweise nach.
Live-SchemaDie Datenbank liegt außerhalb des Erfassungsbereichs des Konnektors, daher wird die Struktur bei jeder Anfrage live gelesen (erfordert die Berechtigung "Abfragen ausführen"; SQL Server, MySQL und PostgreSQL).Die Abfragen werden weiterhin ausgeführt. Claude verwendet bei Bedarf kleinere SELECT-Anweisungen.

Wenn eine Datenbank wichtig ist, führen Sie Semantic Intelligence einmalig darauf aus. Nova → Intelligenz. Der Verbindungen Die Registerkarte zeigt ein Abdeckungsfeld pro Anschluss an. Wie semantische Intelligenz funktioniert.

Was die Pläne erlauben

MCP ist in jedem Tarif, auch im kostenlosen Tarif, ohne zusätzliche Gebühren enthalten. Jeder Tarif legt fest, wie viele Schlüssel oder verbundene Apps Sie halten können und wie viele Anrufe pro Minute Ihr KI-Client tätigen darf:

PlanenSchlüssel pro BenutzerSchlüssel pro OrganisationAnrufe pro Minute
Kostenlos1130
Persönlicher Kern1160
Personal Plus1190
Kerngeschäft23120
Business Plus35150
Business Max510240
Enterprise Core525300
Enterprise Plus850450
Enterprise Max10100600

Eine verbundene App zählt als Schlüssel. Zusätzlich zur Minutenzahl kann jeder Schlüssel maximal 10 Abfragen pro Minute ausführen. Eine Abfrage dauert bis zu 60 Sekunden, es sei denn, Ihr KI-Client fordert mehr an, bis zu fünf Minuten. Ihr Plan legt außerdem fest, wie viele Zeilen eine Abfrage zurückgibt und, mit den Analysetools, wie lange und wie groß ein gespeichertes Ergebnis sein darf; der vollständige MCP-Leitfaden listet alle Pläne auf. Was Ihr KI-Client empfängt, wird auf Ihr Data-Realm-Kontingent angerechnet – denselben Pool, den auch Ihre Excel- und Sheets-Abfragen nutzen: Bei der Nutzung des KI-Agenten (MCP) zählt jedes Byte, das an Ihren KI-Client geliefert wird, also Ergebnisse, Schema-Lesevorgänge und Seiten mit zurückgehaltenen Ergebnissen, und zwar vor einer etwaigen Transportkomprimierung, die Ihr Client aushandelt. Bei Tabellenkalkulationsabfragen zählt hingegen das komprimierte Ergebnis, das Ihr Network Agent liefert. Semantic-Intelligence-Ausführungen, die von Ihrem KI-Client gestartet werden, verbrauchen Nova-AI-Credits – genau wie Ausführungen über das Portal. Siehe die Preisseite für die Zulagen.

Es sicher aufbewahren

Schreibgeschützt, vom Agenten geprüft

Es werden ausschließlich SELECT-Anweisungen ausgeführt. Die Prüfung erfolgt auf dem Computer, auf dem der Agent ausgeführt wird, bevor Ihre JSONL-Ordnerdatei die SQL-Anweisungen sieht. Daher kann nichts, was Ihr KI-Client schreibt, die Daten verändern.

Keine Anmeldeinformationen in der KI

Die Anmeldedaten für den JSONL-Ordner bleiben auf dem Agenten erhalten. Claude verfügt über einen Query-Streams-Schlüssel bzw. eine Verbindung, die Sie über die MCP-Seite widerrufen können; die Änderung wird innerhalb von etwa fünf Minuten wirksam.

Alles wird protokolliert.

Jeder Werkzeugaufruf erscheint auf dem MCP. Aktivität Alle Abfragen im Abfrageverlauf werden als Clienttyp MCP angezeigt und dem Benutzer zugeordnet, dessen Schlüssel oder Verbindung die Abfrage durchgeführt hat. Der SQL-Text und der Schlüssel selbst werden niemals im Aktivitätsprotokoll gespeichert.

Was der KI-Anbieter erhält

Tabellen- und Spaltennamen, die Beschreibungen der semantischen Intelligenz inklusive Beispielwerten und die Zeilen Ihrer Abfragen werden erfasst. Mit dem Analysetoolset wird stattdessen häufig eine Größenschätzung, ein Profil oder ein vorläufiges Ergebnis abgerufen, während das vollständige Ergebnis beim Agenten verbleibt. Die abgerufenen Daten werden gemäß den Nutzungsbedingungen an den verbundenen KI-Anbieter übermittelt. Query Streams hat keinen Zugriff auf Ihren Chat.

Gute nächste Schritte

  • Semantische Intelligenz ausführen Der Konnektor sorgt dafür, dass Claude verständliche Beschreibungen Ihrer Spalten erhält. Die Dateitabellen enthalten bereits integrierte Beschreibungen.
  • Verkürzen Sie das Scanintervall Wenn häufig neue Dateien eintreffen, überprüft der Agent den Ordner standardmäßig stündlich.
  • Lesen Sie die vollständige Anleitung zum JSONL-Ordner. In Einen Ordner mit JSON-Dateien in SQL-Tabellen umwandeln für jede Einstellung.

Wenn etwas nicht funktioniert

Was Sie sehenWas es bedeutetFix
Ihr KI-Client zeigt keine Query Streams-Tools an.Der Stecker wurde zwar angebracht, aber nie angeschlossen, oder der Schlüssel wurde an der falschen Stelle eingeklebt.In Claude: + → Abfrageströme → VerbindenIn einem Entwicklertool: Starten Sie es neu und verwenden Sie dann Überprüfen Sie die Verbindung. im Portal-Leitfaden.
MCP_KEY_REQUIRED oder 401Es ist kein Schlüssel auf dem Server angekommen, üblicherweise aufgrund eines versehentlich eingefügten Zeilenumbruchs beim Kopieren oder Einfügen oder weil sich der Schlüssel im falschen Header befindet.Kopieren Sie den Schlüssel erneut vom Tab „Verbindungen“ und senden Sie ihn an die X-MCP-Schlüssel Kopfzeile.
MCP_USER_DISABLEDEin Administrator hat MCP für Ihren Benutzer deaktiviert.Bitten Sie sie, die MCP unter wieder einschalten Konto → Zugriffskontrolle.
MCP_SCOPE_REQUIRED oder MCP_SCOPE_DENIEDDer Schlüssel oder die Verbindung verfügt nicht über die Berechtigung für diese Aktion, in der Regel für das Ausführen von Abfragen.Bearbeiten Sie den Schlüssel auf der Registerkarte „Verbindungen“ und aktivieren Sie das Kontrollkästchen. Abfragen ausführenOder verbinden Sie die App erneut und genehmigen Sie sie.
MCP_KEY_ORG_LIMIT_EXCEEDEDDas in Ihrem Tarif enthaltene Lizenzlimit ist aufgebraucht. Im kostenlosen Tarif entspricht dies einer Lizenz oder einer verbundenen App.Kündigen Sie einen Tarif, den Sie nicht mehr nutzen, oder wechseln Sie zu einem höheren Tarif.
MCP_AGENT_NOT_CONNECTED oder MCP_AGENT_NOT_REGISTEREDDer Agent, dem Ihre JSONL-Ordnerdatei gehört, ist momentan nicht verbunden.Öffnen Daten → Datenagenten und starten Sie den Agenten auf seinem Computer.
MCP_DATABASE_NOT_CAPTUREDDie Datenbank liegt außerhalb des Erfassungsbereichs des Konnektors, daher sind weder ein gespeichertes Schema noch semantische Informationen dafür vorhanden. Abfragen funktionieren weiterhin.Fügen Sie es der Erfassungsauswahl des Konnektors hinzu und führen Sie anschließend die semantische Intelligenz aus, wenn Sie aussagekräftigere Ergebnisse wünschen.
MCP_RATE_LIMITEDZu viele Anrufe pro Minute für Ihren Tarif oder mehr als 10 Abfrageläufe pro Minute mit einer einzigen Taste.Moment mal. Dank semantischer Intelligenz kann Claude Anrufe in weniger Fällen beantworten.
MCP_QUERY_TIMEOUT oder MCP_OUTPUT_TOO_LARGEDie Abfrage hat das Zeitlimit überschritten oder mehr Daten zurückgegeben, als Ihr KI-Client in einer Antwort verarbeiten kann.Bitten Sie um weniger Zeilen oder Spalten oder um einen Datumsfilter. Bei Tarifen mit Kontextmanagement lassen Sie das Ergebnis zunächst anpassen.
MCP_DATA_REALM_EXHAUSTEDDas Datenvolumen Ihrer Organisation für den Zeitraum ist aufgebraucht.Warten Sie, bis sich Ihr Guthaben wieder aufgeladen hat, oder laden Sie es über das Portal wieder auf.
MCP_FEATURE_NOT_INCLUDEDIhr Plan beinhaltet kein Kontextmanagement, keine Ergebnisanalyse und keine tiefergehende Analyse, oder dieses Tool ist für diesen Schlüssel oder diese Organisation deaktiviert.Bitten Sie Ihren KI-Client, ohne das Tool weiterzumachen, wechseln Sie zu einem höheren Tarif oder bitten Sie einen Administrator, das Tool zu aktivieren.
MCP_RESULT_EXPIREDDas gespeicherte Ergebnis ist nicht mehr gültig: Es ist abgelaufen, wurde freigegeben (manchmal vorzeitig, um Platz für ein neueres zu schaffen) oder der Agent wurde neu gestartet.Bitten Sie Ihren KI-Client, die Abfrage mit der Option "hold" erneut auszuführen.
MCP_WINDOW_BUDGETDer Agent kann ein Ergebnis dieser Größe momentan nicht speichern, oder eine Folgeoperation benötigt mehr Speicherplatz, als zur Verfügung steht.Ein gespeichertes Ergebnis freigeben oder die Abfrage mit einem Filter oder weniger Spalten einschränken.
MCP_AGENT_ANALYSIS_DEAKTIVIERTDie Speicherung von Ergebnissen und Analysen ist für diesen Agenten oder Konnektor deaktiviert.Bitten Sie einen Administrator, die Option zu aktivieren. Lokale Analyse auf der Seite „Datenagenten“ oder erlauben Sie die Analyse des Konnektors.
MCP_WINDOW_SQL_REJECTEDEine Folgeabfrage war keine schreibgeschützte SELECT-Anweisung über das gespeicherte Ergebnis, und es wurde keine Spalte angegeben, die im Ergebnis nicht vorhanden ist.Fordern Sie eine SELECT-Anweisung für dieses Ergebnis an, wobei die Spaltennamen verwendet werden.
MCP_AGENT_VERSION_TOO_OLDDer Agent benötigt ein Update, bevor er Ergebnisse formen, profilieren, speichern oder analysieren kann.Aktualisieren Sie den Agenten von Daten → DatenagentenEinfache Abfragen funktionieren derweil weiterhin.
Verstoß gegen die LesepflichtDie SQL-Anweisung war keine SELECT-Anweisung.Das ist so beabsichtigt. Über MCP werden keine Daten geschrieben.

Fragen, die Menschen stellen

Wie werden verschachtelte JSON-Objekte behandelt?

Sie flachen sich zu Säulen ab. Abflachungstiefe Sie legen die Standardtiefe auf 2 und maximal 8 fest. Jede weitere Verschachtelung bleibt als JSON-Text in einer Spalte erhalten, sodass keine Daten verloren gehen. Erhöhen Sie die Verschachtelungstiefe, falls Claude ständig JSON-Text analysieren muss.

Meine Dateien haben unterschiedliche Formate. Können sie trotzdem abgefragt werden?

Ja. Auswählen Ein Tisch pro Layout Jede Form wird zu einer eigenen Tabelle, maximal 25. Jede Tabelle wird nach dem gemeinsamen Teil ihrer Dateinamen benannt. Es gibt keine automatische Ansicht, die die Layouts übereinanderstapelt, aber Claude kann sie in einer Abfrage per UNION verknüpfen.

Was passiert, wenn später eine Datei mit einer neuen Form eintrifft?

Es ist beiseitegelegt, und Dateien_Ereignisse Es wird als neues Layout gespeichert. Neue Layouts werden nicht automatisch hinzugefügt. Ändern und speichern Sie alle Konnektoroptionen und die Agentenbeispiele erneut, wobei die bestehenden Tabellennamen beibehalten werden.

Liest Claude meine Dateien?

Nein. Der Agent liest die Daten auf seinem eigenen Computer und speichert die Zeilen dort in einem lokalen Cache. Claude sendet SQL-Anweisungen an Query Streams, der Agent führt sie gegen diesen Cache aus, und nur die für die Anfrage benötigten Zeilen werden zurückgesendet. Claude öffnet niemals eine Datei und kann sie weder ändern, verschieben noch löschen.

Muss ich einen Port öffnen oder ein VPN einrichten?

Nein. Der Agent stellt eine ausgehende Verbindung über Port 443 her, über die sowohl Anfragen als auch Datensätze übertragen werden. Wenn ausgehende HTTPS-Verbindungen funktionieren, funktioniert auch dies.

Kann sich der Ordner auf einer Netzwerkfreigabe, in OneDrive oder Dropbox befinden?

Eine Freigabe funktioniert, solange der Computer des Agenten sie öffnen kann; geben Sie sie wie folgt ein: \\server\share\folderDa der Agent als Dienst ausgeführt wird und die beim Anmelden verbundenen Laufwerke nicht sehen kann, fügen Sie unter Windows die Freigabeanmeldung aus dem Ordner hinzu. Berechtigung Spalte, wenn die Freigabe nur namentlich genannten Personen Zugriff gewährt; unter Linux oder Mac muss die Freigabe zuerst eingebunden werden (gespeicherte Anmeldedaten werden dort nicht verwendet). Bei einem synchronisierten Cloud-Ordner legen Sie fest, dass die Dateien auf diesem Gerät gespeichert werden; der Agent überspringt Cloud-Platzhalterdateien.

Ist das im kostenlosen Tarif wirklich enthalten?

Ja. „Free“ ist ein dauerhafter Tarif, keine befristete Testphase. MCP ist in jedem Tarif enthalten; „Free“ beinhaltet eine Taste oder eine verbundene App und 30 Anrufe pro Minute. Ordnerverbinder haben keine eigene Dateibeschränkung. Sehen Sie sich die genauen Leistungen von „Free“ an. Preisseite.

Welche KI-Tools funktionieren außer Claude?

Alles, was MCP über HTTP spricht: ChatGPT, Cursor, VS Code mit Copilot, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev und JetBrains AI – all das bietet eine fertige Anleitung im Leitfaden „KI-Client verbinden“ des Portals.

Immer noch festgefahren? Öffnen Unterstützung Bitte geben Sie in Query Streams an, bei welchem Schritt Sie sich befinden und was Sie sehen. Wir stellen dann die Verbindung her.

Jeder Leitfaden für JSONL Folder

Nicht ganz Ihre Konfiguration?

  • Handelt es sich um die Logdateien Ihrer App, die ständig anwachsen? Application Logs liest neue Zeilen beim Schreiben und extrahiert Level, Logger und Nachricht → App Logs
  • Sie benötigen lediglich eine Liste der Dateien mit Größen, Datumsangaben und Änderungsdetails? Das Dateisystem erledigt das, ohne die Dateien zu lesen. File System

Einrichtungsprobleme?

  • Der Agent meldet, dass die Datei oder der Ordner nicht existiert oder der Zugriff verweigert wird? Für zugeordnete Laufwerke, Netzwerkfreigaben, OneDrive und Linux-Home-Verzeichnisse ist jeweils eine Lösung erforderlich. Wo der Agent Dateien lesen kann
  • Der Agent wird als offline angezeigt, oder die Optionen „Verbindung testen“ und „Durchsuchen“ sind ausgegraut? Überprüfen Sie, ob der Agent online ist → Ist der Agent online?
Aktualisiert am November 9, 2026

Angetrieben durch BetterDocs