Verbind Google AlloyDB met Claude via MCP.

MCP · AlloyDB naar Claude

Vragen Claude over uw AlloyDB-database, in begrijpelijke taal

Verbind Claude, Claude Code, Cursor of een andere MCP-client eenmalig met Query Streams. Claude leest de structuur van uw AlloyDB-database, schrijft de SQL-query, voert deze alleen-lezen uit via de agent die al met uw gegevens werkt en geeft de rijen als antwoord. Er komt geen enkel databasewachtwoord bij de AI terecht. Het duurt ongeveer tien minuten en is inbegrepen in het gratis abonnement.

Ongeveer 10 minuten Claude, ChatGPT, Cursor + 11 andere klanten Uw inloggegevens blijven bij u. Alleen-lezen, altijd

Wat je uiteindelijk overhoudt

Een Claude die vragen over uw AlloyDB-cluster kan beantwoorden met live, alleen-lezen query's, de betekenis van de kolommen kan uitleggen en u verder kan helpen wanneer u om meer informatie vraagt — zonder ooit een database-login te hoeven zien en zonder een firewall te hoeven wijzigen: de agent die zich al in uw netwerk bevindt, voert de SQL-query's uit en stuurt alleen de rijen terug. Zodra de agent is geïnstalleerd, duurt het verbinden met Claude ongeveer 90 seconden als u vertrouwd bent met een instellingenscherm. Zoals dit:

Claude ChatGPT Cursor Claude Code VS Code Windsurf Gemini CLI JetBrains Codex+5 meerAlleen-lezen

Wat zit erin? klanten In mijn AlloyDB-database? Laat me een paar rijen zien en leg uit wat elke kolom betekent.

qs_get_table_schema qs_run_query schema_intelligentie

Ik heb eerst de tabelstructuur bekeken en vervolgens een alleen-lezen query uitgevoerd via uw Agent. Hier zijn drie van de klantrijen:

klant_id	naam	stad
1042	Noordwindhandelaren	Seattle
1057	Alpine Outfitters	Denver
1063	Havenvoedsel	Halifax

klant_id identificeert de rij. naam en stad worden beschreven in uw semantisch intelligentiemodel, zodat ik ze op naam kan filteren.

Welke drie stad Welke producten leverden dit kwartaal de meeste omzet op? Hoe verhoudt zich dat tot het vorige kwartaal? Zijn er zaken waar ik naar zou moeten kijken?

qs_get_relationships qs_run_query qs_run_query

Ik ben lid geworden klanten naar bestellingen Op basis van de gevonden relatie heeft Semantic Intelligence vervolgens voor elk kwartaal een aggregatie uitgevoerd. Beide query's waren alleen-lezen en leverden elk 3 rijen op:

stad	Dit kwartaal	Laatste kwartaal	Wijziging
Denver	184,200	133,900	+38%
Seattle	171,650	168,400	+2%
Halifax	96,300	129,700	-26%

Denver Het verhaal is als volgt: de omzet steeg met 38% bij vrijwel hetzelfde aantal klanten, waardoor de gemiddelde orderwaarde ook toenam. Halifax Een daling van 26%, en die daling betreft twee klanten die het afgelopen kwartaal elke maand bestelden en dit kwartaal helemaal niet meer – het is de moeite waard om ze voor het einde van de maand even te bellen. In Seattle is de situatie gelijk gebleven. Wilt u de namen van die twee klanten in Halifax weten?

Alleen SELECTEREN, gecontroleerd door de agent ingelogd op het tabblad MCP-activiteit 9 rijen geretourneerd verdeeld over 3 zoekopdrachten Dezelfde verbinding in 14 MCP-clients

Liever helemaal geen AI-client aansluiten? In het bedrijfsplan, Nova MCP is de assistent die is ingebouwd in Query Streams zelf. Het beschikt over alle tools die Claude hier heeft, plus de tools die Claude niet heeft: het stelt de SQL op en valideert deze aan de hand van uw Semantic Intelligence-model, zet het antwoord om in een grafiek en slaat het resultaat op als een query die uw team kan uitvoeren vanuit Excel, Google Sheets of de REST API — geen sleutel, geen connector, niets te installeren. Gebruik MCP als uw medewerkers al met Claude, Cursor of ChatGPT werken; gebruik Nova als u de antwoorden direct in het portaal wilt hebben.

