Verbind querystreams met Claude en stel vragen over uw databases in begrijpelijke taal. Claude leest uw schema, uw opgeslagen query's en uw Semantische intelligentie Het model draait live, voert alleen-lezen SQL-query's uit via uw netwerkagent en krijgt nooit een databasewachtwoord te zien. Uw AI-client vraagt erom; de netwerkagent, de partner binnen uw netwerk, doet het zware werk op de plek waar de data zich bevindt. Deze handleiding behandelt claude.ai, Claude Desktop, ChatGPT en Claude Code, plus alle andere MCP-clients.
Korte versie. Installeer de Netwerk Agent Ga een paar minuten naar de server naast je database en voeg een connector toe. Open vervolgens de server. Lijst met querystreams Klik in de Connectors Directory van Anthropic op Verbindenkeur de machtigingen goed op het toestemmingsscherm van Query Streams en vraag het aan Claude. “Tot welke databases heb ik toegang?” Claude kan alleen gegevens zien die door een agent worden aangeboden: sla de agent over en hij zal je vertellen dat er geen connectoren zijn.
Voordat je begint
Je hebt vier dingen nodig. Als je Query Streams vanuit Claude hebt gevonden, zijn de agent en een connector de twee die je nog moet instellen.
Een plan dat MCP omvat.
MCP is bij elk abonnement inbegrepen, ook bij het gratis abonnement. Je abonnement bepaalt hoeveel sleutels of verbonden apps je kunt gebruiken, hoeveel oproepen per minuut je AI-client mag doen, hoeveel rijen één query retourneert en of de analytische toolset is inbegrepen. Wat elk plan inhoudt.
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. Nieuw account? Installeer het nu via mijn.querystreams.com/downloadeen paar minuten later Windows, macOS of LinuxAls uw team al query's uitvoert in de portal, Excel of Google Sheets, is het al geïnstalleerd.
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 uw AI-client
De MCP-pagina in het portaal (Streams → Live → MCP) heeft vier tabbladen: Verbindingen, Context, Hulpmiddelen en voor beheerders, ActiviteitOp Connections, de Verbind een AI-client De knop opent een handleiding in vier stappen: Hoe zal uw AI-client verbinding maken?, Kies uw AI-client, Stel het in en Controleer de verbindingEr zijn twee manieren om toegang te krijgen. Chat-apps geven goedkeuring vanuit de app zelf en hebben geen sleutel nodig. Ontwikkelaarstools gebruiken een MCP-sleutel. Beide maken verbinding met dezelfde server en dezelfde tools.
Optie A: claude.ai, Claude Desktop en ChatGPT (goedkeuren vanuit de app, geen sleutel nodig)
Vermeld in de Anthropic Connectors Directory. Query Streams is een goedgekeurde connector: claude.ai/directory/query-streamsOpen de advertentie, klik Verbinden en goedkeuren; geen server-URL nodig. Toevoegen via URL is de alternatieve oplossing voor Claude-organisaties die directory-connectoren beperken.
- Open de Lijst met querystreams en klik VerbindenDe connector synchroniseert met uw Claude-account, zodat Claude Desktop deze daar weergeeft. + → Connectoren. Kunt u de advertentie niet zien? Uw organisatie kan de toegang tot directory-connectoren beperken: in Instellingen → Connectoren klik Voeg een aangepaste connector toenoem het Query-stromen, plakken
https://mcp.querystreams.com/mcpklik vervolgens in een chat +, 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 → Verbindingen tab.
ChatGPT. Voeg querystreams toe vanuit de app zelf: voorlopig betekent dit dat je de ontwikkelaarsmodus inschakelt in de instellingen van ChatGPT en daar de verbinding maakt, en vervolgens klikt. Aanmelden met querystreams en goedkeuring op hetzelfde toestemmingsscherm. De portalhandleiding toont de huidige ChatGPT-stappen; een officiële ChatGPT-lijst is in ontwikkeling.
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 de URL van de vermelding. Verbinden knop, of Instellingen → Connectoren → Toevoegen voor de URL-route.
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 en klik Verbind een AI-client. Kiezen Gebruik een sleutel in een configuratiebestand en kies je gereedschap.
- Klik op Genereer een sleutel voor je gereedschap. Geef het een naam die overeenkomt met het gereedschap en de machine, bijvoorbeeld: claude-code-laptop, houden Lezen en Voer query's uiten kies een vervaldatum. Je kunt de sleutel later weer zichtbaar maken en kopiëren. Verbindingen tab. Toetsen zien eruit als
qsmcp_gevolgd door 43 tekens. - Stel het in Toont de kant-en-klare configuratie voor Cursor, VS Code, Windsurf, Zed, JetBrains, Gemini CLI, Codex CLI, Continue, Cline en meer, waarbij uw sleutel al is ingevuld. Voor Claude Code is het slechts één commando:
claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp --header "X-MCP-Key: qsmcp_PASTE_KEY_HERE" - Controleer de verbinding wacht op het eerste telefoontje van die toets en zegt Aangesloten.
Vraag het gerust om dit op elk gewenst moment te controleren. Welke Query Streams-connectoren heb ik? De klant moet bellen qs_list_connectorsen de sleutel Laatst gebruikt De tijd op het tabblad Verbindingen wordt binnen enkele seconden bijgewerkt.
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 | Connectors en agents vermelden, schema’s doorzoeken, beschrijvingen van Semantic Intelligence en de opgeslagen kolomprofielen en relaties lezen, en opgeslagen query’s en waarschuwingsregels weergeven. | Altijd. Al het andere bouwt daarop voort. |
| analyseren | Een tabel profileren of impliciete relaties live ontdekken op de Network Agent, en een Semantic Intelligence-run in de wachtrij plaatsen. Zonder deze functie ziet je AI-client de tools waarmee een Semantic Intelligence-run wordt gestart niet. | Aanbevolen. Dit stelt Claude in staat de structuur van uw gegevens te begrijpen voordat hij joins schrijft. |
| uitvoeren | Weergegeven als Query's uitvoeren (alleen-lezen)Voer alleen-lezen SQL- en opgeslagen query's uit en stream de rijen terug; bewaar de resultaten en voer de vervolg- en analysetools erop uit. | 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 het tabblad 'Verbindingen'.
Wat uw AI-client kan doen zodra deze is verbonden.
Uw AI-client ziet de Query Streams-tools en kiest de juiste voor uw vraag; u hoeft ze zelf nooit aan te roepen. Het portaal Tabblad Hulpmiddelen vermeldt alle tools en modi, wat elke tool en modus doet en welke in je abonnement zijn inbegrepen.
Voor een vraag over je gegevens begeleidt Query Streams je AI-client in vier stappen: je connectors weergeven, de tabellen van de database lezen, de kolommen lezen van elke tabel die de client gaat opvragen en vervolgens een alleen-lezenquery uitvoeren. Door eerst de kolommen te lezen, hoeft de client geen namen te raden. In elk abonnement, ook Free:
Breng uw gegevens in kaart.
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.
Voer alleen-lezen SQL uit
Schrijf en voer alleen-lezen SQL-query's uit in het juiste dialect voor de connector. Standaard is er een time-out van 60 seconden, tot maximaal vijf minuten; uw plan bepaalt hoeveel rijen één query retourneert.
Opgeslagen zoekopdrachten, gefedereerde zoekopdrachten en waarschuwingen
Voer de opgeslagen, geparameteriseerde query's van uw organisatie uit met nieuwe waarden; gefedereerde query's die meerdere bronnen omvatten, worden al samengevoegd geretourneerd. Lees waarschuwingsregels en hun recente activering, en stel een nieuwe regel voor in de testmodus.
De analytische hulpmiddelen
Bij betaalde abonnementen doet de Network Agent het voorbereidende werk op de plek waar uw data zich bevindt: het meet, profileert, bewaart en analyseert de resultaten, zodat uw AI-client elke vraag benadert met de context al voorbereid en zich kan concentreren op het denkproces. Het gratis abonnement werkt zoals altijd, met standaardresultaten. De volledige handleiding vindt u in Analyseer uw gegevens met uw AI-client..
Contextmanagement
Persoonlijke kernwaarden en hoger. Bepaal de grootte van het resultaat voordat u het leest (vorm): kolommen, rijschatting en tokenkosten, geen rijen. Loop gebied voor gebied door een grote database (schemaniveaus). Houd antwoorden binnen een tokenbudget, met alleen de kolommen en de benodigde lengte van de tekstcellen.
Resultatenanalyse
Persoonlijke kernwaarden en hoger. A profiel van het hele resultaat in plaats van rijen. Resultaten van de wachtMet behulp van labels kunt u vervolgvragen beantwoorden zoals "splits het uit per regio" of "de volgende 50 rijen" zonder een tweede databasequery uit te voeren. Actualiteit van de gegevens en veranderd sinds Lees alleen de nieuwe berichten.
Diepere analyse
Business Core en hoger. Een data kwaliteit rapport, afwijkingen, segmenten, een statistische vergelijken en een verschil tussen twee vastgestelde resultaten.
Jij behoudt de controle. De Contexttabblad Hiermee worden de standaardinstellingen ingesteld: de limiet voor tekstcellen, de schemaweergave voor grote databases, de resultaatgrootte en de standaardinstellingen voor analyses. Ook wordt weergegeven wat uw AI-client ontvangt. Daarnaast worden de resultaten die elke agent vasthoudt, weergegeven. Elke toets kan de standaardinstellingen overschrijven, elk gesprek wordt weergegeven op het tabblad Activiteit en een beheerder kan de instellingen in- en uitschakelen. Lokale analyse uit voor een agent onder Gegevens → Gegevensagenten.
Wat uw plan inhoudt
MCP is bij elk abonnement inbegrepen, ook bij het gratis abonnement, en het gratis abonnement verloopt nooit.
| Plan | Sleutels per gebruiker | Sleutels per organisatie | Oproepen per minuut | Rijen per query | Analytische hulpmiddelenset | Resultaten van de wacht |
|---|---|---|---|---|---|---|
| Gratis | 1 | 1 | 30 | 1,000 | Standaardresultaten | Geen |
| Persoonlijke kern | 1 | 1 | 60 | 2,500 | Contextmanagement, resultatenanalyse | 15 minuten, 128 MB |
| Persoonlijk Plus | 1 | 1 | 90 | 5,000 | Contextmanagement, resultatenanalyse | 15 minuten, 128 MB |
| Bedrijfskern | 2 | 3 | 120 | 10,000 | Contextmanagement, resultatenanalyse, diepgaande analyse | 60 minuten, 512 MB |
| Business Plus | 3 | 5 | 150 | 25,000 | Alle drie | 60 minuten, 512 MB |
| Business Max | 5 | 10 | 240 | 50,000 | Alle drie | 60 minuten, 512 MB |
| Enterprise Core | 5 | 25 | 300 | 100,000 | Alle drie | 8 uur, 4096 MB |
| Enterprise Plus | 8 | 50 | 450 | 100,000 | Alle drie | 8 uur, 4096 MB |
| Enterprise Max | 10 | 100 | 600 | 100,000 | Alle drie | 8 uur, 4096 MB |
Een gekoppelde app telt als een sleutel. Bij elk abonnement voert elke sleutel maximaal 10 query's per minuut uit. Het aantal rijen per query is het maximale aantal rijen dat één query retourneert aan uw AI-client; als u meer rijen opvraagt, wordt de limiet van uw abonnement bereikt en wordt dit aangegeven, nooit een foutmelding. Een vastgehouden resultaat wordt bewaard voor vervolgvragen, tot de tijd en omvang van het abonnement, binnen de mogelijkheden van de computer van de agent. Elk abonnement naast elkaar: prijzen.
Waarom semantische intelligentie hier van belang 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 |
|---|---|---|
| Semantische 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 er dan eenmaal een Semantic Intelligence-test op uit. Voor grote databases kun je de test beperken tot de tabellen die je query's daadwerkelijk gebruiken. Hoe werkt semantische intelligentie? →
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 semantische intelligentie?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 vervolgquery in dezelfde thread. Bij plannen met resultaatanalyse kan het vervolg afkomstig zijn van het opgeslagen resultaat, zonder tweede query. 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. Queryresultaten die aan Claude worden geretourneerd, tellen mee voor hetzelfde budget voor gegevensdomeinen dat wordt gedeeld met je gebruik van Excel, Google Sheets, Portal en Nova. Via MCP wordt elke byte gemeten die aan Claude wordt geleverd — resultaten, schemalezingen en pagina’s met vastgehouden resultaten — vóór eventuele transportcompressie, omdat een AI-client ze ongecomprimeerd ontvangt; resultaten uit spreadsheets, Portal en API’s tellen mee als het gecomprimeerde resultaat dat je Network Agent levert. Een mislukt antwoord telt nooit mee. Houd verkennende vragen klein; bij abonnementen met Context management voorkomt het eerst vragen aan Claude om de omvang van een resultaat te bepalen (mode: shape) dat er rijen worden opgehaald die het niet nodig heeft.
- Semantische intelligentie draait. 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 zegt dat er geen connectoren zijn, of geen netwerkagent. | Er is nog geen agent actief op uw account, of er is nog geen gegevensbron toegevoegd aan de agent. | Installeer de agent via mijn.querystreams.com/download, voeg een connector toe onder Gegevens → Gegevensagenten → Connector toevoegenVraag het dan nog eens. |
| 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 (Query's 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 bijbehorende app was bij de goedkeuring beperkt tot specifieke connectoren, en dit is er niet één van. | Maak opnieuw verbinding met de app en geef toestemming voor bredere toegang via het scherm voor Query Streams-toestemming. |
MCP_DATABASE_NOT_CAPTURED | De database is niet opgenomen in de schema-capture-selectie van de connector, waardoor er geen semantische 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 Semantische Intelligentie uit. |
MCP_RATE_LIMITED | Te veel gesprekken per minuut voor uw abonnement. | Wacht even. Intensieve sessies profiteren van semantische intelligentie, waardoor Claude in minder oproepen kan antwoorden. |
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 reactie aan uw AI-klant te verstrekken. | Vraag om minder kolommen of rijen. Bij plannen met contextbeheer kunt u het programma vragen om eerst de afmetingen van het resultaat te bepalen. |
MCP_FUNCTIE_NIET_INCLUSIEF | "Uw plan omvat geen contextbeheer", resultaatanalyse of diepgaande analyse; of de tool is uitgeschakeld voor deze sleutel of organisatie. | Vraag uw AI-klant om zonder de tool verder te gaan, een abonnement te upgraden of een beheerder te vragen de tool in te schakelen. |
MCP_RESULT_EXPIRED | Het opgeslagen resultaat is niet langer opgeslagen: het is verlopen, vrijgegeven (soms voortijdig om ruimte te maken voor een nieuwer resultaat) of de agent is opnieuw opgestart. | Vraag uw AI-client om de query opnieuw uit te voeren met een pauze. |
MCP_WINDOW_BUDGET | De agent kan een resultaat van die omvang momenteel niet opslaan, of een vervolgactie vereist meer geheugen dan beschikbaar is voor opgeslagen resultaten. | Geef een vastgehouden resultaat vrij, of verfijn de query met een filter of minder kolommen. |
MCP_AGENT_ANALYSIS_DISABLED | De opgeslagen resultaten en analyses zijn uitgeschakeld voor die agent of connector. | Vraag een beheerder om het in te schakelen Lokale analyse Voor de agent op de pagina 'Data Agents', of sta analyse toe op de connector. |
MCP_WINDOW_SQL_REJECTED | Een vervolgquery was geen alleen-lezen SELECT-query over de tabellen van het opgeslagen resultaat, of er werd een kolom genoemd die het resultaat niet bevat. | Vraag om één SELECT-query op dat resultaat, waarbij de kolomnamen worden gebruikt. |
MCP_AGENT_VERSIE_TE_OUD | De agent heeft een update nodig voordat hij resultaten kan vormgeven, profileren, opslaan of analyseren. | De agent bijwerken vanuit Gegevens → GegevensagentenEenvoudige zoekopdrachten blijven ondertussen gewoon werken. |
| Een query mislukt vanwege een kolom- of tabelnaam | Je AI-client heeft een naam geraden in plaats van eerst de tabel te lezen. | Meestal niets. De foutmelding die de client krijgt, vermeldt de echte kolommen van de tabel of tabellen met een vergelijkbare naam, zodat de client de query bij een volgende poging kan corrigeren. Als de client blijft raden, vraag dan om eerst de kolommen van de tabel te lezen. |
| 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? Stuur een e-mail. [email protected].
Beveiliging en privacy
- Claude ontvangt schema-metadata, beschrijvingen van semantische intelligentie inclusief voorbeeldwaarden en de resultaten van de door u gestelde vragen. Met de analytische toolset ontvangt het vaak een schatting van de grootte, een profiel of een antwoord met een vastgehouden resultaat, terwijl het volledige resultaat bij de agent blijft. Wat het ontvangt, wordt verzonden naar de AI-provider waarmee u verbinding wilt maken, volgens de voorwaarden van die provider.
- 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 Semantic 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 portal Verbind een AI-client De handleiding bevat voor elk een kant-en-klare configuratie.
Wat is een vastgehouden resultaat?
Bij abonnementen met resultaatanalyse kan uw AI-client de agent vragen om een volledig resultaat gedurende een bepaalde tijd te bewaren. Vervolgvragen, zoals een uitsplitsing per regio of de volgende pagina met rijen, worden vervolgens beantwoord vanuit die kopie zonder dat een tweede databasequery nodig is. Hoe lang en hoe groot een bewaard resultaat kan zijn, hangt af van het gekozen abonnement.
Welke abonnementen bevatten de analytische toolset?
Contextmanagement en resultaatanalyse zijn beschikbaar vanaf Personal Core; diepgaandere analyses vanaf Business Core. De plattegrondtabel Bevat de details.
Heeft dit gevolgen voor het gratis abonnement?
Nee. Het gratis abonnement werkt zoals altijd, met standaardresultaten.
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 Semantic 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 met uw gegevens.
Installeer de agent eenmalig, dat duurt maar een paar minuten. Daarna is verbinding maken met Claude een kwestie van één klik: geen sleutel, geen configuratiebestand, geen VPN. Het is van nature alleen-lezen.
Installeer de agent Open de MCP-pagina Hoe MCP werkt
English 
Spanish 
German 
French 
Portuguese 
Japanese 
Korean 
Chinese 
Italian 
Dutch 
Indonesian 
Polish