Umbraco MCP: zo koppel je Claude in 5 stappen aan je CMS

Wat is een MCP-server, in gewone taal?

MCP staat voor Model Context Protocol: een open standaard, ontwikkeld door Anthropic, waarmee AI-assistenten zoals Claude kunnen samenwerken met andere software. Zie het als een universele stekker. Een MCP-server zet de mogelijkheden van een systeem om in 'tools' die Claude kan gebruiken, zoals "zoek een pagina" of "pas een tekst aan".

De Umbraco MCP-server werkt via de Umbraco Management API, dezelfde API die de backoffice zelf gebruikt. Claude kan daardoor pagina's, media, documenttypes en vertalingen lezen en, als jij dat toestaat, aanpassen. Precies zoals een redacteur dat doet, maar dan op basis van een opdracht in gewone taal.

De koppeling in één beeld: Umbraco geeft via een beveiligde API-gebruiker toegang aan de MCP-server, die je CMS als tools beschikbaar maakt voor Claude.

Wat heb je nodig?

• Een Umbraco-website vanaf versie 14. Vanaf die versie bestaat de Management API waar de MCP-server mee praat. Draai je een oudere versie, dan is een upgrade eerst nodig.
• Een Claude-account. Een gratis account werkt, maar met een betaald abonnement kun je grotere opdrachten uitvoeren.
• De Claude Desktop-app voor Mac of Windows (of Claude Code, als je ontwikkelaar bent).
• Node.js versie 22 of hoger op je computer. Dit is gratis software waarmee de MCP-server draait.
• Beheerdersrechten in Umbraco, om een API-gebruiker aan te maken.

Umbraco MCP: Claude koppelen in 5 stappen

Stap 1: Installeer Claude Desktop en Node.js

Download de Claude Desktop-app via claude.ai en log in. Installeer daarnaast Node.js (versie 22 of hoger) via nodejs.org. Controleer de versie door in je terminal node -v te typen.

Stap 2: Maak een API-gebruiker aan in Umbraco

Ga in de backoffice naar Users, kies Create en dan API User. Geef de gebruiker een naam en e-mailadres en koppel hem aan een gebruikersgroep met alleen de rechten die nodig zijn. Voeg daarna bij de gebruiker client credentials toe: een client-ID (die begint altijd met umbraco-back-office-) en een geheim wachtwoord, het client secret. Bewaar beide goed; je hebt ze in de volgende stap nodig.

Stap 3: Voeg de MCP-server toe aan Claude Desktop

Open in Claude Desktop Settings → Developer → Edit Config. Er opent een configuratiebestand. Voeg daar de Umbraco MCP-server aan toe en vul je eigen gegevens in:

{
  "mcpServers": {
    "umbraco-mcp": {
      "command": "npx",
      "args": ["@umbraco-cms/mcp-dev@lts-17"],
      "env": {
        "UMBRACO_CLIENT_ID": "umbraco-back-office-claude",
        "UMBRACO_CLIENT_SECRET": "jouw-client-secret",
        "UMBRACO_BASE_URL": "https://www.jouwwebsite.nl",
        "UMBRACO_INCLUDE_TOOL_COLLECTIONS": "document,media"
      }
    }
  }
}

Het versielabel achter de pakketnaam moet passen bij jouw Umbraco-versie: lts-17 voor Umbraco 17. Met UMBRACO_INCLUDE_TOOL_COLLECTIONS bepaal je welke onderdelen Claude mag gebruiken; begin klein met content en media.

Stap 4: Herstart Claude en test de koppeling

Sluit Claude Desktop helemaal af en open de app opnieuw. Stel daarna een eenvoudige vraag, zoals: "Geef een overzicht van de laatste tien pagina's in Umbraco." Krijg je een lijst terug, dan werkt de koppeling. Krijg je een foutmelding, controleer dan het logbestand mcp-server-umbraco-mcp.log en je client-ID, secret en URL.

Stap 5: Breid stap voor stap uit

Werkt het lezen goed? Voeg dan pas meer tool-collecties of rechten toe, bijvoorbeeld voor documenttypes of vertalingen. Na elke wijziging herstart je Claude Desktop.

