Połącz pliki CSV z wieloma rekordami z Claude za pomocą MCP

MCP · Wielorekordowy plik CSV do Claude'a

Zapytać Klaudiusz o Twoim pliku CSV z wieloma rekordami, po prostu po angielsku

Połącz Claude, Claude Code, Cursor lub dowolnego klienta MCP z Query Streams raz. Claude odczytuje strukturę pliku CSV z wieloma rekordami, zapisuje kod SQL, uruchamia go w trybie tylko do odczytu przez agenta, który już korzysta z Twoich danych, i odpowiada wierszami. Żadne hasło do bazy danych nigdy nie dociera do sztucznej inteligencji. Około dziesięciu minut, a plan darmowy to obejmuje.

Około 10 minut Claude, ChatGPT, Cursor + 11 innych klientów Plik pozostaje tam, gdzie jest Tylko do odczytu, zawsze

Co z tego wyjdzie?

A Claude that can answer questions about CSV files that mix several record types with live, read-only queries over the tables the Agent builds from your files, and tell you which file each answer came from — without ever seeing a login or a file path, and without a firewall change: the Agent already inside your network reads the folder and sends back only the rows. Once the Agent is in place, connecting Claude takes about 90 seconds if you are comfortable with a settings screen. Like this:

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

Wypisz nagłówki plików z tego tygodnia, zaczynając od najstarszych.

qs_get_table_schema qs_run_query inteligencja_schematu

Claude czyta strukturę zestaw_plików.data_hdr i widzi kolumny pozycyjne. Wykonuje jedną operację SELECT przez Twojego agenta i informuje, że odczytuje pole_1 jako numer partii i pole_2 jako data partii.

_plik_źródłowy	pole_1	pole_2
przychodzące/2026-09-21/partia_0917.csv	B-000917	2026-09-21
przychodzące/2026-09-23/partia_0918.csv	B-000918	2026-09-23
przychodzące/2026-09-25/partia_0919.csv	B-000919	2026-09-25

Kontynuuj linie szczegółów. Dołącza Claude dane_hdr do tabeli szczegółów na _plik_źródłowy oraz _sekw., na tym samym czacie.

Total each batch this week from its detail lines and flag any that do not match the header total.

qs_get_relationships qs_run_query qs_run_query

I joined dane_hdr do data_dtl NA _plik_źródłowy oraz _sekw., summed pole_4 on the details and compared it with the header’s pole_3:

Batch	Header total	Detail total	Match
B-000917	48,210.00	48,210.00	✓
B-000918	51,904.50	51,904.50	✓
B-000919	46,300.00	39,115.25	✗ −7,184.75

B-000919 is short by 7,184.75. Its last detail _sekw. is 214 while the header says 228 lines, so the file was cut off before the trailer. Worth re-requesting before it is invoiced.

Tylko SELECT, sprawdzane przez Agenta zalogowano na karcie Aktywność MCP 6 rows returned across 3 queries

Rather not wire up an AI client at all? On the Business plan, Nova is the assistant built into Query Streams itself. It has every tool Claude gets here, plus the ones Claude does not: it drafts and validates the SQL against your Schema Intelligence model, turns the answer into a chart, and saves the result as a query your team can run from Excel, Google Sheets or the REST API — no key, no connector, nothing to install. Use MCP when your people already live in Claude, Cursor or ChatGPT; use Nova when you want the answers inside the Portal.