Google AlloyDB bewaart uw gegevens in de cloud, beheerd door de provider. Claude daarentegen draait in een browser of terminal en weet daar niets van. De gebruikelijke manier om verbinding te maken is door een schema in de chat te plakken en te hopen op een reactie, of door uw AlloyDB-wachtwoord aan een open-source MCP-server te geven. Query Streams doet het anders: de agent die al in uw AlloyDB-cluster aanwezig is, voert de SQL-query's die Claude schrijft alleen-lezen uit, en de MCP-server ertussen controleert wie de query uitvoert, wat ze mogelijk doen en hoe vaak. Claude krijgt antwoorden. Het krijgt nooit inloggegevens.

AlloyDB voor PostgreSQL is de PostgreSQL-compatibele database van Google Cloud voor intensief transactioneel en analytisch werk. Deze handleiding maakt gebruik van de Query Streams MCP-server via uw agent, en niet van Google's MCP Toolbox voor databases of de beheerde AlloyDB MCP-server.

Wat je nodig hebt

Een Query Streams-account

MCP is beschikbaar in alle abonnementen, ook in het gratis abonnement. Met het gratis abonnement kun je één sleutel of één gekoppelde app gebruiken, en dat is alles wat deze handleiding nodig heeft. Meld je aan via mijn.querystreams.nl.

AlloyDB is via de agent verbonden.

De agent wordt geïnstalleerd op elke computer die altijd aan staat, waarbij de AlloyDB-verbinding wordt toegevoegd in Data Agents.

Kies de AlloyDB De kaart valt onder Relationeel. Poort 5432, database PostgreSQL en SSL zijn al ingevuld. Er is geen verbindingsreeks om te plakken. Open in de Google Cloud-console het cluster. Connectiviteit Ga naar de pagina en kopieer het IP-adres van de instantie, privé of openbaar. Voer de gebruikersnaam en het wachtwoord in. Schakel SSL alleen uit wanneer de agent verbinding maakt via de AlloyDB Auth Proxy op 127.0.0.1.

MCP is voor u ingeschakeld.

Makers, eigenaren en beheerders hebben het vanaf het begin. Alle anderen hebben een beheerder nodig om het te kunnen gebruiken. MCP schakelaar naast hun naam onder Account → ToegangsbeheerTot die tijd staat er op de MCP-pagina: "MCP is uitgeschakeld voor uw account".

Een AI-client

Claude op het web, Claude Desktop of de Claude mobiele apps maken zonder sleutel verbinding. Claude Code, Cursor, ChatGPT en ongeveer tien andere tools werken ook; de portal heeft voor elk een kant-en-klaar recept.

Stel het in vier stappen in.

1. Open MCP in het portaal

   Meld u aan bij mijn.querystreams.nl en open Streams → Live → MCPDe pagina heeft vier tabbladen: Verbinden, Verbonden apps, Mijn sleutels en voor beheerders, ActiviteitControleer de Mijn sleutels Open het zijpaneel nu u hier toch bent: het toont uw AlloyDB-connector en of Semantic Intelligence erop is uitgevoerd. Dankzij deze volledige dekking kan Claude in één keer correcte AlloyDB SQL-query's schrijven.

   Open MCP

   Ziet u de melding "MCP is uitgeschakeld voor uw account"? Uw organisatie heeft MCP, maar uw gebruiker is uitgeschakeld. Een beheerder schakelt het in met de MCP schakelaar naast je naam onder Account → ToegangsbeheerMakers, eigenaren en beheerders zijn vanaf het begin betrokken.

