Verbinden Sie Google AlloyDB mit Claude mithilfe von MCP

MCP · AlloyDB an Claude

Fragen Claude über Ihre AlloyDB-Datenbank, in einfachem Englisch

Verbinden Sie Claude, Claude Code, Cursor oder einen beliebigen MCP-Client einmalig mit Query Streams. Claude liest die Struktur Ihrer AlloyDB-Datenbank, schreibt die SQL-Anweisung, führt sie schreibgeschützt über den Agenten aus, der bereits mit Ihren Daten arbeitet, und liefert die Ergebnisse. Das Datenbankpasswort gelangt niemals an die KI. Der Vorgang dauert etwa zehn Minuten und ist im kostenlosen Plan enthalten.

Ungefähr 10 Minuten Claude, ChatGPT, Cursor + 11 weitere Kunden Die Zugangsdaten bleiben bei Ihnen Schreibgeschützt, immer

Was am Ende dabei herauskommt

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:

Claude ChatGPT Cursor Claude Code VS Code Windsurf Gemini CLI JetBrains Kodex+5 weitereSchreibgeschützt

Was ist in Kunden in meiner AlloyDB-Datenbank? Zeigen Sie mir ein paar Zeilen und erklären Sie mir die Bedeutung der einzelnen Spalten.

qs_get_table_schema qs_run_query Schema-Intelligenz

Ich habe mir zunächst die Tabellenstruktur angesehen und anschließend eine Leseabfrage über Ihren Agenten ausgeführt. Hier sind drei der Kundenzeilen:

kunden_id	Name	Stadt
1042	Northwind Traders	Seattle
1057	Alpine Outfitters	Denver
1063	Harbour Foods	Halifax

kunden_id identifiziert die Zeile. Name und Stadt are described in your Schema Intelligence model, so I can filter on them by name.

Which three Stadt 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 Kunden zu Bestellungen on the relationship Schema Intelligence found, then ran one aggregate for each quarter. Both queries were read-only and returned 3 rows each:

Stadt	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?

Nur SELECT, geprüft vom Agenten Im MCP-Aktivitäts-Tab angemeldet 9 rows returned across 3 queries Gleiche Verbindung in 14 MCP-Clients

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 speichert Ihre Daten in der Cloud, betrieben vom Anbieter. Claude hingegen läuft in einem Browser oder Terminal und hat keinerlei Kenntnis davon. Üblicherweise wird ein Schema in den Chat eingefügt und auf das Beste gehofft oder einem Open-Source-MCP-Server das AlloyDB-Passwort übergeben. Query Streams geht anders vor: Der Agent, der bereits in Ihrem AlloyDB-Cluster installiert ist, führt die von Claude geschriebenen SQL-Anweisungen schreibgeschützt aus. Der zwischengeschaltete MCP-Server prüft, wer die Anfrage stellt, welche Aktionen ausgeführt werden und wie oft. Claude erhält Antworten, aber niemals Zugangsdaten.

AlloyDB für PostgreSQL ist die PostgreSQL-kompatible Datenbank von Google Cloud für rechenintensive Transaktions- und Analyseaufgaben. Diese Anleitung verwendet den Query Streams MCP-Server über Ihren Agenten, nicht die MCP Toolbox für Datenbanken von Google oder den verwalteten AlloyDB MCP-Server.

Was Sie benötigen

Ein Query Streams-Konto

MCP ist in allen Tarifen enthalten, auch in der kostenlosen Version. Die kostenlose Version erlaubt einen Schlüssel oder eine verbundene App – mehr benötigt dieser Leitfaden nicht. Melden Sie sich an unter mein.querystreams.de.

AlloyDB ist über den Agenten verbunden.

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

Wähle die 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 ist für Sie aktiviert

Ersteller, Eigentümer und Administratoren haben von Anfang an Zugriff darauf. Alle anderen benötigen einen Administrator, der die Einstellungen ändert. MCP Schalter neben ihrem Namen unter Konto → ZugriffskontrolleBis dahin heißt es auf der MCP-Seite: „MCP ist für Ihr Konto deaktiviert.“

Ein KI-Client

