Database add-on

De database MCP-server geeft Claude drie tools om met je eigen SQL-database te werken: de tabellen opsommen, de kolommen van een tabel beschrijven en een query uitvoeren. Hij ondersteunt MySQL- en MariaDB-compatibele servers en PostgreSQL. Je vraagt "hoeveel accounts zijn er dit jaar per maand aangemaakt?", Claude bekijkt het schema, schrijft de SQL, voert hem uit en legt het resultaat uit.

Deze add-on heeft mcp-core, de zelf gehoste MCP-server nodig. mcp-core draait in Docker op je eigen infrastructuur en opent van daaruit de databaseverbinding. Je database-inloggegevens blijven in je eigen .env en verlaten je server nooit.

Hoe gebruikt Claude de database MCP-server?

Claude werkt in drie stappen, net zoals een developer die nieuw is in de codebase:

1. database_list_tables om te zien wat er is.
2. database_describe_table om kolomnamen, datatypes, nullability en standaardwaarden te lezen.
3. database_query om één SQL-statement uit te voeren en de rijen terug te krijgen.

Omdat Claude eerst het schema leest, kun je vragen in gewone taal stellen en Claude de joins laten uitzoeken. De SQL is zichtbaar in elke toolaanroep, dus je kunt hem controleren of elders hergebruiken.

Is het veilig om Claude op een productiedatabase te zetten?

Ja, als je de ingebouwde vangrails combineert met een beperkte databasegebruiker. De tool start in alleen-lezen-modus: alleen SELECT bereikt de database, en INSERT, UPDATE en DELETE worden geweigerd met een duidelijke foutmelding. CREATE, DROP, ALTER, TRUNCATE, GRANT en REVOKE zijn in elke modus geblokkeerd. Er wordt maar één statement per aanroep geaccepteerd.

Wees duidelijk over wat die controle is. Hij bekijkt de SQL-tekst, dus het is een vangnet en geen rechtensysteem. De echte afdwinging hoort in de database zelf: koppel de database MCP-server met een gebruiker die alleen SELECT mag, en alleen op de tabellen of views die Claude mag zien. De installatiegids voor de database noemt elke variabele en wat die doet.

Welke limieten kun je op query's zetten?

Twee variabelen begrenzen elke query die de database MCP-server uitvoert. DB_MAX_ROWS beperkt het aantal rijen dat Claude terugkrijgt (standaard 200), en Claude krijgt een melding als een resultaat is afgekapt, zodat hij de query kan verfijnen. DB_QUERY_TIMEOUT_MS stopt trage query's (standaard 10.000 ms). Een vergeten WHERE-clausule op een grote tabel levert dan een afgekapt antwoord op in plaats van een vastgelopen server.

Welke instellingen heeft de database MCP-server nodig?

Je configureert hem met standaard verbindingsgegevens in de .env naast je docker-compose.yml:

DB_TYPE=postgres
DB_HOST=db.internal.example.com
DB_PORT=5432
DB_NAME=app_production
DB_USER=claude_readonly
DB_PASSWORD=change-me
DB_SSL=true
DB_QUERY_TIMEOUT_MS=10000
DB_MAX_ROWS=200

Gebruik DB_TYPE=mysql voor MySQL of MariaDB. DB_PORT, DB_SSL en de twee limieten zijn optioneel. Voer ./mcp-update.sh uit nadat je het bestand hebt aangepast. Koop je de add-on bij een bestaande installatie, dan laadt docker exec mcp-core npm run refresh-license hem zonder op de volgende licentiecontrole te wachten.

Wanneer sta je schrijfquery's toe?

Geef een seat de lees-schrijfmodus als Claude ook INSERT, UPDATE of DELETE moet uitvoeren, bijvoorbeeld om een reeks foute records te herstellen die je samen hebt bekeken. Je stelt de modus per seat in als je die toevoegt in Mijn account → MCP Self-hosted: een developer krijgt lezen en schrijven, de rest van je team houdt alleen-lezen-toegang tot dezelfde database MCP-server. DDL blijft in beide gevallen geblokkeerd.

Voor wie is het?

De database MCP-server past bij developers die antwoorden uit hun applicatiedata willen zonder elke query met de hand te schrijven. Bij bureaus die applicaties van klanten ondersteunen en tijdens een incident snel iets moeten controleren. En bij mensen van product en finance die cijfers nodig hebben, waarbij een developer eenmalig de alleen-lezen-gebruiker aanmaakt.

Draait je winkel op WooCommerce, kijk dan ook naar de WooCommerce MCP-server: die gebruikt de REST API en levert bestellingen en producten in een kant-en-klaar formaat, terwijl SQL beter is voor rapportages op maat. De gids over Claude aan een database koppelen legt de aanpak uit voor een minder technisch publiek.