Hoe verbind je PostgreSQL met Claude of Cursor via MCP?

Bekijk alles wat Query Streams kunnen buiten deze handleiding Gratis aan de slag

Ondersteunt

+meer

Live gegevens

Export vervangen door SQL op aanvraag

Excel Vellen

BI & AI-analyse

Vraag Nova, krijg SQL + grafieken

Ontmoet Nova

Database REST API

Eén sleutel per partner. Geen inloggegevens worden gedeeld.

Bouw een API

+meer

Automatisering

Geplande synchronisatie naar 6+ platformen

Verken

+meer

API naar SQL

API's bevragen met SQL, geen code

Verken

+meer

AI-database MCP

Claude, Cursor, ChatGPT en Grok communiceren met uw gegevens.

Connect AI

Query Streams is een veilig, realtime data-integratieplatform dat elke database en SaaS API in uw account integreert in Claude, Cursor, ChatGPT en Grok — via één enkele MCP-sleutel en zonder dat er firewallwijzigingen nodig zijn. Deze handleiding beschrijft specifiek hoe u de PostgreSQL-connector configureert, zodat uw AI-tool vragen in begrijpelijke taal kan beantwoorden over bestellingen, klanten, producten en andere PostgreSQL-gegevens — zoals joins, aggregaties, schema-exploratie en queryprestaties — zonder dat u CSV-exports vanuit pgAdmin of DBeaver hoeft te kopiëren en plakken. Meer informatie vindt u op QueryStreams.com en gratis aanmelden om je AI-tool echte PostgreSQL-vragen te gaan stellen.

Wat Query Streams MCP je biedt voor PostgreSQL

Andere "PostgreSQL MCP"-servers in het open-sourcelandschap verbinden de AI-tool rechtstreeks met een PostgreSQL-verbindingsreeks. Dat werkt, maar het voegt een databasewachtwoord (of een IAM-token) toe aan de configuratie van uw AI-client, beperkt de AI-tool tot slechts één PostgreSQL-cluster en biedt geen auditlogboek van wat de AI daadwerkelijk heeft opgevraagd. Query Streams MCP lost een breder probleem op: één sleutel, elke connector, een volledig auditlogboek en de AI-tool bewaart nooit uw PostgreSQL-gegevens.

Hoe het werkt zonder firewallpoorten te openen

De Query Streams Network Agent is een klein programma dat u eenmalig installeert op een machine die uw PostgreSQL-cluster kan bereiken (elke laptop, on-premise server, EC2-instantie, Azure VM of cloud-VM in dezelfde VPC als uw PostgreSQL). Het programma maakt één uitgaande TLS-verbinding met de cloud en voert SQL-query's uit op PostgreSQL via het lokale netwerk met behulp van het standaard PostgreSQL-protocol — er is geen inkomend verkeer, niets wordt blootgesteld en de AI-tool ziet nooit uw PostgreSQL-verbindingsreeks. Hoe de architectuur voor uitsluitend uitgaand verkeer werkt →

De MCP-toets die je aan Cursor of Claude geeft, is beperkt (lezen / analyseren / uitvoeren), op elk moment herroepbaar en met een limiet per sleutel. De AI-tool roept deze MCP-tools aan om zijn werk te doen:

Waarom Schema Intelligence Query Streams MCP anders maakt

De meeste "MCP for Postgres"-servers in het open-source landschap bieden uw AI-tool dezelfde mogelijkheden. informatie_schema Postgres geeft een onbekende in handen. Kolomnamen. Gegevenstypen. Misschien een primaire sleutel. De LLM moet maar raden wat er aan de hand is. status_id = 3 betekent, wat usr_eml winkels, of dat regel_items.order_id sluit zich daadwerkelijk aan bij orders.id (er is in beide gevallen nooit een foreign key gedeclareerd). Daarom is de eerste SQL-query die de meeste LLM's uitvoeren op een kaal schema onjuist — niet omdat de LLM zelf slecht is, maar omdat deze niet over de benodigde gegevens beschikt om de query correct uit te voeren.

