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

MCP begrijpen en uitleggen aan collega's of klanten
Een Google Workspace MCP-server configureren in n8n
Een AI Agent node koppelen aan MCP-tools zonder losse HTTP nodes
Gmail, Google Calendar en Google Drive aansturen via Claude
Een praktisch MKB-scenario (vergadervoorbereiding) volledig automatiseren
Veiligheid en toegangscontrole instellen via OAuth scopes

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

n8n versie 1.45 of hoger (MCP Client Tool is beschikbaar vanaf deze versie). Controleer via Help > About in de n8n interface.
Node.js 20 of hoger op de server of computer waarop n8n draait (nodig voor de MCP-server package)
Google Workspace account (Business Starter, Standard, Plus of Enterprise) of een gewoon Google-account voor testing
Google Cloud Console toegang om een OAuth 2.0 app te registreren (gratis)
Anthropic API-sleutel via console.anthropic.com voor het aanroepen van Claude Sonnet 4.6
n8n.cloud account of zelf-gehoste n8n instantie met toegang tot de shell (voor npm installatie)

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 Automatische rapportage met n8n en Google Sheets.

Geschatte tijdsinvestering

Google Cloud Console setup: 15 tot 20 minuten
MCP server installeren en configureren: 10 minuten
n8n workflow bouwen: 20 tot 30 minuten
Testen en fijnstellen: 15 minuten

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:

Gmail API
Google Calendar API
Google Drive API
Google Docs API (optioneel, voor het lezen van Docs-bestanden)

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:

https://www.googleapis.com/auth/gmail.readonly
https://www.googleapis.com/auth/gmail.send
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive.file

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:

npm install -g @modelcontextprotocol/server-google-workspace

Zet je credentials JSON-bestand op een vaste locatie. Gebruik een pad zonder spaties:

mkdir -p ~/.mcp/google
cp ~/Downloads/google-credentials.json ~/.mcp/google/credentials.json

Voer de server eenmalig uit via de command line om de OAuth-autorisatie te doorlopen. Je wordt doorgestuurd naar een Google-inlogpagina:

GOOGLE_CREDENTIALS_PATH=~/.mcp/google/credentials.json \
  npx @modelcontextprotocol/server-google-workspace

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:

{
  "name": "google-workspace",
  "version": "1.3.2",
  "tools": [
    "gmail_search",
    "gmail_send",
    "calendar_list_events",
    "calendar_create_event",
    "drive_search",
    "drive_read_file"
  ]
}

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:

npx

Bij 'Arguments' voeg je de volgende JSON-array in:

[
  "-y",
  "@modelcontextprotocol/server-google-workspace"
]

Bij 'Environment Variables' voeg je de credentials-pad toe:

{
  "GOOGLE_CREDENTIALS_PATH": "/home/jouwgebruiker/.mcp/google/credentials.json",
  "GOOGLE_TOKEN_PATH": "/home/jouwgebruiker/.mcp/google/token.json"
}

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:

Je bent een efficiënte werkassistent voor een Nederlands MKB-bedrijf. Je hebt toegang tot Gmail, Google Calendar en Google Drive via MCP-tools. Gebruik altijd de juiste tool voor de taak en geef beknopte, actiegerichte antwoorden in het Nederlands. Bij het versturen van e-mails: bevestig altijd het onderwerp en de ontvanger voordat je verstuurt. Bij het aanmaken van agenda-afspraken: vermeld datum, tijd, duur en deelnemers. Als je informatie niet kunt vinden, zeg dat dan expliciet in plaats van te gokken.

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:

Zoek in mijn Gmail naar de laatste 3 e-mails van klanten over offertes. Geef me een korte samenvatting van elk bericht.

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:

{
  "tool": "gmail_search",
  "parameters": {
    "query": "subject:offerte",
    "maxResults": 3,
    "includeBody": true
  }
}

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:

Plan een kennismakingsgesprek met Jan Pietersen voor aanstaande donderdag om 14:00. Duur: 45 minuten. Stuur een uitnodiging naar jan.pietersen@voorbeeldbedrijf.nl.

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:

{
  "tool": "calendar_create_event",
  "parameters": {
    "summary": "Kennismakingsgesprek Jan Pietersen",
    "startDateTime": "2026-04-02T14:00:00+02:00",
    "endDateTime": "2026-04-02T14:45:00+02:00",
    "attendees": ["jan.pietersen@voorbeeldbedrijf.nl"],
    "description": "Kennismakingsgesprek ingepland via AI-assistent"
  }
}

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:

Zoek in mijn Google Drive naar het meest recente offertesjabloon en geef me een samenvatting van de inhoud.

De agent roept drive_search aan met een passende query en daarna drive_read_file voor het gevonden bestand:

{
  "tool": "drive_search",
  "parameters": {
    "query": "name contains 'offerte' and mimeType contains 'document'",
    "orderBy": "modifiedTime desc",
    "pageSize": 5
  }
}

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:

0 7 * * 1-5

Voeg een 'AI Agent' node toe met de volgende gedetailleerde system message:

Je bent een vergadervoorbereider voor een Nederlands MKB-bedrijf. Elke ochtend voer je de volgende taken uit:

1. Haal alle afspraken op voor vandaag via calendar_list_events
2. Voor elke afspraak: zoek in Google Drive naar relevante documenten    (gebruik de namen van de deelnemers en het onderwerp als zoektermen)
3. Zoek in Gmail naar recente e-mails van de deelnemers (maximaal 5 per persoon)
4. Stel een beknopte briefing samen per afspraak:
   - Wat is het doel van dit gesprek?
   - Wat is de meest recente communicatie met deze persoon?
   - Welke relevante documenten zijn beschikbaar?
   - Wat zijn mogelijke gespreksonderwerpen?
5. Stuur de volledige briefing als e-mail naar mij (gebruik het e-mailadres    van de agenda-eigenaar)

Schrijf alles in het Nederlands. Houd het beknopt en actionable.

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:

https://jouwinstantie.n8n.cloud/mcp/v1

Sla de webhook-url op in je Claude Desktop configuratiebestand. Op Mac vind je dit op ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "n8n-workflows": {
      "url": "https://jouwinstantie.n8n.cloud/mcp/v1",
      "headers": {
        "Authorization": "Bearer jouw-n8n-mcp-token"
      }
    }
  }
}

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 WhatsApp chatbot bouwen voor je webshop 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 Model Context Protocol (MCP) uitgelegd. 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 n8n vs Make.com 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.

MCP instellen in n8n: verbind Claude met Google Workspace

✅ Wat je leert in deze handleiding