Maschinenprotokolle → Claude · mit Query Streams
Mit Query Streams können Sie Claude in einfachem Deutsch Fragen zu Ihrer Maschinenprotokolldatei stellen: Der Agent, der sich bereits in Ihrem Netzwerk befindet, führt SQL schreibgeschützt aus, und kein Datenbankpasswort gelangt jemals zur KI. Die Einrichtung dauert etwa zehn Minuten und ist im kostenlosen Tarif enthalten.
Kostenlos starten
Was am Ende dabei herauskommt
Ein Agent namens Claude kann Fragen zu Ihren CNC-, SPS- und Robotersteuerungs-Protokollen beantworten. Er führt Live-Abfragen im Nur-Lese-Modus über die Tabellen durch, die er 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 befindet sich bereits in Ihrem Netzwerk, liest den Ordner und sendet nur die Zeilen zurück. Sobald der Agent installiert ist, dauert die Verbindung zu Claude etwa 90 Sekunden, wenn Sie mit der Konfigurationsoberfläche vertraut sind. So geht's:
Welche Alarme haben die Maschinen diese Woche am längsten lahmgelegt?
Claude liest die Struktur von fileset.alarms Zuerst wird dann eine SELECT-Abfrage über Ihren Agenten ausgeführt, gefiltert nach dieser Woche und sortiert nach Dauer_Sekunden, längste zuerst.
| Code | Schwere | Dauer_Sekunden |
|---|---|---|
| SV0401 | FEHLER | 2710 |
| OT0500 | FEHLER | 1325 |
| EX1015 | WARNUNG | 640 |
Claude antwortet anhand der beim letzten Scan des Agenten zwischengespeicherten Zeilen. Die Alarmtabelle existiert nur, wenn Ihr Protokolltyp sie erstellt. Überprüfen Sie daher das Profil, bevor Sie Fragen zu Zyklen oder OEE stellen.
Welche Maschine verliert die meiste Zeit durch Alarme, und verschlimmert sich die Situation von Woche zu Woche?
Ich habe zusammengefasst Dauer_Sekunden In fileset.alarms pro Maschine für diese und die letzte Woche, dann wurde der jeweils häufigste Alarmcode jeder Maschine ermittelt:
| Maschine | Diese Woche gesunken | Letzte Woche | Top-Alarm |
|---|---|---|---|
| CNC-07 | 4 Std. 12 Min. | 1 Std. 50 Min. | SV0401 Servoüberlastung |
| CNC-03 | 1 Std. 05 Min. | 1 Std. 10 Min. | Werkzeugwechsel EX1010 |
| CNC-12 | 0 h 40 m | 0 h 35 m | PS0100 Tür offen |
CNC-07 hat sich mehr als verdoppelt, und 80 % seiner Ausfallzeiten sind SV0401 Die Bewegung erfolgt jedes Mal auf derselben Z-Achse, und zwar in längeren Abschnitten täglich. Das deutet auf einen defekten Servo hin, nicht auf einen Bedienungsfehler. Die anderen beiden funktionieren einwandfrei.
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.
Die Karte „Maschinenprotokolle“ liest die Protokolldateien Ihrer CNC-Steuerungen, SPSen und Roboter und wandelt jedes Ereignis in eine Zeile um, die Claude abfragen kann. Anstelle eines Servers geben Sie dem Agenten einen Protokollordner auf einem Computer an, der diesen öffnen kann. Die Dateien werden während ihrer Entwicklung überwacht, und rotierte Dateien werden erkannt, sodass sie nicht doppelt gelesen werden. Einige Maschinenprofile erstellen außerdem Alarm-, Zyklus- und Ausfallzeittabellen.
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. Maschinenprotokolle 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.
Wähle deinen Protokolltyp aus der Liste. Die Maschinenprofile sind festgelegt. Nur die Benutzerdefinierter Protokollordner Mit dieser Karte können Sie Ihr eigenes Format definieren. Unter der Liste steht: „Benötigen Sie einen Protokolltyp, der nicht aufgeführt ist? Eröffnen Sie eine Supportanfrage, und wir fügen ihn innerhalb weniger Tage hinzu.“ Tabellenname ist optional und hat den Standardwert
Veranstaltungen. Nachfüllung (Tage) ist 30, daher geht der erste Messwert 30 Tage zurück. ÜberprüfenDer Agent liest eine Beispieldatei des ausgewählten Protokolltyps und zeigt die Dateien, deren Größe und die zu erstellenden Tabellen an. Stimmen die Dateien nicht überein, erscheint die Überschrift „Diese Dateien sind nicht …“ gefolgt vom Protokolltyp. Wählen Sie einen anderen Typ und klicken Sie auf … Testen Sie erneut. -
Schau dir an, welche Tabellen du erhältst
Geparste Zeilen landen in
Veranstaltungenoder dem von Ihnen festgelegten Tabellennamen. Jede Zeile enthältEreigniszeit, die IdentitätsspalteMaschine(Roboterfür Roboterprofile) und die Spalten des von Ihnen gewählten Protokolltyps. Die abgeleiteten Tabellen existieren nur für Profile, die sie deklarieren.Tisch Was es enthält VeranstaltungenEine Zeile pro analysiertem Protokollereignis, mit Ereigniszeit,event_time_raw,Maschine, die Spalten des Profils,_Quelldateiund_line_no.Ereignisse_RohlinienZeilen, die nicht analysiert werden konnten, wurden beibehalten Linieund einGrundwie z. B. keine Grammatikübereinstimmung oder undekodierbar.Alarm,Zyklen,SchichtenWird nach jeder Synchronisierung aus den Ereignissen neu erstellt, für Profile, die diese deklarieren. Leerlaufintervalle,oee_inputsAusfallzeiten und OEE-Eingaben werden für Profile, die diese deklarieren, nach jeder Synchronisierung neu erstellt. Dateien,Dateien_EreignisseDie Protokolldateien und deren Verlauf, einschließlich rotierter, überschriebener und abgeschnittener Ereignisse. log_cursorsDie Leseposition und der Status jeder Datei. Eine reservierte Datei zeigt den Status „geparkt“ mit der entsprechenden Begründung an. letzter Fehler.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 davon funktionieren gut mit Ihren CNC-, SPS- und Robotersteuerungsprotokollen:
- „Welche Maschinenprotokolldateien liest der Agent, und wann sind diese zuletzt gewachsen?“
- 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 hat jede Maschine gestern pro Stunde protokolliert?“
- Claude gruppiert fileset.events nach Maschine und Stunde des Ereigniszeitpunkts und gibt eine kleine Tabelle zurück.
- „Zeig mir die Zeilen, die nicht analysiert werden konnten, gruppiert nach Grund.“
- Claude zählt die Zeilen in events_raw_lines nach Grund und zeigt für jeden Grund einige Beispielzeilen an.
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 Maschinenprotokolldatei 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 Maschinenprotokolle, 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 Maschinenprotokolldatei, 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 die richtigen SQL-Anweisungen für die Maschinenprotokolle 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 erfolgt auf dem Computer, auf dem der Agent ausgeführt wird, bevor die SQL-Anweisungen in Ihrer Maschinenprotokolldatei erscheinen. Daher können die Daten durch keine Änderungen Ihres KI-Clients verändert werden.
Keine Anmeldeinformationen in der KI
Die Anmeldeinformationen für die Maschinenprotokolle bleiben auf dem Agenten erhalten. Claude verfügt über einen Schlüssel bzw. eine Verbindung für Abfragestreams, 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 Der Konnektor sorgt dafür, dass Claude verständliche Beschreibungen Ihrer Spalten erhält. Die Dateitabellen enthalten bereits integrierte Beschreibungen.
- Ereignisse für N Tage festlegen Wenn Sie alte Ereignisse entfernen möchten: Maschinenprotokolle behalten standardmäßig alles bei.
- Öffnen Sie den Dateidialog des Konnektors. Um jede einzelne Protokolldatei einzusehen und zu erfahren, warum bestimmte Dateien beiseitegelegt wurden, wird dieser Konnektor in der Konnektorliste unter „Protokolldateien“ angezeigt.
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 Maschinenprotokolldatei 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
Wie schnell werden neue Logzeilen angezeigt?
Neue Zeilen werden bei jedem Scan erfasst, standardmäßig stündlich. ScanintervallEine halb geschriebene letzte Zeile wartet auf den nächsten Scan. Der erste Lesevorgang geht 30 Tage zurück, festgelegt durch Nachfüllung (Tage)und liest maximal 64 MiB pro Datei. Claude sieht die Daten des letzten Scans.
Welche Maschinenprofile erstellen Alarm-, Zyklus- und OEE-Tabellen?
MTConnect SHDR und das Syslog der CNC-Steuerung erstellen alle fünf abgeleiteten Tabellen. Haas, Okuma, Mitsubishi und einige andere Hersteller erstellen nur Alarme. Die Telemetrie von SPS-Schlüssel=Wert erstellt keine Tabellen. Falls ein Protokolltyp fehlt, öffnen Sie eine Supportanfrage.
Was geschieht mit Zeilen, die nicht geparst werden können?
Sie werden aufbewahrt in Ereignisse_Rohlinien Die ursprüngliche Zeile und eine Begründung, z. B. „Keine Grammatikübereinstimmung“, „Nicht dekodierbar“ oder „Nul-Bytes“, werden zurückgegeben. Es werden keine Elemente verworfen. Eine hohe Anzahl deutet in der Regel auf einen Fehler hin. Protokolltyp wurde ausgewählt.
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 Machine Logs
Nicht ganz Ihre Konfiguration?
- Ist Ihr Protokollformat nicht eines der vordefinierten Protokollformate? Mit dem benutzerdefinierten Protokollordner können Sie das Format selbst definieren → Custom Logs
- Handelt es sich hier um CutRite-Teilelisten und Schnittmuster oder um Maschinenausgaben? Mehrfach-CSV-Dateien lesen diese ein → Multi-record
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?