Niektóre systemy zapisują pliki CSV, które łączą kilka typów rekordów w jednym pliku, na przykład wiersz nagłówka, wiersze szczegółów i zakończenie, każdy oznaczony tagiem w jednej kolumnie. Konektor Multi-record CSV dzieli je, dzięki czemu Claude może przeszukiwać każdy typ rekordu jak osobną tabelę. Nie ma potrzeby konfigurowania bazy danych. Agent odczytuje folder na swoim komputerze i buforuje wiersze w postaci tabel SQL.

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. Nowość w Agencie? 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ę Wielorekordowy plik CSV 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.

   • Nie ma Nazwa tabeli pole. Tabele są nazywane na podstawie tagów rekordu.
   • Ustawić Układ pliku, ten Kolumna znacznika rekordu (numer) który trzyma tag i Rozgranicznik.
   • Wybierać Zakres tabeliDomyślnie na każdy tag przypada jedna tabela. Jedna tabela na rozszerzenie pliku i tag zachowuje ten sam tag dla różnych typów plików.
   • Przed konfiguracją kreator informuje, że wszystkie dopasowane pliki muszą współdzielić jeden układ. Pierwsza synchronizacja przypina układ z próbki, a pliki, które później się nie zgadzają, są odkładane na bok i raportowane.
   • NA SprawdzaćAgent odczytuje próbkę i wyświetla listę tabel, które utworzy. Pliki, które zostaną odłożone, pojawiają się w sekcji Pokaż, które pliki i dlaczego.

2. Zobacz, jakie stoły otrzymasz

   Tabele są dla Ciebie nazywane, jedna na tag rekordu, np. dane_hdr dla tagu HDR. Kolumny są numerowane według pozycji, pole_1 do pole_N, bez kolumny tagów. Dołącz typy rekordów na _plik_źródłowy oraz _sekw..

   Tabela	Co zawiera
   dane_<znacznik>, Na przykład dane_hdr	Każdy wiersz z tym tagiem z każdego pliku, jako pole_1 do pole_N, plus _sekw., _plik_źródłowy oraz _id_wiersza.
   data_<rozszerzenie>_<znacznik>	To samo, podzielone również według rozszerzenia pliku, kiedy Zakres tabeli Jest Jedna tabela na rozszerzenie pliku i tag.
   akta	Każdy znaleziony plik nadal znajduje się w folderze, ze ścieżką dostępu, rozmiarem i czasem modyfikacji.
   pliki_wydarzenia	Historia zmian, w tym wiersze dryfu dla plików zarezerwowanych dla nieznanego tagu lub nieprawidłowej liczby kolumn. 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

   In Claude, Query Streams is in the Anthropic Connectors Directory: browse connectors, click Łączyć. Elsewhere you paste one address into the app, https://mcp.querystreams.com/mcpi połącz się z czatem. Otworzy się strona strumieni zapytań, wybierz organizację i uprawnienia, a następnie kliknij Zatwierdź połączenie. Nic do kopiowania, nic do zachowania w tajemnicy. Połączenie pojawia się pod Połączone aplikacje i tam może zostać odwołane.

   Narzędzia programistyczne · klucz

   Claude Code, Cursor, VS Code i przyjaciele

   NA Moje klucze trzask Wygeneruj klucz. Daj temu Nazwa klucza takie jak „Claude Code na moim laptopie”, zachowaj Czytać oraz Wykonać zaznaczone, wybierz Wygaśnięcie (Nigdy, 30 dni, 90 dni lub 1 rok) i kliknij Wygeneruj kluczSkopiuj to, a następnie Kontynuuj instalację:ten Łączyć Karta pokazuje dokładny fragment kodu dla Twojego narzędzia z już wypełnionym kluczem.

   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.

   Wykonać

   Uruchom zapytania SQL tylko do odczytu i zapisane zapytania przez agenta i zwróć wiersze. Bez tego Claude może opisać Twoje dane, ale nie może na nie odpowiedzieć.

   Analizować

   Profiluj tabele, odkrywaj relacje i kolejkuj przebiegi Schema Intelligence. Wykorzystuje kredyty Nova AI i limit danych, więc ekran zgody nigdy nie zaznacza go wstępnie.

   Zgubiłeś klucz? Otwórz Moje klucze:ikona oka 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 Ustawienia → Złącza i kliknij Przeglądaj złącza. Query Streams is listed in the Anthropic Connectors Directory: find Strumienie zapytań i kliknij Łączyć. (Or open the directory listing directly and click Łączyć there.)
   2. If your organization hides directory connectors, click Dodaj niestandardowy łącznik instead. Name it Strumienie zapytań, wklej https://mcp.querystreams.com/mcp, leave the OAuth fields empty, click Dodaj, then in any chat click + → Przeglądaj złącza → Strumienie zapytań → Łączyć.
   3. Otworzy się karta „Strumienie zapytań”. Zaloguj się, jeśli zostaniesz o to poproszony, wybierz organizację i sprawdź Czytać oraz Wykonać, 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.

   If you do add it by hand in Claude Desktop, use Ustawienia → Łączniki → Dodaj, nie na czacie Dodaj rynek option, which expects a git repository. Connectors sync to your Claude account, so the mobile apps and Desktop pick it up automatically. Menu names are Anthropic’s and can move.

   Kod Claude'a klawisz

   Jedno polecenie przy użyciu klucza z Moich Kluczy:

   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? Ten Łączyć zakładka 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 plikami CSV łączącymi kilka typów rekordów:

   „Które pliki pojawiły się dziś w folderze?”

   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.

   „Umieść nagłówek każdego pliku obok jego zwiastuna i pokaż oba.”

   Claude łączy data_hdr z tabelą trailer na _source_file i _seq i zwraca jeden wiersz na plik.

   „Czy jakieś pliki zostały odłożone z powodu nieznanego tagu lub nieprawidłowej liczby kolumn?”

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

   Aby potwierdzić okablowanie, zapytaj „Jakie mam łączniki Query Streams?”. Claude dzwoni qs_list_connectorsi dalej Moje klucze klucz jest Ostatnio używane Czas aktualizuje się co kilka sekund.

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

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

