Kategorien anzeigen

Verbinden Sie einen Ordner mit Parquet-Dateien mit Claude mithilfe von MCP

ParkettordnerKostenloser PlanAbfrageströmeClaude

Parquet-Ordner → Claude · mit Query Streams

Mit Query Streams können Sie Claude in einfachem Englisch Fragen zu Ihrer Parquet-Ordnerdatei stellen: Der Agent, der sich bereits in Ihrem Netzwerk befindet, führt SQL schreibgeschützt aus, und kein Datenbankpasswort gelangt jemals zur KI. Das dauert etwa zehn Minuten und ist im Free-Tarif enthalten.

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

Parquet-OrdnersymbolEin Claude, der Fragen zu einem Ordner mit Parquet-Dateien beantworten kann – mit Live-Abfragen (schreibgeschützt) über die Tabellen, die der Agent aus Ihren Dateien erstellt – und Ihnen anzeigt, aus welcher Datei jede Antwort stammt. Und das alles ohne Login, Dateipfad oder 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 mit Claude etwa 90 Sekunden, wenn Sie mit den Einstellungen 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 Parkettordner Die Karte wandelt einen Ordner mit Parquet-Dateien in eine typisierte SQL-Tabelle um, die Claude abfragen kann. Spalten und Datentypen werden dabei aus den Dateifußzeilen übernommen. Sie benötigen weder einen Parquet-Viewer noch eine eigene DuckDB-Installation. Der Agent liest die Dateien, speichert die Zeilen auf seinem Computer zwischen und stellt sie Claude als SQL-Abfrage bereit. Jede geänderte Datei wird neu eingelesen.

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. Parkettordner 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 BestellungenEs ist auf dieser Karte erforderlich.
    • Muster einbeziehen beginnt als **/*.Parkett.
    • Es gibt kein Tabellenlayout Auswahl. Ein Hinweis erklärt, dass alle übereinstimmenden Dateien das gleiche Layout haben müssen und dass Dateien, die später nicht übereinstimmen, beiseitegelegt und gemeldet werden.
    • An ÜberprüfenDer Agent analysiert bis zu 64 Dateien und zeigt Dateianzahl, Größe, geschätzte Zeilenanzahl und Tabellennamen an. Wenn zwei Dateien unterschiedliche Spaltentypen aufweisen, erscheint im gelben Banner die Meldung „Schema-Sniff abgelehnt“ mit Angabe des Grundes. Sie können den Konnektor trotzdem erstellen. Die Überprüfung wird fortgesetzt und der Grund für die Ablehnung angezeigt. Manifest Tab.
  2. Schau dir an, welche Tabellen du erhältst

    Alles befindet sich im Dateisatz Schema. Die Datentabelle übernimmt Ihre TabellennameDateien können Spalten hinzufügen oder weglassen: Die Tabelle enthält alle angezeigten Spalten, und eine Spalte, die in einer Datei fehlt, wird als NULL gelesen.

    TischWas es enthält
    Dateiensatz.BestellungenEine Tabelle, benannt nach Ihrem Tabellenname, das die Zeilen jeder übereinstimmenden Parquet-Datei enthält, plus _Quelldatei und _row_id.
    fileset.filesEine Zeile pro aktuell vorhandener Parquet-Datei mit Pfad, Größe und Änderungsdatum.
    fileset.files_eventsDie Veränderungsgeschichte. A abgelehnt Eine Zeile bedeutet, dass kein Layout angeheftet werden konnte, und eine Drift Die Zeile gibt eine Datei an, die beiseitegelegt wurde.
    fileset.directoriesEine Zeile pro Ordner mit Dateianzahl und Gesamtgröße, nützlich für partitionierte Ordnerstrukturen.

    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 Parquet-Dateien funktionieren:

    „Welche Parquet-Dateien befinden sich in dem Ordner und wie groß ist jede einzelne?“
    Claude fragt nach fileset.files (Abfragen ausführen) und listet jede Datei auf mit Größe_Bytes und modifiziert_utc.
    „Beschreiben Sie die Spalten in fileset.orders und zeigen Sie dann zehn Zeilen an.“
    Claude liest das Tabellenschema mit den Typen aus den Parquet-Fußzeilen (Lesen) und führt dann einen Befehl aus. SELECT mit LIMIT 10 über Ihren Agenten (Abfragen ausführen).
    Wurde eine Parquet-Datei zurückgestellt oder abgelehnt? Warum?
    Claude fragt nach fileset.files_events für Drift und abgelehnt Zeilen, sortiert nach event_at (Abfragen ausführen). Sie erhalten die Datei und den Grund von Detail.

    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 Parquet-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 Parquet Folder, standardmäßig 60 Sekunden, maximal fünf Minuten. Ihr Ausführungsplan legt die maximale Anzahl der von einer Abfrage zurückgegebenen Zeilen fest. (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 Parquet-Ordnerdatei, sodass sich Ihr KI-Client auf die eigentliche Berechnung 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 das richtige Parquet Folder SQL 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 Parquet-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 Parquet-Ordner bleiben auf dem Agenten gespeichert. Claude verfügt über einen Query-Streams-Schlüssel bzw. eine Verbindung, die Sie auf der 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 auf dem Konnektor, damit Claude Beschreibungen Ihrer eigenen Spalten sieht, nicht nur die der Dateitabellen.
  • Ordner auf Änderungen überwachen Wenn neue Teile auf einer lokalen Festplatte landen und Sie sie innerhalb von Sekunden benötigen.
  • Lesen Sie die Anleitung für Parkettordner bei Abfrage eines Ordners mit Parquet-Dateien mittels SQL 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 Parquet-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

Benötigen alle Parquet-Dateien exakt die gleichen Spalten?

Nein. Eine Datei kann Spalten hinzufügen oder weglassen, und eine fehlende Spalte wird als NULL interpretiert. Eine Spalte, deren Datentyp sich zwischen den Dateien unterscheidet, verhindert das Festlegen der Tabelle. Der Agent benennt die Datei, die nicht übereinstimmt, und erstellt keine Tabelle, bis Sie die Datei korrigieren oder ausschließen.

Wie schnell wird eine neue Parquet-Datei angezeigt?

Nach dem nächsten Scan, standardmäßig stündlich unter ScanintervallDie Zeilen werden hinzugefügt, sofern sie dem festgelegten Layout entsprechen. Eine geänderte Datei wird in einem Schritt vollständig neu eingelesen, sodass die alten Zeilen nie neben den neuen verbleiben.

Kann ich Parquet- und CSV-Dateien in einem Connector mischen?

Nein. Ein Konnektor kann nur einen Dateityp lesen. Fügen Sie einen hinzu. CSV-Ordner Der Connector befindet sich im selben Ordner wie die CSV-Dateien, und Claude kann beide abfragen.

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 Parquet Folder

Nicht ganz Ihre Konfiguration?

  • Befinden sich Ihre Daten bereits in einer DuckDB-Datenbankdatei? Der DuckDB-Connector öffnet sie direkt → DuckDB
  • 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