Połącz strumienie zapytań z Claude i zadawaj pytania o swoje bazy danych prostym językiem. Claude odczyta Twój schemat, zapisane zapytania i… Inteligencja semantyczna Model na żywo, uruchamia SQL tylko do odczytu przez Agenta Sieciowego i nigdy nie widzi hasła do bazy danych. Twój klient AI pyta; Agent Sieciowy, jego partner w sieci, wykonuje większość pracy w miejscu przechowywania danych. Ten przewodnik obejmuje claude.ai, Claude Desktop, ChatGPT i Claude Code, a także każdego innego klienta MCP.
Wersja skrócona. Zainstaluj Agent sieciowy obok swojej bazy danych raz (kilka minut) i dodaj łącznik. Następnie otwórz Lista strumieni zapytań w katalogu złączy Anthropic kliknij Łączyć, zatwierdź uprawnienia na ekranie zgody na strumienie zapytań i zapytaj Claude’a „Do jakich baz danych mam dostęp?” Claude może widzieć tylko dane dostarczane przez Agenta: pomiń Agenta, a zostaniesz poinformowany, że nie ma żadnych łączników.
Zanim zaczniesz
Potrzebujesz czterech rzeczy. Jeśli znalazłeś Query Streams w Claude, to agent i łącznik to dwie rzeczy, które musisz jeszcze skonfigurować.
Plan obejmujący MCP
Usługa MCP jest dostępna w każdym planie, również w planie darmowym. Plan określa liczbę kluczy lub połączonych aplikacji, które możesz przechowywać, liczbę połączeń na minutę, jakie może wykonać Twój klient AI, liczbę wierszy zwracanych przez jedno zapytanie oraz to, czy zestaw narzędzi analitycznych jest dostępny. Co obejmuje każdy plan.
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 Query Streams. Nowe konto? Zainstaluj ją teraz z… my.querystreams.com/download, kilka minut na Okna, macOS lub LinuxJeśli Twój zespół już uruchamia zapytania w Portalu, programie Excel lub Arkuszach Google, aplikacja jest zainstalowana.
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 swojego klienta AI
Strona MCP w Portalu (Transmisje → Na żywo → MCP) ma cztery zakładki: Połączenia, Kontekst, Narzędzia i dla administratorów, Działalność. W przypadku połączeń Połącz klienta AI przycisk otwiera czteroetapowy przewodnik: W jaki sposób połączy się Twój klient AI?, Wybierz swojego klienta AI, Skonfiguruj to oraz Sprawdź połączenieIstnieją dwa sposoby. Aplikacje do czatów zatwierdzają z poziomu aplikacji i nie potrzebują klucza. Narzędzia programistyczne używają klucza MCP. Oba łączą się z tym samym serwerem i tymi samymi narzędziami.
Opcja A: claude.ai, Claude Desktop i ChatGPT (zatwierdzenie z poziomu aplikacji, bez klucza)
Znajduje się w katalogu Anthropic Connectors Directory. Query Streams jest zatwierdzonym łącznikiem: claude.ai/directory/query-streamsOtwórz ofertę i kliknij Łączyć i zatwierdź; adres URL serwera nie jest potrzebny. Dodanie go za pomocą adresu URL to rozwiązanie awaryjne dla organizacji Claude, które ograniczają łączniki katalogowe.
- Otwórz Lista strumieni zapytań i kliknij Łączy棹cznik synchronizuje się z Twoim kontem Claude, więc Claude Desktop wyświetla go w sekcji + → Złącza. Nie widzisz oferty? Twoja organizacja może ograniczyć łączniki katalogowe: Ustawienia → Złącza trzask Dodaj niestandardowy łącznik, nazwij to Strumienie zapytań, wklej
https://mcp.querystreams.com/mcp, a następnie w czacie kliknij +, wybierać 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łączenia patka.
ChatGPT. Dodaj strumienie zapytań z samej aplikacji: na razie oznacza to włączenie trybu programisty w ustawieniach ChatGPT i utworzenie tam połączenia, a następnie kliknięcie Zaloguj się za pomocą Query Streams i zatwierdzając na tym samym ekranie zgody. Przewodnik po portalu pokazuje aktualne kroki ChatGPT; oficjalna lista ChatGPT jest w drodze.
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 listy Łączyć przycisk lub Ustawienia → Łączniki → Dodaj dla trasy URL.
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 i kliknij Połącz klienta AI. Wybierać Użyj klucza w pliku konfiguracyjnym i wybierz narzędzie.
- Kliknij Wygeneruj klucz dla Twoje narzędzie. Nazwij je po narzędziu i maszynie, np. claude-code-laptop, trzymać Czytać oraz Uruchom zapytaniai wybierz datę wygaśnięcia. Możesz później ujawnić i ponownie skopiować klucz z Połączenia Tab. Klawisze wyglądają jak
qsmcp_po których następują 43 znaki. - Skonfiguruj to pokazuje gotową do wklejenia konfigurację dla Cursor, VS Code, Windsurf, Zed, JetBrains, Gemini CLI, Codex CLI, Continue, Cline i innych, z już wypełnionym kluczem. W przypadku Claude Code jest to jedno polecenie:
claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp --header "Klucz X-MCP: qsmcp_WKLEJ_KLUCZ_TUTAJ" - Sprawdź połączenie czeka na pierwsze połączenie z tego klawisza i mówi Połączony.
Aby to zweryfikować, w dowolnym momencie zapytaj „Jakie mam łączniki Query Streams?” Klient powinien zadzwonić qs_list_connectorsi klucz Ostatnio używane czas na karcie Połączenia aktualizuje się w ciągu kilku sekund.
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ę konektorów i agentów, przeglądaj schemat, czytaj opisy Semantic Intelligence oraz zapisane profile kolumn i relacje, a także listę zapisanych zapytań i reguł alertów. | Zawsze. Wszystko inne na tym bazuje. |
| analizować | Profiluj tabelę lub wykrywaj na żywo niejawne relacje na Network Agent i dodawaj do kolejki zadanie Semantic Intelligence. Bez tego klient AI nie widzi narzędzi służących do uruchamiania zadań Semantic Intelligence. | Zalecane. To pozwala Claude'owi zrozumieć kształt danych przed napisaniem łączeń. |
| wykonać | Pokazano jako Uruchamianie zapytań (tylko do odczytu). Uruchamiaj zapytania SQL tylko do odczytu i zapisane zapytania, przesyłaj strumieniowo wiersze; zapisuj wyniki i uruchamiaj na nich narzędzia do ich dalszego śledzenia i analizy. | 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 karcie Połączenia.
Co może zrobić Twój klient AI po połączeniu
Twój klient AI widzi narzędzia Query Streams i wybiera odpowiednie dla Twojego pytania; nigdy nie dzwonisz do nich osobiście. Portal Karta Narzędzia wymienia wszystkie narzędzia i tryby, wyjaśnia, do czego służą, oraz wskazuje, które są dostępne w ramach Twojego planu.
Gdy zadasz pytanie dotyczące danych, Query Streams przeprowadzi klienta AI przez cztery kroki: wyświetlenie listy konektorów, odczytanie tabel w bazie danych, odczytanie kolumn każdej tabeli, do której klient będzie wysyłać zapytania, a następnie wykonanie zapytania tylko do odczytu. Wcześniejsze odczytanie kolumn zapobiega zgadywaniu nazw. We wszystkich planach, także Free:
Zmapuj 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.
Uruchom tylko do odczytu SQL
Zapisuj i uruchamiaj zapytania SQL tylko do odczytu w odpowiednim dialekcie dla łącznika. Domyślnie limit czasu wynosi 60 sekund, maksymalnie pięć minut; Twój plan określa liczbę wierszy zwracanych przez jedno zapytanie.
Zapisane zapytania, federacje i alerty
Uruchom zapisane, sparametryzowane zapytania swojej organizacji z nowymi wartościami; zapytania federacyjne obejmujące kilka źródeł zostaną zwrócone jako połączone. Odczytaj reguły alertów i ich ostatnie uruchomienia, a następnie zaproponuj nową regułę w trybie próbnym.
Zestaw narzędzi analitycznych
W planach płatnych Agent Sieciowy wykonuje pracę przygotowawczą, w której znajdują się Twoje dane: mierzy, profiluje, przechowuje i analizuje wyniki, dzięki czemu Twój klient AI podchodzi do każdego pytania z przygotowanym kontekstem i skupia się na procesie myślowym. Plan darmowy działa tak jak zawsze, ze standardowymi wynikami. Pełny opis znajduje się w Analizuj swoje dane za pomocą klienta AI.
Zarządzanie kontekstem
Personal Core i wyżej. Zmień rozmiar wyniku przed jego odczytaniem (kształt): kolumny, szacowanie wierszy i koszt tokena, brak wierszy. Przejrzyj dużą bazę danych obszar po obszarze (poziomy schematu). Utrzymuj odpowiedzi w ramach budżetu symbolicznego, używając tylko kolumny i długości komórek tekstowych, jakich potrzebuje.
Analiza wyników
Personal Core i wyżej. A profil całego wyniku zamiast wierszy. Wyniki zdobytych, z etykietami, odpowiedz na pytania uzupełniające, takie jak „podziel według regionów” lub „następne 50 wierszy” bez konieczności wykonywania drugiego zapytania do bazy danych. Świeżość danych oraz zmieniony od czytaj tylko to, co nowe.
Głębsza analiza
Podstawowe obszary działalności i wyższe. Dane jakość raport, anomalie, segmenty, statystyczny porównywać i różnica pomiędzy dwoma utrzymanymi wynikami.
Zachowujesz kontrolę. Ten Karta kontekstowa Ustawia wartości domyślne: limit komórek tekstowych, widok schematu dla dużych baz danych, rozmiar wyników i domyślne ustawienia analizy, a także pokazuje, co otrzymuje Twój klient AI. Wyświetla również wyniki przechowywane przez każdego agenta. Każdy klawisz może zastąpić ustawienia domyślne, każde wywołanie znajduje się na karcie Aktywność, a administrator może je wyłączyć. Analiza lokalna dla agenta pod Dane → Agenci danych.
Co obejmuje Twój plan
MCP jest dostępny w każdym planie, także bezpłatnym, a plan bezpłatny nigdy nie wygasa.
| Plan | Klucze na użytkownika | Klucze na organizację | Połączenia na minutę | Wierszy na zapytanie | Zestaw narzędzi analitycznych | Wyniki zdobytych |
|---|---|---|---|---|---|---|
| Bezpłatny | 1 | 1 | 30 | 1,000 | Wyniki standardowe | Nic |
| Rdzeń osobisty | 1 | 1 | 60 | 2,500 | Zarządzanie kontekstem, analiza wyników | 15 minut, 128 MB |
| Osobisty Plus | 1 | 1 | 90 | 5,000 | Zarządzanie kontekstem, analiza wyników | 15 minut, 128 MB |
| Podstawy działalności | 2 | 3 | 120 | 10,000 | Zarządzanie kontekstem, Analiza wyników, Głębsza analiza | 60 minut, 512 MB |
| Biznes Plus | 3 | 5 | 150 | 25,000 | Wszystkie trzy | 60 minut, 512 MB |
| Biznes Max | 5 | 10 | 240 | 50,000 | Wszystkie trzy | 60 minut, 512 MB |
| Rdzeń przedsiębiorstwa | 5 | 25 | 300 | 100,000 | Wszystkie trzy | 8 godzin, 4096 MB |
| Enterprise Plus | 8 | 50 | 450 | 100,000 | Wszystkie trzy | 8 godzin, 4096 MB |
| Enterprise Max | 10 | 100 | 600 | 100,000 | Wszystkie trzy | 8 godzin, 4096 MB |
Połączona aplikacja jest traktowana jako klucz. W każdym planie, każdy klucz wykonuje maksymalnie 10 zapytań na minutę. Liczba wierszy na zapytanie to maksymalna liczba wierszy, jaką jedno zapytanie zwraca klientowi AI; prośba o więcej zwraca limit planu i to potwierdza, nigdy nie powodując błędu. Zatrzymany wynik jest przechowywany na potrzeby pytań uzupełniających do czasu i rozmiaru planu, w granicach możliwości komputera agenta. Każdy plan obok siebie: ustalanie cen.
Dlaczego inteligencja semantyczna 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 |
|---|---|---|
| Inteligencja semantyczna | 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 analizę semantyczną raz. W przypadku dużych baz danych ogranicz zakres uruchomienia do tabel, z których faktycznie korzystają Twoje zapytania. Jak działa inteligencja semantyczna →
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 wykorzystują inteligencję semantyczną?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 konektora, a następnie kontynuacja w tym samym wątku. W planach z analizą wyników kontynuacja może pochodzić z przechowywanego wyniku, bez konieczności drugiego zapytania. 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 zapytań zwracane do Claude’a obciążają ten sam limit data realm, z którego korzystają Excel, Google Sheets, Portal i Nova. W przypadku MCP liczy się każdy bajt dostarczony do Claude’a — wyniki, odczyty schematu i strony przechowywanych wyników — przed jakąkolwiek kompresją transmisji, ponieważ klient AI otrzymuje je w postaci nieskompresowanej. Wyniki z arkuszy kalkulacyjnych, Portalu i API są liczone po kompresji, w postaci dostarczanej przez Network Agent. Nieudana odpowiedź nie jest wliczana. Ogranicz rozmiar pytań eksploracyjnych; w planach z funkcją zarządzania kontekstem poproś najpierw Claude’a o oszacowanie rozmiaru wyniku (mode: shape), aby uniknąć pobierania niepotrzebnych wierszy.
- Inteligencja semantyczna 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 mówi, że nie ma żadnych złączy ani agenta sieciowego | Na Twoim koncie nie działa jeszcze żaden Agent lub Agent nie ma dodanego żadnego źródła danych. | Zainstaluj agenta z my.querystreams.com/download, dodaj złącze pod Dane → Agenci danych → Dodaj łącznik, a następnie zapytaj ponownie. |
| 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ć (Uruchom zapytania). | 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 | Po zatwierdzeniu połączona aplikacja była ograniczona do określonych łączników, a ta do nich nie należy. | Ponownie połącz aplikację i zatwierdź szerszy dostęp na ekranie zgody Query Streams. |
BAZA_DANYCH_MCP_NIE_PRZECHWYCONA | Baza danych nie znajduje się w wyborze przechwytywania schematu przez konektor, więc nie ma inteligencji semantycznej ani zapisanych relacji do odczytu. Zapytania nadal działają. | Dodaj bazę danych do wyboru przechwytywania w łączniku w Portalu, a następnie opcjonalnie uruchom funkcję Semantic Intelligence. |
OGRANICZONA STAWKA_MCP | Zbyt duża liczba połączeń na minutę w stosunku do Twojego planu. | Chwileczkę. Intensywne sesje korzystają z inteligencji semantycznej, 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 klientowi AI w jednej odpowiedzi. | Poproś o mniejszą liczbę kolumn lub wierszy. W planach z zarządzaniem kontekstem poproś najpierw o ustalenie rozmiaru wyniku. |
MCP_FEATURE_NOT_INCLUDED | „Twój plan nie obejmuje zarządzania kontekstem”, analizy wyników lub głębszej analizy; lub narzędzie jest wyłączone dla tego klucza lub organizacji. | Poproś swojego klienta AI o kontynuowanie pracy bez niego, przejdź na wyższy plan lub poproś administratora o włączenie narzędzia. |
WYNIK_MCP_WYGASŁ | Zatrzymany wynik nie jest już dłużej przechowywany: wygasł, został zwolniony (czasem wcześniej, aby zrobić miejsce na nowszy wynik) lub Agent został uruchomiony ponownie. | Poproś swojego klienta AI o ponowne uruchomienie zapytania z wstrzymaniem. |
BUDŻET_OKNA_MCP | Agent nie może obecnie przechowywać wyników o takim rozmiarze lub operacja uzupełniająca wymaga więcej pamięci, niż jest przeznaczone na przechowywane wyniki. | Zwolnij wstrzymany wynik lub zawęź zapytanie, stosując filtr lub mniejszą liczbę kolumn. |
ANALIZA_AGENTA_MCP_WYŁĄCZONA | Przechowywane wyniki i analizy są wyłączone dla danego Agenta lub dla danego łącznika. | Poproś administratora o włączenie Analiza lokalna dla Agenta na stronie Agentów danych lub zezwól na analizę w łączniku. |
MCP_WINDOW_SQL_ODRZUCONE | Dalsza operacja nie polegała na wykonaniu tylko jednej operacji SELECT przeznaczonej do odczytu na tabelach przechowywanych wyników ani na podaniu nazwy kolumny, której wynik nie ma. | Poproś o wykonanie jednego polecenia SELECT na tym wyniku, używając nazw jego kolumn. |
WERSJA_AGENTA_MCP_ZBYT_STARA | Agent potrzebuje aktualizacji zanim będzie mógł kształtować, profilować, przechowywać lub analizować wyniki. | Zaktualizuj agenta z Dane → Agenci danychTymczasem zwykłe zapytania nadal działają. |
| Zapytanie kończy się błędem dotyczącym nazwy kolumny lub tabeli | Klient AI zgadł nazwę zamiast najpierw odczytać tabelę. | Zazwyczaj nic. Otrzymany błąd zawiera listę rzeczywistych kolumn tabeli lub tabel o podobnej nazwie, więc klient może poprawić zapytanie przy kolejnej próbie. Jeśli nadal zgaduje, poproś go, aby najpierw odczytał kolumny tabeli. |
| 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? Wyślij e-mail [email protected].
Bezpieczeństwo i prywatność
- Claude otrzymuje metadane schematu, opisy inteligencji semantycznej, w tym wartości próbek, oraz wyniki zapytań, o które prosisz. Dzięki zestawowi narzędzi analitycznych często otrzymuje szacunkowy rozmiar, profil lub odpowiedź z wstrzymanym wynikiem, a pełny wynik pozostaje u agenta. Otrzymane dane są przesyłane do wybranego 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 inteligencji semantycznej 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. Portal Połącz klienta AI W przewodniku znajduje się gotowa konfiguracja dla każdego z nich.
Co to jest wynik utrzymany?
W planach z analizą wyników, klient AI może poprosić agenta o przechowywanie pełnego wyniku przez pewien czas. Na pytania uzupełniające, takie jak podział według regionów lub następna strona wierszy, udzielane są odpowiedzi z tej kopii bez konieczności ponownego zapytania do bazy danych. Czas przechowywania i rozmiar przechowywanego wyniku rosną wraz z planem.
Które plany obejmują zestaw narzędzi analitycznych?
Zarządzanie kontekstem i analiza wyników są dostępne w wersji Personal Core i nowszych; głębsza analiza w wersji Business Core i nowszych. Tabela planów ma szczegóły.
Czy ma to wpływ na plan darmowy?
Nie. Plan bezpłatny działa tak jak zawsze, oferując standardowe wyniki.
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 inteligencji semantycznej. Używaj Novy, gdy potrzebujesz odpowiedzi w Query Streams; używaj 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
Połącz Claude'a ze swoimi danymi
Zainstaluj agenta raz, w kilka minut. Potem połączenie z Claude to tylko jedno kliknięcie: bez klucza, pliku konfiguracyjnego i VPN. Zaprojektowany jako tylko do odczytu.
Zainstaluj agenta Otwórz stronę MCP Jak działa MCP
English 
Spanish 
German 
French 
Portuguese 
Japanese 
Korean 
Chinese 
Italian 
Dutch 
Indonesian 
Polish