Query Streams über MCP mit Claude verbinden: Einrichtung, Berechtigungen und Fehlerbehebung

Verbinden Sie Query Streams mit Claude und stellen Sie Fragen zu Ihren Datenbanken in Klartext. Claude liest Ihr Schema, Ihre gespeicherten Abfragen und Ihre Semantische Intelligenz Das Modell läuft live, führt schreibgeschützte SQL-Abfragen über Ihren Netzwerkagenten aus und sieht niemals ein Datenbankpasswort. Ihr KI-Client fragt ab; der Netzwerkagent, sein Partner in Ihrem Netzwerk, erledigt die rechenintensive Arbeit dort, wo die Daten gespeichert sind. Diese Anleitung behandelt claude.ai, Claude Desktop, ChatGPT und Claude Code sowie alle anderen MCP-Clients.

Bevor Sie beginnen

Sie benötigen vier Dinge. Wenn Sie Query Streams innerhalb von Claude gefunden haben, müssen Sie noch den Agenten und einen Konnektor einrichten.

So funktioniert es

Claude stellt keine Verbindung zu Ihrer Datenbank her. Er kommuniziert mit dem Query Streams MCP-Server in unserer Cloud, der jede Anfrage über die einzige ausgehende Verbindung weiterleitet, die Ihr Netzwerkagent bereits offen hält. Der Agent führt die Abfrage lokal aus und streamt die Zeilen auf demselben Weg zurück. Anfragen und Ergebnisse fließen in beide Richtungen über diesen einen, vom Agenten initiierten Kanal, sodass keine Firewall-Konfiguration erforderlich ist.

Aus diesem Entwurf ergeben sich drei Eigenschaften:

• Keine Referenzen in Claude. Ihre Datenbankverbindungszeichenfolge befindet sich auf dem Agenten. Claude besitzt lediglich eine OAuth-Berechtigung oder einen MCP-Schlüssel, die Sie beide mit einem Klick über das Portal widerrufen können.
• Schreibgeschützt, wird vom Agenten durchgesetzt. Nur SELECT, MIT und ERKLÄREN Die Erklärungen werden akzeptiert. Die Prüfung erfolgt auf Ihrer Seite der Verbindung, nicht in der Cloud und nicht in Claude.
• Alles wird protokolliert. Jeder Toolaufruf erscheint auf der MCP-Seite. Aktivität Registerkarte und jede Abfrage im Abfrageverlauf, zugeordnet dem Benutzer, der die Verbindung hergestellt hat.

Verbinden Sie Ihren KI-Client

Die MCP-Seite im Portal (Streams → Live → MCP) hat vier Registerkarten: Verbindungen, Kontext, Werkzeuge und für Administratoren AktivitätZum Thema Verbindungen Verbinden Sie einen KI-Client Durch Klicken dieser Schaltfläche wird eine vierstufige Anleitung geöffnet: Wie wird Ihr KI-Client die Verbindung herstellen?, Wählen Sie Ihren KI-Client, Richten Sie es ein. und Überprüfen Sie die Verbindung.Es gibt zwei Zugriffswege. Chat-Apps genehmigen den Zugriff über die App und benötigen keinen Schlüssel. Entwicklertools verwenden einen MCP-Schlüssel. Beide greifen auf denselben Server und dieselben Tools zu.

Option A: claude.ai, Claude Desktop und ChatGPT (Genehmigung über die App, kein Schlüssel erforderlich)

