Database MCP instellen

Met Database MCP instellen verbind je mcp-core met één MySQL-, MariaDB-compatibele of PostgreSQL-database, zodat Claude tabellen kan opvragen, kolommen kan beschrijven en SQL kan draaien. Je hebt de Database-entitlement nodig, een databasegebruiker en vijf verplichte env-variabelen. Read-only is de standaard, en de veiligste opzet gebruikt een gebruiker die alleen SELECT mag.

Wat heb je nodig voordat je Database MCP instelt?

Je hebt een draaiende mcp-core-installatie nodig, de Database-add-on op dezelfde licentie en een database die de container via het netwerk kan bereiken. Nog geen mcp-core? Volg dan eerst de installatiehandleiding van mcp-core.

• Een actieve licentie met de entitlement tool:database, uit de add-on Database MCP-server.
• Host, poort, databasenaam, gebruiker en wachtwoord.
• Een seat in Mijn account → MCP Self-hosted met de Database-tool aangevinkt.

Binnen de container is localhost de container zelf, niet je server. Gebruik een hostnaam of IP-adres dat de container kan bereiken. Heb je de add-on later gekocht? Er hoeft niets opnieuw geïnstalleerd te worden: de add-on komt bij je licentie, en een e-mail noemt de env-variabelen die je moet invullen.

Hoe maak je een read-only gebruiker aan voor Database MCP?

Maak een aparte gebruiker aan met alleen SELECT, op alleen de tabellen die Claude mag zien. De tool heeft zijn eigen vangrails, maar de rechten in de database zijn de echte handhaving. MySQL of MariaDB:

CREATE USER 'claude_ro'@'%' IDENTIFIED BY 'a-long-random-password';
GRANT SELECT ON shopdb.* TO 'claude_ro'@'%';

PostgreSQL:

CREATE ROLE claude_ro LOGIN PASSWORD 'a-long-random-password';
GRANT CONNECT ON DATABASE shopdb TO claude_ro;
GRANT USAGE ON SCHEMA public TO claude_ro;
GRANT SELECT ON ALL TABLES IN SCHEMA public TO claude_ro;

Beperk '%' waar mogelijk tot het adres van je mcp-core-server. Wil je later schrijftoegang, geef dan INSERT, UPDATE en DELETE op specifieke tabellen aan een aparte gebruiker.

Welke env-variabelen gebruikt Database MCP?

Er zijn vijf verplichte en vijf optionele variabelen. Je gedownloade .env bevat de verplichte regels leeg en de optionele als commentaar.

Voorbeeld voor een MariaDB-database:

DB_TYPE=mysql
DB_HOST=db.internal.example.com
DB_NAME=shopdb
DB_USER=claude_ro
DB_PASSWORD=a-long-random-password

Je kunt deze waarden ook bewaren in Mijn account → MCP Self-hosted → Tools. Ze worden versleuteld opgeslagen, een draaiende mcp-core pikt ze op zonder nieuwe download, en ze gaan voor op .env.

Welke tools ziet Claude nadat je Database MCP hebt ingesteld?

Claude krijgt drie tools, in beide modi. Anders dan bij de andere add-ons gebeurt de schrijfcontrole per query, omdat één SQL-tool kan lezen of schrijven.

• database_list_tables: de tabellen die de gebruiker kan zien. Op MySQL en MariaDB bevat deze lijst ook views; op PostgreSQL toont hij alleen gewone tabellen, uit elk schema behalve de systeemschema’s.
• database_describe_table: kolomnaam, datatype, nullability en standaardwaarde
• database_query: één SQL-statement per aanroep, resultaten begrensd op DB_MAX_ROWS

Wat is het verschil tussen read-only en read-write in Database MCP?

In read-only-modus weigert database_query INSERT, UPDATE en DELETE voordat ze de database bereiken. Read-write laat die door. Schemawijzigingen (CREATE, DROP, ALTER, TRUNCATE, GRANT, REVOKE) worden in elke modus geblokkeerd, net als meerdere statements in één aanroep.

Je stelt de modus per seat in wanneer je die toevoegt in Mijn account → MCP Self-hosted → Seats; DB_MODE is de fallback. De controle op trefwoorden is een vangnet, geen garantie: wat schrijven echt tegenhoudt, is een databasegebruiker die alleen SELECT mag. Zie entitlements vs. toolmodi voor het verschil tussen een tool kopen en de modus ervan.

Hoe herstart en test je Database MCP?

Draai het updatescript vanuit de map die je hebt uitgepakt:

./mcp-update.sh

Net de add-on gekocht? Forceer de licentiecheck:

docker exec mcp-core npm run refresh-license

Draai in Claude eerst mcp_status: die toont de licentiestatus, de seat en de modus van elke tool. Vraag daarna “toon de tabellen in de database”. Gebruik je meerdere clients, controleer dan in MCP-seats welk token bij welke seat hoort.

Welke foutmeldingen kom je tegen bij het instellen van Database MCP?

De meldingen hieronder komen uit de tool, dus je kunt er direct op zoeken.

• Helemaal geen databasetools: het log meldt “DB_TYPE/DB_HOST/DB_NAME/DB_USER are not fully set”. Vul ze in en draai ./mcp-update.sh.
• “Unsupported DB_TYPE”: gebruik precies mysql of postgres.
• “This looks like a write statement (INSERT/UPDATE/DELETE) but this connection is read-only”: verwacht gedrag in read-only-modus.
• “Schema-changing statements … are never allowed through this tool”: voer schemawijzigingen rechtstreeks op de database uit.
• “Multiple statements in one call are not allowed”: stuur één statement per query.
• “No such table (or it has no columns visible to this database user)”: een typfout, of de gebruiker heeft geen rechten op die tabel.
• “…showing first 200 of N rows”: maak de query smaller met WHERE of LIMIT, of verhoog DB_MAX_ROWS.

Database MCP is ingesteld zodra database_list_tables je tabellen teruggeeft. De andere add-ons staan in de MCP-installatiehandleidingen.