2. Kies hoe u verbinding wilt maken.

   Er zijn twee ingangen, en ze komen allebei op dezelfde plek uit:

   Chat-apps · geen sleutel

   claude.ai, Claude Desktop, ChatGPT

   In Claude bevindt Query Streams zich in de Directory van antropische connectoren: blader door connectoren, klik VerbindenElders plak je één adres in de app, https://mcp.querystreams.com/mcpen maak verbinding vanuit een chat. Er wordt een pagina 'Query Streams' geopend, waar u de organisatie en de machtigingen selecteert en klikt. Verbinding goedkeurenNiets om te kopiëren, niets om geheim te houden. De verbinding verschijnt onder Verbonden apps en kan daar worden ingetrokken.

   Ontwikkelaarstools · een sleutel

   Claude Code, Cursor, VS Code en vrienden

   Op Mijn sleutels klik Sleutel genererenGeef het eens een Sleutelnaam zoals "Claude Code op mijn laptop", bewaar Lezen en Uitvoeren aangevinkt, kies een Vervaldatum (Nooit, 30 dagen, 90 dagen of 1 jaar) en klik Sleutel genererenKopieer het vervolgens. Ga verder met installeren: de Verbinden Het tabblad toont het exacte codefragment voor uw tool, waarbij de sleutel al is ingevuld.

   Beide methoden gebruiken dezelfde drie machtigingen, die u kiest op het toestemmingsscherm of in de legenda:

   Lezen

   Toont connectoren, bladert door tabellen en kolommen, leest uw opgeslagen query's en waarschuwingsregels. Geeft nooit rijgegevens terug.

   Uitvoeren

   Voer alleen-lezen SQL-query's en opgeslagen query's uit via uw agent en retourneer de rijen. Zonder dit kan Claude uw gegevens wel beschrijven, maar er geen antwoord op geven.

   Analyseren

   Profieltabellen, ontdek relaties en plan een Semantic Intelligence-run in. Het verbruikt Nova AI-credits en data, dus het toestemmingsscherm vinkt het nooit vooraf aan.

   Sleutel kwijt? Open Mijn sleutelsHet oogpictogram laat het nogmaals zien en Kopieer de volledige sleutel kopieert het. Trek het daar in als een laptop vermist raakt; elke klant die het gebruikt, faalt bij het volgende gesprek, binnen ongeveer vijf minuten.

3. Verbind Claude

   Kies het recept voor de Claude die je gebruikt. Het serveradres is overal hetzelfde: https://mcp.querystreams.com/mcp.

   Claude op het web, Claude voor desktop en mobiel geen sleutel

   1. Open Instellingen → Connectoren en klik Connectoren bekijkenQuery Streams wordt vermeld in de Directory van antropische connectoren: vinden Query-stromen en klik Verbinden(Of open de directorylijst direct en klik) Verbinden daar.)
   2. Als uw organisatie directory-connectoren verbergt, klik dan hier. Voeg een aangepaste connector toe Geef het in plaats daarvan een naam. Query-stromen, plakken https://mcp.querystreams.com/mcpLaat de OAuth-velden leeg en klik. Toevoegenklik vervolgens in een willekeurige chat + → Connectoren bekijken → Query-stromen → Verbinden.
   3. Er wordt een tabblad 'Query Streams' geopend. Meld u aan als daarom wordt gevraagd, selecteer de organisatie en bekijk de resultaten. Lezen en Uitvoeren, optioneel Beperk tot specifieke connectorenen klik Verbinding goedkeuren.
   4. In Claude zie je 'Verbonden met querystreams'. De eerste keer dat Claude een tool gebruikt, wordt er om een keuze gevraagd; kies Altijd toestaan.

   Als je het handmatig toevoegt in Claude Desktop, gebruik dan het volgende: Instellingen → Connectoren → Toevoegen, niet de chatfunctie Voeg een marktplaats toe Deze optie vereist een Git-repository. Connectors synchroniseren met je Claude-account, waardoor de mobiele apps en de desktopversie deze automatisch herkennen. Menunamen zijn van Anthropic en kunnen worden gewijzigd.

   Claude Code sleutel

   Eén commando, met uw sleutel uit Mijn sleutels:

   Terminal

   claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp \ --header "X-MCP-Key: qsmcp_PASTE_YOUR_KEY_HERE"

   Dat schrijft het huidige project. .mcp.json. Toevoegen --scope gebruiker Om querystreams in elk project te hebben. Uitvoeren /mcp Kijk binnen in de Claude-code om te zien hoe het werkt.

   Cursor sleutel

   Open Cursorinstellingen → MCP → Nieuwe MCP-server toevoegenof bewerken .cursor/mcp.json aan de basis van je werkruimte:

   .cursor/mcp.json

   { "mcpServers": { "querystreams": { "url": "https://mcp.querystreams.com/mcp", "headers": { "X-MCP-Key": "qsmcp_PASTE_YOUR_KEY_HERE" } } } }

   Cursor opnieuw starten of uitvoeren MCP: Servers opnieuw opstarten; A querystreams Het badge verschijnt in de statusbalk van het MCP.

   Gebruik je iets anders? De Verbinden tabblad Bevat kant-en-klare recepten voor ChatGPT, VS Code, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev en JetBrains AI, plus een Plakken en samenvoegen gereedschap dat de querystreams een invoer in een configuratiebestand dat je al hebt. Elke client die MCP via HTTP ondersteunt, werkt: server https://mcp.querystreams.com/mcp, koptekst X-MCP-sleutel (een Autorisatie: Houder Een header met dezelfde sleutel werkt ook.