1. Öffnen Sie die Abfragestreams-Liste und klicken Sie VerbindenDer Konnektor synchronisiert sich mit Ihrem Claude-Konto, daher wird er in Claude Desktop unter folgendem Pfad angezeigt: + → Konnektoren. Sie können den Eintrag nicht sehen? Ihre Organisation kann die Verwendung von Verzeichnisverbindungen einschränken: in Einstellungen → Konnektoren klicken Benutzerdefinierten Konnektor hinzufügen, nenne es Abfrageströme, Paste https://mcp.querystreams.com/mcpdann im Chat klicken +, wählen Abfrageströme und klicken Sie Verbinden.
2. Es öffnet sich ein neuer Browsertab mit dem Einwilligungsbildschirm für Query Streams. Melden Sie sich gegebenenfalls an, wählen Sie die Organisation aus, überprüfen Sie die Berechtigungen (siehe unten) und klicken Sie auf „Zustimmen“. Verbindung genehmigen.
3. Zurück in Claude werden Sie sehen Verbunden mit AbfrageströmenWenn Claude ein Werkzeug zum ersten Mal benutzt, fragt es um Erlaubnis. Wählen Sie Immer erlauben So funktioniert es, ohne dass bei jedem Anruf eine Aufforderung erforderlich ist.

Die Verbindung ist mit Ihrem Claude-Konto verknüpft, nicht mit einem einzelnen Gerät, und wird daher automatisch in den Claude-Mobil-Apps und auf dem Claude-Desktop angezeigt. Sie können die Verbindung jederzeit über das Portal verwalten oder widerrufen. MCP → Verbindungen Tab.

ChatGPT. Query-Streams direkt in der App hinzufügen: Das bedeutet vorerst, den Entwicklermodus in den ChatGPT-Einstellungen zu aktivieren, dort die Verbindung herzustellen und anschließend auf „…“ zu klicken. Mit Query Streams anmelden und die Zustimmung auf demselben Bildschirm zu erteilen. Die Portalanleitung zeigt die aktuellen ChatGPT-Schritte; ein offizieller ChatGPT-Eintrag ist in Vorbereitung.

Option B: Claude Code, Cursor und andere Entwicklertools (MCP-Schlüssel)

Die Entwicklertools authentifizieren sich mit einem Schlüssel, den Sie im Portal generieren und übergeben. X-MCP-Schlüssel Kopfzeile.

1. Anmelden unter mein.querystreams.de, offen MCP und klicken Sie Verbinden Sie einen KI-Client. Wählen Verwenden Sie einen Schlüssel in einer Konfigurationsdatei und wähle dein Werkzeug.
2. Klicken Sie auf Generieren Sie einen Schlüssel für Ihr Werkzeug. Benennen Sie es nach dem Werkzeug und der Maschine, zum Beispiel claude-code-laptop, halten Lesen und Abfragen ausführenund wählen Sie ein Ablaufdatum. Sie können den Schlüssel später erneut anzeigen und kopieren. Verbindungen Tabulator. Die Tasten sehen so aus: qsmcp_ gefolgt von 43 Zeichen.
3. Richten Sie es ein. Zeigt die sofort einfügbare Konfiguration für Cursor, VS Code, Windsurf, Zed, JetBrains, Gemini CLI, Codex CLI, Continue, Cline und weitere Programme, wobei Ihr Schlüssel bereits eingetragen ist. Für Claude Code ist es ein einziger Befehl:
   claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp --header "X-MCP-Key: qsmcp_PASTE_KEY_HERE"
4. Überprüfen Sie die Verbindung. wartet auf den ersten Anruf von dieser Taste und sagt Verbunden.

Um dies jederzeit zu überprüfen, fragen Sie nach „Welche Query Streams-Konnektoren habe ich?“ Der Kunde sollte anrufen qs_list_connectorsund der Schlüssel Zuletzt verwendet Die Zeitangabe auf der Registerkarte „Verbindungen“ wird innerhalb von Sekunden aktualisiert.

Berechtigungen

Unabhängig davon, ob Sie die Verbindung per OAuth oder per Schlüssel herstellen, wird der Zugriff durch drei Bereiche gesteuert. Diese werden auf dem Zustimmungsbildschirm angezeigt; anhand dieser Bereiche wird ein Schlüssel erstellt.

