Połącz Google AlloyDB z Claude za pomocą MCP

MCP · AlloyDB do Claude'a

Zapytać Klaudiusz o Twojej bazie danych AlloyDB, po prostu po angielsku

Połącz Claude, Claude Code, Cursor lub dowolnego klienta MCP z Query Streams raz. Claude odczytuje strukturę bazy danych AlloyDB, 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 Poświadczenia pozostają z Tobą Tylko do odczytu, zawsze

Co z tego wyjdzie?

A Claude that can answer questions about your AlloyDB cluster with live, read-only queries, explain what the columns mean, and follow up when you ask for more — without ever seeing a database login, and without a firewall change: the Agent already inside your network runs the SQL 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:

Klaudiusz ChatGPT Kursor Kod Claude'a Kod VS Windsurf Interfejs wiersza poleceń Gemini JetBrains Kodeks+5 więcejTylko do odczytu

Co jest w środku klienci w mojej bazie danych AlloyDB? Pokaż mi kilka wierszy i powiedz, co oznacza każda kolumna.

qs_get_table_schema qs_run_query inteligencja_schematu

Najpierw przyjrzałem się strukturze tabeli, a następnie uruchomiłem zapytanie tylko do odczytu przez Twojego agenta. Oto trzy wiersze klientów:

customer_id	nazwa	miasto
1042	Northwind Traders	Seattle
1057	Alpejskie wyposażenie	Denver
1063	Harbour Foods	Halifax

customer_id identyfikuje wiersz. nazwa oraz miasto are described in your Schema Intelligence model, so I can filter on them by name.

Which three miasto values brought in the most revenue this quarter, and how does that compare with last quarter? Anything I should look into?

qs_get_relationships qs_run_query qs_run_query

I joined klienci do zamówienia on the relationship Schema Intelligence found, then ran one aggregate for each quarter. Both queries were read-only and returned 3 rows each:

miasto	This quarter	Last quarter	Change
Denver	184,200	133,900	+38%
Seattle	171,650	168,400	+2%
Halifax	96,300	129,700	−26%

Denver is the story: revenue up 38% on almost the same number of customers, so average order value rose. Halifax fell 26%, and the drop is two customers who ordered every month last quarter and not at all this quarter — worth a call before month end. Seattle is flat. Want the two Halifax accounts by name?

Tylko SELECT, sprawdzane przez Agenta zalogowano na karcie Aktywność MCP 9 rows returned across 3 queries To samo połączenie u 14 klientów MCP

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.

Google AlloyDB przechowuje Twoje dane w chmurze, obsługiwanej przez swojego dostawcę. Claude natomiast działa w przeglądarce lub terminalu i nic o tym nie wie. Typowy most polega na wklejeniu schematu do czatu i oczekiwaniu, lub przekazaniu serwerowi MCP z otwartym kodem źródłowym, hasła do AlloyDB. Query Streams robi to inaczej: agent, który już znajduje się w klastrze AlloyDB, uruchamia zapisy SQL, które Claude zapisuje w trybie tylko do odczytu, a serwer MCP w międzyczasie sprawdza, kto pyta, co może zrobić i jak często. Claude otrzymuje odpowiedzi. Nigdy nie otrzymuje danych uwierzytelniających.

AlloyDB for PostgreSQL to baza danych PostgreSQL od Google Cloud, kompatybilna z platformą PostgreSQL, przeznaczona do intensywnych zadań transakcyjnych i analitycznych. W tym przewodniku wykorzystano serwer Query Streams MCP za pośrednictwem agenta, a nie Google MCP Toolbox for Databases ani zarządzany serwer AlloyDB MCP.

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.

AlloyDB połączony przez agenta

The Agent installed on any always-on computer, with the AlloyDB connection added in Data Agents.

