Połącz swój system plików z Claude za pomocą MCP

System plikówBezpłatny planStrumienie zapytańKlaudiusz

System plików → Claude · z Query Streams

Za pomocą Query Streams możesz zadawać Claude pytania o plik w systemie plików zwykłym językiem: Agent działający już w Twojej sieci wykonuje zapytania SQL tylko do odczytu, a hasło do bazy danych nigdy nie trafia do AI. To zajmie około dziesięciu minut, a bezpłatny plan w zupełności wystarczy.

Zacznij za darmo

Co z tego wyjdzie?

Claude, który może odpowiadać na pytania dotyczące plików i folderów na Twoim komputerze lub w udziale plików za pomocą zapytań w czasie rzeczywistym, tylko do odczytu, na tabelach tworzonych przez Agenta z Twoich plików, i informować Cię, z którego pliku pochodzi każda odpowiedź — bez konieczności logowania się do konta ani sprawdzania ścieżki dostępu 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

Które pliki w fileset.files uległy ostatnio zmianie i jak duże są?

qs_get_table_schema qs_run_query inteligencja_schematu

Oto trzy ostatnio modyfikowane pliki w Twoich folderach. Skoroszyt na zamknięcie kwartału został zmieniony wczoraj późnym popołudniem.

ścieżka_względna	rozmiar_bajtów	zmodyfikowany_utc
Finanse/2026/zamknięcie III kw.	482113	2026-09-25 17:42:10
Contracts/Acme-renewal-2026.pdf	1893402	2026-09-25 14:05:37
Raporty/tygodniowe/podsumowanie-operacji-w39.docx	96120	2026-09-25 09:18:54

Chcesz, żebym pokazał, które foldery najbardziej się rozrosły w tym miesiącu? migawki katalogów?

Które foldery rozrosły się najbardziej w tym miesiącu i czy jest coś nietypowo dużego?

qs_run_query qs_run_query

Czytam katalogi zestawu plików dla rozmiaru według folderu, następnie zestaw_plików.pliki dla najnowszego pliku w każdym z nich. Oba zapytania były tylko do odczytu:

ścieżka	akta	rozmiar	najnowszy plik
Eksport/dziennie	27	10,8 GB	2026-09-27 03:10
Finanse/2026	412	2,1 GB	2026-09-27 17:42
Zdjęcia/wizyty na miejscu	1,930	6,4 GB	2026-09-19 08:55

Eksport/dziennie To jest to, na co warto zwrócić uwagę: 27 kopii tego samego zrzutu o rozmiarze 400 MB, jedna na noc, i nic nie usuwa starych. Finanse rosną tak, jak można się spodziewać. Chcesz zobaczyć dziesięć największych plików w sekcji Eksporty wraz z datami?

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.

Ten System plików Karta przekształca foldery na komputerze lub w udziale plików w tabele SQL, które opisują pliki: każdą nazwę, ścieżkę, rozmiar i datę, a także historię zmian i rozmiary folderów. Indeksuje jedynie metadane plików i nie odczytuje ich zawartości, więc nie jest czytnikiem plików, takim jak serwer referencyjnych systemów plików Anthropic, a Claude nie może otwierać, zmieniać ani usuwać plików za jego pośrednictwem. Wystarczy wskazać agentowi foldery zamiast serwera bazy danych, a on sam tworzy i odświeża tabele.

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ę System plików 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. System plików buduje tylko tabele inwentarzowe.
   • Umieść jeden folder w każdym wierszu Foldery główneŚcieżki znajdują się na komputerze agenta. Wpisz udział sieciowy jako \\serwer\udział\folder, a nie jako zamapowana litera dysku, np. Z:, ponieważ Agent działa jako usługa i nie widzi zamapowanych dysków podczas logowania.
   • Uwzględnij wzorce zaczyna się jako **/*.csv. Dodaj wzorce dla każdego typu pliku, który chcesz uwzględnić na liście i użyj Wyklucz wzorce na wszystko, co chcesz pominąć.
   • NA SprawdzaćAgent odczytuje próbkę i pokazuje, ile folderów jest dostępnych, ile plików pasuje i jaki jest ich całkowity rozmiar. Nic jeszcze nie zostało utworzone.

2. Zobacz, jakie stoły otrzymasz

   System plików nie ma tabeli danych. Wszystko znajduje się w jednym schemacie zwanym zestaw plików, które Agent buforuje na swoim komputerze i odświeża przy każdym skanowaniu. Claude widzi wbudowane opisy dla każdej z tych tabel bez uruchamiania Inteligencji Semantycznej.

   Tabela	Co zawiera
   zestaw_plików.pliki	Jeden wiersz na każdy plik, który obecnie istnieje: ścieżka_względna, nazwa, rozszerzenie, rozmiar_bajtów, created_utc, zmodyfikowany_utc oraz właściciel (Tylko system Windows).
   zestaw_plików.zdarzenia_plików	Historia zmian. Każdy wiersz ma typ_wydarzenia takie jak pojawiły się, zmieniły się lub zniknęły, czas w wydarzenie_wi poprzedni rozmiar.
   katalogi zestawu plików	Jeden wiersz na folder z liczbą plików, poddrzewo_bajtów, najstarszy i najnowszy plik oraz powód_pominięcia gdy folder nie został odczytany.
   zbiór_plików.katalog_migawki	Maksymalnie jedna migawka rozmiaru dla każdego folderu na dzień, dzięki czemu można zobaczyć, które foldery się rozrastają.
   zbiór_plików.woluminy	Pojemność i wolna przestrzeń każdego dysku, z pojemność_bajtów oraz wolne_bajty.

   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 współpracują z plikami i folderami na Twoim komputerze lub w udziale plików:

   „Jakie rodzaje plików znajdują się w tym folderze i ile miejsca zajmują poszczególne typy plików?”

   Claude czyta zestaw_plików.pliki schemat (Odczyt), a następnie uruchamia jedno zapytanie, które grupuje według rozszerzenie i sumy rozmiar_bajtów (Uruchom zapytania). Otrzymasz liczbę i całkowity rozmiar dla każdego typu pliku.

   „Które foldery są największe, a które zostały pominięte?”

   Claude pyta katalogi zestawu plików (Uruchom zapytania), sortuje według poddrzewo_bajtów i wyświetla wszystkie foldery z powód_pominięcia, takie jak jedno z przeszłości Maksymalna głębokość.

   „Co zostało usunięte z udziału w ciągu ostatnich siedmiu dni?”

   Claude pyta zestaw_plików.zdarzenia_plików dla wierszy, które zniknęły, filtrowanych i sortowanych według wydarzenie_w (Uruchom zapytania). Otrzymasz każdy brakujący plik i informację o tym, kiedy skanowanie go wykryło.

   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 w systemie plików, więc Twój klient AI skupia się na myśleniu. 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

• Włącz opcję Obserwuj folder pod kątem zmian jeśli chcesz, aby nowe pliki pojawiały się na dysku lokalnym w ciągu kilku sekund.
• Zapytaj o aktualność danych. Claude odpowiada z najnowszego ostatnio_widziany_utc W pliki_bieżące i najnowsze wydarzenie_w W pliki_wydarzenia.
• Przeczytaj cały przewodnik po systemie plików Na Indeksowanie systemu plików i wykonywanie zapytań 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 systemu plików
• Łączenie strumieni zapytań z Claude za pośrednictwem MCP: konfiguracja, uprawnienia i rozwiązywanie problemów
• Wszystkie przewodniki MCP