Claude im Web, Claude Desktop oder die Claude-Mobil-Apps verbinden sich ohne Schlüssel. Claude Code, Cursor, ChatGPT und etwa zehn weitere Tools funktionieren ebenfalls; das Portal bietet für jedes Tool eine vorkonfigurierte Konfiguration.

Richten Sie es in vier Schritten ein

1. MCP im Portal öffnen

   Anmelden unter mein.querystreams.de und öffnen Streams → Live → MCPDie Seite hat vier Registerkarten: Verbinden, Verbundene Apps, Meine Schlüssel und für Administratoren AktivitätÜberprüfen Sie die Meine Schlüssel Im Seitenbereich wird Ihr AlloyDB-Connector angezeigt und ob Schema Intelligence darauf ausgeführt wurde. Die vollständige Abdeckung ermöglicht es Claude, beim ersten Versuch korrekte AlloyDB-SQL-Anweisungen zu schreiben.

   MCP öffnen

   Wird die Meldung „MCP ist für Ihr Konto deaktiviert“ angezeigt? Ihre Organisation nutzt MCP, aber Ihr Benutzer ist deaktiviert. Ein Administrator aktiviert es mit dem MCP Schalter neben Ihrem Namen unter Konto → ZugriffskontrolleSchöpfer, Eigentümer und Administratoren sind von Anfang an dabei.

2. Wählen Sie aus, wie Sie die Verbindung herstellen möchten.

   Es gibt zwei Wege hinein, und sie enden am selben Ort:

   Chat-Apps · keine Taste

   claude.ai, Claude Desktop, ChatGPT

   In Claude, Query Streams is in the Anthropic Connectors Directory: browse connectors, click Verbinden. Elsewhere you paste one address into the app, https://mcp.querystreams.com/mcpund stellen Sie eine Verbindung über einen Chat her. Es öffnet sich eine Seite mit Abfragestreams. Sie wählen die Organisation und die Berechtigungen aus und klicken auf Verbindung genehmigenNichts zu kopieren, nichts geheim zu halten. Die Verbindung erscheint unter Verbundene Apps und kann dort widerrufen werden.

   Entwicklertools · ein Schlüssel

   Claude Code, Cursor, VS Code und Freunde

   An Meine Schlüssel klicken Schlüssel generierenGib ihm ein Schlüsselname wie zum Beispiel „Claude Code auf meinem Laptop“, behalten Sie Lesen und Ausführen Wenn Sie ein Häkchen gesetzt haben, wählen Sie eine Ablauf (Nie, 30 Tage, 90 Tage oder 1 Jahr) und klicken Schlüssel generierenKopiere es dann Installation fortsetzen: Die Verbinden Der Tab zeigt den genauen Codeausschnitt für Ihr Tool, wobei der Schlüssel bereits ausgefüllt ist.

   Beide Methoden verwenden dieselben drei Berechtigungen, die Sie entweder auf dem Zustimmungsbildschirm oder auf dem Schlüssel auswählen:

   Lesen

   Listen Sie Konnektoren auf, durchsuchen Sie Tabellen und Spalten, lesen Sie Ihre gespeicherten Abfragen und Benachrichtigungsregeln. Es werden niemals Zeilendaten zurückgegeben.

   Ausführen

   Führen Sie schreibgeschützte SQL-Abfragen und gespeicherte Abfragen über Ihren Agenten aus und geben Sie die Zeilen zurück. Ohne diese kann Claude Ihre Daten zwar beschreiben, aber keine Antworten darauf geben.

   Analysieren

   Tabellenprofile erstellen, Beziehungen ermitteln und einen Schema Intelligence-Lauf in die Warteschlange stellen. Dies verbraucht Nova AI-Credits und Datenvolumen, sodass die Zustimmungsabfrage diese Option nicht vorauswählt.

   Schlüssel verloren? Öffnen Meine SchlüsselDas Augensymbol zeigt es erneut an und Vollständigen Schlüssel kopieren Kopiert es. Entzieht es dort, wenn ein Laptop verloren geht; jeder Client, der es benutzt, schlägt beim nächsten Anruf innerhalb von etwa fünf Minuten fehl.

