n8n-workflows laten bouwen door Claude Code: wat werkt en waar je zelf kijkt
Claude Code kan n8n-workflows voor je bouwen via de ingebouwde MCP-server van n8n. In onze test bouwde hij er drie op basis van één opdracht in gewone taal. Alle drie kwamen in één keer door de validatie, en toen we ze daarna zelf draaiden, deden ze wat ze moesten doen. Wat je zelf blijft nakijken: hoe vaak een workflow draait, of een melding niet blijft herhalen, en welke testgegevens er achterblijven. Hieronder de opzet, de opdracht die je kunt kopiëren en wat we zagen.
Zelf getest op 11 november 2026.
Wat je nodig hebt
- Claude Code met een betaald abonnement of een API-sleutel.
- n8n met de ingebouwde MCP-server aan: bij Settings, Instance-level MCP, of op een zelf gehoste n8n met
N8N_MCP_MANAGED_BY_ENV=trueenN8N_MCP_ACCESS_ENABLED=true. Wij gebruikten n8n 2.47.3. - Een persoonlijk MCP-token uit dezelfde instellingenpagina, tabblad API key. Of je logt in via OAuth.
- De accounts die je workflows nodig hebben, al aangemaakt in n8n. De agent gebruikt ze, maar maakt ze niet zelf.
Claude Code koppelen aan n8n
claude mcp add --transport http n8n-mcp https://<je-n8n>/mcp-server/http \
--header "Authorization: Bearer <je-n8n-mcp-token>"
claude mcp listDe opdracht volgens de documentatie van n8n, gecontroleerd op 11 november 2026.
In onze testopstelling draaide n8n op een andere computer dan Claude Code. Daarom koppelden we de twee via een eigen doorgeefluik in plaats van met deze opdracht. Claude Code zag precies dezelfde 57 tools, maar elke aanroep duurde 10 tot 30 seconden in plaats van een fractie daarvan. De werkwijze van de agent verandert daar niet door, de duur wel.
De opdracht die we gaven
Een goede opdracht zegt hoe de agent moet werken, niet alleen wat hij moet bouwen. De onze laat hem eerst de regels en nodes van n8n lezen, verbiedt het zelf aanmaken van accounts, eist een geslaagde validatie en een testrun, en verbiedt publiceren. Download: opdracht.md.
Je bouwt n8n-workflows via de MCP-server "n8n". Werk zo:
1. Lees eerst get_workflow_best_practices en get_workflow_sdk_reference. Zoek nodes op met search_nodes en get_node_types; gok geen parameters.
2. Gebruik bestaande accounts: zoek ze met list_credentials. Maak zelf geen accounts en zet nergens wachtwoorden of sleutels in.
3. Bouw elke workflow met create_workflow_from_code en controleer hem met validate_workflow. Los fouten op tot de validatie slaagt.
4. Test elke workflow met test_workflow (gebruik prepare_workflow_pin_data voor proefgegevens als dat nodig is) en lees het resultaat.
5. Publiceer niets. Laat elke workflow ongepubliceerd staan; een mens zet hem aan.
6. Geef per workflow: naam, id, of validatie en test slaagden, en wat je niet kon testen.De werkregels uit onze opdracht. Daaronder stonden de drie workflows die we wilden.
| Workflow | Wat we vroegen |
|---|---|
| Website-bewaker | Elke 10 minuten example.com opvragen; bij een andere status dan 200 of geen antwoord een mail. |
| Terugbelverzoek | Een formulier met naam en telefoonnummer; elke inzending als rij in een nieuwe tabel. |
| Weekteller leads | Elke maandag om 8:00 de leads van de afgelopen 7 dagen tellen en het aantal mailen. |
Wat Claude Code deed
In totaal deed Claude Code 34 aanroepen naar n8n. Eerst las hij de SDK-handleiding, vroeg hij vier keer de werkregels van n8n op (voor bewaking had n8n ze nog niet), zocht hij de nodes op en vroeg hij de bestaande accounts en tabellen op. Daarna valideerde hij alle drie de workflows; ze kwamen in één keer door. Hij maakte ze aan en draaide vijf testruns: drie voor de website-bewaker (status 500, status 200 en geen antwoord), één voor het formulier en één voor de weekteller. Alle vijf slaagden.
(opent op ware grootte)- Hij hield zich aan de grenzen. Een bestaande workflow van ons kon hij niet openen, omdat die niet voor MCP was vrijgegeven; n8n meldde dat netjes. Eén keer probeerde hij een opdracht op de server zelf uit te voeren; die werd geweigerd, omdat we hem alleen de n8n-tools hadden gegeven.
- Hij bouwde degelijk. De HTTP-stap gaat door bij een netwerkfout, zodat *geen antwoord* ook een melding oplevert. De weekteller telt alle leads in één stap en stuurt één mail, ook als er veel leads zijn.
- Zijn tests waren deels nagespeeld. Bij zijn testruns zette hij ook de uitkomst van de mailstap vast. Er ging dus geen echte mail weg. Daarom draaiden we zelf nog een keer, met alleen de trigger vastgezet.
- In een Engelse herhaling meldde hij het zelf. Dezelfde opdracht in het Engels kostte 7,5 minuten en 36 aanroepen, met hetzelfde resultaat. Dit keer stond in zijn eindverslag dat er geen echte mail was verstuurd, dat de bewaker elke 10 minuten blijft mailen zolang een site plat ligt, en dat er een testrij was achtergebleven.
Onze eigen controle
Bij onze eigen runs werkte alles echt. De weekteller las de leadtabel, telde 2 nieuwe leads (dat klopte) en stuurde precies één mail met *Weekteller leads: 2 nieuwe leads*. De website-bewaker kreeg status 200 van example.com en bleef stil. Het formulier maakte de tabel *terugbellen* aan en zette onze proefinzending erin.
(opent op ware grootte)Waar je zelf kijkt
- Hoe vaak een workflow draait. Elke 10 minuten is 4.320 uitvoeringen per maand. Op n8n Cloud Starter, met 2.500 per maand, past dat niet. De agent waarschuwde daar niet voor.
- Meldingen die blijven komen. De bewaker mailt bij elke controle zolang de site plat ligt: 6 mails per uur. Onze eigen website-bewaker onthoudt de vorige status en meldt alleen een verandering. Vraag daar in je opdracht om.
- Testgegevens die achterblijven. Claude Code liet een proefregel in de nieuwe tabel staan, met *mag weg* in de naam. Netjes gemarkeerd, maar ruim hem op voor je live gaat.
- Accounts en afzender. Controleer bij elke mailstap welk account en welk afzenderadres hij koos. Hier was dat goed, omdat we de naam in de opdracht meegaven.
- Publiceren doe je zelf. Laat de agent nooit zelf publiceren. Kijk de workflow in de editor na, zet een foutmelder aan en klik dan zelf op Publish.
Via MCP of via de REST-API?
Een coding agent kan n8n ook via de gewone REST-API besturen, met een API-sleutel en curl. Zo bouwden wij eerder op dezelfde dag onze eigen tien sjablonen. Dat werkt, maar de agent moet dan zelf het JSON-formaat van elke node kennen en kan niet valideren of testen zonder eerst iets te draaien. De MCP-server geeft hem juist die stappen: werkregels, nodebeschrijvingen, validatie en testruns met proefdata. Daardoor kwamen de drie workflows hier in één keer goed door de validatie.
Vragen
Kan Claude Code n8n-workflows bouwen?
Ja. Via de ingebouwde MCP-server van n8n kan Claude Code workflows maken, valideren en testen. In onze test bouwde hij er drie die daarna echt werkten.
Hoe koppel je Claude Code aan n8n?
Zet in n8n de instance-level MCP aan, maak een token aan en voeg de server in Claude Code toe met claude mcp add, het adres dat eindigt op /mcp-server/http en een Bearer-header.
Moet ik de workflows van Claude Code nakijken?
Ja. Kijk naar hoe vaak ze draaien, of meldingen zich herhalen, welke accounts ze gebruiken en welke testgegevens achterblijven. Publiceer zelf.
Is de n8n-MCP beter dan de REST-API voor een coding agent?
Voor bouwen wel: de MCP-server biedt werkregels, validatie en testruns. Voor eenvoudige beheertaken, zoals een workflow aan of uit zetten, volstaat de REST-API.
Bronnen
- n8n Docs: Connect to n8n MCP server gecontroleerd op
- n8n Docs: MCP client examples (Claude Code) gecontroleerd op
- n8n Docs: MCP server tools reference gecontroleerd op
- Claude Code Docs: MCP gecontroleerd op
- n8n Docs gecontroleerd op
- n8n: Pricing gecontroleerd op
- Claude Code Docs: Setup (welke abonnementen) gecontroleerd op
Meer over automatiseringsrecepten
- n8n en MCP: je workflows als gereedschap voor een AI-app, en n8n als MCP-clientZo maak je van n8n een MCP-server voor Claude, ChatGPT of je eigen agent, en zo gebruikt n8n zelf een MCP-server. Getest, met sjablonen.
- n8n-workflows en templates voor een klein bedrijf: tien stuks, allemaal getestTien n8n-workflows die we bouwden en testten: offerte-opvolging, betalingsherinnering, aanvraagformulier, mail sorteren en meer. Gratis te downloaden.
- Wat is n8n? Uitleg voor ondernemers, met kosten en drie workflowsn8n uitgelegd voor ondernemers: wat het doet, wat het kost in de cloud of op je eigen server, en drie workflows die we testten en die je kunt importeren.
- Bedrijfsprocessen automatiseren: welk proces eerst, hoe je meet en wat je laat liggenWelk proces je eerst automatiseert, hoe je meet of het werkt en wat je beter niet automatiseert. Met een werkblad en uitkomsten uit onze eigen tests.
Ook handig
- n8n AI: zo bouw je AI-stappen en agents in n8n, met drie geteste voorbeeldenWat AI in n8n doet, met drie workflows die we bouwden en testten: mail samenvatten, mail sorteren en een agent met gereedschap. Met uitkomsten en kosten.
- n8n zelf hosten met Docker: installeren, back-ups maken en veilig bijwerkenn8n op je eigen server met Docker Compose, PostgreSQL en automatische HTTPS. Met een getest back-upscript, de updateroute en wat het per maand kost.
- AI-nieuws deze week: wat er van 2 tot 10 november 2026 veranderde in de tools die je gebruiktAI-nieuws van 2 tot 10 november 2026 voor ondernemers: nieuwe Claude-modellen, updates van Codex, Gemini CLI en n8n, en wat je ermee doet.