Werk je met Claude Code? Dan voeg je de server toe met één commando: claude mcp add umbraco-mcp, met dezelfde gegevens als --env-waarden. Zie de officiële Umbraco-documentatie voor het volledige commando.

Wat levert het op? Voorbeelden uit de praktijk

We hebben de koppeling getest op onze eigen Umbraco-website. Een paar voorbeelden van wat dat oplevert:

• Contentaudits in minuten. Claude las alle 55 berichten in onze Insights-sectie uit en signaleerde direct dat 61 van de 65 afbeeldingen in de tekst geen alt-tekst hadden en dat een aantal berichten een tijdelijke afbeelding gebruikte.
• Consistente visuals. Op basis van de bestaande blogafbeeldingen stelde Claude een vaste beeldstijl op, waarmee we nieuwe headers in onze huisstijl genereren. De afbeeldingen bij deze blog zijn daar een voorbeeld van.
• Pagina's opbouwen volgens de structuur. Claude leest de opbouw van een bestaand documenttype uit en maakt nieuwe pagina's aan met dezelfde blokken, instellingen en SEO-velden. Deze blog is op die manier aangemaakt.
• Bulkwerk en SEO. Denk aan meta-omschrijvingen controleren, interne links nalopen of vertalingen voorbereiden voor een tweede taal. Dat sluit aan op AI search optimalisatie, waarbij goed gestructureerde content steeds belangrijker wordt.

Waar let je op bij een Umbraco MCP-koppeling?

Geef niet meer rechten dan nodig

De MCP-server kan alles wat de API-gebruiker mag. Begin daarom met leesrechten en breid alleen uit wanneer dat nodig is. Laat publiceren bij voorkeur bij een redacteur.

Test eerst op een testomgeving

Probeer nieuwe werkwijzen eerst uit op een test- of acceptatieomgeving. Zo zie je precies wat er gebeurt voordat het je live website raakt.

Kies de juiste versie

Elke Umbraco-versie heeft een eigen versie van de MCP-server. Past het versielabel niet bij je website, dan mislukt de eerste opdracht al. Controleer dit voordat je de koppeling breed inzet.

Houd een mens in de loop

AI versnelt het werk, maar een redacteur blijft eindverantwoordelijk. Laat Claude concepten klaarzetten en controleer de inhoud voordat je publiceert.

Veelgestelde vragen over Umbraco MCP

Moet ik hier zelf iets voor bouwen?

Nee. De Umbraco MCP-server bestaat al en wordt door Umbraco zelf onderhouden. Je hoeft hem alleen in te stellen: een API-gebruiker aanmaken en de server toevoegen aan Claude.

Werkt de koppeling met mijn Umbraco-versie?

De MCP-server werkt met Umbraco 14 en hoger, omdat hij de Management API gebruikt. Voor elke versie is er een passend versielabel, zoals lts-17 voor Umbraco 17.

Heb ik een betaald Claude-abonnement nodig?

Niet per se. De koppeling werkt ook met een gratis account, maar met een betaald abonnement kan Claude grotere opdrachten aan, zoals een audit van al je pagina's.

Werkt de koppeling alleen met Claude?

Nee. MCP is een open standaard. Umbraco beschrijft ook de koppeling met onder meer Cursor, GitHub Copilot en OpenAI Codex.

Is het veilig om AI toegang te geven tot Umbraco?

Ja, mits je een aparte API-gebruiker met beperkte rechten gebruikt, eerst op een testomgeving werkt en publicatie door een redacteur laat controleren.

Kan Claude zelf pagina's publiceren?

Technisch wel, als de API-gebruiker die rechten heeft. Wij adviseren om Claude concepten te laten maken en het publiceren bij je redactie te houden.

Liever laten inrichten?

Geen tijd of zin om zelf met configuratiebestanden en API-gebruikers aan de slag te gaan? Als Umbraco Gold Partner richten we de koppeling voor je in: met de juiste versie, een veilige rechtenstructuur en werkafspraken voor je redactie, zodat je team direct aan de slag kan. Neem contact op en we denken graag mee.