Połącz dzienniki kontenera Docker z Claude za pomocą MCP

MCP · Logi kontenerowe do Claude'a

Zapytać Klaudiusz o pliku dzienników kontenerów, po prostu po angielsku

Połącz Claude, Claude Code, Cursor lub dowolnego klienta MCP z Query Streams raz. Claude odczytuje strukturę pliku dzienników kontenerów, 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 your Docker container logs 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 kontenery zapisały błędy do stderr w ciągu ostatniej godziny?

qs_get_table_schema qs_run_query inteligencja_schematu

Claude czyta kolumny zestaw_plików.zdarzenia najpierw. Następnie uruchamia jedno zapytanie, które zachowuje wiersze, gdzie strumień Jest stderr oraz czas_wydarzenia przypada na ostatnią godzinę, od najnowszych. Na szczególną uwagę zasługują trzy kontenery:

aplikacja	strumień	wiadomość
API kasy	stderr	BŁĄD wybierz tcp 172.18.0.4:5432: połącz: połączenie odrzucone
pracownik	stderr	redis.exceptions.TimeoutError: Przekroczono limit czasu odczytu z gniazda
serwer proxy nginx	stderr	[błąd] 29#29: *1184 przekroczono limit czasu połączenia (110: przekroczono limit czasu połączenia)

Interfejs API checkout-api utracił bazę danych, a serwer proxy przekroczył limit czasu oczekiwania na połączenie z serwerem. Poproś Claude'a o zliczenie wierszy stderr na kontener na minutę, aby sprawdzić, który z nich padł pierwszy. Odpowiedź dotyczy danych odczytanych przez agenta podczas ostatniego skanowania.

Is the checkout-api connection error new, and what else was happening at the same time?

qs_run_query qs_run_query

I counted API kasy stderr errors per hour in zestaw_plików.zdarzenia, and put the postgres oraz scheduler containers alongside for the same hours:

Hour	checkout-api errors	postgres restarts	scheduler warnings
12:00	0	0	0
13:00	412	1	9
14:00	1,880	2	31

New as of 13:07, and it is not checkout-api’s fault: every burst starts the minute postgres restarts, and postgres’s own last lines before each restart are out of memory. Fix the database container’s memory limit and the checkout errors go with it.

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.

Container Logs odczytuje pliki dziennika zapisywane przez Dockera dla każdego kontenera i przekształca każdy wiersz w wiersz w tabeli SQL, którą Claude może przeszukać. Nie jest to własny zestaw narzędzi MCP Dockera. Nie uruchamia ani nie zarządza kontenerami; odczytuje jedynie ich logi kontenerów Docker. Agent śledzi każdy plik w miarę jego wzrostu, rozpoznaje pliki rotowane, aby nic nie było odczytywane dwukrotnie, odczytuje każdy plik. .gz archiwizuje raz i uzupełnia ostatnie 30 dni przy pierwszym odczycie.

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ę Dzienniki kontenerowe 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.

   • Dodaj folder, w którym znajdują się dzienniki kontenerów Foldery główne. Uwzględnij wzorce zacząć jako **/*-json.log, **/*.dziennik oraz **/*.dziennik.*.
   • Wybierz Typ dziennikaKarta dostarcza plik Docker json, dzienniki dokera --znaczniki czasu eksport i Portainer.
   • Nazwa tabeli jest opcjonalny i domyślnie wynosi wydarzenia.
   • NA SprawdzaćAgent odczytuje próbkę i wyświetla liczbę plików, rozmiar, szacunkową liczbę wierszy oraz tabele, które zostaną utworzone. Nic jeszcze nie zostało utworzone. Jeśli pliki nie wyglądają na pliki o wybranym typie, nagłówek brzmi: Te pliki nie są a następnie ten typ i powód.

2. Zobacz, jakie stoły otrzymasz

   Przeanalizowane linie trafiają do zestaw_plików.zdarzenialub w Nazwa tabeli Wybrałeś. Agent przechowuje wiersze w lokalnej pamięci podręcznej na komputerze agenta i obsługuje je jako SQL. Każdy wiersz zawiera informację o pliku, z którego pochodzi. _plik_źródłowyPoniższe kolumny pochodzą z domyślnego typu dziennika pliku json Docker.

   Tabela	Co zawiera
   wydarzenia	Jeden wiersz na linię dziennika: czas_wydarzenia, aplikacja (nazwa kontenera), strumień oraz wiadomość, plus obraz, usługa_kompozycji oraz identyfikator_kontenera.
   wydarzenia_surowe_linie	Linie, które nie zostały przeanalizowane, zachowane w linia z powód jak na przykład brak dopasowania gramatycznego lub niemożliwy do rozszyfrowania. Nic nie jest upuszczane.
   akta	Każdy plik dziennika w folderze w tej chwili, z ścieżka_względna, rozmiar_bajtów oraz zmodyfikowany_utc.
   pliki_wydarzenia	Historia każdego pliku: pojawił się, zmodyfikowany, obrócony, kadłubowy oraz dryf rzędy, mierzone przez wydarzenie_w.
   kursory logu	Pozycja i stan odczytu każdego pliku. Plik odłożony pokazuje stan zaparkowany z powodem w ostatni_błąd.

   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 współpracują z logami kontenera Docker:

   „Które pliki dziennika kontenera czytasz i kiedy nastąpiła ostatnia zmiana?”

   Claude pyta zestaw_plików.pliki Do ścieżka_względna, rozmiar_bajtów oraz zmodyfikowany_utc, najnowsze na górze.

   „Ile linii stderr zapisał każdy kontener w ciągu ostatniej godziny?”

   Claude liczy rzędy w zestaw_plików.zdarzenia przez aplikacja Gdzie strumień jest stderr, filtrowany według czas_wydarzenia.

   „Czy dzisiaj dokonano rotacji lub odłożenia jakichkolwiek plików dziennika kontenerów?”

   Claude czyta zestaw_plików.zdarzenia_plików Do obrócony oraz dryf wiersze, uporządkowane według wydarzenie_wi nadaje nazwę każdemu plikowi.

   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

• Włącz opcję „Obserwuj folder pod kątem zmian” (w czasie zbliżonym do rzeczywistego) aby w ciągu kilku sekund wykryć nowe linie na dysku lokalnym. Zaplanowane skanowanie pozostaje gwarantowane.
• Ustaw opcję Zachowaj zdarzenia na N dni Aby kontrolować, ile historii pozostaje w pamięci podręcznej. Logi kontenerów są domyślnie przechowywane przez 30 dni.
• Otwórz okno dialogowe Pliki na złączu, aby zobaczyć każdy plik dziennika odczytywany przez Agenta i dlaczego każdy z nich jest odkładany.

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
• Łączenie strumieni zapytań z Claude za pośrednictwem MCP: konfiguracja, uprawnienia i rozwiązywanie problemów
• Wszystkie przewodniki MCP