Połącz folder plików JSONL z Claude za pomocą MCP

Folder JSONLBezpłatny planStrumienie zapytańKlaudiusz

Folder JSONL → Claude · z Query Streams

Dzięki Query Streams możesz zadawać Claude pytania prostym językiem o plik z folderu JSONL: Agent działający już w Twojej sieci wykonuje zapytanie SQL tylko do odczytu, a hasło do bazy danych nigdy nie trafia do AI. Zajmuje to około dziesięciu minut, a bezpłatny plan w zupełności wystarczy.

Zacznij za darmo

Co z tego wyjdzie?

Claude, który potrafi odpowiadać na pytania dotyczące folderu plików JSON za pomocą zapytań w czasie rzeczywistym, tylko do odczytu, na tabelach tworzonych przez Agenta z Twoich plików, i wskazywać, z którego pliku pochodzi każda odpowiedź — bez konieczności logowania się do konta ani ścieżki dostępu do pliku i bez zmiany zapory sieciowej: Agent, który jest już w Twojej sieci, odczytuje folder i odsyła tylko wiersze. Po uruchomieniu Agenta połączenie z Claude zajmuje około 90 sekund, jeśli nie przeszkadza Ci ekran ustawień. Na przykład:

Claude · połączony z Query Streams Tylko do odczytu

U których klientów wczoraj wystąpiło zdarzenie checkout_failed i w którym pliku ono wystąpiło?

qs_get_table_schema qs_run_query inteligencja_schematu

Claude czyta strukturę zestaw_plików.zdarzenia Najpierw, aby wiedzieć, które spłaszczone kolumny istnieją. Następnie uruchamia jedno zapytanie SELECT przez agenta, filtrując je według typ_wydarzenia i wczorajsza data.

_plik_źródłowy	typ_wydarzenia	customer_id
eksporty/2026-09-25/web-01.jsonl	kasa_nieudana	C-104482
eksporty/2026-09-25/web-02.jsonl	kasa_nieudana	C-099317
eksporty/2026-09-25/web-02.jsonl	kasa_nieudana	C-110206

Każdy wiersz zawiera nazwę pliku źródłowego, dzięki czemu możesz otworzyć plik i samodzielnie sprawdzić wiersz. Claude odpowiada na podstawie wierszy, które Agent zbuforował podczas ostatniego skanowania.

Jak wygląda sytuacja z kasami w tym tygodniu? Czy sytuacja się pogarsza i dla kogo?

qs_run_query qs_run_query

policzyłem rozpoczęte_wymeldowanie przeciwko kasa_nieudana dziennie w zestaw_plików.zdarzenia, a następnie pogrupował dzisiejsze porażki według dostawca płatności oraz kod błędu:

Dzień	Kasy	Przegrany	Wskaźnik
25 września	41,200	1,236	3.0%
26 września	39,880	1,596	4.0%
27 września	22,410	2,017	9.0%

Sytuacja szybko się pogarsza. Dzisiejsze 9% to prawie wyłącznie jeden dostawca: 1840 z 2017 awarii to Cardco z 3ds_timeout, począwszy od 06:40. Pozostali dostawcy mają standardową stawkę 3%. To problem dostawcy, a nie Twojej płatności.

Tylko SELECT, sprawdzane przez Agenta zalogowano na karcie Aktywność MCP Zwrócono 6 wierszy w 3 zapytaniach

A może w ogóle nie podłączać klienta AI? W planie biznesowym Nova to asystent wbudowany w Query Streams. Korzysta z tego samego zestawu narzędzi agenta, co Twój klient AI, a dodatkowo z tego, czego nie robi klient zewnętrzny: tworzy i weryfikuje kod SQL w oparciu o model inteligencji semantycznej, przekształca odpowiedź w wykres i zapisuje wynik jako zapytanie, które Twój zespół może uruchomić z poziomu Excela, Arkuszy Google lub interfejsu REST API — bez klucza, bez konektora i bez instalacji. Użyj MCP, gdy Twoi pracownicy korzystają już z Claude, Cursor lub ChatGPT; użyj Nova, gdy chcesz uzyskać odpowiedzi w Portalu.