Claude widzi dziewiętnaście małych narzędzi. Nigdy nie dzwonisz do nich osobiście; Claude wybiera to właściwe do twojego pytania. Mówiąc wprost:

Dlaczego inteligencja schematów 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 raz Schema Intelligence Nova → Inteligencja. Ten Moje klucze Karta pokazuje panel pokrycia dla każdego złącza. Jak działa inteligencja schematów.

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ę klawiszy lub podłączonych aplikacji, które możesz przytrzymać, oraz liczbę połączeń, jakie Claude może wykonać na minutę:

Połączona aplikacja jest liczona jako klucz. Oprócz liczby za minutę, każdy klucz może wykonać maksymalnie 10 zapytań na minutę. Zapytanie zwraca do 1000 wierszy i trwa do 60 sekund, chyba że Claude poprosi o więcej, do limitu 50 000 wierszy i pięciu minut. Wiersze otrzymane przez Claude'a są wliczane do limitu Data Realm, tej samej puli, z której korzystają zapytania w Excelu i Arkuszach, a MCP jest mierzony przed kompresją, więc szeroki wynik kosztuje więcej niż te same wiersze w arkuszu kalkulacyjnym. Uruchomienia Schema Intelligence rozpoczynają się od kredytów Nova AI wydanych przez Claude'a, dokładnie tak samo jak w Portalu. Zobacz stronę z cennikiem za dodatki.

Dbanie o bezpieczeństwo

Dobre następne ruchy

• Uruchom inteligencję schematu więc Claude dowiaduje się, co pole_1 do pole_N oznacza w każdym typie rekordu. Tabele plików zawierają już wbudowane opisy.
• Sprawdź zdarzenia plików po pierwszej synchronizacji dowolnego pliku zarezerwowanego dla nieznanego tagu.
• Przeczytaj cały przewodnik dotyczący plików CSV z wieloma rekordami W Zapytaj o pliki CSV zawierające wiele rekordów za pomocą 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 Multi-record
• Łączenie strumieni zapytań z Claude za pośrednictwem MCP: konfiguracja, uprawnienia i rozwiązywanie problemów
• Wszystkie przewodniki MCP