Query Streams MCP retourneert hetzelfde schema, verrijkt met wat wij noemen Schema-intelligentie (SI) — Door AI samengestelde metadata die wordt gegenereerd door profileringsquery's uit te voeren op uw gegevens. werkelijke Postgres-gegevens voordat de AI-client erom vraagt. Wanneer SI is ingeschakeld op een connector en database, worden alle schematools die de AI aanroept (qs_get_connector_schema, qs_get_table_schema, qs_profiel_tabel, qs_get_relationships) retourneert het kale schema plus zes lagen van samengestelde kennis. De LLM maakt een einde aan het giswerk.

Om dit concreet te maken, volgt hier wat de AI-client terugkrijgt van een enkele opdracht. qs_get_table_schema een aanroep doen tegen een typisch PostgreSQL e-commerce schema (bestellingen, regelitems, klanten, producten) — eerst zonder schema-intelligentie, daarna mét.

De zes lagen die Schema Intelligence toevoegt

Elke laag behandelt een type vraag waar de LLM anders alleen maar naar zou gissen. De optionele SI-profileringsstap wordt alleen-lezen uitgevoerd op uw PostgreSQL-gegevens zonder uw schema te wijzigen of naar uw database te schrijven, en wordt incrementeel vernieuwd wanneer uw schema verandert. Wat Schema Intelligence toevoegt en hoe het actueel blijft →

Dezelfde prompt, andere SQL-query

Het bewijs zit in de SQL-query's die de AI-tool daadwerkelijk genereert. Dezelfde cursorsessie, hetzelfde Claude-model, dezelfde prompt. Wat waren de 5 producten met de hoogste omzet in de afgelopen 30 dagen? Zonder schema-intelligentie moet het LLM-model gissen. Met schema-intelligentie weet het LLM-model het zeker.

Is MCP niet jouw ding? Probeer dan Nova AI eens.

Sla de JSON-configuratie volledig over: Nova AI is geïntegreerd in het Query Streams-webportaal. en stelt dezelfde vragen in begrijpelijke taal aan uw PostgreSQL-connector — "Top 10 klanten op basis van levenslange waarde,”bestellingen die langer dan 7 dagen niet verzonden zijn"— plus elke andere connector op uw account, met dezelfde agent, alleen-lezen-handhaving en Schema Intelligence, en zonder MCP-infrastructuur.

Maak kennis met Nova AI

Vereisten

Voordat je begint, zorg ervoor dat je het volgende hebt:

1. Een gratis Query Streams-account bij mijn.querystreams.nl.
2. De Query Streams Network Agent is geïnstalleerd op een machine die uw PostgreSQL-cluster kan bereiken — zie Download de Query Streams Agent..
3. Een PostgreSQL-connector geconfigureerd voor de agent — zie de bestaande connector instellen Richtlijnen voor de verbindingsreeks. De agent bewaart het PostgreSQL-wachtwoord (of de IAM-referenties voor beheerde PostgreSQL); de AI-tool heeft hier geen toegang toe.
4. Elke AI-client die MCP ondersteunt. In deze handleiding laten we Cursor, Claude Desktop, ChatGPT en Grok zien; als je Windsurf, Zed, Continue, Cline, VS Code Copilot, Codex of Goose gebruikt, is het configuratieblok in principe hetzelfde.
5. Vijf minuten.

Stap 1: Genereer een MCP-sleutel in Query Streams