Łącznik JSONL Folder umożliwia przeglądanie i wyszukiwanie plików JSONL z poziomu Claude bez konieczności otwierania przeglądarki JSONL. Wystarczy wskazać folder z plikami JSON Lines, a każdy wiersz stanie się wierszem, a zagnieżdżone obiekty zostaną spłaszczone do kolumn. Nie ma dostępu do serwera bazy danych. Agent odczytuje folder na własnym komputerze i buforuje wiersze w postaci tabeli SQL, do której Claude wysyła zapytania za pośrednictwem MCP.

Czego będziesz potrzebować

Konto Query Streams

MCP jest dostępny w każdym planie, w tym w planie darmowym. Plan darmowy obejmuje jeden klucz lub jedną powiązaną aplikację, czyli wszystko, czego potrzebujesz w tym przewodniku. Zarejestruj się na my.querystreams.com.

Agent na komputerze, który może otworzyć folder

Wersja 2.6.0 lub nowsza. Folder może znajdować się na tym komputerze lub w udziale plików, do którego ma dostęp. Agent działa jako usługa, więc wpisz „shares” jako \\serwer\udział\folder, a nie jako zmapowana litera dysku. W systemie Windows można zalogować się do udziału za pomocą przechowywanego loginu; w systemie Linux lub Mac należy najpierw zamontować udział (Linux pod /mnt lub /głoska bezdźwięczna, Mac pod /Kłęby). Nowość u agenta? Zainstaluj w systemie Windows, macOS lub Linux.

MCP włączony dla Ciebie

Twórcy, właściciele i administratorzy mają to od samego początku. Wszyscy inni potrzebują administratora, żeby to zmienić. MCP przełącznik obok ich imienia pod Konto → Kontrola dostępuDo tego czasu na stronie MCP będzie widniał komunikat „MCP jest wyłączony dla Twojego konta”.

Klient AI

Claude w wersji webowej, Claude Desktop lub aplikacje mobilne Claude łączą się bez użycia klucza. Działają również Claude Code, Cursor, ChatGPT i około dziesięciu innych narzędzi; Portal ma gotowy przepis na każde z nich.

Skonfiguruj w czterech krokach

1. Wskaż agenta na folder

   W portalu otwórz Dane → Agenci danych, znajdź agenta, który może otworzyć folder i kliknij jego Dodaj złącze przycisk. Pod Pliki i foldery kliknij pigułkę Folder JSONL Karta. Następnie kreator przeprowadzi Cię przez Lornetka składana, Sprawdzać, Ustawienia, Królestwo oraz Recenzja:

   Lornetka składana

   Wpisz Foldery główne, po jednym w każdym wierszu, jako ścieżki na komputerze Agenta. Skanuj podfoldery jest włączony, Maksymalna głębokość wynosi 8. Uwzględnij wzorce zaczyna się od właściwego globu dla tego typu pliku; dodaj Wyklucz wzorce Jeśli folder zawiera pliki, których nie chcesz. Zmapowana litera dysku wyświetla bursztynowy komunikat: Agent jej nie widzi, więc użyj \\serwer\udział zamiast tego ścieżka.

   Sprawdzać

   Agent odczytuje próbkę do 64 plików i pokazuje, co zbuduje. Nic jeszcze nie zostało utworzone. Gotowy do stworzenia oznacza, że każdy próbkowany plik pasuje. Bursztynowy baner z informacją „{n} z {m} plików zostanie odłożonych” wyświetla listę plików, które nie pasują Pokaż, które pliki i dlaczego; możesz utworzyć łącznik i tak, a następnie naprawić go później. Jeśli folder zawiera różne układy, niebieski panel oferuje Przełącz się na jedną tabelę na układ.

   Ustawienia

   Interwał skanowania (domyślnie co godzinę, od co 5 minut do codziennie) określa częstotliwość, z jaką Agent sprawdza nowe, zmienione i zniknięte pliki. Obserwuj folder pod kątem zmian reaguje w ciągu kilku sekund na dyskach lokalnych. Kiedy plik znika Jest Upuść jego wiersze domyślnie.

   Realm, Recenzja

   Wybierz obszar danych, do którego mają być przypisane wiersze, sprawdź podsumowanie i kliknij Utwórz łącznik. Pierwsze skanowanie rozpoczyna się natychmiast; złącze Oczywisty Karta pokazuje, co zostało zbudowane i jakie pliki zostało odłożone.

   • Wpisz Nazwa tabeli, Na przykład wydarzenia. Jest to wymagane na tej karcie.
   • Spłaszcz głębokość Ustawia liczbę poziomów zagnieżdżonych obiektów, które stają się kolumnami. Wartość domyślna to 2, a zakres wynosi od 1 do 8.
   • Wyjechać Układ tabeli NA Jeden przypięty układ (domyślny) dla eksportów cyklicznych. Wybierz Jeden stół na układ dla folderów wypełnianych ręcznie.
   • NA SprawdzaćAgent odczytuje próbkę do 64 plików i wyświetla liczbę plików, rozmiar, szacunkową liczbę wierszy oraz tabelę, którą utworzy. Nic jeszcze nie zostało utworzone. Jeśli pliki mają różne kształty, panel informuje, że folder zawiera kilka różnych układów plików. Kliknij Przełącz się na jedną tabelę na układ aby nadać każdemu kształtowi własną tabelę.

