In deze handleiding leer je stap voor stap hoe je Claude Desktop installeert, MCP-servers toevoegt en direct productieve AI-workflows opzet die verbinding maken met je eigen bedrijfssystemen. We werken met een fictief scenario: Lotte van Dijk, eigenaar van een marketingbureau in Haarlem met acht medewerkers, die Claude wil koppelen aan Google Drive, Notion en GitHub.
Na deze handleiding heb jij precies hetzelfde werkend: een AI-assistent die in jouw bestanden kan zoeken, taken kan aanmaken in je projecttool, en code kan bekijken in je repository, allemaal vanuit één chatvenster.
Wat je na deze handleiding kunt
- Claude Desktop installeren en configureren op macOS of Windows
- MCP-servers toevoegen voor Google Drive, Notion en GitHub
- Claude laten zoeken in jouw bestanden en daar acties op laten uitvoeren
- Veilige MCP-configuratie met OAuth consent instellen
- Veelvoorkomende problemen herkennen en oplossen
Wat je nodig hebt
- Een computer met macOS 13+ of Windows 11 (Claude Desktop vereist een moderne OS-versie)
- Een Anthropic-account: gratis aanmaken op claude.ai
- Node.js 18 of hoger geinstalleerd (controleer met: node --version in je terminal)
- Accounts bij de tools die je wilt koppelen (Google, Notion, GitHub)
- Basiskennis van de terminal/command prompt (commando's kopiëren en uitvoeren)
Tijdsinvestering: circa 45-60 minuten voor de volledige setup. Daarna draait het systeem zelfstandig.
Stap 1: Claude Desktop downloaden en installeren
Ga naar claude.ai/download en download de versie voor jouw besturingssysteem. Installeer de app zoals je elke andere app installeert: op macOS sleep je de app naar de Applications-map, op Windows voer je het installatieprogramma uit.
Start Claude Desktop na de installatie en log in met je Anthropic-account. Als je nog geen account hebt, maak je die gratis aan via claude.ai/signup. Het gratis plan is voldoende om MCP te testen; voor productief gebruik is het Pro-abonnement (20 dollar per maand) aanbevolen vanwege hogere limieten.
Controleer na de login dat de app correct draait: je ziet het bekende chatvenster van Claude. In de linkerbalk zie je 'Model Context Protocol' staan als je naar Instellingen gaat. Dat is de plek waar we straks onze servers toevoegen.
Stap 2: Node.js controleren en installeren
De meeste MCP-servers zijn geschreven in JavaScript en draaien via Node.js. Open je terminal (op macOS: via Spotlight zoek je 'Terminal', op Windows: zoek 'Command Prompt' of 'PowerShell') en voer dit commando uit:
node --version
npm --versionJe ziet zoiets als v22.5.1 en 10.8.2. Als je een foutmelding krijgt ('command not found'), installeer dan Node.js via nodejs.org. Kies de LTS-versie (Long Term Support), die is het meest stabiel voor zakelijk gebruik. Herstart je terminal na de installatie en controleer opnieuw.
Stap 3: Het MCP-configuratiebestand aanmaken
Claude Desktop leest zijn MCP-configuratie uit een JSON-bestand. Dit bestand moet je zelf aanmaken op de juiste locatie:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Maak op macOS de map aan en open het bestand in een teksteditor (bijv. TextEdit, VS Code of Cursor):
mkdir -p ~/Library/Application\ Support/Claude
open ~/Library/Application\ Support/Claude/Maak in deze map een nieuw bestand aan met de naam claude_desktop_config.json. Begin met een lege configuratie:
{
"mcpServers": {}
}Sla op. Dit is je startpunt. We vullen mcpServers stap voor stap in met de servers die we willen toevoegen.
Stap 4: Google Drive koppelen via MCP
De officiële Google Drive MCP-server laat Claude bestanden zoeken, lezen en aanmaken in je Google Drive. Installeer eerst de server via npm:
npm install -g @modelcontextprotocol/server-gdriveJe hebt een Google Cloud-project nodig met de Drive API ingeschakeld. Ga naar console.cloud.google.com, maak een project aan (of gebruik een bestaand project), schakel de 'Google Drive API' in via 'APIs & Services', en maak OAuth 2.0 credentials aan (type: Desktop application). Download het credentials.json bestand.
Sla het credentials.json bestand op in je home-map: ~/google-drive-credentials.json. Voer vervolgens de authenticatie uit:
npx @modelcontextprotocol/server-gdrive --credentials ~/google-drive-credentials.jsonJe browser opent automatisch en vraagt toestemming voor toegang tot je Google Drive. Na goedkeuring sla je een token op. Dat hoeft maar eenmalig.
Voeg nu de server toe aan je claude_desktop_config.json:
{
"mcpServers": {
"gdrive": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-gdrive",
"--credentials",
"/Users/JOUWGEBRUIKERSNAAM/google-drive-credentials.json"
]
}
}
}Vervang JOUWGEBRUIKERSNAAM door je werkelijke gebruikersnaam. Sla op en herstart Claude Desktop. Na de herstart zie je in Claude een gereedschapspictogram dat aangeeft dat Google Drive beschikbaar is.
Stap 5: Notion koppelen via MCP
Voor Notion heb je een integration token nodig. Ga naar notion.so/my-integrations en maak een nieuwe integratie aan. Geef hem een duidelijke naam zoals 'Claude MCP' en kopieer het Internal Integration Token dat begint met 'secret_'.
Belangrijk: je moet de integratie nog koppelen aan je Notion-pagina's. Open in Notion de pagina's die Claude mag zien, klik op de drie puntjes rechtsboven, ga naar 'Add connections' en selecteer je Claude MCP-integratie. Doe dit voor elke pagina of database die je wilt ontsluiten.
Installeer de Notion MCP-server en voeg hem toe aan je configuratie:
npm install -g @modelcontextprotocol/server-notion{
"mcpServers": {
"gdrive": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-gdrive",
"--credentials", "/Users/JOUWGEBRUIKERSNAAM/google-drive-credentials.json"]
},
"notion": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-notion"],
"env": {
"NOTION_API_KEY": "secret_JOUW_NOTION_TOKEN_HIER"
}
}
}
}Vervang secret_JOUW_NOTION_TOKEN_HIER door het token dat je net hebt gekopieerd. Sla op en herstart Claude Desktop.
Stap 6: GitHub koppelen via MCP
Voor GitHub heb je een Personal Access Token (PAT) nodig. Ga naar github.com/settings/tokens, klik op 'Generate new token (classic)' en geef het de scopes: repo, read:org, en read:user. Kopieer het token dat begint met 'ghp_'.
{
"mcpServers": {
"gdrive": { ... },
"notion": { ... },
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_JOUW_TOKEN_HIER"
}
}
}
}De puntjes (...) staan voor je bestaande gdrive- en notion-configuratie die je al hebt ingevuld. Sla op en herstart Claude Desktop voor de derde en laatste keer.
Stap 7: Testen of alles werkt
Na de herstart van Claude Desktop zie je onderin het chatvenster een gereedschapspictogram (een hamer-icoon of plug-icoon). Klik erop om te zien welke MCP-servers actief zijn. Je zou 'gdrive', 'notion' en 'github' moeten zien staan met een groen vinkje.
Test elke koppeling met een eenvoudige vraag:
- Google Drive: 'Zoek in mijn Drive naar bestanden over marketing en geef me een lijst van de vijf meest recente.'
- Notion: 'Wat staat er in mijn projectenlijst in Notion?' (werkt alleen voor pagina's die je hebt gedeeld met de integratie)
- GitHub: 'Geef me een overzicht van de open pull requests in mijn repository [naam/repo].'
Claude geeft direct antwoord op basis van echte, actuele data uit jouw systemen. Geen kopieer-plakwerk meer.
Stap 8: Veiligheid instellen met OAuth consent
MCP-servers kunnen acties uitvoeren in jouw systemen. Dat is krachtig, maar vraagt om bewuste keuzes over wat je toestaat. Claude Desktop heeft hiervoor een ingebouwde consent-laag: bij elke actie die een MCP-server wil uitvoeren, krijg jij een bevestigingsdialoog. Je ziet precies wat er gaat gebeuren en kunt goedkeuren of afwijzen.
Aanbevolen instellingen voor zakelijk gebruik:
- Schakel 'Ask before tool use' in via Instellingen > Model Context Protocol > Bevestigingen. Claude vraagt dan altijd toestemming voordat hij een actie uitvoert.
- Geef de GitHub MCP-server alleen read-rechten tenzij je expliciet wilt dat Claude issues aanmaakt of pull requests opent. Pas de token-scopes hierop aan.
- Deel in Notion uitsluitend de pagina's die relevant zijn voor de taak. Een klantenservice-assistent heeft geen toegang tot je financiële databases nodig.
- Sla geen tokens op in gedeelde bestanden. Het claude_desktop_config.json bestand staat lokaal op jouw computer en is niet automatisch gedeeld, maar wees voorzichtig als je backups maakt naar de cloud.
Problemen oplossen: de meest voorkomende fouten
Probleem 1: MCP-server verschijnt niet in Claude Desktop
Oorzaak: JSON-syntaxfout in claude_desktop_config.json, of Claude Desktop is niet herstart. Oplossing: open het JSON-bestand in een editor met syntaxhighlighting (VS Code) en controleer op ontbrekende komma's of haakjes. Herstart Claude Desktop volledig (sluit helemaal af via de menubalk, niet alleen het venster).
Probleem 2: 'command not found: npx' bij starten server
Oorzaak: Node.js niet gevonden door Claude Desktop, omdat de app wordt gestart vanuit een andere omgeving dan je terminal. Oplossing: gebruik het volledige pad naar npx in je configuratie. Voer in je terminal uit: which npx. Dat geeft iets als /usr/local/bin/npx. Gebruik dat volledige pad in je JSON als command-waarde in plaats van 'npx'.
{
"notion": {
"command": "/usr/local/bin/npx",
"args": ["-y", "@modelcontextprotocol/server-notion"],
"env": { "NOTION_API_KEY": "secret_..." }
}
}Probleem 3: Google Drive vraagt steeds opnieuw om toestemming
Oorzaak: het token-bestand wordt niet gevonden of heeft geen schrijfrechten. Oplossing: voer de authenticatie opnieuw uit via de terminal en controleer dat het token-bestand succesvol is opgeslagen (je ziet 'Token opgeslagen' in de output). Controleer de bestandsrechten: chmod 600 ~/google-drive-token.json.
Probleem 4: Claude zegt dat hij geen tools heeft
Oorzaak: de MCP-servers zijn gestart maar Claude herkent ze niet. Controleer de logs via Help > Open Logs in Claude Desktop (macOS) of %APPDATA%\Claude\logs op Windows. Zoek naar foutmeldingen die beginnen met 'mcp' of 'server'. Die geven de exacte oorzaak aan.
Probleem 5: Notion-pagina's zijn niet zichtbaar
Oorzaak: je hebt de Notion-integratie niet gedeeld met de specifieke pagina's. Oplossing: open elke Notion-pagina die Claude moet kunnen zien, klik op de drie puntjes rechtsboven, kies 'Add connections' en voeg je Claude MCP-integratie toe. Dit moet voor elke pagina (of bovenliggende database) apart worden gedaan.
Verder bouwen: wat je nog meer kunt koppelen
Nu je de basis hebt staan, zijn er veel richtingen om naartoe uit te breiden:
- Slack: laat Claude berichten lezen en sturen in je werkkanalen (MCP-server: @modelcontextprotocol/server-slack)
- PostgreSQL of SQLite: laat Claude queries draaien op je database en data analyseren zonder SQL te schrijven
- Filesystem: laat Claude bestanden lezen en schrijven op een specifieke map op je computer (ideaal voor lokale projecten)
- n8n als MCP-server: gebruik n8n 2.32 als MCP-endpoint zodat Claude complexe workflows kan triggeren in jouw automatiseringsplatform
- Eigen MCP-server bouwen: heb je een intern systeem dat nog geen MCP-server heeft? Je kunt er een schrijven in JavaScript of Python. De documentatie staat op modelcontextprotocol.io/docs
Conclusie: je AI-assistent is nu verbonden met je bedrijf
Wat je zojuist hebt opgezet is geen experiment meer. Lotte van Dijk, onze fictieve marketingbureau-eigenaar in Haarlem, heeft nu een AI-assistent die haar Google Drive doorzoekt, actiepunten aanmaakt in Notion, en pull requests reviewt in GitHub, allemaal vanuit één chatvenster. Zonder kopieer-plakwerk. Zonder zes tabbladen open.
Dat is de belofte van MCP: AI die niet praat over je werk, maar ermee meewerkt. De setup kost een middagje. De tijdwinst die het oplevert is dagelijks.
Wil je verder gaan? Lees ons artikel over wat MCP is en waarom het belangrijk is voor jouw bedrijf, of bekijk onze handleiding over het bouwen van een n8n AI Agent met Claude voor geavanceerdere geautomatiseerde workflows.
