Naar de inhoud
Mia Automation
NLEN Inloggen Zet Mia aan het werkBeginnen

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.

AutomatiseringsreceptenBijgewerkt op 6 min lezen

Zelf getest op 11 november 2026.

Bewegend schema: een opdracht in gewone taal, Claude Code leest regels en nodes in, bouwt en valideert, test met proefdata, en daarna kijkt een mens na en publiceert.
De taakverdeling in onze test: de agent bouwt en test, een mens publiceert.

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=true en N8N_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

bash
claude mcp add --transport http n8n-mcp https://<je-n8n>/mcp-server/http \
  --header "Authorization: Bearer <je-n8n-mcp-token>"
claude mcp list

De 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.

markdown
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.

WorkflowWat we vroegen
Website-bewakerElke 10 minuten example.com opvragen; bij een andere status dan 200 of geen antwoord een mail.
TerugbelverzoekEen formulier met naam en telefoonnummer; elke inzending als rij in een nieuwe tabel.
Weekteller leadsElke 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.

n8n-uitvoeringen van de door Claude Code gebouwde website-bewaker: vier geslaagde testruns, met de trigger vastgezet op proefdata en de stappen gegroepeerd als Controle en Melding. De workflow staat nog op Publish, dus niet aan. (opent op ware grootte)
De website-bewaker van Claude Code. Rechtsboven staat nog Publish: hij is niet aangezet, zoals gevraagd.
  • 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.

n8n-uitvoering van de door Claude Code gebouwde weekteller: trigger, leads ophalen, tellen en mailen, alle stappen geslaagd. (opent op ware grootte)
Onze eigen run van de weekteller: één mail met het juiste aantal.

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