2. Zobacz, jakie stoły otrzymasz

   Otrzymujesz jedną tabelę nazwaną przez Nazwa tabeli piszesz na przykład zestaw_plików.zdarzenia. Zagnieżdżone obiekty stają się kolumnami aż do Spłaszcz głębokość, a wszystko głębsze jest przechowywane jako tekst JSON. Każdy wiersz zawiera _plik_źródłowy, dzięki czemu zawsze będziesz wiedział, z którego pliku pochodzi.

   Tabela	Co zawiera
   wydarzenia (nazwa Twojej tabeli)	Jeden wiersz na linię JSON z każdego dopasowanego pliku, spłaszczony do głębokości spłaszczenia, plus _plik_źródłowy oraz _id_wiersza.
   Jeden stół na układ	Z Jeden stół na układKażdy odrębny kształt ma własną tabelę, nazwaną na podstawie wspólnej części nazw plików. Do 25 układów.
   akta	Każdy znaleziony plik nadal znajduje się w folderze, ze ścieżką dostępu, rozmiarem i czasem modyfikacji.
   pliki_wydarzenia	Historia zmian: pliki, które się pojawiły, zostały zmodyfikowane i zniknęły, a także wiersze dryfujące i odrzucone dla plików, które się nie zmieściły. Sortuj według wydarzenie_w.
   katalogi	Liczba i rozmiary plików dla każdego folderu w katalogu głównym.

   Każdy łącznik folderów zapewnia Claude'owi te same tabele księgowe, wszystkie w zestaw plików schemat:

   Tabela	Co zawiera
   akta	Każdy plik aktualnie znajdujący się w folderze: ścieżka, nazwa, rozszerzenie, rozmiar, czas utworzenia i modyfikacji. Zapytaj: „Co jest w tym folderze?”, a Claude to przeczyta.
   pliki_wydarzenia	Historia zmian: jeden wiersz na plik, który się pojawił, został zmodyfikowany, zniknął lub został odłożony (dryf), z czasem w wydarzenie_w i powód w szczegół.
   katalogi, kłęby	Rozmiary i liczba folderów oraz dyski lub udziały, na których są przechowywane.
   _plik_źródłowy, _id_wiersza	Dwie kolumny w każdym wierszu danych: z którego pliku pochodzi wiersz i identyfikator stabilnego wiersza w tym pliku. Grupuj według _plik_źródłowy aby porównać pliki.

