Source: https://claudetutorial.com/guides/nl-nl/een-mcp-server-toevoegen-aan-claude-code-commandos-scopes-en-oplossingen [Terug naar Gidsen](https://claudetutorial.com/guides/nl-nl) Builders # Een MCP-server toevoegen aan Claude Code: commando's, scopes en oplossingen 27 oktober 2026 11 min leestijd --- De gebruikelijke manier om Claude Code aan een tool te koppelen is drie verschillende installatiepagina's lezen, een commando kopiëren dat net niet klopt voor jouw systeem en je afvragen waarom er niets verschijnt. In werkelijkheid is het één commando en één controle, zolang je weet welke soort server je toevoegt. > Elke MCP-server die je aan Claude Code toevoegt, komt neer op één commando: claude mcp add, gevolgd door hoe de server verbindt. Deze gids geeft je de commando's voor de drie soorten servers, legt de scopes uit die bepalen wie de server krijgt en behandelt aanmelden, veiligheid en de oplossingen voor wat misgaat. Is MCP nieuw voor je, begin dan met [Wat is MCP?](https://claudetutorial.com/guides/nl-nl/wat-is-mcp-het-model-context-protocol-eenvoudig-uitgelegd). ## Wat je nodig hebt - Claude Code geïnstalleerd en werkend. Zo niet, zie [Claude Code voor beginners](https://claudetutorial.com/guides/nl-nl/claude-code-voor-beginners-installeren-inloggen-en-je-eerste-taak) - Het adres van de server (voor een externe server) of zijn startcommando (voor een lokale), uit de eigen documentatie van de dienst - Een account bij de dienst die je koppelt Koppel een server wanneer je merkt dat je gegevens uit een andere tool naar de chat kopieert. Zodra hij verbonden is, kan Claude uit dat systeem lezen en er rechtstreeks in handelen. ## Drie soorten servers Welk commando je gebruikt, hangt af van hoe de server met jou verbindt. | Soort | Hoe hij verbindt | Gebruik hem voor | | --- | --- | --- | | **Externe HTTP** | Een webadres op internet | De meeste clouddiensten. De aanbevolen keuze | | **Externe SSE** | Een webadres met een oudere methode | Diensten die alleen dat aanbieden. Verouderd, dus kies waar mogelijk HTTP | | **Lokale stdio** | Een programma dat op je machine draait | Lokale bestanden, databases en tools | ### Externe HTTP-server De basisvorm is voor elke dienst hetzelfde: ``` claude mcp add --transport http ``` Een echt voorbeeld koppelt Notion: ``` claude mcp add --transport http notion https://mcp.notion.com/mcp ``` Heeft de server een token nodig, geef het dan mee als header: ``` claude mcp add --transport http secure-api https://api.example.com/mcp \ --header "Authorization: Bearer your-token" ``` ### Externe SSE-server (verouderd) De SSE-methode is verouderd, dus gebruik HTTP wanneer de dienst dat aanbiedt. Heeft een dienst alleen SSE, dan gebruikt het commando een ander transport: ``` claude mcp add --transport sse asana https://mcp.asana.com/sse ``` ### Lokale stdio-server Een stdio-server is een programma dat op je eigen machine draait en door Claude Code wordt gestart. De basisvorm heeft een dubbel streepje, en alles erna is het commando dat de server start: ``` claude mcp add [options] -- [args...] ``` Een voorbeeld dat een Airtable-server met een API-sleutel toevoegt: ``` claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \ -- npx -y airtable-mcp-server ``` Vergeet het dubbele streepje niet Alles na `--` wordt ongewijzigd aan de server doorgegeven. Zonder dat streepje probeert Claude Code de eigen opties van de server als zijn opties te lezen, en mislukt het commando op verwarrende manieren. ## Controleer of het gelukt is Nadat je een server hebt toegevoegd, controleer je hem vanuit je terminal of vanuit Claude Code. Terminal ``` $ claude mcp list$ claude mcp get notion$ claude mcp remove notion ``` Toon alle ingestelde servers, bekijk de details van één server of verwijder er een. Typ in een sessie `/mcp` om de status van elke server te zien. Je ziet een van drie toestanden: verbonden, aanmelding nodig of verbinden mislukt. | Status | Wat het betekent | Wat je doet | | --- | --- | --- | | Connected | De server is klaar | Vraag Claude hem te gebruiken | | Needs authentication | Je bent nog niet aangemeld | Draai `/mcp` en volg de login in de browser | | Failed to connect | Claude Code kon hem niet bereiken of starten | Zie de oplossingen hieronder | ## Aanmelden met OAuth Veel cloudservers gebruiken OAuth 2.0, de aanmeldmethode "log in met je account". De eenvoudigste weg heeft twee stappen. 1. Voeg de server toe Bijvoorbeeld: `claude mcp add --transport http sentry https://mcp.sentry.dev/mcp` 2. Authenticeer Draai in Claude Code `/mcp` en volg de loginstappen in je browser. Vanuit de shell kun je ook `claude mcp login ` en `claude mcp logout ` draaien. Tokens worden veilig opgeslagen en automatisch vernieuwd. Om toegang in te trekken gebruik je **Clear authentication** (Authenticatie wissen) in het menu van `/mcp`. ## Scopes: wie krijgt de server Wanneer je een server toevoegt, kies je zijn scope. De scope bepaalt welke projecten hem zien en of je team hem deelt. | Scope | Beschikbaar in | Gedeeld met je team | Opgeslagen in | | --- | --- | --- | --- | | **Local** (de standaard) | Alleen het huidige project | Nee | `~/.claude.json` | | **Project** | Alleen het huidige project | Ja, via versiebeheer | `.mcp.json` in de hoofdmap van het project | | **User** | Al je projecten | Nee | `~/.claude.json` | Kies er een met de vlag `--scope`: ``` # Project scope: shared with your team claude mcp add --transport http shared-server --scope project https://example.com/mcp # User scope: available in all your projects claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic ``` Een server met projectscope schrijft een bestand `.mcp.json` in de hoofdmap van je project, dat je commit zodat iedereen dezelfde verbinding krijgt: ``` { "mcpServers": { "shared-server": { "type": "http", "url": "https://example.com/mcp" } } } ``` Komt dezelfde servernaam in meer dan één scope voor, dan verbindt Claude Code één keer, met de definitie van de bron met de hoogste voorrang: eerst local, dan project, dan user. Wint als eerste Wint als laatste 1. Local Alleen dit project, alleen jij, opgeslagen in ~/.claude.json 2. Project Gedeeld met je team via .mcp.json 3. User Al je projecten, alleen jij, opgeslagen in ~/.claude.json Gebruik projectscope voor tools die het hele team nodig heeft, userscope voor je persoonlijke tools en local wanneer je test. Open je een project met een `.mcp.json` van iemand anders, dan vraagt Claude Code in een interactieve sessie om je goedkeuring voordat het de servers ervan gebruikt. Om die keuzes te resetten draai je `claude mcp reset-project-choices`. ## Populaire servers die je nu kunt toevoegen Deze voorbeelden komen uit de officiële documentatie. Lees altijd de eigen pagina van de dienst voor het actuele adres. | Dienst | Commando | | --- | --- | | Sentry (fouten) | `claude mcp add --transport http sentry https://mcp.sentry.dev/mcp` | | Stripe (betalingen) | `claude mcp add --transport http stripe https://mcp.stripe.com` | | GitHub (codereviews) | `claude mcp add --transport http github https://api.githubcopilot.com/mcp/ --header "Authorization: Bearer YOUR_GITHUB_PAT"` | | Notion | `claude mcp add --transport http notion https://mcp.notion.com/mcp` | | PostgreSQL via DBHub | `claude mcp add --transport stdio db -- npx -y @bytebase/dbhub --dsn "postgresql://readonly:pass@prod.db.com:5432/analytics"` | Let bij de database op de gebruikersnaam: `readonly`. Geef Claude een databaseaccount dat alleen kan lezen. Die ene keuze voorkomt de duurste fout die je kunt maken. Je kunt ook door beoordeelde connectors bladeren in de map van Anthropic op claude.ai/directory. En heb je een connector in claude.ai toegevoegd, dan is die al beschikbaar in Claude Code wanneer je je aanmeldt met je Claude-account. ## Blijf veilig Een MCP-server geeft Claude toegang tot een systeem, en sommige servers halen inhoud van buiten op, zoals webpagina's of tickets die vreemden hebben geschreven. Controleer of je elke server vertrouwt Servers die externe inhoud ophalen, kunnen je blootstellen aan prompt injection: tekst die is geschreven om een AI iets te laten doen wat je niet hebt gevraagd. Voeg alleen servers toe uit bronnen die je vertrouwt en kijk wat Claude ermee van plan is. - De server komt uit de eigen documentatie van de dienst, niet uit een willekeurig bericht - Databases gebruiken een account dat alleen kan lezen - Tokens staan in headers of omgevingsvariabelen, nooit in een bestand dat je commit - Je werkt in een permission mode waarin je ziet wat Claude met de tools doet Dat laatste punt hangt samen met hoeveel Claude doet zonder te vragen. Zie [Claude Code: permission modes en Plan-modus uitgelegd](https://claudetutorial.com/guides/nl-nl/claude-code-permission-modes-en-plan-modus-uitgelegd) om dat te bepalen. In Claude Tutorial Een tool vertrouwen is een beslissing, geen standaard Beoordelen welke systemen toegang verdienen, en voor welke acties, is een vaardigheid die ver buiten code reikt, en de app oefent die met echte scenario's. Binnenkort [DOWNLOAD VIA Google Play](https://play.google.com/store/apps/details?id=com.claudetutorial.mobile) ## Limieten en afstellen Twee limieten helpen gedrag te verklaren dat anders vreemd lijkt. - **Grote resultaten.** Claude Code toont een waarschuwing wanneer de uitvoer van een tool 10.000 tokens overschrijdt, en beperkt de uitvoer standaard tot 25.000 tokens. Om de limiet te verhogen zet je de variabele `MAX_MCP_OUTPUT_TOKENS`, bijvoorbeeld `MAX_MCP_OUTPUT_TOKENS=50000`. - **Trage servers.** Om te wijzigen hoe lang Claude Code op het starten van een server wacht, zet je `MCP_TIMEOUT`. Bijvoorbeeld: `MCP_TIMEOUT=10000 claude` geeft tien seconden. Tool search staat standaard aan, zodat je context niet vol raakt met alle toolbeschrijvingen tegelijk. Draai `/context` om te zien wat ruimte inneemt. ## Als het niet werkt | Wat je ziet | Waarschijnlijke oorzaak | Oplossing | | --- | --- | --- | | De server ontbreekt in `claude mcp list` | Hij is in een andere scope of een ander project toegevoegd | Draai `claude mcp list` vanuit het project waar je hem toevoegde, of voeg hem toe met `--scope user` | | `/mcp` toont dat aanmelding nodig is | Je bent niet aangemeld | Draai `/mcp` en volg de stappen in de browser, of `claude mcp login ` | | `/mcp` toont dat verbinden mislukt is | Fout adres, server niet bereikbaar of een startcommando dat faalt | Controleer de URL in de documentatie van de dienst. Draai bij een lokale server zijn commando in je terminal om de fout te zien | | De eigen vlaggen van een lokale server worden geweigerd | Het dubbele streepje ontbreekt | Zet `--` vóór het servercommando | | Het werkt in het ene project maar niet in het andere | Local scope geldt voor één project | Voeg hem opnieuw toe met `--scope user`, of projectscope voor een team | | Claude negeert een projectserver | De goedkeuring voor de `.mcp.json` is geweigerd | Draai `claude mcp reset-project-choices` en keur opnieuw goed | | De uitvoer wordt afgekapt | De standaardlimiet van 25.000 tokens | Verhoog `MAX_MCP_OUTPUT_TOKENS` | Past niets hiervan, vraag Claude Code dan om hulp: plak de fout en vraag wat ze betekent. Met `/doctor` controleer je ook je installatie. ## Veelgestelde vragen ### Hoe voeg ik een MCP-server toe aan Claude Code? Draai `claude mcp add --transport http ` voor een externe server, of `claude mcp add -- ` voor een lokale. Draai daarna `/mcp` in Claude Code om de status te controleren en je aan te melden. ### Waar slaat Claude Code MCP-servers op? Servers met local en user scope staan in `~/.claude.json`. Servers met projectscope staan in een bestand `.mcp.json` in de hoofdmap van je project, dat je kunt committen. ### Wat is het verschil tussen local, project en user scope? Local geldt voor het huidige project en alleen voor jou. Project geldt voor het huidige project en wordt met je team gedeeld. User geldt voor al je projecten en alleen voor jou. ### Hoe verwijder ik een MCP-server? Draai `claude mcp remove `. Om je af te melden bij een server zonder hem te verwijderen gebruik je `claude mcp logout `. ### Wat betekent het dubbele streepje in claude mcp add? Het scheidt de eigen opties van Claude Code van het commando dat de server start. Alles erna wordt ongewijzigd aan de server doorgegeven. ### Zijn MCP-servers veilig? Alleen zo veilig als de servers die je kiest en de toegang die je geeft. Gebruik vertrouwde servers, databaseaccounts die alleen lezen en een permission mode waarin je ziet wat Claude doet. ### Kan ik mijn claude.ai-connectors in Claude Code gebruiken? Ja. Connectors die je in claude.ai toevoegt, zijn beschikbaar in Claude Code, in de terminal en in cloudsessies, wanneer je je aanmeldt met je Claude-account. ## Je MCP-checklist voor Claude Code - `claude mcp list` toont de server en `/mcp` toont hem als verbonden - Je hebt de scope bewust gekozen: local om te testen, project voor het team, user voor jezelf - Inloggegevens staan in headers of omgevingsvariabelen, niet in bestanden die je commit - Alles wat gegevens raakt die je niet kunt herstellen, gebruikt alleen-lezen toegang ## Verder lezen - [Wat is MCP? Het Model Context Protocol eenvoudig uitgelegd](https://claudetutorial.com/guides/nl-nl/wat-is-mcp-het-model-context-protocol-eenvoudig-uitgelegd) voor het idee erachter. - [Connectors toevoegen in Claude: de map, een eigen URL en veiligheid](https://claudetutorial.com/guides/nl-nl/connectors-toevoegen-in-claude-de-map-een-eigen-url-en-veiligheid) voor hetzelfde in de Claude-apps. - [Claude Code: gewoonten voor betere resultaten](https://claudetutorial.com/guides/nl-nl/claude-code-gewoonten-voor-betere-resultaten) om goed te werken zodra de tools gekoppeld zijn. - [CLAUDE.md uitgelegd: leer Claude Code je project één keer kennen](https://claudetutorial.com/guides/nl-nl/claude-md-uitgelegd-leer-claude-code-je-project-een-keer-kennen) om Claude te vertellen hoe het de gekoppelde tools in je project gebruikt.