3. Verbinde dich mit Claude

   Wählen Sie das Rezept für den Claude, den Sie verwenden möchten. Die Serveradresse ist überall gleich: https://mcp.querystreams.com/mcp.

   Claude im Web, Claude Desktop und Mobilgeräte kein Schlüssel

   1. Öffnen Einstellungen → Konnektoren und klicken Sie Konnektoren durchsuchen. Query Streams is listed in the Anthropic Connectors Directory: find Abfrageströme und klicken Sie Verbinden. (Or open the directory listing directly and click Verbinden there.)
   2. If your organization hides directory connectors, click Benutzerdefinierten Konnektor hinzufügen instead. Name it Abfrageströme, Paste https://mcp.querystreams.com/mcp, leave the OAuth fields empty, click Hinzufügen, then in any chat click + → Konnektoren durchsuchen → Abfrageströme → Verbinden.
   3. Es öffnet sich ein Tab „Abfrageströme“. Melden Sie sich gegebenenfalls an, wählen Sie die Organisation aus und überprüfen Sie die Abfrage. Lesen und Ausführenoptional Beschränkung auf bestimmte Anschlüsseund klicken Sie Verbindung genehmigen.
   4. Zurück in Claude sehen Sie „Mit Abfrageströmen verbunden“. Wenn Claude zum ersten Mal ein Tool verwendet, werden Sie gefragt; wählen Sie Immer erlauben.

   If you do add it by hand in Claude Desktop, use Einstellungen → Konnektoren → Hinzufügennicht der Chat Marktplatz hinzufügen 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.

   Claude Code Schlüssel

   Ein Befehl, mit Ihrem Schlüssel aus „Meine Schlüssel“:

   Terminal

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

   Das schreibt das aktuelle Projekt. .mcp.json. Hinzufügen --scope Benutzer Query Streams in jedem Projekt haben. Ausführen /mcp Im Claude-Code sehen Sie, ob die Verbindung besteht.

   Cursor Schlüssel

   Öffnen Cursor-Einstellungen → MCP → Neuen MCP-Server hinzufügenoder bearbeiten .cursor/mcp.json im Stammverzeichnis Ihres Arbeitsbereichs:

   .cursor/mcp.json

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

   Cursor neu starten oder ausführen MCP: Server neu starten; A Abfrageströme Das Symbol erscheint in der MCP-Statusleiste.

   Etwas anderes verwenden? Der Verbinden Registerkarte enthält sofort einsatzbereite Rezepte für ChatGPT, VS Code, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev und JetBrains AI sowie ein Einfügen und Zusammenführen Werkzeug, das die Abfrageströme Eintrag in eine bereits vorhandene Konfigurationsdatei. Jeder Client, der MCP über HTTP unterstützt, funktioniert: Server https://mcp.querystreams.com/mcp, Kopfzeile X-MCP-Schlüssel (ein Autorisierung: Inhaber (Auch eine Kopfzeile mit demselben Schlüssel funktioniert.)

4. Stelle deine erste Frage

   Beginnen Sie mit einer Frage, deren Antwort Sie bereits kennen, damit Sie sehen können, wie Claude das richtige Werkzeug auswählt. Drei Beispiele, die gut mit Ihrem AlloyDB-Cluster funktionieren:

   „Welche Daten befinden sich in meinem AlloyDB-Cluster?“

   Claude listet die Tabellen auf, die er sehen kann, zeigt Ihnen an, welche Tabellen Schema Intelligence enthalten, und fragt Sie, was Sie sich ansehen möchten.

   „Zeigen Sie mir zehn Zeilen mit Kundendaten und erklären Sie jede Spalte.“

   Claude liest zuerst die Tabellenstruktur (Lesen), führt dann eine SELECT-Anweisung über Ihren Agenten aus (Ausführen) und beschreibt, was Name und Stadt bedeuten.

   „Wie viele Reihen hat jeder Kunde pro Stadt? Welche Stadt hat die meisten?“

   Claude schreibt die GROUP BY-Klausel im AlloyDB-Dialekt, führt sie aus und antwortet mit einem Satz und einer kleinen Tabelle. Die weitere Kommunikation erfolgt im selben Chat, um den Kontext zu erhalten.

   Um die Verkabelung zu überprüfen, fragen Sie „Welche Query Streams-Konnektoren habe ich?“Claude ruft an qs_list_connectorsund auf Meine Schlüssel der Schlüssel Zuletzt verwendet Die Zeit wird innerhalb weniger Sekunden aktualisiert. Eine verbundene App wird unter angezeigt. Verbundene Apps mit Angabe der Uhrzeit, zu der es angeschlossen war und zuletzt benutzt wurde.