3. Połącz Claude'a

   Otwórz Transmisje strumieniowe → Na żywo → MCPIstnieją dwie drogi dojazdowe, które kończą się w tym samym miejscu:

   Aplikacje do czatów · bez klucza

   claude.ai, Claude Desktop, ChatGPT

   W claude.ai i Claude Desktop otwórz Lista strumieni zapytań w katalogu złączy Anthropic kliknij Łączyć i zatwierdź. Dodając go przez adres URL, https://mcp.querystreams.com/mcp, to rozwiązanie awaryjne. W ChatGPT dodajesz strumienie zapytań z aplikacji (na razie w trybie programistycznym) i logujesz się za pomocą strumieni zapytań. W obu przypadkach otworzy się strona strumieni zapytań: wybierz organizację i uprawnienia, a następnie kliknij Zatwierdź połączenie. Nic do kopiowania. Połączenie pojawia się na Połączenia kartę i można ją tam odwołać.

   Narzędzia programistyczne · klucz

   Claude Code, Cursor, VS Code i przyjaciele

   Na stronie MCP kliknij Połącz klienta AIPrzewodnik pyta W jaki sposób połączy się Twój klient AI?: wybierać Użyj klucza w pliku konfiguracyjnym, wybierz swoje narzędzie, a następnie Wygeneruj klucz dla to: a Nazwa klucza, Czytać oraz Uruchom zapytania zaznaczone, Wygaśnięcie (Nigdy, 30 dni, 90 dni lub 1 rok). Skonfiguruj to pokazuje fragment kodu z wypełnionym kluczem i Sprawdź połączenie czeka na pierwsze połączenie.

   Obie metody wykorzystują te same trzy uprawnienia, które wybierasz na ekranie zgody lub za pomocą klucza:

   Czytać

   Wyświetlaj łączniki, przeglądaj tabele i kolumny, odczytuj zapisane zapytania i reguły alertów. Nigdy nie zwraca danych wierszowych.

   Uruchom zapytania

   Uruchom zapytania SQL tylko do odczytu i zapisane zapytania za pośrednictwem agenta i zwróć wiersze. Bez tego klient AI może opisać dane, ale nie może na nie odpowiedzieć.

   Analizować

   Twórz profile tabel, odkrywaj relacje i dodawaj do kolejki uruchomienie Semantic Intelligence. Profilowanie i odkrywanie są bezpłatne; uruchomienie Semantic Intelligence zużywa kredyty Nova AI i limit danych, dlatego na ekranie zgody ta opcja nigdy nie jest zaznaczona domyślnie.

   Zgubiłeś klucz? Jest on wymieniony na Połączenia patka: Pokaż pełny klucz pokazuje to ponownie i Skopiuj pełny klucz Kopiuje go. Cofnij go tam, jeśli laptop zginie; każdy klient, który go używa, straci połączenie przy następnym połączeniu, w ciągu około pięciu minut.

   Następnie wybierz przepis na Claude'a, którego używasz. Adres serwera jest wszędzie taki sam: https://mcp.querystreams.com/mcp.

   Claude w sieci, Claude na komputerze i urządzeniu mobilnym bez klucza

   1. Otwórz Lista strumieni zapytań w katalogu złączy Anthropic i kliknij Łączyć. Na pulpicie znajduje się pod + → Konektory.
   2. Rozwiązanie awaryjne, jeśli Twoja organizacja ukrywa łączniki katalogowe: Ustawienia → Łączniki → Dodaj niestandardowy łącznik, nazwa Strumienie zapytań, adres URL https://mcp.querystreams.com/mcp, Pola OAuth puste, Dodaj; następnie na czacie + → Strumienie zapytań → Łączyć.
   3. Otworzy się karta „Strumienie zapytań”. Zaloguj się, jeśli zostaniesz o to poproszony, wybierz organizację i sprawdź Czytać oraz Uruchom zapytania, opcjonalnie Ogranicz do określonych złączyi kliknij Zatwierdź połączenie.
   4. W Claude widzisz „Połączono ze strumieniami zapytań”. Za pierwszym razem, gdy Claude używa narzędzia, pojawia się pytanie: wybierz Zawsze pozwalaj.

   Jeśli dodasz go ręcznie w Claude Desktop, użyj Ustawienia → Łączniki → Dodaj, nie na czacie Dodaj rynek Opcja, która oczekuje repozytorium Git. Konektory synchronizują się z kontem Claude, więc aplikacje mobilne i pulpit automatycznie je wychwytują. Nazwy menu są Anthropic i można je przenosić.

   Kod Claude'a klawisz

   Jedno polecenie z kluczem z zakładki Połączenia:

   Terminal

   claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp \ --header "Klucz X-MCP: qsmcp_WKLEJ_TUTAJ_SWÓJ_KLUCZ"

   To pisze obecny projekt .mcp.json. Dodać --scope użytkownik mieć strumienie zapytań w każdym projekcie. Uruchom /mcp wewnątrz Claude Code, aby zobaczyć połączenie.

   Kursor klawisz

   Otwórz Ustawienia kursora → MCP → Dodaj nowy serwer MCPlub edytuj .kursor/mcp.json u podstaw Twojego miejsca pracy:

   .kursor/mcp.json

   { "mcpServers": { "querystreams": { "url": "https://mcp.querystreams.com/mcp", "headers": { "Klucz X-MCP": "qsmcp_WKLEJ_TUTAJ_SWÓJ_KLUCZ" } } } }

   Uruchom ponownie kursor lub uruchom MCP: Uruchom ponownie serwery; A strumienie zapytań Odznaka pojawia się na pasku stanu MCP.

   Używasz czegoś innego? Portalu Połącz klienta AI przewodnik zawiera gotowe do wklejenia przepisy dla ChatGPT, VS Code, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev i JetBrains AI, a także Wklej i scal narzędzie, które upuszcza strumienie zapytań wpis do pliku konfiguracyjnego, który już posiadasz. Każdy klient obsługujący protokół MCP przez HTTP działa: serwer https://mcp.querystreams.com/mcp, nagłówek Klucz X-MCP (jakiś Autoryzacja: Posiadacz nagłówek z tym samym kluczem również działa).

