Naar de inhoud
Mia Automation
NLEN Inloggen Zet Mia aan het werkBeginnen

MCP-servers in Claude Code: toevoegen, testen en weghalen

Met claude mcp add koppel je een MCP-server aan Claude Code, met claude mcp list test je hem en met claude mcp remove haal je hem weer weg. Een MCP-server geeft Claude toegang tot iets buiten je project, zoals een map, een database of Notion. Wij voegden op een Windows-pc drie servers toe en lieten Claude Code in twee losse sessies iets onthouden via een geheugenserver. Onderweg liepen we tegen twee fouten aan die je makkelijk mist.

Claude in de praktijkBijgewerkt op 5 min lezen

Zelf getest op 11 november 2026.

Bewegend schema: in sessie 1 slaat Claude Code via de MCP-geheugenserver een klantafspraak op in een bestand; in sessie 2 vraagt Claude Code hem terug en krijgt het antwoord dat de klant elke dinsdag levert

Een server toevoegen

Er zijn twee soorten. Een lokale server is een programma dat Claude Code op je eigen computer start; dat heet stdio. Alles na de twee streepjes -- is het commando van die server. Een online server spreek je aan via een internetadres; dat heet http. Dit zijn de drie commando's uit onze test:

bash
# Lokale server: lees- en schrijftoegang tot één map
claude mcp add --transport stdio bestanden -- npx -y @modelcontextprotocol/server-filesystem C:\Users\Public\voorbeeld\project

# Lokale server die het hele team krijgt, via .mcp.json
claude mcp add --scope project --transport stdio geheugen -- npx -y @modelcontextprotocol/server-memory

# Online server, voor al je projecten
claude mcp add --scope user --transport http context7 https://mcp.context7.com/mcp

Uitgevoerd in de map van het project. Vervang het pad door je eigen projectmap.

Uit de MCP-documentatie van Claude Code, gecontroleerd op 11 november 2026.
ScopeWaar het staatWie hem krijgt
local (standaard)Je eigen .claude.json, onder dit projectAlleen je eigen account, alleen in dit project
project.mcp.json in de projectmapIedereen die het project uit Git haalt
userJe eigen .claude.jsonAlleen je eigen account, in al je projecten
PowerShell-venster: drie MCP-servers toegevoegd met claude mcp add; de lokale server komt in .claude.json, de projectserver in .mcp.json, en claude mcp list toont twee servers als verbonden en één als wachtend op akkoord (opent op ware grootte)
De meldingen ‘File modified’ laten zien in welk bestand elke server terechtkwam.

Controleren of hij werkt

claude mcp list start elke server even en meldt Connected of een fout. Bij ons waren de bestandsserver en de online server meteen verbonden. De geheugenserver uit .mcp.json stond op Pending approval. Claude Code vraagt bij de eerste interactieve sessie of je servers uit een gedeeld projectbestand vertrouwt. Dat is een vangnet: iemand anders kan zo'n bestand in de repository hebben gezet.

Let op: met claude -p laadt Claude Code projectservers wel zonder die vraag. Dat staat in de documentatie en zagen we ook in onze test. Draai je Claude Code in scripts op een repository van een ander, kijk dan eerst wat er in .mcp.json staat.

Testen in een echte sessie

Een server die verbonden is, hoeft nog niet goed te werken. Daarom gaven we Claude Code twee opdrachten in twee losse sessies. Eerst: ‘Sla in het MCP-geheugen op dat klant Bakkerij De Vries elke dinsdag levert en altijd vóór 7 uur 's ochtends gebeld wil worden.’ Na 9,2 seconden stond de afspraak in het bestand van de geheugenserver. In de tweede sessie vroegen we wanneer Bakkerij De Vries levert. Claude zocht in het geheugen en antwoordde na 6,2 seconden met dinsdag en het belverzoek.

De handelingen van een server heten in Claude Code mcp__<servernaam>__<handeling>, zoals mcp__geheugen__search_nodes. Met --allowedTools "mcp__geheugen__*" geef je in een script toestemming voor alle handelingen van die ene server.

Twee fouten die we tegenkwamen

  1. De volgorde van -e telt. We schreven eerst --transport stdio -e MEMORY_FILE_PATH=… geheugen. Claude Code las de naam geheugen toen als tweede omgevingsvariabele en gaf Invalid environment variable format: geheugen. Zet -e vóór --transport, of zet een andere optie tussen -e en de naam.
  2. Zonder server zocht Claude zelf een andere weg. Door die fout bestond de geheugenserver niet. Claude Code meldde toch ‘Opgeslagen’ en schreef de afspraak in zijn eigen geheugenbestanden. Het antwoord zag er goed uit, maar de server was niet gebruikt. Kijk daarom bij een test welke handeling er echt draaide: in een sessie met Ctrl+O, in een script met --output-format stream-json.

Op Windows werkte npx bij ons direct als commando, zonder extra omweg via cmd. We testten dat met Node.js 22 en Claude Code 2.1.322.

Een server weghalen

claude mcp get <naam> toont de scope en het verwijdercommando dat erbij hoort. Geef bij het verwijderen dezelfde scope mee als bij het toevoegen, anders vindt Claude Code de server niet.

bash
claude mcp get bestanden
claude mcp remove geheugen --scope project
claude mcp remove context7 --scope user
PowerShell-venster: claude mcp get toont scope en status van de bestandsserver met het verwijdercommando, daarna worden de geheugen- en context7-server verwijderd en blijft alleen de bestandsserver over (opent op ware grootte)

Welke koppelingen wij gebruiken

Wij koppelen weinig, maar dan goed: mail en agenda, documenten en spreadsheets, een browser voor taken zonder eigen koppeling, en ons eigen zoekgeheugen. Een deel bouwden we zelf met de officiële SDK's. Elke koppeling krijgt een eigen, smal account. Mail lezen en mail versturen lopen via verschillende accounts.

Voor elke nieuwe koppeling stellen we vier vragen. Welke taak heeft dit nodig? Moet hij alleen lezen of ook schrijven? Welk account krijgt hij? En wat gebeurt er als de agent hem verkeerd gebruikt? Begin met lezen. Schrijfrechten geef je pas als je op die vierde vraag een antwoord hebt.

Vragen

Hoe voeg je een MCP-server toe aan Claude Code?

Met claude mcp add <naam> -- <commando> voor een lokale server of claude mcp add --transport http <naam> <adres> voor een online server. Voeg --scope project toe om hem met je team te delen.

Waar slaat Claude Code MCP-servers op?

In je eigen .claude.json (scope local of user) of in .mcp.json in de projectmap (scope project).

Hoe zie je of een MCP-server werkt?

claude mcp list test de verbinding. In een sessie toont /mcp de status. Of Claude hem echt gebruikt, zie je aan de handelingen met mcp__ ervoor.

Kan ik de servers uit Claude Desktop gebruiken?

Ze staan in een ander bestand. Je zet ze over met claude mcp add of claude mcp add-json. Gebruik je Claude Desktop uit de Microsoft Store, let dan op de afwijkende map van het instellingenbestand.

Bronnen