Was Claude tun kann, sobald er verbunden ist

Claude sieht neunzehn kleine Werkzeuge. Man ruft sie nie selbst an; Claude wählt das passende für die jeweilige Frage aus. Einfach ausgedrückt:

Warum Schema-Intelligenz hier wichtig ist

Jede Antwort, die Claude erhält, wird mit dem Hinweis versehen, woher die Struktur stammt, und Claude passt an, wie sehr er dem Gesehenen vertraut.

Wenn eine Datenbank wichtig ist, führen Sie Schema Intelligence einmalig darauf aus. Nova → Intelligenz. Der Meine Schlüssel Die Registerkarte zeigt ein Abdeckungsfeld pro Anschluss an. Wie Schema Intelligence funktioniert.

Was die Pläne erlauben

MCP ist in allen Tarifen, auch im kostenlosen Tarif, ohne zusätzliche Gebühren enthalten. Jeder Tarif legt fest, wie viele Tasten oder verbundene Apps Sie halten können und wie viele Anrufe Claude pro Minute tätigen darf:

Eine verbundene App zählt als Schlüssel. Zusätzlich zum Minutenwert kann jeder Schlüssel maximal 10 Abfragen pro Minute ausführen. Eine Abfrage liefert bis zu 1.000 Zeilen und läuft bis zu 60 Sekunden, sofern Claude keine weiteren Abfragen anfordert. Die maximale Anzahl an Zeilen und die maximale Laufzeit betragen fünf Minuten. Die von Claude empfangenen Zeilen werden auf Ihr Datenkontingent angerechnet, das gleiche Kontingent, das auch Ihre Excel- und Tabellenkalkulationsabfragen nutzen. Die MCP-Werte werden vor der Komprimierung gemessen, daher sind die Kosten für ein umfangreiches Ergebnis hier höher als für dieselben Zeilen in einer Tabellenkalkulation. Schema Intelligence-Abfragen, die von Claude gestartet werden, verbrauchen Nova AI-Credits, genau wie Abfragen über das Portal. Siehe die Preisseite für die Zulagen.

Es sicher aufbewahren

Gute nächste Schritte

• Speichern Sie die Abfragen, die Sie als kanonisch betrachten. Im Abfrage-Generator greift Claude zuerst auf gespeicherte Abfragen zu, daher bedeutet „aktive Kunden“ genau das, was Ihr Team darunter versteht.
• Verwenden Sie ein Claude-Projekt mit angehängten Query Streams und fügen Sie Ihre Hausregeln in die Anweisungen ein: welche AlloyDB-Datenbank standardmäßig verwendet werden soll, welche gespeicherten Abfragen die offiziellen Definitionen sind.
• Grant Analyze, wenn Sie tiefergehende Antworten wünschen. Die Profilerstellung einer Spalte vor dem Filtern ist der Unterschied zwischen dem Raten eines Statuscodes und der Verwendung des richtigen. Dies verbraucht Nova-KI-Credits und ist daher deaktiviert, bis Sie es explizit anordnen.
• Bitten Sie um eine Übersicht. claude.ai erstellt Diagramme aus den Zeilen, die Claude zurückerhält.

Wenn etwas nicht funktioniert

Fragen, die Menschen stellen

Verwandte Leitfäden

• Verbinden Sie Microsoft SQL Server mit Claude mithilfe von MCP
• Verbinden Sie PostgreSQL mit Claude mithilfe von MCP
• Verbinden Sie MySQL mit Claude mithilfe von MCP
• Verbinden Sie Microsoft Access mit Claude mithilfe von MCP
• Query Streams über MCP mit Claude verbinden: Einrichtung, Berechtigungen und Fehlerbehebung
• Alle MCP-Leitfäden