4. Zadaj swoje pierwsze pytanie

   Zacznij od czegoś, co możesz sprawdzić, otwierając folder, tak aby Claude sięgnął po odpowiednią tabelę. Trzy, które dobrze działają z folderem plików JSON:

   „Które pliki JSONL uległy zmianie w ciągu ostatniego dnia?”

   Claude sprawdza w plikach fileset.files, czy znajdują się w nich informacje o ścieżce względnej (relative_path), rozmiarze (size_bytes) i zmodyfikowanym adresie UTC (modified_utc), przy czym najnowsze są pierwsze.

   „Ile zdarzeń każdego typu zdarzenia miało miejsce w ciągu dnia w tym tygodniu?”

   Claude grupuje tabelę danych według dnia i typu zdarzenia. Pola zagnieżdżone są już kolumnami, więc można je filtrować bezpośrednio.

   „Czy jakieś pliki JSONL zostały odłożone i dlaczego?”

   Claude odczytuje dryf i odrzuca wiersze w files_events, przy czym najnowszy event_at jest pierwszy, i nadaje nazwę każdemu plikowi oraz powód jego utworzenia.

   Aby potwierdzić okablowanie, zapytaj „Jakie mam łączniki Query Streams?”. Claude dzwoni qs_list_connectors, przewodnik po portalu Sprawdź połączenie krok mówi Połączonyi klucz lub aplikację na Połączenia karta pokazuje swoje Ostatnio używane w ciągu kilku sekund.

Dostęp do pliku w udziale sieciowym

Agent otwiera pliki jako usługa w tle, a nie jako użytkownik, więc otwieranie plików na innym komputerze wymaga wykonania jednego dodatkowego kroku. Który krok zależy od komputera, na którym działa Agent.

Jeżeli test nie może dotrzeć do udziału, w jego wynikach poszukaj następujących słów: nieosiągalny oznacza, że komputer agenta nie otrzymał odpowiedzi z serwera. W systemie Linux lub Mac, nie zamontowano oznacza, że udział nadal musi zostać zamontowany, a ta wiadomość zawiera dokładne polecenie montowania dla Twojego serwera.

Jak wyświetlają się nowe, zmienione i usunięte pliki

Co Claude może zrobić po połączeniu

