AI & development 9 min lezen

MCP en Umbraco: hoe het Model Context Protocol je CMS-workflow verandert

Een nieuwe generatie AI-integratie waarbij Claude of Cursor direct met je Umbraco-installatie praat — geen losse scripts, geen plugin-versnippering. Wat is MCP, wat kun je er vandaag al mee in Umbraco, en waar ligt de grens?

Het korte antwoord

MCP — Model Context Protocol — is een open standaard van Anthropic waarmee AI-assistenten zoals Claude rechtstreeks met externe systemen praten. Databases, file systems, API's, en sinds kort ook met je Umbraco-installatie. Geen losse scripts, geen versnipperde plugin-ecosystemen meer. Eén protocol, overal dezelfde stekker.

Voor Umbraco betekent dat concreet: je vraagt Claude een blogartikel aan te maken, en Claude roept de Management API aan via de officiële MCP-server van Umbraco. Het document landt direct in je backoffice — inclusief SEO-meta's, content blocks en relaties — mits je scope en rechten goed staan. Deze blogpost die je nu leest, is op precies die manier gepubliceerd.

Wat is Model Context Protocol precies?

MCP is in november 2024 door Anthropic open-source uitgebracht. De analogie die rond is gaan zingen: USB-C voor AI. Een standaard die de manier waarop AI-modellen met tools en data praten uniformeert, zodat iedere modelprovider en ieder systeem met dezelfde stekker werkt.

De architectuur is overzichtelijk:

  • Host — de AI-applicatie (Claude Desktop, Claude Code, Cursor, VS Code-extensies).
  • Client — de component binnen de host die MCP-verbindingen beheert.
  • Server — een los proces dat tools en resources aanbiedt: maak een document, lees een bestand, query deze database.

Servers draaien lokaal of remote. Credentials blijven op de machine van de gebruiker. Er is geen centrale hub waar data doorheen moet — een belangrijk onderscheid met ChatGPT-plugins of andere gesloten integraties.

Waarom MCP relevant is voor Umbraco

Umbraco heeft sinds versie 14 een moderne Management API — een volledig REST-eindpunt voor alles wat je in de backoffice doet. Die API is krachtig, maar onbereikbaar voor AI zonder maatwerk: voor iedere workflow moest je een custom integratie of script bouwen.

MCP elimineert die tussenstap. Umbraco HQ publiceert een officiële MCP-server (@umbraco-cms/mcp-dev) die de complete Management API vertaalt naar circa 400 tools. Van create-document tot publish-document-with-descendants, van get-media-by-id tot rebuild-indexer.

Praktisch: je laadt de MCP-server één keer in je Claude Code- of Cursor-configuratie, geeft OAuth client credentials op, en vanaf dat moment zeg je tegen je AI:

Maak een blogpost aan onder /blog over headless CMS, met SEO-meta's, drie content blocks, en publish 'm.

En dat gebeurt ook daadwerkelijk.

Wat je er vandaag al mee kunt

Een paar scenario's waar we het zelf voor inzetten in klantprojecten:

1. Content-migraties. Oude WordPress- of Drupal-export in JSON of XML? Claude leest het bestand, mapt velden op je Umbraco document types, maakt de nodes aan — inclusief media-uploads, URL-redirects en taxonomieën. Werk van weken wordt werk van uren. Meer over Umbraco-migraties.

2. Bulk-wijzigingen. "Voeg aan alle dienstenpagina's de FAQ-block toe met deze vijf vragen." Zonder SQL-script, zonder batch-tool. Claude loopt de tree af, doet per node een update-document-properties, rapporteert achteraf. Fouten rollen in een oogopslag boven water.

3. Redactie-assistentie. Redacteuren die niet technisch zijn kunnen via een chat-interface content aanmaken: "Nieuwe case-omschrijving voor klant X, gebaseerd op deze interview-transcriptie." De AI vult de juiste blocks, zet de juiste taxonomieën, en biedt het ter review aan.