Eine verbundene App kann bei der Genehmigung auf bestimmte Konnektoren beschränkt werden; ein generierter Schlüssel erreicht alle Konnektoren in der Organisation. Der Widerruf einer Berechtigung oder eines Schlüssels wird innerhalb von etwa fünf Minuten wirksam. Administratoren können alle aktiven Berechtigungen und Schlüssel der Organisation auf der Registerkarte „Verbindungen“ einsehen.

Was Ihr KI-Client nach der Verbindung leisten kann

Ihr KI-Client erkennt die Abfragestream-Tools und wählt das passende für Ihre Frage aus; Sie müssen diese Tools nie selbst aufrufen. Das Portal Registerkarte „Tools“ listet alle Tools und Modi auf, erklärt, wozu sie dienen, und zeigt, welche in Ihrem Tarif enthalten sind.

Bei einer Frage zu Ihren Daten führt Query Streams Ihren KI-Client durch vier Schritte: Ihre Connectoren auflisten, die Tabellen der Datenbank lesen, die Spalten jeder abzufragenden Tabelle lesen und anschließend eine schreibgeschützte Abfrage ausführen. Das vorherige Lesen der Spalten verhindert, dass Namen geraten werden. In allen Tarifen, einschließlich Free:

Das Analyse-Toolset

Bei den kostenpflichtigen Tarifen übernimmt der Netzwerkagent die Vorarbeit, wo Ihre Daten gespeichert sind: Er misst, profiliert, speichert und analysiert Ergebnisse, sodass Ihr KI-Client jede Frage mit dem vorbereiteten Kontext angeht und sich auf das eigentliche Denken konzentrieren kann. Der kostenlose Tarif funktioniert wie gewohnt mit Standardergebnissen. Die vollständige Anleitung finden Sie hier. Analysieren Sie Ihre Daten mit Ihrem KI-Client..

Sie behalten die Kontrolle. Der Kontext-Registerkarte Legt die Standardeinstellungen fest: Textzellenlimit, Schemaansicht für große Datenbanken, Ergebnisgröße und Analysestandards. Außerdem zeigt es an, was Ihr KI-Client empfängt. Zusätzlich werden die Ergebnisse jedes Agenten aufgelistet. Jede Taste kann die Standardeinstellungen überschreiben, jeder Aufruf wird auf der Registerkarte „Aktivität“ angezeigt, und ein Administrator kann die Einstellungen ändern. Lokale Analyse abwesend für einen Agenten unter Daten → Datenagenten.

Was Ihr Plan beinhaltet

MCP ist in jedem Tarif enthalten, auch im kostenlosen Tarif, und der kostenlose Tarif läuft nie ab.

Eine verbundene App zählt als Schlüssel. In jedem Tarif führt jeder Schlüssel maximal 10 Abfragen pro Minute aus. Die Anzahl der Zeilen pro Abfrage gibt die maximale Anzahl an Zeilen an, die eine Abfrage an Ihren KI-Client zurückgibt. Bei einer Anfrage nach mehr Zeilen wird das Limit Ihres Tarifs erreicht und dies angezeigt – es wird niemals ein Fehler ausgegeben. Ein gespeichertes Ergebnis wird für Folgeabfragen bis zum im Tarif festgelegten Zeit- und Größenlimit aufbewahrt, sofern die Rechenleistung des Agentenrechners dies zulässt. Alle Tarife im Vergleich: Preisgestaltung.

Warum semantische Intelligenz hier wichtig ist

Jede Antwort, die Claude erhält, wird mit der Angabe versehen, aus welcher von drei Ebenen sie stammt, und Claude passt an, wie sehr er dem Gesehenen vertraut.

Wenn eine Datenbank für Ihr Team wichtig ist, führen Sie Semantic Intelligence einmalig dafür aus. Bei großen Datenbanken beschränken Sie die Ausführung auf die Tabellen, die Ihre Abfragen tatsächlich verwenden. Wie semantische Intelligenz funktioniert →

Beispielhafte Eingabeaufforderungen

Beginnen Sie mit einer Frage, deren Antwort Sie bereits kennen. Stellen Sie dann Nachfragen; Claude behält den Kontext im Blick.