Twój klient AI widzi narzędzia Query Streams i wybiera odpowiednie dla Twojego pytania. Portal Narzędzia zakładka zawiera listę wszystkich narzędzi i trybów dostępnych w ramach Twojego planu. Query Streams prosi klienta AI o odczytanie kolumn każdej tabeli przed wykonaniem zapytania, dzięki czemu używa prawdziwych nazw zamiast zgadywać. W każdym planie, także Free:

Zestaw narzędzi analitycznych. W planach płatnych Agent wykonuje pracę przygotowawczą, w której znajduje się plik folderu JSONL, dzięki czemu klient AI koncentruje się na procesie myślowym. Wersja darmowa działa tak jak zawsze.

Domyślne ustawienia są dostępne na Kontekst zakładka: limit liczby komórek tekstowych, widok schematu, rozmiar wyniku, domyślne ustawienia analizy i wstrzymane wyniki.

Dlaczego inteligencja semantyczna ma tu znaczenie

Każda odpowiedź, którą otrzymuje Claude, jest oznaczona informacją o źródle struktury, a Claude dostosowuje stopień zaufania do tego, co widzi.

Jeśli baza danych ma znaczenie, uruchom na niej inteligencję semantyczną raz Nova → Inteligencja. Ten Połączenia Karta pokazuje panel pokrycia dla każdego złącza. Jak działa inteligencja semantyczna.

Co pozwalają plany

Usługa MCP jest dostępna w każdym planie, w tym w planie darmowym, bez dodatkowych opłat. Każdy plan określa liczbę kluczy lub podłączonych aplikacji, które możesz przytrzymać, oraz liczbę połączeń na minutę, jakie może wykonać Twój klient AI:

Połączona aplikacja jest liczona jako klucz. Oprócz liczby zapytań na minutę, każdy klucz może wykonać maksymalnie 10 zapytań na minutę. Zapytanie trwa do 60 sekund, chyba że klient AI poprosi o więcej, maksymalnie pięć minut. Plan określa również liczbę wierszy zwracanych przez jedno zapytanie oraz, za pomocą zestawu narzędzi analitycznych, czas trwania i rozmiar przechowywanego wyniku. pełny przewodnik MCP wyświetla wszystkie plany. To, co otrzymuje Twój klient AI, jest wliczane do limitu Data Realm, czyli tej samej puli, z której korzystają zapytania Excel i Sheets: użycie agenta AI (MCP) obejmuje każdy bajt dostarczony do klienta AI — wyniki, odczyty schematu i strony z zatrzymanymi wynikami — przed kompresją transportową uzgodnioną przez klienta. W przypadku zapytań arkuszy kalkulacyjnych liczony jest skompresowany wynik dostarczony przez agenta Network Agent. Uruchomienia Semantic Intelligence rozpoczęte z poziomu klienta AI zużywają kredyty Nova AI, tak samo jak uruchomienia z poziomu Portalu. Zobacz stronę z cennikiem za dodatki.

Dbanie o bezpieczeństwo

Dobre następne ruchy

• Uruchom inteligencję semantyczną na złączu, aby Claude mógł uzyskać opisy kolumn w języku potocznym. Tabele plików zawierają już wbudowane opisy.
• Skróć interwał skanowania Jeśli nowe pliki pojawiają się często. Agent domyślnie sprawdza folder co godzinę.
• Przeczytaj cały przewodnik po folderach JSONL W Przekształć folder plików JSON w tabele SQL do każdego ustawienia.

Kiedy coś nie działa

Pytania, które zadają ludzie

Powiązane przewodniki

• Połącz folder plików CSV z Claude za pomocą MCP
• Połącz folder plików Excel z Claude za pomocą MCP
• Połącz folder baz danych SQLite z Claude za pomocą MCP
• Połącz folder plików Parquet z Claude za pomocą MCP
• Przewodnik po łączniku folderu JSONL
• Łączenie strumieni zapytań z Claude za pośrednictwem MCP: konfiguracja, uprawnienia i rozwiązywanie problemów
• Wszystkie przewodniki MCP