Claude Code MCP: zo koppel je je eigen tools.

MCP is een stekker tussen Claude Code en een andere dienst, zoals je agenda, je zoekcijfers of een beeldmaker. Je koppelt een dienst met één regel in de Terminal: claude mcp add. Daarna kan Claude in die dienst lezen en dingen doen. Ik gebruik het zelf voor zoekcijfers, Search Console en beelden.

Ik ben stukadoor en geen programmeur. Toch hangen er bij mij tien koppelingen aan Claude Code. Drie zette ik erbij met één regel in de Terminal, de rest via mijn Claude-account. Wie ik ben, lees je op de pagina over mij. Staat Claude Code nog niet op je computer? Begin dan bij Claude Code installeren.

Wat is MCP, en hoe werkt MCP?

MCP staat voor Model Context Protocol. Anthropic noemt het een open standaard om AI aan andere programma’s te koppelen. Denk aan een stekkerdoos. Claude Code is de doos. Elke dienst die je wilt gebruiken, krijgt een eigen stekker.

Eén nieuw woord: server. Zo heet die stekker. Een MCP-server is een klein stukje software dat Claude Code vertelt wat er bij die dienst kan, zoals “maak een beeld” of “haal de zoekcijfers op”. Claude kiest zelf wanneer hij zo’n mogelijkheid gebruikt.

Er zijn twee soorten stekkers:

• Via internet. De dienst draait bij de maker. Je geeft Claude Code alleen het adres, en soms een sleutel.
• Op je eigen computer. Claude Code start een klein programma op je Mac, en dat praat met de dienst.

Voeg je een koppeling toe, begin daarna dan een nieuw gesprek. Dan weet je zeker dat Claude Code hem heeft geladen. Wat Claude Code zelf doet, staat in wat is Claude Code.

Welke koppelingen ik zelf gebruik

Dit zijn de koppelingen die op 6 oktober 2026 bij mij aan stonden, uit claude mcp list. Ik noem alleen wat ik er echt mee doe.

De koppeling met fal gebruik ik het meest. Daarmee kan ik bij een hele rij beeld- en videomodellen, met één sleutel. Voor voice-overs werk ik daarnaast met ElevenLabs.

Een voorbeeld uit de praktijk. Elk getal over zoekvolume in deze kennisbank komt via DataForSEO. Voor dit artikel vroeg Claude Code de zoekcijfers en de Google-resultaten van drie onderwerpen op. Dat kostte samen naar schatting 5 dollarcent. Claude Code vroeg ze op via die koppeling. Een commando typte ik er niet voor.

Daarnaast staan er nog een paar koppelingen in mijn lijst die ik minder gebruik, zoals Gmail en mijn agenda. Die kwamen er via mijn Claude-account bij, daarover verderop meer.

Claude mcp add: een koppeling toevoegen

Een koppeling toevoegen doe je met claude mcp add. Dat typ je los in de Terminal, niet in een gesprek met Claude. Ik deed het op 6 oktober 2026 na in een lege map, zodat er niets van mijn eigen werk tussen zat.

1. 01

   Ga in de Terminal naar je projectmap

   Met cd en de naam van de map. De koppeling hoort dan bij dat project.

2. 02

   Plak de regel van de dienst

   De meeste diensten geven je zelf de regel. Vervang JOUW_SLEUTEL door je eigen sleutel als de dienst erom vraagt.

   Nieuw woord sleutel: een lange code waarmee de dienst weet dat jij het bent. Behandel hem als een pincode.

3. 03

   Kijk of het gelukt is

   Met claude mcp list. Dat staat in het volgende stuk.

Zo ziet het eruit voor een dienst via internet. Ik nam fal, de beeldmaker die ik zelf gebruik, en noemde de koppeling “beelden”:

$ claude mcp add --scope project --transport http beelden https://mcp.fal.ai/mcp --header "Authorization: Bearer JOUW_SLEUTEL"Added HTTP MCP server beelden with URL: https://mcp.fal.ai/mcp to project configHeaders: {  "Authorization": "[REDACTED]"}File modified: ~/mijn-project/.mcp.json

En zo voor een programma op je eigen computer. Alles na de twee streepjes -- geeft Claude Code ongewijzigd door aan dat programma:

$ claude mcp add --scope project zoekconsole -- npx -y [email protected]Added stdio MCP server zoekconsole with command: npx -y [email protected] to project config

Waar de koppeling terechtkomt, kies je met --scope. Zeg je niets, dan krijg je de eerste rij:

