Waarom MCP de manier verandert waarop AI-agents werken
Stel je voor: je AI-agent in n8n kan zelfstandig je Gmail doorzoeken, een afspraak in Google Calendar zetten, een document in Google Drive aanmaken en dat allemaal combineren op basis van een enkelvoudige instructie. Geen aparte nodes voor elk platform, geen API-sleutels die je handmatig door de workflow moet leiden. Dat is wat het Model Context Protocol, kortweg MCP, mogelijk maakt.
MCP is een open standaard die in november 2024 door Anthropic werd gepubliceerd en sindsdien razendsnel is geadopteerd. In 2026 ondersteunen vrijwel alle grote AI-tools en orchestratie-platforms het protocol, waaronder n8n. De kern van MCP is eenvoudig: het biedt een gestandaardiseerde manier voor AI-modellen om externe tools aan te roepen, ongeacht het onderliggende platform of de programmeertaal.
Voor MKB-ondernemers die n8n gebruiken betekent dit concreet: je hoeft niet langer voor elke integratie een aparte HTTP Request node te configureren met handmatige OAuth-flows, JSON-parsing en error handling. Je stelt eenmalig een MCP-server in voor Google Workspace, en elke AI-agent in je n8n-instantie kan die tools daarna direct aanroepen via eenvoudige instructies in het Nederlands.
In deze handleiding bouw je stap voor stap een werkende MCP-koppeling tussen n8n, Claude en Google Workspace. Aan het einde heb je een AI-agent die zelfstandig e-mails kan lezen en versturen, agenda-afspraken kan aanmaken, en bestanden in Google Drive kan aanmaken en ophalen. Als praktisch scenario bouwen we een automatische vergadervoorbereider: de agent analyseert inkomende vergaderverzoeken, zoekt relevante documenten op in Drive, en stuurt een samenvatting naar je inbox.
Wat je na deze handleiding kunt
Stap 1: Begrijp hoe MCP werkt (5 minuten theorie)
Voordat je begint met configureren is het nuttig om de drie bouwstenen van MCP te kennen. MCP definieert de communicatie tussen een Host, een Client en een Server.
De Host is de applicatie die de AI bevat. In dit geval is dat n8n. De Host beheert de AI Agent node en bepaalt welke MCP-verbindingen beschikbaar zijn voor die agent.
De Client is het protocol-component dat binnen de Host leeft en berichten naar MCP-servers stuurt. In n8n is dit ingebouwd in de MCP Client Tool-node. Je hoeft de client niet apart te installeren.
De Server is de externe service die tools beschikbaar stelt. In deze handleiding gebruik je een Google Workspace MCP-server. Die server weet hoe hij Gmail, Calendar en Drive moet aanroepen en presenteert die mogelijkheden via een gestandaardiseerde interface aan de client.
Wat dit in de praktijk betekent: de MCP-server beschrijft zijn tools in een gestandaardiseerd schema. Claude leest dat schema en begrijpt automatisch welke tools beschikbaar zijn, welke parameters ze accepteren en wat ze teruggeven. Je hoeft Claude niet apart te leren hoe Gmail werkt; het protocol doet dat.
Voor Google Workspace gebruik je de officieel ondersteunde @modelcontextprotocol/server-google-workspace package, die via npm te installeren is en tools biedt voor Gmail, Calendar, Drive, Docs en Sheets. De volledige documentatie vind je op https://modelcontextprotocol.io/docs/tools/google-workspace.
Stap 2: Controleer de vereisten
Software en accounts
Technisch niveau
Deze handleiding is geschikt voor gevorderde n8n-gebruikers. Je hebt ervaring nodig met het configureren van credentials, het lezen van JSON-responses en basiskennis van OAuth. Als je net begint met n8n, lees dan eerst de handleiding over automatische rapportage op /handleidingen/automatische-rapportage-n8n-google-sheets.
Geschatte tijdsinvestering
Stap 3: Google Cloud Console instellen
De MCP-server heeft OAuth 2.0-credentials nodig om namens jou Google Workspace te kunnen aanroepen. Die credentials maak je aan in Google Cloud Console.
Ga naar console.cloud.google.com en log in met je Google Workspace-account. Maak een nieuw project aan via het project-dropdown bovenaan de pagina. Geef het een herkenbare naam, bijvoorbeeld 'workflows-nl-mcp-2026'.
Navigeer naar 'APIs & Services' > 'Library'. Zoek en activeer de volgende APIs een voor een door op 'Enable' te klikken:
Ga vervolgens naar 'APIs & Services' > 'OAuth consent screen'. Kies 'Internal' als je een Google Workspace-organisatie hebt, of 'External' voor persoonlijke accounts. Vul de verplichte velden in (App name, User support email, Developer contact). Klik op 'Save and Continue'.
Voeg de volgende scopes toe op het Scopes-scherm. Dit zijn de minimale rechten die de MCP-server nodig heeft:
Ga nu naar 'Credentials' > 'Create Credentials' > 'OAuth client ID'. Kies als application type 'Desktop app' (dit werkt goed voor lokale MCP-servers). Geef het een naam zoals 'n8n-mcp-client' en klik op 'Create'.
Download het gegenereerde credentials JSON-bestand via de downloadknop. Sla dit op als google-credentials.json in een veilige map. Je hebt dit bestand nodig in de volgende stap.
Stap 4: Installeer de Google Workspace MCP-server
De MCP-server is een Node.js-package die je installeert op dezelfde machine als waar n8n draait. Open een terminal en voer de volgende commando's uit.
Installeer de server globaal via npm:
Zet je credentials JSON-bestand op een vaste locatie. Gebruik een pad zonder spaties:
Voer de server eenmalig uit via de command line om de OAuth-autorisatie te doorlopen. Je wordt doorgestuurd naar een Google-inlogpagina:
Na succesvol inloggen slaat de server een token.json-bestand op in dezelfde map als je credentials. Dit token wordt automatisch vernieuwd en je hoeft dit proces maar eenmalig te doorlopen.
Als de server succesvol draait, zie je output zoals:
Stop de server met Ctrl+C. In de volgende stap stel je n8n in om de server automatisch op te starten als onderdeel van een workflow.
Stap 5: Configureer de MCP-verbinding in n8n
Open je n8n-instantie. Ga naar Settings > Community Nodes en controleer dat je n8n versie 1.45 of hoger hebt. Als je een oudere versie hebt, update dan eerst via npm update n8n -g of via je hostingprovider.
In n8n gebruik je de MCP Client Tool-node om verbinding te maken met een externe MCP-server. Deze node is beschikbaar in de node-library onder 'AI' > 'Tools'. Je hoeft geen extra packages te installeren; de MCP Client is ingebouwd.
Maak een nieuwe workflow aan en voeg de MCP Client Tool-node toe. Configureer de volgende instellingen:
MCP Client Tool configuratie
Vul in het veld 'Connection Type' de waarde 'STDIO' in. Dit is de meest stabiele verbindingsmethode voor lokaal gehoste MCP-servers.
Bij 'Command' vul je het volledige pad naar de server binary in:
Bij 'Arguments' voeg je de volgende JSON-array in:
Bij 'Environment Variables' voeg je de credentials-pad toe:
Vervang /home/jouwgebruiker door je eigen gebruikersnaam. Op een Mac is dit /Users/jounaam, op Ubuntu typisch /home/jounaam. Klik op 'Test Connection' om te verifiëren dat n8n de MCP-server kan starten en de beschikbare tools kan uitlezen.
Stap 6: Koppel de AI Agent node aan je MCP-tools
Nu de MCP-verbinding werkt, koppel je de AI Agent node aan de MCP Client Tool. In n8n werkt dit via het 'Tools' connector-punt van de AI Agent node.
Voeg een 'AI Agent' node toe aan je workflow. Configureer de volgende instellingen:
AI Agent configuratie
Bij 'Chat Model' kies je 'Anthropic' en selecteer je 'claude-sonnet-4-6' als model. Als je de API-sleutel nog niet hebt ingesteld, maak dan een nieuwe Anthropic credential aan via 'Add new credential'.
Bij 'System Message' voer je de instructies in voor de agent. Dit is het systeem-prompt dat bepaalt hoe de agent zich gedraagt en welke tools hij wanneer inzet. Hier een effectief voorbeeld:
Verbind de MCP Client Tool-node met de AI Agent node door een kabel te trekken van het output-punt van de MCP Client naar het 'Tools' input-punt van de AI Agent. Je kunt meerdere MCP-servers verbinden als je dat wilt; elke server voegt zijn eigen tools toe aan de agent.
Stap 7: Test de Gmail-integratie
Voeg een 'Chat Trigger' node toe als startpunt van je workflow. Dit maakt een chat-interface beschikbaar waarmee je de agent direct kunt aanspreken. Verbind de Chat Trigger met de AI Agent node.
Sla de workflow op en activeer hem. Open de chat-interface via de knop 'Open Chat' in de workflow-editor. Typ het volgende testverzoek:
De agent zal de gmail_search-tool aanroepen met een query die overeenkomt met je verzoek. In de n8n execution log kun je de exacte tool-aanroep zien:
Als het goed gaat krijg je binnen enkele seconden een samenvatting van de gevonden e-mails terug. De agent gebruikt de volledige e-mailtekst als context om een inhoudelijke samenvatting te schrijven.
Stap 8: Stel Google Calendar in
Met de calendar_list_events en calendar_create_event tools kan de agent agenda-items lezen en aanmaken. Test dit met het volgende verzoek in de chat:
De agent zal eerst calendar_list_events aanroepen om te controleren of er al iets gepland staat op die dag, en daarna calendar_create_event:
Let op het tijdzone-formaat: gebruik altijd +02:00 voor Nederlandse zomertijd (CEST) of +01:00 voor wintertijd (CET). Als je dit weglaat, gebruikt de API standaard UTC en komen afspraken op de verkeerde tijd te staan.
Stap 9: Koppel Google Drive voor bestandstoegang
De drive_search en drive_read_file tools geven de agent toegang tot bestanden in Google Drive. Dit is met name handig voor het ophalen van contracten, offertes, presentaties of andere bedrijfsdocumenten die relevant zijn voor een gesprek.
Test de Drive-integratie met:
De agent roept drive_search aan met een passende query en daarna drive_read_file voor het gevonden bestand:
Als de bestandstoegang werkt, geeft de agent een inhoudelijke samenvatting van het gevonden document. Bij grote bestanden leest de tool automatisch de eerste secties en geeft aan dat het bestand is afgebroken na een bepaalde tekenslimiet.
Stap 10: Bouw de automatische vergadervoorbereider
Nu alle tools werken, bouwen we een praktisch scenario dat direct waarde levert: een automatische vergadervoorbereider. De agent analyseert je agenda voor de volgende werkdag, zoekt relevante documenten op in Drive en stuurt een samenvatting naar je Gmail.
Voeg een 'Schedule Trigger' node toe aan een nieuwe workflow. Stel hem in op elke werkdag om 07:00:
Voeg een 'AI Agent' node toe met de volgende gedetailleerde system message:
Verbind de Schedule Trigger met de AI Agent, en verbind de AI Agent met de MCP Client Tool. Activeer de workflow en wacht tot 07:00 of test hem handmatig via 'Execute workflow'.
De volledige workflow bestaat uit slechts drie nodes: een Schedule Trigger, een AI Agent en een MCP Client Tool. Zonder MCP had je voor hetzelfde resultaat minimaal 15 tot 20 nodes nodig met aparte Google Calendar, Gmail en Drive credentials per node.
Stap 11: Maak n8n zelf beschikbaar als MCP-server
Een krachtige uitbreiding is n8n niet alleen als MCP-client te gebruiken, maar ook als MCP-server. Hiermee kunnen externe AI-tools zoals Claude.ai Desktop, Cursor of andere n8n-instanties je eigen workflows aanroepen als tools.
In n8n open je Settings > MCP Server. Activeer de MCP-server en kopieer de gegenereerde server-URL en authenticatietoken. De URL heeft het formaat:
Sla de webhook-url op in je Claude Desktop configuratiebestand. Op Mac vind je dit op ~/Library/Application Support/Claude/claude_desktop_config.json:
Na het herstarten van Claude Desktop zijn al je n8n-workflows beschikbaar als tools in Claude.ai. Je kunt via Claude.ai zeggen 'Stuur een vergaderupdaite naar mijn team via n8n' en Claude roept dan de juiste n8n-workflow aan. Dit is de krachtigste manier om je bedrijfsprocessen te verbinden met AI.
Meer informatie over n8n als MCP-server vind je in de officiële documentatie op https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.mcpserver/.
Gerelateerde handleidingen en artikelen
Wil je dieper ingaan op het bouwen van AI-agents in n8n? De handleiding over het bouwen van een WhatsApp chatbot via /handleidingen/whatsapp-chatbot-webshop-n8n-claude laat zien hoe je vergelijkbare agent-patronen toepast voor klantenservice, met Supabase als geheugenlaag en WooCommerce als databron.
Meer weten over MCP als concept en waarom het relevant is voor jouw bedrijf? Lees het kennisbankartikel op /kennisbank/model-context-protocol-mcp-uitleg-mkb-2026. Dat artikel legt uit hoe MCP verschilt van traditionele API-integraties en welke andere MCP-servers al beschikbaar zijn voor populaire bedrijfstools.
Ben je nog aan het oriënteren op welke automatiseringstool het beste bij jouw bedrijf past? De vergelijking op /kennisbank/n8n-vs-make-vergelijking-2026 helpt je kiezen tussen n8n, Make en Zapier op basis van technische mogelijkheden, kosten en leercurve.
Wat gaat er mis en hoe fix je het?
Bij het instellen van MCP-koppelingen komen een aantal problemen regelmatig voor. Hier zijn de meest voorkomende issues met hun oplossingen.
Probleem 1: MCP Client geeft 'ENOENT: npx not found'
Dit betekent dat n8n het npx commando niet kan vinden, omdat het pad van Node.js niet beschikbaar is in de omgevingsvariabelen van het n8n-process. Oplossing: gebruik het volledige pad naar npx. Achterhaal het pad via which npx in de terminal. Op de meeste systemen is dit /usr/local/bin/npx of /home/jounaam/.nvm/versions/node/v20.x.x/bin/npx. Vul dit volledige pad in bij het 'Command' veld van de MCP Client Tool-node.
Probleem 2: OAuth token verloopt of wordt niet vernieuwd
Google OAuth-tokens verlopen na 7 dagen als de applicatie in 'Testing' staat in Google Cloud Console. Oplossing: publiceer de OAuth consent screen naar 'Production' (je kunt dit doen zonder Google-verificatie als je minder dan 100 gebruikers hebt en alleen interne tools bouwt). Ga naar Google Cloud Console > OAuth consent screen > Publishing Status > Publish App. Na publicatie verlopen tokens na 6 maanden en worden ze automatisch vernieuwd zolang de server actief is.
Probleem 3: Agent roept niet de verwachte tool aan
Soms kiest de agent een suboptimale tool of sloeg hij een stap over. Dit is een prompt engineering probleem. Voeg aan je system message toe welke tool in welke situatie gebruikt moet worden. Wees expliciet: 'Gebruik altijd gmail_search voor het zoeken van e-mails. Gebruik nooit drive_search voor e-mails.' Hoe explicieter je de toolkeuze beschrijft, hoe consistenter het gedrag.
Probleem 4: Google Drive geeft 403 Forbidden op bepaalde bestanden
Dit betekent dat het OAuth-account geen toegang heeft tot het bestand. Dit gebeurt vaak bij gedeelde Drive-bestanden van andere organisaties, of bij bestanden die zijn afgeschermd door een Google Workspace-admin. Controleer de Drive-rechten van het betreffende bestand via drive.google.com > Rechten beheren. Als je gedeelde drives wilt doorzoeekn, voeg dan de scope https://www.googleapis.com/auth/drive toe aan je OAuth-consent screen en voer de autorisatieflow opnieuw uit.
Probleem 5: n8n crasht bij lange agent-uitvoeringen
Bij complexe multi-step taken met veel tool-aanroepen kan de agent execution timeout bereiken. De standaard timeout in n8n is 30 seconden voor cloud-instanties. Oplossing: ga naar Settings > Executions en verhoog de timeout naar 300 seconden (5 minuten). Voor zelf-gehoste n8n voeg je EXECUTIONS_TIMEOUT=300000 toe aan je omgevingsvariabelen. Splits bij complexe taken de workflow op in meerdere AI-agents die via sub-workflows worden aangeroepen.
Conclusie: MCP als fundament van je AI-infrastructuur
MCP is in 2026 de meest efficiënte manier om AI-agents te verbinden met bedrijfstools. De standaard is stabiel, breed ondersteund en reduceert de technische complexiteit van AI-integraties aanzienlijk. Wat vroeger tientallen nodes en handmatige OAuth-configuraties kostte, werkt nu met drie nodes.
De Google Workspace-koppeling die je in deze handleiding hebt gebouwd is een fundament. Je kunt dezelfde aanpak toepassen voor honderden andere MCP-servers: er zijn al MCP-servers voor Notion, Slack, GitHub, Jira, Salesforce, Exact Online en tientallen andere bedrijfstools. Elke server voeg je op dezelfde manier toe via een nieuwe MCP Client Tool-node.
De volgende stap is het uitbreiden van je vergadervoorbereider met Slack-notificaties (via de Slack MCP-server) of het automatisch aanmaken van vergadernotities in Notion na afloop van een afspraak. De architectuur die je nu hebt is klaar voor die uitbreidingen.
Heb je deze handleiding gevolgd en je eerste MCP-workflow live? Deel je ervaringen en vragen via de community op workflows.nl. We zijn benieuwd welke Google Workspace-taken jij als eerste hebt geautomatiseerd.