4. Stel je eerste vraag

   Begin met iets waarvan je het antwoord al weet, zodat je kunt zien hoe Claude het juiste gereedschap pakt. Drie die goed werken met je AlloyDB-cluster:

   Welke gegevens heb ik in mijn AlloyDB-cluster?

   Claude geeft een lijst van de tabellen die het kan zien, vertelt je welke tabellen semantische intelligentie hebben en vraagt wat je wilt bekijken.

   "Laat me tien rijen met klantgegevens zien en leg elke kolom uit."

   Claude leest eerst de tabelstructuur (Read), voert vervolgens één SELECT-query uit via uw agent (Execute) en beschrijft wat 'name' en 'city' betekenen.

   "Hoeveel rijen hebben klanten per stad? Welke stad heeft de meeste?"

   Claude schrijft de GROUP BY-query in het dialect van AlloyDB, voert deze uit en geeft een antwoord in één zin met een kleine tabel. Ga verder in dezelfde chat; zo blijft de context behouden.

   Om de bedrading te controleren, kunt u vragen Welke Query Streams-connectoren heb ik?Claude belt qs_list_connectorsen op Mijn sleutels de sleutel is Laatst gebruikt De tijd wordt binnen enkele seconden bijgewerkt. Een verbonden app verschijnt onder Verbonden apps met de tijd waarop het apparaat was aangesloten en voor het laatst gebruikt.

Wat Claude kan doen zodra hij verbonden is.

Claude ziet negentien kleine gereedschappen. Je benoemt ze zelf nooit; Claude kiest de juiste uit voor jouw vraag. Simpel gezegd:

Waarom semantische intelligentie hier van belang is

Elk antwoord dat Claude ontvangt, is voorzien van een label dat aangeeft waar de structuur vandaan komt, en Claude past vervolgens aan in hoeverre hij de informatie die hij ziet vertrouwt.

Als een database van belang is, voer er dan eenmaal een Semantic Intelligence-test op uit. Nova → IntelligentieDe Mijn sleutels Het tabblad toont een overzichtspaneel per connector. Hoe werkt semantische intelligentie?.

Wat de plannen toestaan

MCP is bij elk abonnement inbegrepen, ook bij het gratis abonnement, zonder extra kosten. Elk abonnement bepaalt hoeveel toetsen of verbonden apps je kunt vasthouden en hoeveel gesprekken Claude per minuut mag voeren.

Een verbonden app telt als een sleutel. Naast het bedrag per minuut mag één sleutel maximaal 10 query's per minuut uitvoeren. Een query retourneert maximaal 1.000 rijen en duurt maximaal 60 seconden, tenzij Claude om meer vraagt, tot een maximum van 50.000 rijen en vijf minuten. De rijen die Claude ontvangt, tellen mee voor uw Data Realm-limiet, dezelfde limiet die uw Excel- en Sheets-query's gebruiken. MCP wordt gemeten vóór compressie, dus een breed resultaat kost hier meer dan dezelfde rijen in een spreadsheet. Semantische intelligentie-runs die vanuit Claude worden gestart, verbruiken Nova AI-credits, net zoals vanuit de portal. Bekijk de prijspagina. voor de toeslagen.

Het veilig bewaren

Goede volgende stappen

• Bewaar de query's die u als canoniek beschouwt. In de querybuilder zoekt Claude eerst naar opgeslagen query's, dus "actieve klanten" betekent wat jouw team eronder verstaat.
• Gebruik een Claude-project Voeg querystreams toe en stel je eigen regels in de instructies in: welke AlloyDB-database standaard moet worden gebruikt en welke opgeslagen query's de officiële definities zijn.
• Gebruik Grant Analyze als je diepere antwoorden wilt. Het profileren van een kolom vóórdat je erop filtert, maakt het verschil tussen het raden van een statuscode en het gebruiken van de juiste. Het verbruikt Nova AI-credits, dus het is uitgeschakeld totdat je het uitschakelt.
• Vraag om een schema. claude.ai maakt grafieken van de rijen die Claude terugkrijgt.

Als iets niet werkt

Vragen die mensen stellen

Gerelateerde handleidingen

• Verbind Microsoft SQL Server met Claude via MCP
• Verbind PostgreSQL met Claude via MCP
• Verbind MySQL met Claude via MCP
• Verbind Microsoft Access met Claude via MCP.
• Querystreams verbinden met Claude via MCP: configuratie, machtigingen en probleemoplossing
• Alle MCP-handleidingen