MCP is de stopcontactstandaard tussen Claude Desktop en uw gereedschap. In plaats van tien eigen integraties praten app en tool via hetzelfde protocol – en koppelt u mail, agenda of bestandssysteem rechtstreeks aan, in plaats van via kopiëren en plakken.
Het configuratiebestand begrijpen
Eén enkel bestand bepaalt welke servers Claude Desktop kent: claude_desktop_config.json. Het staat op macOS onder ~/Library/Application Support/Claude, op Windows onder %APPDATA%\Claude, op Linux onder ~/.config/Claude.
Per server één regel met naam, opdracht en argumenten. Optioneel omgevingsvariabelen, optioneel een ander transport. Na elke wijziging moet de app volledig opnieuw worden gestart – op macOS is het sluiten van het venster niet genoeg.
Laat vóór het activeren een JSON-lint lopen. Eén ontbrekende komma laat de complete serverlijst verdwijnen.
Zes servers waarmee ik het vaakst begin
Bestandssysteemserver. Claude leest en schrijft in een duidelijk afgebakende map. Geef alleen een expliciet gekozen pad vrij.
GitHub- of GitLab-server. Repositorycontext, pull requests, issues – een apart botaccount met minimale rechten is daarbij verplicht.
Notion- of Confluence-server. De kennisbank lezen en vullen. Regel de paginarechten vooraf, anders overschrijft Claude hele delen.
Gmail- of Outlook-server. De mailbox doorzoeken en concepten opslaan. Begin read-only, verzenden pas wanneer de spelregels vaststaan.
Google Drive- of OneDrive-server. PDF’s samenvatten, tabellen bevragen, versies vergelijken. Geef nooit de hele Drive vrij.
JIRA- of Linear-server. Tickets als context meenemen. Geef de voorkeur aan leestokens, schrijven alleen voor duidelijk afgebakende taken.
Wanneer het hamerpictogram leeg blijft
Vier storingsbeelden verklaren in de praktijk 90 % van de gevallen.
JSON-syntaxfout. Een vergeten komma of een dubbele haak is al genoeg. Gooi het bestand vóór het opslaan door een JSON-linter.
Verkeerd pad naar het uitvoerbare bestand. Gebruik absolute paden, geen relatieve. Controleer op macOS en Linux de uitvoerrechten.
Ontbrekende omgevingsvariabelen. Tokens en paden horen in het env-blok van de serverconfiguratie. Op het shellprofiel vertrouwt de app niet.
Server blijft hangen bij het starten. Controleer in het logbestand of het proces op invoer wacht. Veelvoorkomende oorzaak: een interactieve OAuth-flow die eenmalig doorlopen moet worden.