Wybierz AlloyDB card under Relational. It pre-fills port 5432, database postgres and SSL on. There is no connection string to paste. In the Google Cloud console, open the cluster's Connectivity page and copy the instance IP, private or public. Type the user and password. Turn SSL off only when the Agent connects through the AlloyDB Auth Proxy on 127.0.0.1.

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. Otwórz MCP w portalu

   Zaloguj się na my.querystreams.com i otwórz Transmisje strumieniowe → Na żywo → MCPStrona ma cztery zakładki: Łączyć, Połączone aplikacje, Moje klucze i dla administratorów, Działalność. Sprawdź Moje klucze panel boczny, gdy już tu jesteś: wyświetla listę Twojego łącznika AlloyDB i informację, czy uruchomiono na nim Schema Intelligence. Pełne pokrycie pozwala Claude'owi pisać poprawne zapytania SQL dla AlloyDB za pierwszym razem.

   Otwórz MCP

   Widzisz komunikat „MCP jest wyłączony dla Twojego konta”? Twoja organizacja ma MCP, ale Twój użytkownik jest wyłączony. Administrator włącza go za pomocą MCP przełącznik obok swojego imienia pod Konto → Kontrola dostępuTwórcy, właściciele i administratorzy są obecni od samego początku.

2. Wybierz sposób połączenia

   Istnieją dwie drogi dojścia, 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.

3. Połącz Claude'a

   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ś, na co już znasz odpowiedź, żeby Claude mógł sięgnąć po odpowiednie narzędzie. Trzy, które dobrze współpracują z Twoim klastrem AlloyDB:

   „Jakie dane mam w moim klastrze AlloyDB?”

   Claude wyświetla listę tabel, które widzi, mówi, które z nich mają inteligencję schematów i pyta, na co chcesz zwrócić uwagę.

   „Pokaż mi dziesięć wierszy od klientów i wyjaśnij każdą kolumnę.”

   Claude najpierw odczytuje strukturę tabeli (Odczyt), następnie uruchamia instrukcję SELECT za pośrednictwem agenta (Wykonaj) i opisuje znaczenie nazwy i miasta.

   „Ile rzędów mają klienci w każdym mieście? Które miasto ma ich najwięcej?”

   Claude pisze komendę GROUP BY w dialekcie AlloyDB, uruchamia ją i odpowiada jednym zdaniem z małą tabelą. Kontynuuj na tym samym czacie; zachowuje to kontekst.

   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ę w ciągu kilku sekund. Połączona aplikacja pojawia się pod Połączone aplikacje z czasem podłączenia i ostatniego użycia.

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

• Zapisz zapytania, które uważasz za kanoniczne w Kreatorze zapytań. Claude najpierw sięga po zapisane zapytania, więc „aktywni klienci” oznaczają to, co mówi Twój zespół.
• Użyj projektu Claude z dołączonymi strumieniami zapytań i umieść w instrukcjach swoje zasady domowe: która baza danych AlloyDB ma być używana domyślnie, które zapisane zapytania są oficjalnymi definicjami.
• Udziel opcji Analize, jeśli chcesz uzyskać głębsze odpowiedzi. Profilowanie kolumny przed filtrowaniem jej według to różnica między odgadnięciem kodu statusu a użyciem właściwego. Wykorzystuje to kredyty Nova AI, więc filtr jest wyłączony, dopóki nie zdecydujesz.
• Poproś o wykres. claude.ai rysuje wykresy na podstawie wierszy otrzymanych przez Claude'a.

Kiedy coś nie działa

Pytania, które zadają ludzie

Powiązane przewodniki

• Połącz Microsoft SQL Server z Claude za pomocą MCP
• Połącz PostgreSQL z Claude za pomocą MCP
• Połącz MySQL z Claude za pomocą MCP
• Połącz Microsoft Access z Claude za pomocą MCP
• Łączenie strumieni zapytań z Claude za pośrednictwem MCP: konfiguracja, uprawnienia i rozwiązywanie problemów
• Wszystkie przewodniki MCP