4. Testdata genereren. Voor staging-omgevingen: vijftig dummy-blogposts, twintig dummy-producten, met realistische inhoud. Sneller dan Bogus of Faker, en semantisch aanzienlijk beter.

5. Schema-introspectie voor developers. "Welke velden heeft het document type blogPost?" of "welke blocks zijn toegestaan in contentBlocks?" — geen klik-werk meer in de backoffice. Gewoon vragen aan Claude terwijl je aan het coderen bent.

Beperkingen en risico's die echt tellen

Het klinkt als een wondermiddel, maar er zijn harde grenzen. Wie MCP op productie inzet moet ze kennen.

Hallucinaties blijven. AI gokt soms met UUID's of document types die niet bestaan. De officiële MCP-server valideert tegen de API en vangt het meeste op. Maar semantische fouten — verkeerd document type, verkeerde parent, onverwachte culture-variant — kan Claude nog steeds maken. Dry-run en review blijven verplicht.

Rechten bepalen impact. Een MCP-server met admin-credentials kan alles wat een admin kan. Inclusief verwijderen, unpublishen en users aanmaken. Gebruik altijd een editor-client met minimale scope voor AI-workflows. Reserveer admin voor specifieke, bewust aangeroepen acties.

Geen transactionele rollback. MCP kent geen ingebouwde transactie-laag. Als Claude halverwege een bulk-operatie stopt, zit je met een inconsistente staat. Bouw dus altijd eerst een get-document-by-id of search-document stap in om de uitgangssituatie te loggen, zodat je handmatig kunt herstellen.

Protocol-versies evolueren. MCP zelf is jong — sinds eind 2024 — en de tool-schema's veranderen nog. Pin je versies (@umbraco-cms/mcp-dev@17) en test elke bump tegen je eigen content-model.

Hoe je het lokaal opzet

Minimaal nodig:

  1. Een Umbraco 15+ installatie met de Management API bereikbaar.
  2. Een user met Client credentials aangemaakt onder Users → [gebruiker] → Client credentials.
  3. Claude Code, Claude Desktop of Cursor geïnstalleerd.
  4. Een .mcp.json-bestand met de server-config.

Voorbeeld-config voor een editor-scope:

{
  "mcpServers": {
    "umbraco": {
      "command": "npx",
      "args": ["-y", "@umbraco-cms/mcp-dev@17"],
      "env": {
        "UMBRACO_CLIENT_ID": "umbraco-back-office-editor",
        "UMBRACO_CLIENT_SECRET": "<secret>",
        "UMBRACO_BASE_URL": "https://uwsite.nl",
        "UMBRACO_INCLUDE_TOOL_COLLECTIONS": "document,media"
      }
    }
  }
}

Reload je AI-client en de Umbraco-tools verschijnen. Vanaf dat moment stel je vragen in gewone Nederlandse zinnen — de tool-namen hoef je niet te kennen.

Wanneer MCP plus Umbraco echt rendeert

Onze vuistregel na een paar maanden productie-ervaring: MCP betaalt zich terug zodra je méér doet dan één enkele redacteur die één pagina per week aanmaakt.

Bij content-teams, migraties, bulk-wijzigingen en developers die snel moeten introspecteren is de tijdwinst dramatisch. Voor kleine sites met één blog per maand is het meer een gimmick dan een business case.

Wil je dit voor jouw Umbraco-site opzetten?

De Codebrouwerij bouwt Umbraco-sites waarbij AI-integratie via MCP vanaf dag één in de architectuur zit — niet achteraf erop geplakt, maar als onderdeel van de redactie-flow en developer-workflow. We hebben het protocol draaien op onze eigen site (deze blogpost is er via MCP op gekomen), we kennen de valkuilen, en we hebben productie-configuraties voor zowel editor-scopes als admin-scopes.

Heb je een Umbraco-site en wil je weten of MCP een zinvolle investering is voor jouw organisatie? Plan een vrijblijvend gesprek — in een half uur weten we of en hoe het in jouw situatie rendeert.