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.
Zelf getest op 11 november 2026.
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:
# 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/mcpUitgevoerd in de map van het project. Vervang het pad door je eigen projectmap.
| Scope | Waar het staat | Wie hem krijgt |
|---|---|---|
local (standaard) | Je eigen .claude.json, onder dit project | Alleen je eigen account, alleen in dit project |
project | .mcp.json in de projectmap | Iedereen die het project uit Git haalt |
user | Je eigen .claude.json | Alleen je eigen account, in al je projecten |
(opent op ware grootte)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
- De volgorde van
-etelt. We schreven eerst--transport stdio -e MEMORY_FILE_PATH=… geheugen. Claude Code las de naamgeheugentoen als tweede omgevingsvariabele en gafInvalid environment variable format: geheugen. Zet-evóór--transport, of zet een andere optie tussen-een de naam. - 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.
claude mcp get bestanden
claude mcp remove geheugen --scope project
claude mcp remove context7 --scope user
(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
- Claude Code: Connect Claude Code to tools via MCP gecontroleerd op
- GitHub: modelcontextprotocol/servers (filesystem, memory) gecontroleerd op
- Model Context Protocol: Connect to local MCP servers gecontroleerd op
Meer over claude in de praktijk
- Claude Desktop: downloaden, installeren en goed instellenDe Claude desktop-app voor Windows, Mac en Linux: waar je hem downloadt, wat hij kost, wat hij meer kan dan de browser en wat je na installatie instelt.
- Claude Code installeren: kiezen, installeren en je eerste taakClaude Code installeren met één commando: getest op een schone Mac en Linux. Met de keuze terminal, app of editor, de foutmeldingen en een eerste taak.
- Claude Code-skills: zelf een skill maken, installeren en testenEen skill in Claude Code maken in tien minuten, met een werkend controlescript. Getest: laadt bij de juiste vraag, blijft dicht bij een andere.
- Claude Code gebruiken: een handleiding met één echt projectjeHoe je Claude Code gebruikt, uitgelegd met één echt projectje: plannen, bouwen, nakijken en vastleggen. Met alle opdrachten woord voor woord en de uitkomst.
Ook handig
- Wat is MCP? Het Model Context Protocol uitgelegd met een eigen MCP-serverMCP is de standaardstekker tussen een AI-app en je eigen software. Uitgelegd met een MCP-server die we zelf bouwden en aansloten, en waar je op let.
- n8n-workflows laten bouwen door Claude Code: wat werkt en waar je zelf kijktClaude Code bouwde, valideerde en testte drie n8n-workflows via de MCP-server van n8n. Wat werkte, wat je zelf nakijkt, en de opdracht om te kopiëren.
- AI-nieuws deze week: wat er van 2 tot 10 november 2026 veranderde in de tools die je gebruiktAI-nieuws van 2 tot 10 november 2026 voor ondernemers: nieuwe Claude-modellen, updates van Codex, Gemini CLI en n8n, en wat je ermee doet.