Iets wat ik bij die proef zag. Claude Code laat de sleutel in zijn uitvoer weg en zet er [REDACTED] neer. Maar in het bestand .mcp.json staat hij gewoon leesbaar. Gaat die map mee naar GitHub of naar iemand anders, dan gaat je sleutel mee. Mijn regel daarom: een koppeling met een sleutel nooit op project, alleen op local of user. Ook dan staat de sleutel leesbaar in een bestand, maar dat bestand gaat niet mee met je project. Mijn eigen fal-koppeling staat op user.

Claude mcp list: kijk of hij werkt

Na het toevoegen kijk je of de stekker contact maakt:

$ claude mcp listChecking MCP server health…fal-ai: https://mcp.fal.ai/mcp (HTTP) - Connectedgsc: npx -y [email protected] - Connectedclaude.ai WordPress.com: https://public-api.wordpress.com/wpcom/v2/mcp/v1 - ! Needs authenticationbeelden: https://mcp.fal.ai/mcp (HTTP) - Pending approval (run `claude` to approve)

Achter elke koppeling staat hoe hij ervoor staat. Wat je bij elk doet:

• Connected: hij werkt. In een nieuw gesprek kan Claude hem gebruiken.
• Needs authentication: de dienst wil dat je inlogt. Staat er claude.ai voor de naam, dan koppel je hem opnieuw in je Claude-account, bij de connectors. Anders start je Claude Code, typ je /mcp, kies je de koppeling en log je in via de browser die opengaat. Dat inloggen heb ik niet nagedaan: het komt uit de handleiding.
• Pending approval: een projectkoppeling uit .mcp.json die je nog niet hebt goedgekeurd. Start claude in die map. Claude Code vraagt dan of je hem vertrouwt.

Wil je alles van één koppeling zien, dan typ je claude mcp get met de naam erachter. Let op: die laat ook de sleutel zien. Doe dat dus niet terwijl iemand meekijkt of terwijl je je scherm opneemt.

Een Claude Code MCP server weghalen

Gebruik je een koppeling niet meer, haal hem dan weg. Minder stekkers is minder om op te letten.

$ claude mcp remove beelden -s projectRemoved MCP server beelden from project configFile modified: ~/mijn-project/.mcp.json

Met -s zeg je in welk bereik hij staat. Typ je een naam die niet bestaat, dan krijg je netjes een lijst van wat er wel is: No MCP server named "…". Configured servers: …. Na mijn proef stond er in .mcp.json weer niets, en mijn eigen koppelingen waren niet aangeraakt.

Claude desktop MCP: koppelingen uit de app

Je kunt ook koppelen zonder Terminal. In de Claude-app en op claude.ai heten koppelingen connectors. Je voegt ze toe in de instellingen van je account. Log je in Claude Code in met datzelfde Claude-abonnement, dan staan ze daar vanzelf ook. In claude mcp list herken je ze aan “claude.ai” voor de naam.

Zo kwamen DataForSEO, Blotato, Gmail en mijn agenda bij mij in Claude Code: ik heb ze één keer in mijn account gekoppeld, en sindsdien kunnen de app en Claude Code er allebei bij. Werk je met een losse API-sleutel in plaats van je abonnement, dan komen ze niet mee. Dat staat zo in de handleiding van Anthropic.

Is MCP veilig?

Eerlijk antwoord: zo veilig als de dienst die je koppelt. Anthropic schrijft er zelf een waarschuwing bij: vertrouw elke server voor je hem koppelt. Een server die tekst van internet ophaalt, kan in die tekst verborgen opdrachten meekrijgen. Dat heet prompt injection: iemand anders probeert Claude via een omweg iets te laten doen.

Drie dingen die ik zelf aanhoud:

• Alleen koppelingen van de maker zelf, of een pakket dat je hebt nagekeken en op een vaste versie zet, zoals mijn Search Console-koppeling (versie 0.3.0). Een server van een onbekende is een vreemde met een sleutel van je huis.
• Koppelingen die iets kunnen versturen, krijgen een vaste stap. Blotato kan posts klaarzetten. Bij mij gebeurt dat pas als ik per post “ja” heb gezegd.
• Kijk wat een koppeling teruggeeft. Geeft een dienst veel tekst terug, dan waarschuwt Claude Code boven de 10.000 tokens. Grote antwoorden vullen je gesprek en je limiet.

Lukt het niet? Dit doe je

De eerste vier zag ik zelf in mijn Terminal. De laatste is mijn eigen vaste stap.

Koppelingen zijn één helft. De andere helft is het vaste briefje met jouw regels, dat Claude elk gesprek als eerste leest. Hoe dat werkt, lees je bij CLAUDE.md. Meer in gewone taal staat op de Claude Code-pagina met alle artikelen.