Dateisystem → Claude · mit Query Streams
Mit Query Streams können Sie Claude in einfachem Englisch Fragen zu Ihrer Datei im Dateisystem stellen: Der Agent, der sich bereits in Ihrem Netzwerk befindet, führt die SQL-Abfragen schreibgeschützt aus, und Ihr Datenbankpasswort gelangt niemals zur KI. Das dauert etwa zehn Minuten und ist im Free-Tarif enthalten.
Kostenlos starten
Was am Ende dabei herauskommt
Ein Claude, der Fragen zu Dateien und Ordnern auf Ihrem Computer oder Ihrer Dateifreigabe beantworten kann. Er führt dazu Live-Abfragen (nur lesend) auf den Tabellen durch, die der Agent aus Ihren Dateien erstellt, und zeigt Ihnen 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 mit Claude etwa 90 Sekunden, sofern Sie mit der Konfigurationsoberfläche vertraut sind. So geht's:
Welche Dateien in fileset.files haben sich zuletzt geändert und wie groß sind sie?
Hier sind die drei zuletzt geänderten Dateien in Ihren Ordnern. Die Quartalsabschluss-Arbeitsmappe wurde gestern Nachmittag geändert.
| relativer Pfad | Größe_Bytes | modifiziert_utc |
|---|---|---|
| Finance/2026/Q3-close.xlsx | 482113 | 2026-09-25 17:42:10 |
| Contracts/Acme-renewal-2026.pdf | 1893402 | 2026-09-25 14:05:37 |
| Berichte/wöchentlich/Betriebszusammenfassung-w39.docx | 96120 | 2026-09-25 09:18:54 |
Soll ich Ihnen zeigen, welche Ordner diesen Monat am stärksten gewachsen sind? Verzeichnis-Snapshots?
Welche Ordner sind in diesem Monat am stärksten gewachsen, und gibt es darunter ungewöhnlich große?
Ich lese fileset.directories für die Größe nach Ordner, dann fileset.files für die jeweils neueste Datei. Beide Abfragen waren schreibgeschützt:
| Weg | Dateien | Größe | neueste Datei |
|---|---|---|---|
| Exporte/täglich | 27 | 10,8 GB | 2026-09-27 03:10 |
| Finanzen/2026 | 412 | 2,1 GB | 2026-09-27 17:42 |
| Fotos/Besichtigungen | 1,930 | 6,4 GB | 2026-09-19 08:55 |
Exporte/täglich Das ist das Beispiel, das man sich ansehen sollte: 27 Kopien desselben 400-MB-Dumps, eine pro Nacht, und die alten werden nicht gelöscht. Die Finanzen wachsen erwartungsgemäß. Möchten Sie die zehn größten Dateien unter „Exporte“ mit ihren jeweiligen Datumsangaben sehen?
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 Dateisystem Die Karte wandelt die Ordner auf Ihrem Computer oder Ihrer Dateifreigabe in SQL-Tabellen um, die Ihre Dateien beschreiben: Name, Pfad, Größe und Datum sowie Änderungsverlauf und Ordnergrößen. Sie indiziert ausschließlich Metadaten und liest keine Dateiinhalte. Daher ist sie kein Dateileser wie der Referenzdateisystemserver von Anthropic, und Claude kann damit keine Dateien öffnen, ändern oder löschen. Sie verweisen den Agenten auf Ordner anstatt auf einen Datenbankserver, und er erstellt und aktualisiert die Tabellen selbstständig.
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
-
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. Dateisystem 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\sharestattdessen 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.
- Es gibt kein Tabellenname Feld. Das Dateisystem erstellt nur die Inventartabellen.
- Legen Sie pro Zeile einen Ordner ab. StammverzeichnisseDie Pfade befinden sich auf dem Agentencomputer. Geben Sie eine Netzwerkfreigabe ein als
\\server\share\foldernicht als zugeordneter Laufwerksbuchstabe wie Z:, da der Agent als Dienst ausgeführt wird und beim Anmelden keine zugeordneten Laufwerke sehen kann. - Muster einbeziehen beginnt als
**/*.csvFügen Sie für jeden Dateityp, den Sie auflisten möchten, ein Muster hinzu und verwenden Sie es. Ausschlussmuster für alles, was Sie weglassen möchten. - An ÜberprüfenDer Agent liest eine Stichprobe und zeigt an, wie viele Ordner erreichbar sind, wie viele Dateien übereinstimmen und wie groß diese insgesamt sind. Es wird noch nichts erstellt.
-
Schau dir an, welche Tabellen du erhältst
Das Dateisystem besitzt keine Datentabelle. Alles befindet sich in einem einzigen Schema namens
DateisatzDiese Daten speichert der Agent auf seinem Computer zwischen und aktualisiert sie bei jedem Scan. Claude sieht die integrierten Beschreibungen für jede dieser Tabellen, ohne dass eine semantische Intelligenzanalyse durchgeführt werden muss.Tisch Was es enthält fileset.filesEine Zeile pro Datei, die derzeit vorhanden ist: relativer Pfad,Name,Verlängerung,Größe_Bytes,erstellt_utc,modifiziert_utcundEigentümer(Nur für Windows).fileset.files_eventsDer Änderungsverlauf. Jede Zeile enthält eine Ereignistypwie zum Beispiel erschienen, verändert oder verschwunden, die Zeit inevent_atund der vorherigen Größe.fileset.directoriesEine Zeile pro Ordner mit Dateianzahl, Teilbaum-Bytes, älteste und neueste Datei und einGrund für Überspringenwenn ein Ordner nicht gelesen wurde.fileset.directory_snapshotsEs wird maximal ein Größen-Snapshot pro Ordner und Tag erstellt, damit Sie sehen können, welche Ordner wachsen. Dateiensätze.VolumesKapazität und freier Speicherplatz jedes Laufwerks, mit Kapazität_Bytesundfreie Bytes.Jeder Ordnerverbinder liefert Claude außerdem dieselben Buchhaltungstabellen, alle im
DateisatzSchema:Tisch Was 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 inevent_atund der Grund dafürDetail.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 _Quelldateium Dateien zu vergleichen. -
Verbinde dich mit Claude
Öffnen Streams → Live → MCPEs gibt zwei Wege hinein, und sie enden am selben Ort:
Chat-Apps · keine Tasteclaude.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üsselClaude 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
- Öffnen Sie die Abfragestreams-Liste im Connectors Directory von Anthropic und klicken Sie VerbindenIn der Desktop-Umgebung befindet es sich dann unter + → Connectoren.
- 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. - 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.
- 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“:
Terminalclaude 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 BenutzerQuery Streams in jedem Projekt haben. Ausführen/mcpIm Claude-Code sehen Sie, ob die Verbindung besteht.Cursor Schlüssel
Öffnen Cursor-Einstellungen → MCP → Neuen MCP-Server hinzufügenoder bearbeiten
.cursor/mcp.jsonim 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ömeDas 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ömeEintrag in eine bereits vorhandene Konfigurationsdatei. Jeder Client, der MCP über HTTP unterstützt, funktioniert: Serverhttps://mcp.querystreams.com/mcp, KopfzeileX-MCP-Schlüssel(einAutorisierung: Inhaber(Auch eine Kopfzeile mit demselben Schlüssel funktioniert.) -
Stelle deine erste Frage
Beginnen Sie mit etwas, das Sie überprüfen können, indem Sie den Ordner öffnen, damit Sie sehen, wie Claude nach der richtigen Tabelle greift. Drei Optionen, die gut mit den Dateien und Ordnern auf Ihrem Computer oder Ihrer Dateifreigabe funktionieren:
- „Welche Dateitypen befinden sich in diesem Ordner und wie viel Speicherplatz belegt jeder Dateityp?“
- Claude liest die
fileset.filesschema (Lesen), dann wird eine Abfrage ausgeführt, die gruppiert nachVerlängerungund SummenGröße_Bytes(Abfragen ausführen). Sie erhalten die Anzahl und die Gesamtgröße pro Dateityp. - „Welche Ordner sind die größten und welche wurden übersprungen?“
- Claude fragt nach
fileset.directories(Abfragen ausführen), sortiert nachTeilbaum-Bytesund listet alle Ordner mit einem aufGrund für Überspringenwie zum Beispiel eine vergangene Maximale Tiefe. - „Was wurde in den letzten sieben Tagen aus der Aktie gelöscht?“
- Claude fragt nach
fileset.files_eventsfür verschwundene Zeilen, gefiltert und sortiert nachevent_at(Abfragen ausführen). Sie erhalten jede fehlende Datei und den Zeitpunkt, an dem der Scan sie festgestellt hat.
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.
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 Dateisystemdatei 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 das Dateisystem, 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 Dateisystem, sodass sich Ihr KI-Client auf die eigentliche Berechnung konzentrieren kann. Die kostenlose Version funktioniert wie gewohnt.
Kontextmanagement
Persönlicher Kern und darüber hinausGröß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 hinausA 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öherDaten 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.
| Erlaubnis | Werkzeuge |
|---|---|
| Lesen | qs_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) |
| Analysieren | qs_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ühren | qs_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.
| Stufe | Was Claude sieht | Ergebnis |
|---|---|---|
| Semantische Intelligenz | Beschreibungen für jede Tabelle und Spalte, Beispielwerte, Bedeutungen der Aufzählungszeichen, deklarierte und erkannte Joins. | Claude schreibt auf Anhieb das richtige Dateisystem-SQL und erklärt die Daten in Ihren Geschäftsbegriffen. |
| Erfasstes Schema | Tabellen- und Spaltennamen, Datentypen, Schlüssel. | Claude arbeitet, erschließt aber die Bedeutung aus den Namen und fragt möglicherweise nach. |
| Live-Schema | Die 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:
| Planen | Schlüssel pro Benutzer | Schlüssel pro Organisation | Anrufe pro Minute |
|---|---|---|---|
| Kostenlos | 1 | 1 | 30 |
| Persönlicher Kern | 1 | 1 | 60 |
| Personal Plus | 1 | 1 | 90 |
| Kerngeschäft | 2 | 3 | 120 |
| Business Plus | 3 | 5 | 150 |
| Business Max | 5 | 10 | 240 |
| Enterprise Core | 5 | 25 | 300 |
| Enterprise Plus | 8 | 50 | 450 |
| Enterprise Max | 10 | 100 | 600 |
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 findet auf dem Computer statt, auf dem der Agent ausgeführt wird, bevor Ihre Dateisystemdatei die SQL-Anweisungen sieht. Daher kann nichts, was Ihr KI-Client schreibt, die Daten verändern.
Keine Anmeldeinformationen in der KI
Die Dateisystemanmeldung bleibt auf dem Agenten. Claude verfügt über einen Abfragestream-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
- Ordner auf Änderungen überwachen Wenn Sie möchten, dass neue Dateien innerhalb von Sekunden auf einer lokalen Festplatte angezeigt werden.
- Fragen Sie nach der Aktualität der Daten. Claude antwortet aus dem neuesten
last_seen_utcInfiles_currentund die neuestenevent_atInDateien_Ereignisse. - Lesen Sie den vollständigen Leitfaden zum Dateisystem bei Indizieren Sie ein Dateisystem und fragen Sie es mit SQL ab. für jede Einstellung.
Wenn etwas nicht funktioniert
| Was Sie sehen | Was es bedeutet | Fix |
|---|---|---|
| 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 401 | Es 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_DISABLED | Ein Administrator hat MCP für Ihren Benutzer deaktiviert. | Bitten Sie sie, die MCP unter wieder einschalten Konto → Zugriffskontrolle. |
MCP_SCOPE_REQUIRED oder MCP_SCOPE_DENIED | Der 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_EXCEEDED | Das 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_REGISTERED | Der Agent, dem Ihre Dateisystemdatei gehört, ist momentan nicht verbunden. | Öffnen Daten → Datenagenten und starten Sie den Agenten auf seinem Computer. |
MCP_DATABASE_NOT_CAPTURED | Die 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_LIMITED | Zu 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_LARGE | Die 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_EXHAUSTED | Das 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_INCLUDED | Ihr 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_EXPIRED | Das 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_BUDGET | Der 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_DEAKTIVIERT | Die 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_REJECTED | Eine 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_OLD | Der 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 Lesepflicht | Die SQL-Anweisung war keine SELECT-Anweisung. | Das ist so beabsichtigt. Über MCP werden keine Daten geschrieben. |
Fragen, die Menschen stellen
Kann der Dateisystem-Connector den Inhalt meiner Dateien lesen?
Nein. Es werden Pfad, Name, Größe, Datum und Änderungshistorie jeder Datei protokolliert. Der Dateiinhalt wird nicht gelesen. Um die Zeilen in CSV-, Parquet-, Excel- oder SQLite-Dateien abzufragen, fügen Sie die entsprechende Ordnerkarte im selben Ordner hinzu.
Wie schnell sieht Claude eine neue oder gelöschte Datei?
Nach dem nächsten Scan überprüft der Agent den Ordner auf dem Scanintervall, standardmäßig stündlich. Ordner auf Änderungen überwachen (nahezu in Echtzeit) Reagiert innerhalb von Sekunden auf lokalen Festplatten und arbeitet nach bestem Bemühen auf Netzwerkfreigaben. Claude antwortet mit dem Ergebnis des letzten Scans und kann keinen neuen starten.
Kann ich eine Netzwerkfreigabe oder einen synchronisierten OneDrive-Ordner indizieren?
Ja. Geben Sie auf einem Windows-Agenten die Freigabe wie folgt ein: \\server\share\folderFalls nur namentlich genannte Personen zugelassen werden, klicken Sie auf Dienstidentität im Ordner Berechtigung Spalte und speichern Sie ein Login für diesen Server (Schritt für SchrittUnter Linux oder einem Mac werden die im Portal gespeicherten Anmeldedaten nicht verwendet: Binden Sie die Freigabe zuerst unter /mnt oder /media unter Linux ein (Wie) oder unter /Volumes auf einem Mac (WieEin synchronisierter Ordner funktioniert nur, wenn seine Dateien auf dem Computer gespeichert sind. Stellen Sie ihn daher entsprechend ein. Dieses Gerät immer eingeschaltet lassen.
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.
Verwandte Leitfäden
Jeder Leitfaden für File System
Nicht ganz Ihre Konfiguration?
- Benötigen Sie die Daten in den Dateien, nicht nur die Liste? Wählen Sie die Karte für Ihren Dateityp, z. B. CSV-Ordner oder Excel-Ordner → Wie man einen Ordner mit Dateien abfragt
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?


