
We beginnen met de kernvraag: hoe krijg je toegang tot de Umbraco-context binnen jouw Claude AI assistent? Een gestandaardiseerde manier om te verbinden is via het Model Context Protocol (MCP). Umbraco heeft een paar maanden geleden een eigen MCP-server gelanceerd. Inmiddels zijn er meerdere updates verschenen en is er officiële documentatie beschikbaar.
De AI-tool naar keuze, in dit geval Claude, verbindt met deze server. Die server legt vervolgens de koppeling met het platform, in dit geval Umbraco. Je kunt ook andere AI-tools gebruiken, zoals Codex of Github Copilot. Dat klinkt misschien ingewikkeld, maar in de praktijk valt het mee. Je hoeft weinig te configureren en de MCP-server draait gewoon op de achtergrond.
Het instellen van je ontwikkelomgeving is eenvoudig. Op het moment van schrijven is de MCP-server beschikbaar voor Umbraco 16 en inmiddels ook voor Umbraco 17. Het inschakelen van de MCP-verbinding bestaat uit twee stappen. Je voegt een API-gebruiker toe in Umbraco, via het reguliere tabblad voor gebruikersbeheer. Daarna voer je één opdracht uit om de MCP-server toe te voegen aan je AI-tool.
Het is geen goed idee om direct verbinding te maken met een productieomgeving. Gebruik hiervoor altijd je ontwikkel of staging omgeving. De volledige documentatie voor instellen van je AI-assistent is hier te vinden.
Tijdens het configureren is het belangrijk rekening te houden met het volgende:
Wil je ook logdata en gebruikers kunnen bekijken? Dan kun je dit eenmalige MCP-setup command gebruiken:
claude mcp add umbraco-mcp --env UMBRACO_CLIENT_ID="your-id" --env UMBRACO_CLIENT_SECRET="your-secret" --env UMBRACO_BASE_URL="https://your-domain.com" --env NODE_TLS_REJECT_UNAUTHORIZED="0" --env UMBRACO_INCLUDE_TOOL_COLLECTIONS="document,dictionary,media,document-type,data-type,log-viewer,user,user-data" -- npx @umbraco-cms/mcp-dev@16
Als de connectie staat, kun je de kracht ervan benutten. Een logische eerste stap is het maken van een instructiebestand voor projectrichtlijnen en conventies. Een voorbeeld daarvan vind je hier.
Als alles werkt, wil je natuurlijk weten wat je ermee kunt doen. Een aantal praktische voorbeelden ter inspiratie:
Als concreet voorbeeld voegen we een blogfunctionaliteit toe aan een website. Ik vroeg om een nieuw documenttype met de benodigde velden, zoals een publicatiedatum en een afbeelding, en om een view bestand op de schijf om deze velden op de website te tonen.
Claude start met het zoeken naar de juiste datatypen en velden en vraagt eerst om toestemming. Daarna zoekt hij automatisch een passend pictogram voor in de content editor. Vervolgens wordt de ‘create’ actie uitgevoerd. Het resultaat is een nieuw documenttype binnen Umbraco.
Met deze prompt start Umbraco met het zoeken naar de benodigde datatypen
Nadat de juiste velden zijn gevonden, probeert Claude een relevant icoon te vinden voor het documenttype
Nu de voorbereidingen zijn gedaan, stuurt Claude een ‘create-document-type’ command naar de MCP en het documenttype is aangemaakt
Het eindresultaat in Umbraco
Zoals je ziet biedt het integreren van een op developers gerichte AI-tool in Umbraco veel mogelijkheden. Taken waarvoor je normaal complexe scripts, maatwerkcode of handmatig werk nodig hebt, kun je nu eenvoudig laten uitvoeren door je AI-assistent.
Blijf daarbij wel bewust van wat je deelt. Als je project gevoelige content bevat, kan een deel daarvan naar de AI-service worden verzonden. En zoals altijd geldt: zorg voor goede database back-ups. Deze tools zijn krachtig en zonder voorbereiding kan er snel iets misgaan.
Ben je geïnteresseerd in meer informatie over het volledige Umbraco MCP project, dan kun je de code hier vinden. Dit is niet nodig voor installatie of het draaien van de MCP.