Tipps für bessere Antworten

• Verwenden Sie ein Claude-Projekt. Verknüpfen Sie den Query Streams-Connector mit einem Projekt und definieren Sie Ihre Geschäftsregeln in den Projektanweisungen: welche Datenbank standardmäßig verwendet werden soll, welche gespeicherten Abfragen die offiziellen Definitionen darstellen und welche Namenskonventionen gelten. Claude liest das Schema weiterhin live, sodass die Anweisungen kurz bleiben.
• Speichern Sie die Abfragen, die Sie als kanonisch betrachten. Claude greift zuerst auf gespeicherte Abfragen zurück, daher bedeutet „aktive Kunden“ genau das, was Ihr Team darunter versteht.
• Gewähren Sie den Analysebereich. Die Profilierung einer Spalte vor dem Filtern danach ist der Unterschied zwischen dem Raten eines Statuscodes und der Verwendung des richtigen.
• Bitten Sie um eine Übersicht. claude.ai rendert Diagramme aus den Zeilen, die Claude zurückerhält.

Was es kostet

MCP selbst erhebt in keinem Tarif eine separate Gebühr. Zwei Dinge werden verbrauchsabhängig abgerechnet:

• Datenvolumen. Von Query-Ergebnissen, die an Claude zurückgegeben werden, wird dasselbe Data-Realm-Budget beansprucht, das auch von der Nutzung in Excel, Google Sheets, Portal und Nova gemeinsam genutzt wird. Über MCP wird jedes an Claude übertragene Byte gezählt – Ergebnisse, Schema-Lesevorgänge und Seiten mit gespeicherten Ergebnissen – und zwar vor jeglicher Transportkomprimierung, da ein KI-Client sie unkomprimiert empfängt. Bei Tabellenkalkulationen, Portal und API zählt das komprimierte Ergebnis, das Ihr Network Agent überträgt. Eine fehlgeschlagene Antwort wird nie angerechnet. Halten Sie explorative Fragen klein; bei Tarifen mit Context management vermeiden Sie unnötig abgerufene Zeilen, wenn Sie Claude zuerst die Größe eines Ergebnisses bestimmen lassen (mode: shape).
• Semantische Intelligenz wird ausgeführt. Wenn Sie eine Analyse über Claude in die Warteschlange stellen, werden Ihrem Unternehmen KI-Guthaben belastet, genau wie bei der Ausführung über das Portal. Claude fragt vorher nach.

Fehlerbehebung

Immer noch keine Lösung? E-Mail [email protected].

Sicherheit und Datenschutz

• Claude empfängt Schema-Metadaten, Beschreibungen der semantischen Intelligenz einschließlich Beispielwerten und die Ergebnisse Ihrer Abfragen. Mit dem Analyse-Toolset erhält er stattdessen häufig eine Größenschätzung, ein Profil oder ein vorläufiges Ergebnis, während das vollständige Ergebnis beim Agenten verbleibt. Die empfangenen Daten werden gemäß den Bedingungen des von Ihnen gewählten KI-Anbieters an diesen übermittelt.
• Query Streams empfängt oder speichert Ihre Claude-Konversation nicht.
• OAuth-Berechtigungen und -Schlüssel gelten pro Benutzer und pro Organisation. Ein Administrator kann alle Berechtigungen und Schlüssel auf der MCP-Seite einsehen und widerrufen.
• Alle Einzelheiten finden Sie in unserem Datenschutzerklärung und Bedingungen der Dienstleistung.

Häufig gestellte Fragen

Muss ich einen Port öffnen oder ein VPN einrichten?
Nein. Der Agent stellt eine ausgehende TLS-Verbindung über Port 443 her. Wenn ausgehendes HTTPS funktioniert, funktioniert auch MCP.

Kann Claude meine Daten ändern?
Nein. Der Agent akzeptiert nur Leseanweisungen. Claude kann einen Semantic-Intelligence-Lauf in die Warteschlange stellen und im Testlaufmodus eine Warnregel vorschlagen; beides schreibt in die Metadaten von Query Streams, niemals in Ihre Datenbank.

