Verbind querystreams met Claude en stel vragen over uw databases in begrijpelijke taal. Claude leest uw schema, uw opgeslagen query's en uw Schema Intelligence-model live, voert alleen-lezen SQL uit via uw netwerkagent en ziet nooit een databasewachtwoord. Deze handleiding behandelt claude.ai, Claude Desktop en Claude Code, plus alle andere MCP-clients.
Korte versie. Query Streams is in the Anthropic Connectors Directory. In claude.ai open Settings → Connectors → Browse connectors, vinden Query-stromen, klik Verbindenkeur de machtigingen goed op het toestemmingsscherm van Query Streams en vraag het aan Claude. “Tot welke databases heb ik toegang?” That’s it.
Voordat je begint
Je hebt vier dingen nodig. De meeste accounts hebben de eerste drie al.
Een plan dat MCP omvat.
MCP is beschikbaar in alle abonnementen, ook in het gratis abonnement. Het verschil per abonnement zit hem in het aantal toetsen of gekoppelde apps dat je kunt gebruiken en het aantal gesprekken dat Claude per minuut mag voeren; met het gratis abonnement kun je één toets of één gekoppelde app gebruiken en 30 gesprekken per minuut voeren.
Een netwerkagent die online is
De agent is de kleine service die naast uw database draait en één uitgaande verbinding met Query Streams tot stand brengt. Als uw team al query's uitvoert in de portal, Excel of Google Sheets, is deze al geïnstalleerd. Installatiehandleiding →
Ten minste één connector
Een connector is een database of API-bron die in het portaal is geregistreerd. Claude ziet elke connector die uw account kan zien, afhankelijk van de machtigingen die u verleent.
MCP-toegang voor uw gebruiker
Organisatiemakers en -eigenaren hebben automatisch toegang tot MCP. Andere gebruikers hebben een beheerder nodig om dit aan te vinken. MCP naast hun naam in Account → Toegangsbeheer.
Hoe het werkt
Claude maakt nooit verbinding met uw database. Het communiceert met de Query Streams MCP-server in onze cloud, die elk verzoek doorstuurt via de enige uitgaande verbinding die uw Network Agent al openhoudt. De agent voert de query lokaal uit en streamt de rijen op dezelfde manier terug. Verzoeken en resultaten stromen in beide richtingen via dat ene door de agent geïnitieerde kanaal, dus er hoeft niets op uw firewall te worden geopend.
OAuth, scopes, audit, snelheidslimieten
één uitgaande TLS-verbinding
Uit dat ontwerp vloeien drie eigenschappen voort:
- Geen referenties in Claude. Uw databaseverbindingsreeks bevindt zich op de agent. Claude bewaart alleen een OAuth-machtiging of een MCP-sleutel, die u beide met één klik vanuit de portal kunt intrekken.
- Alleen-lezen, alleen geldig bij de agent. Alleen
SELECT,METenUITLEGGENVerklaringen worden geaccepteerd. De controle vindt plaats aan uw kant van de verbinding, niet in de cloud en niet in Claude. - Alles wordt geregistreerd. Elke tooloproep verschijnt op de MCP-pagina. Activiteit tab en elke query in de querygeschiedenis, toegewezen aan de gebruiker die verbinding heeft gemaakt.
Verbind Claude
Er zijn twee manieren om toegang te krijgen. Chat-apps gebruiken OAuth en hebben geen sleutel nodig. Ontwikkelaarstools gebruiken een MCP-sleutel. Beide methoden maken verbinding met dezelfde server en dezelfde tools.
Optie A: claude.ai en Claude Desktop (OAuth, geen sleutel)
Listed in the Anthropic Connectors Directory. Query Streams is an approved connector: claude.ai/directory/query-streams. On claude.ai and in Claude Desktop you can connect it with one click from Connectoren bekijken; no server URL needed. The custom-connector route below still works and is what to use if your Claude organization restricts directory connectors.
- Op claude.ai open Settings → Connectors → Browse connectors, zoeken naar Query-stromen en klik Verbinden (or open the directory listing directly). In Claude Desktop the same option is under Instellingen → Connectoren. Can’t see it? Your organization may restrict directory connectors: click Voeg een aangepaste connector toe instead, name it Query-stromen and paste
https://mcp.querystreams.com/mcp. - Open een chat en klik op de + knop naast het berichtenvenster kiezen Query-stromen en klik Verbinden.
- In een nieuw browsertabblad wordt het toestemmingsscherm van Query Streams geopend. Meld u aan als daarom wordt gevraagd, selecteer de organisatie, controleer de machtigingen (zie hieronder) en klik op Verbinding goedkeuren.
- Terug in Claude zul je zien Verbonden met querystreamsClaude gebruikt een tool voor het eerst en die vraagt om toestemming. Kies Altijd toestaan zodat het kan werken zonder bij elk gesprek een prompt te hoeven weergeven.
De connector is gekoppeld aan uw Claude-account, niet aan één apparaat, waardoor deze automatisch verschijnt in de Claude-apps voor mobiele apparaten en Claude Desktop. U kunt de connector op elk gewenst moment beheren of intrekken via het portaal. MCP → Verbonden apps tab.
Niet hetzelfde als "Marktplaats toevoegen". In Claude Desktop is er een chatfunctie. + → Connectoren bekijken → Marktplaats toevoegen Deze optie vereist een Git-repository voor plugin-marktplaatsen, niet een MCP-server-URL. Gebruik Instellingen → Connectoren → Toevoegen.
Optie B: Claude Code, Cursor en andere ontwikkelaarstools (MCP-sleutel)
Ontwikkelaarstools authenticeren met een sleutel die u in de portal genereert en geven de volgende informatie door: X-MCP-sleutel koptekst.
- Meld u aan bij mijn.querystreams.nl, open MCP → Mijn sleutels en klik Sleutel genererenGeef het een naam die overeenkomt met het gereedschap of de machine, bijvoorbeeld: claude-code-laptopen de bijbehorende scopes te kiezen.
- Kopieer de sleutel nu. Je kunt hem later weer weergeven en kopiëren. Mijn sleutelsDe sleutels zien eruit als
qsmcp_gevolgd door 43 tekens. - Voer voor Claude Code het volgende commando uit:
claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp --header "X-MCP-Key: qsmcp_PASTE_KEY_HERE" - Voor Cursor, VS Code, Windsurf, Zed, JetBrains, Gemini CLI, Codex CLI, Continue en Cline, open de MCP → Verbinden tab in de portal. Daar wordt een kant-en-klare configuratie voor elke client weergegeven, waarbij uw sleutel al is ingevuld.
Om dit te verifiëren, kunt u vragen Welke Query Streams-connectoren heb ik? De klant moet bellen qs_list_connectors en de sleutel laatst gebruikt De tijd wordt binnen enkele seconden bijgewerkt op het tabblad 'Mijn sleutels'.
Toestemmingen
Of je nu verbinding maakt via OAuth of via een sleutel, de toegang wordt beheerd door drie scopes. Deze worden weergegeven op het toestemmingsscherm; er wordt een sleutel mee aangemaakt.
| Domein | Wat Claude kan doen | Wanneer moet je het toekennen? |
|---|---|---|
| lezen | Connectoren en agents weergeven, schema's bekijken, Schema Intelligence-beschrijvingen lezen, opgeslagen query's en waarschuwingsregels weergeven. | Altijd. Al het andere bouwt daarop voort. |
| analyseren | Profileer tabellen (voorbeeldwaarden, verdelingen, semantische typen), ontdek impliciete relaties en plan een Schema Intelligence-run in. | Aanbevolen. Dit stelt Claude in staat de structuur van uw gegevens te begrijpen voordat hij joins schrijft. |
| uitvoeren | Voer alleen-lezen SQL-query's en opgeslagen query's uit en stream de rijen terug. | Voor iedereen die antwoorden wil, en niet alleen de structuur wil bekijken. Laat deze optie uitgeschakeld voor een sleutel die alleen voor het bekijken van gegevens geschikt is. |
Een gekoppelde app kan bij goedkeuring worden beperkt tot specifieke connectors; een gegenereerde sleutel bereikt elke connector in de organisatie. Het intrekken van een machtiging of sleutel wordt binnen ongeveer vijf minuten van kracht. Beheerders kunnen alle actieve machtigingen en sleutels voor de organisatie bekijken op de MCP-pagina.
Wat Claude kan doen zodra hij verbonden is.
Claude ziet een kleine set hulpmiddelen. Je hoeft ze zelf nooit te benoemen; Claude kiest het juiste hulpmiddel voor jouw vraag. Simpel gezegd:
Begrijp uw gegevens
Toon connectoren, databases en agents. Lees de schemastructuur van elke database met tabel- en kolomomschrijvingen, semantische typen, voorbeeldwaarden, enum-labels en zowel gedeclareerde als ontdekte relaties.
Profiel bekijken en ontdekken
Analyseer een tabel om de werkelijke waardeverdeling te bekijken voordat u een filter schrijft. Ontdek koppelingen tussen tabellen zonder gedeclareerde foreign keys.
Gebruik uw opgeslagen zoekopdrachten
Geef een overzicht van de opgeslagen, geparameteriseerde query's van uw organisatie en voer ze uit met verschillende parameters. Gefedereerde query's die meerdere bronnen omvatten, worden aan de serverzijde uitgevoerd en retourneren reeds samengevoegde rijen.
Voer ad-hoc SQL uit
Schrijf en voer alleen-lezen SQL-query's uit in het juiste dialect voor de connector. De resultaten bevatten standaard 1000 rijen en een time-out van 60 seconden, beide instelbaar.
Controleer meldingen
Bekijk de alarmregels, hun huidige status en recente activering. Claude kan een nieuwe regel voorstellen in de testmodus; een gebruiker activeert deze op de pagina 'Alerts'.
Verbeter het model
Controleer de dekking van Schema Intelligence per database en plan, met uw toestemming, een analyse in zodat toekomstige resultaten beter zijn.
Waarom schema-intelligentie hier belangrijk is
Elk antwoord dat Claude ontvangt, wordt gelabeld met de categorie waartoe het behoort (drie niveaus), en Claude past vervolgens aan in hoeverre hij de ontvangen informatie vertrouwt.
| Laag | Wat Claude ziet | Resultaat |
|---|---|---|
| Schema-intelligentie | Beschrijvingen voor elke tabel en kolom, semantische typen, enum-labels, voorbeeldwaarden, classificatie van feiten en dimensies, gedeclareerde en ontdekte joins. | Claude schrijft in één keer productieklare SQL-query's en legt de gegevens uit in termen die bij uw bedrijf passen. |
| Vastgelegd schema | Tabel- en kolomnamen, gegevenstypen, primaire sleutels, indexen, gedeclareerde externe sleutels. | Claude kan het wel, maar moet de betekenis afleiden uit namen en heeft mogelijk een vervolgvraag nodig. |
| Live schema | De database is niet opgenomen in de selectie van de connector, waardoor de structuur bij elk verzoek live uit de catalogus wordt gelezen. | De query's worden nog steeds uitgevoerd. Claude verkent de resultaten met behulp van steekproefselecties wanneer dat nodig is. |
Als een database belangrijk is voor je team, voer dan eenmaal Schema Intelligence erop uit. Voor grote databases kun je de uitvoering beperken tot de tabellen die je query's daadwerkelijk gebruiken. Hoe schema-intelligentie werkt →
Voorbeelden van prompts
Begin met iets waarvan je het antwoord al weet. Stel vervolgens vervolgvragen; Claude zorgt ervoor dat de context behouden blijft.
Tot welke databases en tabellen heb ik toegang, en welke daarvan beschikken over Schema Intelligence?Het brengt je verbindingspunten in kaart en laat je zien waar de antwoorden het sterkst zullen zijn. Laat me zien hoe klanten zich verhouden tot bestellingen in de verkoopdatabase en profileer de kolom met de bestelstatus.Maakt gebruik van relaties en kolomprofilering. Claude zal u de daadwerkelijke statuscodes en hun betekenis laten zien. Voer de opgeslagen query "Maandelijkse omzet per regio" uit voor het tweede kwartaal van dit jaar.Voert een vertrouwde, opgeslagen query met parameters uit in plaats van zelf een SQL-query te genereren. De 10 producten met de hoogste omzet in de afgelopen 90 dagen. Vervolgens een uitsplitsing per kanaal.Ad-hoc SQL in het dialect van de connector, gevolgd door een vervolg op dezelfde thread. Welke waarschuwingsregels zijn geconfigureerd en zijn er deze week waarschuwingsregels geactiveerd?Leest de waarschuwingsregels en hun recente status.Tips voor betere antwoorden
- Gebruik een Claude-project. Koppel de Query Streams-connector aan een project en plaats uw bedrijfsregels in de projectinstructies: welke database standaard moet worden gebruikt, welke opgeslagen query's de officiële definities zijn en welke naamgevingsconventies gelden. Claude leest het schema nog steeds live, waardoor de instructies kort en bondig blijven.
- Bewaar de zoekopdrachten die u als canoniek beschouwt. Claude zoekt eerst naar opgeslagen zoekopdrachten, dus "actieve klanten" betekent precies wat jouw team ermee bedoelt.
- Geef de analyseomvang de ruimte. Het profileren van een kolom vóórdat je erop filtert, maakt het verschil tussen het gokken van een statuscode en het gebruiken van de juiste.
- Vraag om een schema. claude.ai genereert grafieken op basis van de rijen die Claude terugkrijgt.
Wat het kost
MCP zelf brengt geen aparte kosten in rekening voor welk abonnement dan ook. Twee zaken worden gemeten:
- Gegevensvolume. De queryresultaten die naar Claude worden teruggestuurd, tellen mee voor hetzelfde databudget dat u deelt met uw gebruik van Excel, Google Sheets, Portal en Nova. Omdat MCP via HTTP werkt zonder end-to-end-compressie, wordt het gemeten in niet-gecomprimeerde bytes. Een resultaat van 1 MB kost dus ongeveer 1 MB, terwijl hetzelfde resultaat in Excel doorgaans 150 tot 250 KB kost.
preview_limitGeschikt voor verkennende vragen. - Schema Intelligence wordt uitgevoerd. Het in de wachtrij plaatsen van een analyse via Claude brengt AI-credits in rekening bij uw organisatie, net zoals wanneer u de analyse via het portaal uitvoert. Claude vraagt hierom voordat dit gebeurt.
Probleemoplossing
| Wat je ziet | Wat het betekent | Repareren |
|---|---|---|
| Claude toont geen Query Streams-tools. | De connector is wel toegevoegd, maar niet verbonden vanuit een chat, of de OAuth-goedkeuring is nooit voltooid. | Open een chat, klik +, kies Query Streams, Verbindenen voltooi het toestemmingsscherm. |
MCP_SLEUTEL_VEREIST of 401 | Er is geen sleutel of machtiging bij de server aangekomen. Voor clients die sleutels gebruiken, is dit meestal een kopieer- en plakfout, zoals een ontbrekende regelovergang of de sleutel in de verkeerde header. | Kopieer de sleutel opnieuw naar de X-MCP-sleutel koptekst. Voor claude.ai, maak opnieuw verbinding via het + menu. |
MCP_TOKEN_EXPIRED | Het OAuth-token is verlopen na een periode van inactiviteit. | Claude vernieuwt zich normaal gesproken vanzelf. Zo niet, koppel dan de connector los en sluit deze opnieuw aan. |
MCP_KEY_REVOKED of MCP_GEBRUIKER_UITGESCHAKELD | De sleutel is ingetrokken of de MCP-toegang is voor uw gebruiker uitgeschakeld. | Genereer een nieuwe sleutel of vraag een beheerder om MCP opnieuw in te schakelen. Account → Toegangsbeheer. |
MCP_SCOPE_REQUIRED | De subsidie of sleutel biedt daarvoor meestal niet de nodige ruimte. uitvoeren. | Maak opnieuw verbinding en keur het ontbrekende bereik goed, of genereer een sleutel die het bereik wel bevat. |
MCP_PLAN_VERLOPEN | Het abonnement van uw organisatie is verlopen. | De MCP-pagina in het portaal toont de huidige status van het plan en de verdere stappen die gezet moeten worden. |
MCP_AGENT_NIET_VERBONDEN | De netwerkagent die eigenaar is van de connector is momenteel niet verbonden. | Rekening Data Agents In het portaal. Start de agentservice op de host. |
MCP_CONNECTOR_NIET_TOEGESTAAN | De sleutel is beperkt tot specifieke connectoren en dit is er geen van. | Bewerk de lijst met toegestane connectoren van de sleutel in 'Mijn sleutels' of gebruik een andere sleutel. |
MCP_DATABASE_NOT_CAPTURED | De database is niet opgenomen in de schema-capture-selectie van de connector, waardoor er geen schema-intelligentie of opgeslagen relaties beschikbaar zijn om te lezen. Query's werken echter nog steeds. | Voeg de database toe aan de selectie voor vastlegging op de connector in de portal en voer vervolgens optioneel Schema Intelligence uit. |
MCP_RATE_LIMITED | Te veel gesprekken per minuut voor uw abonnement. | Wacht even. Intensieve sessies profiteren van schema-intelligentie, waardoor Claude met minder oproepen kan reageren. |
MCP_QUERY_TIMEOUT | De query heeft de time-out, standaard 60 seconden, overschreden. | Vraag Claude om een filter of een lagere rijlimiet toe te voegen, of verhoog de timeout_seconden tot 300. |
MCP_UITGANG_TE_GROOT | Het resultaat was te omvangrijk om in één antwoord aan Claude te presenteren. | Vraag om minder kolommen of rijen. Claude zal dit meestal zelf voorstellen. |
| Alleen-lezen-schending | De SQL-query bevatte iets anders dan SELECT, MET of UITLEGGEN. | Dit is opzettelijk. Schrijfbewerkingen worden nooit via MCP geaccepteerd. |
Zit je nog steeds vast? Open een ticket op my.querystreams.com/support of e-mail [email protected].
Beveiliging en privacy
- Claude ontvangt schema-metadata, Schema Intelligence-beschrijvingen inclusief voorbeeldwaarden en de resultaten van de door u gestelde vragen. Deze resultaten worden, volgens de voorwaarden van de AI-aanbieder waarmee u verbinding wilt maken, naar die aanbieder verzonden.
- Query Streams ontvangt of bewaart uw Claude-conversatie niet.
- OAuth-machtigingen en -sleutels gelden per gebruiker en per organisatie. Een beheerder kan alle machtigingen en sleutels bekijken en intrekken via de MCP-pagina.
- Alle details vindt u in onze Privacybeleid en Servicevoorwaarden.
Veelgestelde vragen
Moet ik een poort openen of een VPN-verbinding gebruiken?
Nee. De agent maakt één uitgaande TLS-verbinding op poort 443. Als uitgaande HTTPS werkt, werkt MCP ook.
Kan Claude mijn gegevens wijzigen?
Nee. De agent accepteert alleen leesopdrachten. Claude kan een Schema Intelligence-run in de wachtrij plaatsen en een waarschuwingsregel voorstellen in de testmodus; beide schrijven naar de metadata van Query Streams, nooit naar uw database.
Welke andere AI-tools werken?
Alles wat MCP ondersteunt: ChatGPT, Cursor, Claude Code, Windsurf, Zed, VS Code Copilot, JetBrains AI, Gemini CLI, Codex CLI, Continue, Cline en meer. De MCP-pagina van het portaal biedt voor elk een kant-en-klaar configuratiebestand.
Werkt het met meerdere organisaties?
Elke licentie of sleutel is gekoppeld aan één organisatie. Maak één keer verbinding per organisatie die u nodig hebt.
Wat is het verschil tussen dit en Nova?
Nova is de assistent die is ingebouwd in de Query Streams Portal en maakt gebruik van hetzelfde Schema Intelligence-model. Gebruik Nova wanneer u antwoorden wilt binnen Query Streams; gebruik MCP wanneer u uw gegevens in Claude wilt gebruiken, samen met al uw andere activiteiten daar.
Connectorspecifieke handleidingen
Elke handleiding doorloopt dezelfde verbinding met voorbeelden voor die bron.
Databases: Microsoft SQL Server · PostgreSQL · MySQL · MariaDB · Oracle · Sneeuwvlok · Google BigQuery · SQLite · Microsoft Access · DuckDB · Supabase
API's: Streep · Shopify · HubSpot · Google-advertenties · Google Analytics 4 · Google Zoekresultaten · ShipStation · iTick
Mappen met bestanden en logbestanden (De agent scant een map en zet de bestanden om in tabellen): Bestandssysteem · CSV-map · Parquet-map · Excel-map · SQLite-map · JSONL-map · CSV-bestand met meerdere records · Machinelogboeken · Webserverlogboeken · Containerlogboeken · Toepassingslogboeken · Systeemlogboeken · Aangepaste logboeken
Gehoste databases (Beheerde PostgreSQL, MySQL, MariaDB en SQL Server, bereikbaar via TLS door de agent): Neon · Amazon RDS · Azure Database voor PostgreSQL · Azure Database voor MySQL · Azure SQL · Google Cloud SQL · Google AlloyDB · Door DigitalOcean beheerde databases · Aiven · Knapperige brug · Heroku Postgres · Veroorzaken · Spoorweg · Fly.io Postgres · Vultr beheerde databases · OVHcloud beheerde databases · Scaleway beheerde databases · OCI-database met PostgreSQL · MySQL HeatWave · IBM Cloud Databases voor PostgreSQL · MariaDB SkySQL · Xata · Tijdschaalwolk · PlanetScale Postgres · Prisma Postgres · Koyeb · Nijl
Verbind Claude in ongeveer een minuut met je gegevens.
Geen sleutel, geen configuratiebestand, geen VPN. Uitsluitend leesbaar.
Open de MCP-pagina Hoe MCP werkt
English 
Spanish 
German 
French 
Portuguese 
Japanese 
Korean 
Chinese 
Italian 
Dutch 
Indonesian 
Polish