Połącz strumienie zapytań z Claude i zadawaj pytania dotyczące swoich baz danych prostym językiem. Claude odczytuje schemat, zapisane zapytania i model Schema Intelligence na żywo, uruchamia SQL tylko do odczytu za pośrednictwem agenta sieciowego i nigdy nie widzi hasła do bazy danych. Ten przewodnik obejmuje claude.ai, Claude Desktop i Claude Code, a także każdego innego klienta MCP.
Wersja skrócona. Query Streams is in the Anthropic Connectors Directory. In claude.ai open Settings → Connectors → Browse connectors, znajdować Strumienie zapytań, kliknij Łączyć, zatwierdź uprawnienia na ekranie zgody na strumienie zapytań i zapytaj Claude’a „Do jakich baz danych mam dostęp?” That’s it.
Zanim zaczniesz
Potrzebne są cztery rzeczy. Większość kont ma już pierwsze trzy.
Plan obejmujący MCP
MCP jest dostępne w każdym planie, również w planie darmowym. W zależności od planu zmienia się liczba klawiszy lub podłączonych aplikacji, które można przytrzymać, oraz liczba połączeń, jakie Claude może wykonać na minutę. Plan darmowy obejmuje jeden klawisz lub jedną podłączoną aplikację i 30 połączeń na minutę.
Agent sieciowy, który jest online
Agent to niewielka usługa, która działa obok Twojej bazy danych i nawiązuje jedno połączenie wychodzące do strumieni zapytań. Jeśli Twój zespół uruchamia już zapytania w Portalu, Excelu lub Arkuszach Google, jest ona zainstalowana. Instrukcja instalacji →
Co najmniej jedno złącze
Łącznik to baza danych lub źródło API zarejestrowane w Portalu. Claude widzi każdy łącznik widoczny dla Twojego konta, zgodnie z przyznanymi przez Ciebie uprawnieniami.
Dostęp MCP na Twoim koncie użytkownika
Twórcy i właściciele organizacji automatycznie uzyskują dostęp do MCP. Inni użytkownicy potrzebują uprawnień administratora, aby to zaznaczyć. MCP obok ich imienia w Konto → Kontrola dostępu.
Jak to działa
Claude nigdy nie łączy się z bazą danych. Komunikuje się z serwerem MCP Query Streams w naszej chmurze, który przekazuje każde żądanie przez pojedyncze połączenie wychodzące, które Twój Agent Sieciowy już utrzymuje otwarte. Agent uruchamia zapytanie lokalnie i przesyła strumieniowo wiersze w ten sam sposób. Żądania i wyniki przepływają w obu kierunkach przez ten jeden kanał inicjowany przez agenta, więc nic nie musi być otwierane na Twojej zaporze sieciowej.
OAuth, zakresy, audyt, limity szybkości
jedno połączenie wychodzące TLS
Z tego projektu wynikają trzy właściwości:
- Brak danych uwierzytelniających w Claude. Twój ciąg połączenia z bazą danych znajduje się na agencie. Claude posiada jedynie autoryzację OAuth lub klucz MCP, które możesz cofnąć w Portalu jednym kliknięciem.
- Tylko do odczytu, egzekwowane przez agenta. Tylko
SELECT,ZorazWYJAŚNIĆAkceptowane są oświadczenia. Kontrola odbywa się po Twojej stronie połączenia, a nie w chmurze ani w Claude. - Wszystko jest rejestrowane. Każde wywołanie narzędzia pojawia się na stronie MCP Działalność karta i każde zapytanie w Historii zapytań, przypisane użytkownikowi, który się połączył.
Połącz Claude'a
Istnieją dwa sposoby. Aplikacje do czatów korzystają z protokołu OAuth i nie potrzebują klucza. Narzędzia programistyczne korzystają z klucza MCP. Oba korzystają z tego samego serwera i tych samych narzędzi.
Opcja A: claude.ai i Claude Desktop (OAuth, bez klucza)
Listed in the Anthropic Connectors Directory. Query Streams is an approved connector: claude.ai/directory/query-streams. On claude.ai and in Claude Desktop you can connect it with one click from Przeglądaj złącza; no server URL needed. The custom-connector route below still works and is what to use if your Claude organization restricts directory connectors.
- NA claude.ai Otwarte Settings → Connectors → Browse connectors, wyszukaj Strumienie zapytań i kliknij Łączyć (or open the directory listing directly). In Claude Desktop the same option is under Ustawienia → Złącza. Can’t see it? Your organization may restrict directory connectors: click Dodaj niestandardowy łącznik instead, name it Strumienie zapytań and paste
https://mcp.querystreams.com/mcp. - Otwórz dowolny czat, kliknij + przycisk przy polu wiadomości, wybierz Strumienie zapytań i kliknij Łączyć.
- Nowa karta przeglądarki otwiera ekran zgody na strumienie zapytań. Zaloguj się, jeśli zostaniesz o to poproszony, wybierz organizację, sprawdź uprawnienia (patrz poniżej) i kliknij Zatwierdź połączenie.
- Wrócisz do Claude'a i zobaczysz Połączono ze strumieniami zapytań. Za pierwszym razem, gdy Claude używa narzędzia, prosi o pozwolenie. Wybierz Zawsze pozwalaj dzięki czemu może działać bez konieczności wyświetlania komunikatu przy każdym połączeniu.
Łącznik jest powiązany z Twoim kontem Claude, a nie z jednym urządzeniem, więc automatycznie pojawia się w aplikacjach mobilnych Claude i Claude Desktop. Możesz nim zarządzać lub go anulować w dowolnym momencie z poziomu Portalu. MCP → Połączone aplikacje patka.
Nie to samo co „Dodaj rynek”. W Claude Desktop czat w trakcie rozmowy + → Przeglądaj złącza → Dodaj rynek Opcja wymaga repozytorium Git dla sklepów z wtyczkami, a nie adresu URL serwera MCP. Użyj Ustawienia → Łączniki → Dodaj.
Opcja B: Claude Code, Cursor i inne narzędzia programistyczne (klucz MCP)
Narzędzia programistyczne uwierzytelniają się za pomocą klucza generowanego w Portalu i przekazywanego Klucz X-MCP chodnikowiec.
- Zaloguj się na my.querystreams.com, otwarty MCP → Moje klucze i kliknij Wygeneruj klucz. Nazwij go na cześć narzędzia i maszyny, np. claude-code-laptopi wybierz jego zakresy.
- Skopiuj klucz teraz. Możesz go później wyświetlić i skopiować ponownie z Moje klucze. Klucze wyglądają jak
qsmcp_po których następują 43 znaki. - W przypadku kodu Claude'a uruchom:
claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp --header "Klucz X-MCP: qsmcp_WKLEJ_KLUCZ_TUTAJ" - W przypadku Cursor, VS Code, Windsurf, Zed, JetBrains, Gemini CLI, Codex CLI, Continue i Cline otwórz MCP → Połącz w Portalu. Pokazuje gotową do wklejenia konfigurację dla każdego klienta z już wypełnionym kluczem.
Aby zweryfikować, zapytaj „Jakie mam łączniki Query Streams?” Klient powinien zadzwonić qs_list_connectors i klucz ostatnio używany czas aktualizuje się w ciągu kilku sekund na karcie Moje klucze.
Uprawnienia
Niezależnie od tego, czy łączysz się przez OAuth, czy za pomocą klucza, dostęp jest kontrolowany przez trzy zakresy. Wyświetlają się one na ekranie zgody; na ich podstawie tworzony jest klucz.
| Zakres | Co potrafi Claude | Kiedy to przyznać |
|---|---|---|
| Czytać | Wyświetl listę łączników i agentów, przeglądaj schematy, czytaj opisy Schema Intelligence, wyświetlaj listę zapisanych zapytań i reguł alertów. | Zawsze. Wszystko inne na tym bazuje. |
| analizować | Profiluj tabele (wartości próbek, dystrybucje, typy semantyczne), odkrywaj niejawne relacje i kolejkuj przebiegi Schema Intelligence. | Zalecane. To pozwala Claude'owi zrozumieć kształt danych przed napisaniem łączeń. |
| wykonać | Uruchamiaj zapytania SQL tylko do odczytu, zapisuj zapytania i przesyłaj strumieniowo wiersze. | Dla każdego, kto potrzebuje odpowiedzi, nie tylko przeglądać strukturę. Zostaw to jako klucz tylko do przeglądania. |
Po zatwierdzeniu można ograniczyć dostęp do połączonej aplikacji do określonych łączników; wygenerowany klucz dociera do każdego łącznika w organizacji. Cofnięcie zgody lub klucza następuje w ciągu około pięciu minut. Administratorzy widzą wszystkie aktywne zgody i klucze dla organizacji na stronie MCP.
Co Claude może zrobić po połączeniu
Claude widzi mały zestaw narzędzi. Nigdy nie dzwonisz do nich osobiście; Claude wybiera te właściwe do twojego pytania. Mówiąc wprost:
Zrozum swoje dane
Wyświetlaj łączniki, bazy danych i agentów. Odczytaj drzewo schematu dowolnej bazy danych z opisami tabel i kolumn, typami semantycznymi, wartościami przykładowymi, etykietami wyliczeniowymi oraz zadeklarowanymi i odkrytymi relacjami.
Profil i eksploracja
Profiluj tabelę, aby zobaczyć rzeczywiste rozkłady wartości przed napisaniem filtra. Odkryj połączenia między tabelami, które nie mają zadeklarowanych kluczy obcych.
Użyj zapisanych zapytań
Wyświetlaj zapisane, sparametryzowane zapytania swojej organizacji i uruchamiaj je z różnymi parametrami. Zapytania federacyjne obejmujące kilka źródeł są uruchamiane po stronie serwera i zwracają już połączone wiersze.
Uruchom ad-hoc SQL
Zapisuj i uruchamiaj zapytania SQL tylko do odczytu w odpowiednim dialekcie dla łącznika. Domyślnie wyniki obejmują 1000 wierszy i 60-sekundowy limit czasu, oba z możliwością regulacji.
Sprawdź alerty
Wyświetl listę reguł alertów, zobacz ich aktualny stan i ostatnie uruchomienia. Claude może zaproponować nową regułę w trybie próbnym; użytkownik uzbraja ją na stronie Alertów.
Ulepsz model
Sprawdź zasięg Schema Intelligence dla każdej bazy danych i po uzyskaniu Twojej zgody zakolejkuj analizę, aby przyszłe odpowiedzi były lepsze.
Dlaczego inteligencja schematów ma tu znaczenie
Każda odpowiedź, którą otrzymuje Claude, jest oznaczana informacją o tym, z którego z trzech poziomów pochodzi, a Claude może dostosować poziom zaufania do tego, co widzi.
| Szczebel | Co widzi Claude | Wynik |
|---|---|---|
| Schema Intelligence | Opisy każdej tabeli i kolumny, typy semantyczne, etykiety wyliczeniowe, wartości próbek, klasyfikacja faktów i wymiarów, zadeklarowane i odkryte połączenia. | Claude już przy pierwszej próbie pisze kod SQL o jakości produkcyjnej i objaśnia dane w języku biznesowym. |
| Przechwycony schemat | Nazwy tabel i kolumn, typy, klucze podstawowe, indeksy, zadeklarowane klucze obce. | Claude pracuje, ale musi wywnioskować znaczenie imion i może potrzebować dodatkowych pytań. |
| Schemat na żywo | Baza danych nie znajduje się w wyborze przechwytywania łącznika, więc struktura jest odczytywana na bieżąco z katalogu przy każdym żądaniu. | Zapytania nadal działają. Claude sprawdza próbki, gdy potrzeba więcej. |
Jeśli baza danych ma znaczenie dla Twojego zespołu, uruchom na niej Schema Intelligence raz. W przypadku dużych baz danych ogranicz zakres uruchomienia do tabel, z których faktycznie korzystają Twoje zapytania. Jak działa inteligencja schematów →
Przykładowe monity
Zacznij od czegoś, na co już znasz odpowiedź. Następnie zadawaj pytania uzupełniające; Claude trzyma się kontekstu.
Do jakich baz danych i tabel mam dostęp i które z nich obsługują Schema Intelligence?Mapuje Twoje łączniki i wskazuje, gdzie odpowiedzi będą najsilniejsze. Pokaż mi, jaki jest związek klientów z zamówieniami w bazie danych sprzedaży i jak wygląda kolumna ze statusem zamówienia.Wykorzystuje relacje i profilowanie kolumn. Claude pokaże Ci rzeczywiste kody statusu i ich znaczenie. Uruchom zapisane zapytanie „Miesięczne przychody według regionu” za drugi kwartał tego roku.Uruchamia zaufane zapisane zapytanie z parametrami zamiast wymyślać własne zapytanie SQL. 10 najlepszych produktów pod względem przychodów w ciągu ostatnich 90 dni. Następnie podziel je według kanału.Ad-hoc SQL w dialekcie łącznika, a następnie kontynuacja w tym samym wątku. Jakie reguły alertów są skonfigurowane i czy któraś z nich została uruchomiona w tym tygodniu?Odczytuje reguły alertów i ich ostatni stan.Wskazówki dotyczące lepszych odpowiedzi
- Użyj projektu Claude. Podłącz łącznik Query Streams do projektu i umieść swoje reguły biznesowe w instrukcjach projektu: która baza danych ma być używana domyślnie, które zapisane zapytania są oficjalnymi definicjami, konwencje nazewnictwa. Claude nadal czyta schemat na żywo, więc instrukcje są krótkie.
- Zapisz zapytania, które uważasz za kanoniczne. Claude najpierw sięga po zapisane zapytania, więc „aktywni klienci” oznaczają to, co rozumie Twój zespół.
- Przyznaj zakres analizy. Profilowanie kolumny przed filtrowaniem według niej stanowi różnicę między odgadnięciem kodu statusu a użyciem właściwego.
- Poproś o wykres. claude.ai renderuje wykresy na podstawie wierszy otrzymanych przez Claude'a.
Ile to kosztuje
Sam MCP nie pobiera osobnych opłat za żaden plan. Opłaty dotyczą dwóch rzeczy:
- Objętość danych. Wyniki zapytania zwrócone do Claude'a są liczone w tym samym budżecie obszaru danych, co Twój udział w korzystaniu z Excela, Arkuszy Google, Portalu i Novy. Ponieważ MCP działa przez HTTP bez kompresji end-to-end, jest mierzony w nieskompresowanych bajtach, więc wynik o rozmiarze 1 MB kosztuje około 1 MB, podczas gdy ten sam wynik w Excelu kosztuje zazwyczaj od 150 do 250 KB. Zachowaj
limit_podglądurozsądne w przypadku pytań eksploracyjnych. - Schemat Intelligence działa. Kolejkowanie analizy przez Claude obciąża Twoją organizację kredytami AI, tak samo jak uruchamianie jej z poziomu Portalu. Claude pyta, zanim to zrobi.
Rozwiązywanie problemów
| Co widzisz | Co to znaczy | Naprawić |
|---|---|---|
| Claude nie pokazuje żadnych narzędzi do obsługi strumieni zapytań | Łącznik został dodany, ale nie nawiązano połączenia za pośrednictwem czatu lub zatwierdzenie OAuth nie zostało nigdy ukończone. | Otwórz czat, kliknij +, wybierz Strumienie zapytań, Łączyći zakończ ekran zgody. |
WYMAGANY_KLUCZ_MCP lub 401 | Do serwera nie dotarł żaden klucz ani żaden grant. W przypadku klientów z kluczami jest to zazwyczaj błąd kopiuj-wklej, taki jak dodanie nowej linii na końcu lub umieszczenie klucza w niewłaściwym nagłówku. | Skopiuj klucz ponownie do Klucz X-MCP Nagłówek. W przypadku claude.ai połącz się ponownie z menu +. |
MCP_TOKEN_WYGASŁ | Token OAuth wygasł po okresie bezczynności. | Claude zazwyczaj odświeża się samoczynnie. Jeśli nie, odłącz i ponownie podłącz złącze. |
MCP_KEY_REVOKED lub MCP_USER_DISABLED | Klucz został odwołany lub dostęp do MCP został wyłączony dla Twojego użytkownika. | Wygeneruj nowy klucz lub poproś administratora o ponowne włączenie MCP Konto → Kontrola dostępu. |
WYMAGANY_ZAKRES_MCP | Najczęściej dotacja lub klucz nie obejmują zakresu tego działania wykonać. | Połącz się ponownie i zatwierdź brakujący zakres lub wygeneruj klucz, który go uwzględnia. |
MCP_PLAN_UPŁYNĄŁ | Subskrypcja Twojej organizacji wygasła. | Strona MCP w Portalu przedstawia aktualny stan planu i dalsze działania. |
MCP_AGENT_NIE_POŁĄCZONY | Agent sieciowy będący właścicielem łącznika nie jest obecnie połączony. | Sprawdzać Agenci danych w Portalu. Uruchom usługę agenta na jej hoście. |
Złącze MCP_NIE_dozwolone | Klucz jest ograniczony do konkretnych złączy i to nie jest jedno z nich. | Edytuj listę dozwolonych łączników klucza w Moich kluczach lub użyj innego klucza. |
BAZA_DANYCH_MCP_NIE_PRZECHWYCONA | Baza danych nie znajduje się w wyborze przechwytywania schematu przez konektor, więc nie ma możliwości odczytu danych Schema Intelligence ani zapisanych relacji. Zapytania nadal działają. | Dodaj bazę danych do wyboru przechwytywania w łączniku w Portalu, a następnie opcjonalnie uruchom Schema Intelligence. |
OGRANICZONA STAWKA_MCP | Zbyt duża liczba połączeń na minutę w stosunku do Twojego planu. | Zaczekaj chwilę. Intensywne sesje korzystają z funkcji Schema Intelligence, która pozwala Claude'owi odbierać połączenia w mniejszej liczbie przypadków. |
PRZEKROCZENIE_Limitu_zapytania_MCP | Zapytanie zostało wykonane po upływie limitu czasu, który domyślnie wynosi 60 sekund. | Poproś Claude'a o dodanie filtra lub obniżenie limitu wiersza lub podniesienie limit_czasu_sekund do 300. |
MCP_OUTPUT_TOO_LARGE | Wynik był zbyt duży, aby przekazać go Claude'owi w jednej odpowiedzi. | Poproś o mniej kolumn lub wierszy. Claude zazwyczaj sam to zasugeruje. |
| Naruszenie tylko do odczytu | W kodzie SQL znajdowało się coś innego niż SELECT, Z lub WYJAŚNIĆ. | Z założenia. Zapisy nigdy nie są akceptowane przez MCP. |
Nadal masz problem? Otwórz zgłoszenie na my.querystreams.com/support lub e-mail [email protected].
Bezpieczeństwo i prywatność
- Claude otrzymuje metadane schematu, opisy Schema Intelligence, w tym przykładowe wartości, oraz wyniki zapytań, o które prosisz. Wyniki te są przesyłane do wybranego przez Ciebie dostawcy sztucznej inteligencji, zgodnie z jego warunkami.
- Query Streams nie odbiera ani nie przechowuje konwersacji z Claude.
- Uprawnienia i klucze OAuth są przypisane do użytkownika i organizacji. Administrator może przeglądać i cofać wszystkie uprawnienia i klucze na stronie MCP.
- Pełne szczegóły znajdziesz w naszym Polityka prywatności oraz Warunki korzystania z usługi.
Często zadawane pytania
Czy muszę otworzyć port lub uruchomić sieć VPN?
Nie. Agent nawiązuje jedno połączenie wychodzące TLS na porcie 443. Jeśli połączenie wychodzące HTTPS działa, MCP działa.
Czy Claude może zmienić moje dane?
Nie. Agent akceptuje tylko polecenia odczytu. Claude może ustawić w kolejce uruchomienie Schema Intelligence i zaproponować regułę alertu w trybie próbnym; oba zapisują dane w metadanych strumieni zapytań, a nie w bazie danych.
Które inne narzędzia AI działają?
Wszystko, co obsługuje MCP: ChatGPT, Cursor, Claude Code, Windsurf, Zed, VS Code Copilot, JetBrains AI, Gemini CLI, Codex CLI, Continue, Cline i wiele innych. Strona MCP w portalu zawiera gotową konfigurację dla każdego z nich.
Czy działa z kilkoma organizacjami?
Każdy grant lub klucz jest przypisany do jednej organizacji. Połącz się raz dla każdej potrzebnej organizacji.
Jaka jest różnica między tym a Novą?
Nova to asystent wbudowany w portal Query Streams, który korzysta z tego samego modelu Schema Intelligence. Użyj Nova, gdy potrzebujesz odpowiedzi w Query Streams; użyj MCP, gdy chcesz, aby Twoje dane znajdowały się w Claude, obok wszystkich innych danych, które tam przetwarzasz.
Przewodniki dotyczące konkretnych złączy
Każdy przewodnik omawia te same powiązania, podając przykłady dla danego źródła.
Bazy danych: Microsoft SQL Server · PostgreSQL · MySQL · MariaDB · Oracle · Płatek śniegu · Google BigQuery · SQLite · Microsoft Access · DuckDB · Supabase
Pszczoła: Pasek · Shopify · HubSpot · Reklamy Google · Google Analytics 4 · Google Search Console · ShipStation · iTick
Foldery plików i dzienników (Agent skanuje folder i zamienia pliki na tabele): System plików · Folder CSV · Folder parkietowy · Folder Excela · Folder SQLite · Folder JSONL · Wielorekordowy plik CSV · Dzienniki maszynowe · Dzienniki serwera WWW · Dzienniki kontenerowe · Dzienniki aplikacji · Dzienniki systemowe · Niestandardowe dzienniki
Hostowane bazy danych (zarządzane PostgreSQL, MySQL, MariaDB i SQL Server, dostępne dla agenta przez TLS): Neon · Amazon RDS · Baza danych Azure dla PostgreSQL · Baza danych Azure dla MySQL · Azure SQL · Google Cloud SQL · Google AlloyDB · Zarządzane bazy danych DigitalOcean · Aiven · Chrupiący mostek · Heroku Postgres · Oddać · Kolej żelazna · Fly.io Postgres · Bazy danych zarządzane przez Vultr · Zarządzane bazy danych OVHcloud · Bazy danych zarządzane Scaleway · Baza danych OCI z PostgreSQL · Fala upałów MySQL · Bazy danych IBM Cloud dla PostgreSQL · MariaDB SkySQL · Xata · Chmura skali czasu · PlanetScale Postgres · Prisma Postgres · Koyeb · Nil
Podłącz Claude'a do swoich danych w około minutę
Bez klucza, pliku konfiguracyjnego i VPN. Tylko do odczytu.
Otwórz stronę MCP Jak działa MCP
English 
Spanish 
German 
French 
Portuguese 
Japanese 
Korean 
Chinese 
Italian 
Dutch 
Indonesian 
Polish