Meld u aan bij Query Streams en open de MCP-pagina (of meld u eerst aan bij mijn.querystreams.nl en klik MCP (in de linkernavigatie). Klik Sleutel genererenGeef de sleutel een herkenbare naam (iets zoals cursor-laptop of claude-desktop), en kies de bereiken die je aan deze sleutel wilt toevoegen:

• lezen — De AI kan connectoren doorzoeken en schema's lezen. Dat is voor al het andere nodig.
• analyseren — De AI kan tabellen profileren en relaties ontdekken (steekproefwaarden, verdelingen, semantische typen). Optioneel, maar sterk aanbevolen voor PostgreSQL-werk, waar inzicht in de structuur van uw gegevens van belang is wanneer de LLM joins genereert.
• uitvoeren — De AI kan daadwerkelijk SQL-query's uitvoeren. Zonder dit kan de AI alleen schema-metadata lezen.

Voor een typische workflow waarbij "Claude mijn PostgreSQL-gegevens analyseert", zijn alle drie de scopes geschikt. Voor een sleutel die je aan een teamlid of een minder vertrouwde klant geeft, laat je deze scope weg. uitvoeren en laat ze alleen browsen. Je kunt elke sleutel op elk moment vanaf dezelfde pagina intrekken; de AI-client zal dit zien. MCP_KEY_REVOKED Bij de volgende oproep stopt het direct met werken. Er is geen vertraging in de signaaloverdracht.

Kopieer de sleutel nu — Query Streams toont deze eenmalig en slaat vervolgens alleen een hash op. Als u de sleutel kwijtraakt, genereer dan een nieuwe. De sleutel ziet er als volgt uit: qsmcp_ gevolgd door 48 willekeurige tekens, en dat is wat uw AI-client verzendt in de X-MCP-sleutel verzoekheader.

Stap 2: Voeg Query Streams MCP toe aan uw AI-client

De configuratie heeft dezelfde vorm voor elke MCP-compatibele client: een MCP-serververmelding die verwijst naar https://mcp.querystreams.com met uw sleutel in de X-MCP-sleutel Koptekst. Kies hieronder uw klant.

Cursor ~/.cursor/mcp.json

// Bewerk ~/.cursor/mcp.json
{
  "mcpServers": {
    "querystreams": {
      "url": "https://mcp.querystreams.com",
      "kopteksten": {
        "X-MCP-sleutel": "qsmcp_PLAK_HIER_SLEUTEL_"
      }
    }
  }
}

Claude Desktop claude_desktop_config.json

// Instellingen → Ontwikkelaar → Configuratie bewerken
{
  "mcpServers": {
    "querystreams": {
      "url": "https://mcp.querystreams.com",
      "kopteksten": {
        "X-MCP-sleutel": "qsmcp_PLAK_HIER_SLEUTEL_"
      }
    }
  }
}

ChatGPT Apps en connectoren

// Instellingen → Apps en connectors → MCP toevoegen
Server-URL  https://mcp.querystreams.com
Auth-header X-MCP-sleutel
Kopwaarde qsmcp_PLAK_HIER_SLEUTEL_

// Vereist een betaald ChatGPT-abonnement
// (Plus / Pro / Team / Enterprise).

Grok Externe MCP-tools

// Grok → Instellingen → Hulpmiddelen
{
  "mcp_servers": [{
    "naam": "querystreams",
    "url": "https://mcp.querystreams.com",
    "auth_header": "X-MCP-sleutel",
    "auth_value": "qsmcp_..."
  }]
}

Start uw AI-client opnieuw op. Bij de volgende opstart zal deze de acht hierboven vermelde Query Streams MCP-tools detecteren en in het toolpalet weergeven. In Cursor en Claude Desktop kunt u dit controleren door te typen “lijstconnectoren” — de AI zou moeten bellen qs_list_connectors en retourneer uw PostgreSQL-connector samen met alle andere door u geconfigureerde gegevens.

Stap 3: Stel de AI een vraag over PostgreSQL.

Je hoeft geen SQL te schrijven, dat doet de AI. Je stelt een vraag, de AI kiest de juiste MCP-tool, de agent voert de query uit op je PostgreSQL-database en het antwoord krijg je terug als tekst plus tabellen. Drie voorbeeldvragen om mee te beginnen:

De eerste keer dat de AI een tool aanroept, kan er in uw client een bevestigingsmelding verschijnen waarin u wordt gevraagd de tooloproep goed te keuren. Dit is de standaard toestemmingsprocedure van MCP en geen extra functie van Query Streams. Keur de oproep eenmaal goed en de AI kan de rest van het gesprek zonder problemen voortzetten. U kunt de toestemming op elk gewenst moment opnieuw bekijken in de instellingen van uw client.

Veelgestelde vragen

Aan de slag

Gerelateerde handleidingen: Download de Query Streams Agent. | Databaseconnector instellen | Alle MCP Server-handleidingen | Nova AI tekst-naar-SQL

Categorie: MCP-server

Tags: mcp, claude, cursor, postgresql, postgres, postgres-mcp, ai

Metabeschrijving: Verbind PostgreSQL met Claude of Cursor via Query Streams MCP. Alleen uitgaand, alleen-lezen, installatie in 5 minuten.