MCP-servers koppelen aan Claude Code

MCP-servers geven Claude Code toegang tot tools buiten je code, zoals een issuetracker, een database of een ontwerptool. Deze handleiding toont de commando's om er een toe te voegen, waar de instelling wordt opgeslagen, hoe je inlogt en hoe je ziet of het werkt.

Bijgewerkt 30 oktober 2026

Kort antwoord: voer voor een externe server claude mcp add --transport http name https://server/mcp uit; voor een lokale claude mcp add name -- command args. Voeg --scope user toe om hem in elk project te gebruiken of --scope project om hem via .mcp.json te delen. Open daarna Claude Code, typ /mcp om zo nodig in te loggen en controleer of de server als verbonden wordt getoond.

De commando's hieronder volgen de documentatie van Anthropic over Claude Code van oktober 2026. Je voert de claude mcp-commando's uit in je gewone terminal, niet binnen een sessie van Claude Code.

Een externe server toevoegen (het meest gebruikelijk)

Een gehoste dienst geeft je een webadres voor zijn MCP-server, dat je in de eigen installatie-instructies van die dienst vindt. Anthropic raadt hiervoor het HTTP-transport aan.

Ga in je terminal met cd naar het project waarin je hem gaat gebruiken.
Voer claude mcp add --transport http notion https://mcp.notion.com/mcp uit, met je eigen naam en adres. De naam zie je terug in lijsten en in /mcp.
Gebruikt de dienst een API-sleutel in plaats van een login, geef die dan mee als header: --header "Authorization: Bearer your-token".

Oudere servers bieden soms alleen SSE aan, dat verouderd is. Recente versies van Claude Code proberen eerst HTTP en vallen zelf terug op SSE; gebruik bij oudere versies --transport sse.

Een lokale server toevoegen

Een lokale (stdio-)server is een programma dat op je computer draait en vaak met npx wordt gestart.

Schrijf eerst de opties voor Claude, dan --, en dan het eigen commando van de server: claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable -- npx -y airtable-mcp-server.
Claude Code geeft alles na -- rechtstreeks door aan het serverprogramma. Zonder dat scheidingsteken worden opties voor de server (zoals -y) gelezen als opties van Claude Code.
Gebruik je --env, zet dan een andere optie tussen die en de servernaam, zoals in het voorbeeld, anders wordt de naam gelezen als nog een variabele.

Een bereik kiezen

Bereik	Waar het werkt	Opgeslagen in
`local` (standaard)	Dit project, alleen voor jou	`~/.claude.json`, onder het pad van het project
`project`	Dit project, voor iedereen die het kloont	`.mcp.json` in de hoofdmap van het project (commit het)
`user`	Al je projecten	`~/.claude.json`

Kies user voor tools die je overal wilt, zoals je notitie-app, en project voor tools die het hele team in één repository nodig heeft. Is één server op meerdere plekken gedefinieerd, dan maakt Claude Code één keer verbinding, in deze volgorde van prioriteit: local, project, user, dan servers uit plugins, dan connectors van claude.ai. De drie bereiken worden op naam vergeleken; pluginservers en connectors tellen als dubbel als ze naar hetzelfde adres of commando wijzen. De winnende vermelding wordt in zijn geheel gebruikt; velden worden niet samengevoegd.

Zet geen geheimen rechtstreeks in een gedeelde .mcp.json. Het bestand accepteert variabelen zoals ${API_KEY} of ${API_BASE_URL:-https://api.example.com}, die ieder in zijn eigen omgeving instelt.

Inloggen bij een server die een account nodig heeft

Start Claude Code met claude.
Typ /mcp. Het paneel toont de servers waarvoor je nog moet inloggen.
Selecteer de server en volg de login in de browser. Het token wordt op je computer bewaard en voor je vernieuwd.
Je kunt ook vanuit je shell claude mcp login name uitvoeren. Log uit met claude mcp logout name.

Bij sommige diensten moet je eerst een app registreren. Voeg de server in dat geval toe met --client-id, --client-secret (je wordt gevraagd het in te typen) en, als hun instructies om een vaste redirect vragen, --callback-port.

Controleren of het werkt

claude mcp list toont elke server met zijn status: Connected (verbonden), Needs authentication (login nodig), Failed to connect (verbinding mislukt), Pending approval (wacht op goedkeuring) of Disabled for this project (uitgeschakeld voor dit project).
claude mcp get name toont de details van één server, inclusief de HTTP-fout als het misgaat.
Binnen een sessie toont /mcp dezelfde status en kun je opnieuw verbinden.
Vraag Claude tot slot iets te doen wat alleen die server kan, zoals "list my open Linear issues".

Verwijder een server met claude mcp remove name.

Goed om te weten

Projectservers vragen eerst: de eerste keer dat een sessie servers vindt in de .mcp.json van een repository, vraagt Claude Code je om ze goed te keuren. Maak je keuzes ongedaan met claude mcp reset-project-choices. Keur alleen servers goed uit repository's die je vertrouwt.
Permissies blijven gelden: elke aanroep van een MCP-tool kan je om toestemming vragen, net als elke andere tool; zie permissies beheren in Claude Code.
Grote resultaten: Claude Code waarschuwt als een tool meer dan 10.000 tokens teruggeeft en begrenst de uitvoer standaard op 25.000. Verhoog dat met de omgevingsvariabele MAX_MCP_OUTPUT_TOKENS.
Plugins: sommige plugins brengen hun eigen MCP-servers mee, dus een plugin installeren kan een makkelijkere route zijn; zie plugins installeren in Claude Code.

Als het niet werkt

Failed to connect: voer claude mcp get name uit om de fout te zien, controleer de URL en voer dan in een sessie /mcp reconnect all uit (recente versies) om het opnieuw te proberen.
Een trage lokale server loopt bij het opstarten in een time-out: start Claude Code met een ruimere limiet, zoals MCP_TIMEOUT=10000 claude (in milliseconden).
"has a url but no type": in een JSON-vermelding voor een externe server ontbreekt "type": "http".
De API-sleutel wordt geweigerd: Claude Code waarschuwt voor spaties of regeleinden aan het begin of eind van een header. Voeg de server opnieuw toe met een netjes geplakt token.

Bronnen

Claude Code user FAQ (Claude Help Center, gecontroleerd op 30 oktober 2026)
Connect Claude Code to tools via MCP (Claude Code Docs, gecontroleerd op 30 oktober 2026)

Veelgestelde vragen

Is dit hetzelfde als connectors op claude.ai?

Ze hangen samen, maar je stelt ze apart in. Connectors van claude.ai kunnen ook in Claude Code laden, maar ze hebben de laagste prioriteit: wijst een server die je met claude mcp add hebt toegevoegd naar hetzelfde adres, dan wordt die van jou gebruikt. Zie onze handleiding over Claude-connectors voor de web- en desktop-apps.

Log ik bij de dienst uit als ik een server verwijder?

Niet helemaal. claude mcp remove verwijdert de opgeslagen login op je computer, maar trekt hem niet in. Voer eerst claude mcp logout name uit als je wilt dat het token wordt ingetrokken.

Kan ik een server toevoegen vanuit een JSON-fragment?

Ja. claude mcp add-json name gevolgd door de JSON-configuratie werkt. Neem voor een externe server "type": "http" op in de JSON, anders wordt hij als lokaal commando behandeld en mislukt het.