Welche anderen KI-Tools funktionieren?
Alles, was MCP unterstützt: ChatGPT, Cursor, Claude Code, Windsurf, Zed, VS Code Copilot, JetBrains AI, Gemini CLI, Codex CLI, Continue, Cline und mehr. Das Portal Verbinden Sie einen KI-Client Der Leitfaden enthält für jeden Parameter eine vorgefertigte Konfiguration.

Was ist ein vorläufig feststehendes Ergebnis?
Bei Tarifen mit Ergebnisanalyse kann Ihr KI-Client den Agenten anweisen, ein vollständiges Ergebnis für eine gewisse Zeit zu speichern. Folgefragen, wie z. B. eine Aufschlüsselung nach Region oder die nächste Seite mit Zeilen, werden dann anhand dieser Kopie ohne erneute Datenbankabfrage beantwortet. Die Speicherdauer und der Umfang eines gespeicherten Ergebnisses hängen vom gewählten Tarif ab.

Welche Tarife beinhalten das Analysetoolset?
Kontextmanagement und Ergebnisanalyse sind ab Personal Core enthalten; eine tiefergehende Analyse ab Business Core. Der Plantisch enthält die Details.

Ändert sich dadurch der kostenlose Tarif?
Nein. Der kostenlose Tarif funktioniert wie immer und liefert die üblichen Ergebnisse.

Funktioniert es mit mehreren Organisationen?
Jede Förderung oder jeder Schlüssel ist an eine bestimmte Organisation gebunden. Stellen Sie für jede benötigte Organisation eine separate Verbindung her.

Worin besteht der Unterschied zwischen diesem Produkt und Nova?
Nova ist der im Query Streams Portal integrierte Assistent und verwendet dasselbe semantische Intelligenzmodell. Nutzen Sie Nova, wenn Sie Antworten direkt in Query Streams benötigen; verwenden Sie MCP, wenn Sie Ihre Daten in Claude zusammen mit allen anderen dort verwendeten Funktionen nutzen möchten.

Steckverbinderspezifische Leitfäden

Jeder Leitfaden erläutert die gleiche Verbindung anhand von Beispielen für diese Quelle.

Datenbanken: Microsoft SQL-Server · PostgreSQL · MySQL · MariaDB · Oracle · Schneeflocke · Google BigQuery · SQLite · Microsoft Access · DuckDB · Supabase

APIs: Streifen · Shopify · HubSpot · Google Ads · Google Analytics 4 · Google Suchkonsole · ShipStation · iTick

Ordner mit Dateien und Protokollen (Der Agent scannt einen Ordner und wandelt die Dateien in Tabellen um): Dateisystem · CSV-Ordner · Parkettordner · Excel-Ordner · SQLite-Ordner · JSONL-Ordner · CSV-Datei mit mehreren Datensätzen · Maschinenprotokolle · Webserver-Protokolle · Containerprotokolle · Anwendungsprotokolle · Systemprotokolle · Benutzerdefinierte Protokolle

Gehostete Datenbanken (verwaltete PostgreSQL-, MySQL-, MariaDB- und SQL-Server-Datenbanken, die vom Agenten über TLS erreicht werden): Neon · Amazon RDS · Azure-Datenbank für PostgreSQL · Azure-Datenbank für MySQL · Azure SQL · Google Cloud SQL · Google AlloyDB · DigitalOcean Managed Databases · Aiven · Knirschende Brücke · Heroku Postgres · Machen · Eisenbahn · Fly.io Postgres · Vultr Managed Databases · OVHcloud Managed Databases · Scaleway Managed Databases · OCI-Datenbank mit PostgreSQL · MySQL HeatWave · IBM Cloud-Datenbanken für PostgreSQL · MariaDB SkySQL · Xata · Zeitskalen-Cloud · PlanetScale Postgres · Prisma Postgres · Koyeb · Nil