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

MCP · Folder CSV do Claude'a

Zapytać Klaudiusz o Twoim pliku folderu CSV, po prostu po angielsku

Połącz Claude, Claude Code, Cursor lub dowolnego klienta MCP z Query Streams raz. Claude odczytuje strukturę pliku folderu CSV, 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 a folder of CSV files 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

Które pliki przesyłają dane do pliku fileset.sales i ile wierszy dodaje każdy z nich?

qs_get_table_schema qs_run_query inteligencja_schematu

Trzy pliki CSV zestaw_plików.sprzedażNajwiększy eksport miał miejsce we wrześniu i wyniósł nieco ponad 18 000 wierszy.

_plik_źródłowy	liczba_wierszy	identyfikator_pierwszego_wiersza
eksport/sprzedaż_2026_09.csv	18422	eksport/sprzedaż_2026_09.csv:0000000
eksport/sprzedaż_2026_08.csv	17305	eksport/sprzedaż_2026_08.csv:0000000
eksport/sprzedaż_2026_07.csv	16988	eksport/sprzedaż_2026_07.csv:0000000

Chcesz, żebym podsumował sprzedaż miesięczną we wszystkich trzech plikach?

Which regions grew the most this month against last month, and did anything drop?

qs_run_query qs_run_query

Every CSV is already one table, so I summed kwota przez region for each month straight from zestaw_plików.sprzedaż. Two read-only queries:

region	This month	Last month	Change
Zachód	412,300	348,900	+18%
Centrum	388,120	391,000	−1%
Wschód	201,450	262,800	−23%

Zachód is up on more orders, not bigger ones. Wschód fell 23%, and it is one account: Harbour Foods ordered every week last month and not once this month. Central is flat. Want the East orders by customer?

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.

Ten Folder CSV Karta scala każdy plik CSV w folderze w jedną tabelę SQL, którą Claude może przeszukiwać, i oznacza każdy wiersz plikiem, z którego pochodzi. Nie przesyłasz plików do czatu. Wystarczy raz wskazać folder agentowi, a on kopiuje wiersze do lokalnej pamięci podręcznej na swoim komputerze i utrzymuje aktualność tabeli w miarę napływania lub zmiany plików.

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ę Folder 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.

   • Wpisz Nazwa tabeli, Na przykład sprzedaż. Jest to wymagane na tej karcie.
   • Uwzględnij wzorce zaczyna się jako **/*.csv.
   • Wybierz Układ tabeli. Jeden przypięty układ (domyślny) nadaje się do cyklicznych eksportów, które mają jeden nagłówek. Jeden stół na układ pasuje do folderów składanych ręcznie, do 25 układów.
   • NA SprawdzaćAgent odczytuje próbkę i wyświetla liczbę plików, szacunkową liczbę wierszy oraz tabele, które utworzy. Jeśli folder zawiera różne układy, informuje o tym niebieski panel. Kliknij Przełącz się na jedną tabelę na układ.
   • Bursztynowy baner wyświetla listę plików, które zostaną odłożone. Otwórz Pokaż, które pliki i dlaczego aby zobaczyć przyczynę każdego z nich.

2. Zobacz, jakie stoły otrzymasz

   Wszystko siedzi w zestaw plików Schemat. Tabela danych przyjmuje nazwę, którą wpiszesz Nazwa tabeliJego kolumny pochodzą z nagłówka CSV, plus _plik_źródłowy oraz _id_wiersza w każdym rzędzie.

   Tabela	Co zawiera
   zestaw_plików.sprzedaż	Z Jeden przypięty układ, jedna tabela nazwana przez ciebie Nazwa tabeli, przechowujący wiersze każdego dopasowanego pliku CSV.
   zestaw_plików.orders, zestaw plików.zwraca	Z Jeden stół na układ, jedna tabela na układ, nazwana tak od wspólnej części nazw plików. zamówienia_2026_01.csv do zamówienia_2026_03.csv stać się zamówienia.
   zestaw_plików.pliki	Jeden wiersz na każdy aktualnie istniejący plik CSV, zawierający jego ścieżkę, rozmiar i czas modyfikacji.
   zestaw_plików.zdarzenia_plików	Historia zmian, w tym: dryf wiersz dla każdego odłożonego pliku z podanym powodem szczegół.

   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 sprawdzają się w przypadku folderu z plikami CSV:

   „Które pliki CSV znajdują się w folderze i kiedy każdy z nich został ostatnio zmieniony?”

   Claude pyta zestaw_plików.pliki (Wykonaj) i wyświetl każdy plik z rozmiar_bajtów oraz zmodyfikowany_utc, najnowsze na górze.

   „Zsumuj kwotę w kolumnie fileset.sales według miesiąca”.

   Claude najpierw odczytuje schemat tabeli, aby znaleźć prawdziwe nazwy kolumn (Read), a następnie uruchamia jeden program DuckDB GROUP BY za pośrednictwem swojego Agenta (Wykonaj). Otrzymasz małą tabelę z miesięcznymi sumami.

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

   Claude pyta zestaw_plików.zdarzenia_plików Do dryf oraz odrzucony wiersze, uporządkowane według wydarzenie_w (Wykonaj). Otrzymasz każdy plik i powód. szczegół.

   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 na łączniku, aby Claude widział opisy kolumn pliku CSV, a nie tylko tabel plików.
• Dodaj drugi łącznik w tym samym folderze jeśli zawiera również pliki Parquet lub Excel. Jeden łącznik odczytuje jeden typ pliku.
• Przeczytaj przewodnik po folderach CSV Na Połącz wiele plików CSV w jedną tabelę do każdego ustawienia.

Kiedy coś nie działa

Pytania, które zadają ludzie

Powiązane przewodniki

• 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
• Połącz folder plików JSONL z Claude za pomocą MCP
• Przewodnik po łączniku folderu CSV
• Łączenie strumieni zapytań z Claude za pośrednictwem MCP: konfiguracja, uprawnienia i rozwiązywanie problemów
• Wszystkie przewodniki MCP