MCP-server

Overzicht

Creator levert een ingebouwde MCP (Model Context Protocol)-server. Elke MCP-compatibele AI-assistent — Claude op claude.ai, Claude Code, MCP Inspector — kan verbinding maken met je Creator-account en, vanuit een chat, alles doen wat de editor doet:

  • Je werkruimte en organisaties doorbladeren
  • Mappen, cursussen, microlearnings en vraagbanken aanmaken
  • Lessen en alle 46 bricktypen toevoegen, bewerken, verplaatsen en verwijderen, met hun volledige configuratie
  • De themabibliotheek van de organisatie beheren en het thema van elke content kiezen (kleuren, lettertypen, omslag, aangepaste CSS)
  • Exporteren naar SCORM, web of PDF, de vragenbank exporteren (GIFT, Moodle XML of QTI 2.1), deel-links publiceren, momentopnamen beheren, dupliceren en vertalen

Authenticatie gebeurt via OAuth op je SLXD-account: de assistent ziet je wachtwoord nooit en je kunt de toegang op elk moment intrekken. Alles wat de assistent doet, is beperkt tot wat jouw gebruiker kan doen — organisatielidmaatschap en rollen worden bij elke aanroep gehandhaafd.

Verbinden

Het MCP-eindpunt is de connector-URL van je organisatie:

https://<jouw-organisatie>.slxd.app/mcp/creator

Je hoeft hem niet zelf samen te stellen: het SLXD-platform toont hem onder Organisatie > Connectors, naast de connectors van de andere producten in de suite.

claude.ai

  1. Ga naar Instellingen > Connectors > Aangepaste connector toevoegen
  2. Plak de eindpunt-URL
  3. Rond het inloggen af en autoriseer de toegang

Claude Code

claude mcp add --transport http creator https://<jouw-organisatie>.slxd.app/mcp/creator

Bij de eerste aanroep wordt de browser geopend om in te loggen en de toegang te autoriseren.

Clients registreren zichzelf automatisch (dynamische OAuth-clientregistratie) — er is niets te configureren aan de serverzijde.

Hoe de tools werken

De server biedt een samengestelde set tools op het hoogste niveau (werkruimte doorbladeren, content-/lesbeheer, bricks, thema, export, bestandsuploads, content dupliceren) plus drie meta-tools die de volledige catalogus ontsluiten:

browse_workspace dekt drie behoeften: één mapniveau doorbladeren, de hele scope doorzoeken op titel/naam met query, of de volledige mapstructuur in één aanroep in kaart brengen met recursive: true (elke map met zijn parentId). Om content — lessen, bricks en assets — als sjabloon te klonen, gebruik je duplicate_content (hoogste niveau); duplicate_lesson doet hetzelfde voor één les.

Naast het opstellen van content dekt de catalogus ook: volledige prullenbaklevenscyclus voor mappen (restore_folder, delete_folder_permanently) en batchbewerkingen op content (batch_move_contents, batch_trash_contents); content naar een andere ruimte kopiëren, altijd een kopie en nooit een verplaatsing (copy_content_to_tenant); versiebeheer (rename_snapshot, delete_snapshot); zoeken in gelicentieerde stockbibliotheken en een asset onder content importeren (search_stock_images/import_stock_image, search_stock_icons/import_stock_icon); en toegankelijkheidsproblemen controleren en oplossen (zie hieronder). Media die het model zelf genereert, wordt geüpload met request_asset_upload.

Meta-toolDoel
find_toolsDoorzoek de hele catalogus op trefwoord (publiceren, momentopnamen, vertaling, sjablonen, prullenbak…)
tool_schemaHaal het invoerschema van elke catalogustool op
run_toolVoer een catalogustool uit op naam

Voor bricks toont list_brick_types elk type gegroepeerd per categorie (tekst, media, collecties, vragen, games, lesstructuur — structure) met een "wanneer te gebruiken"-hint om het juiste type te kiezen voor een leerdoel, en get_brick_type_schema geeft de exacte opbouwvorm (met een voorbeeld) voor elk type — rich text wordt opgesteld als platte HTML. Inline code (<code>) werkt in elk tekstveld met meerdere regels en codeblokken (<pre><code class="language-…">, de taal blijft behouden) in velden met volledige opmaak (get_brick_type_schema noemt ze onder richText); velden van één regel weigeren beide met een foutmelding die het veld noemt. Wat wordt opgeslagen maar onderweg verandert — een tag, attribuut of stijl die de editor niet kan bewaren, een link in een veld zonder links, samengevoegde alinea's in een veld van één regel — komt terug in het resultaat van add_brick en update_brick onder warnings, per veld, zonder de les opnieuw te hoeven lezen.

De categorie structure bevat het type CONDITIONAL (Voorwaardelijke inhoud): add_brick neemt zijn takken en de blokken daarvan in één aanroep aan, get_lesson geeft de blokken terug die in elke tak genest zijn, en update_brick, move_brick en delete_brick werken op de hele groep. De grammatica van de voorwaarde en de regels (één niveau, nooit in examens of banken) staan in Voorwaardelijke inhoud; het manifest en de berichten van de simulaties die hij leest, in Insluitpakketten en simulaties.

De juiste brick kiezen

Om de assistent te helpen de meest geschikte brick te kiezen, bevat list_brick_types per type "wanneer te gebruiken"-richtlijnen, en de resource creator://guides/brick-selection is een volledige selectiegids (intentie → aanbevolen bricks). Beide worden gegenereerd uit dezelfde bron, zodat ze nooit uit elkaar lopen, en beide werken in elke MCP-client.

Thema's

Thema's staan in de themabibliotheek van de organisatie en elke content gebruikt er één. Meerdere contents kunnen hetzelfde thema delen, dus een thema wijzigen wijzigt alle content die het gebruikt.

ToolWaarvoor
list_themesDe thema's van de bibliotheek bekijken, hoeveel contents elk thema gebruiken en welk het standaardthema is (het thema dat nieuwe content krijgt)
get_themeEen thema lezen via contentId (het thema dat die content gebruikt) of via themeId. Geeft ook de version terug en hoeveel contents het gebruiken
get_theme_schemaZien wat een thema kan bevatten, zonder een thema te lezen: van elk veld het exacte pad, de vorm die het aanneemt (één lengte of tot vier, een kleur als tekst zoals palette:accent in de brickstijlen of als {"paletteId": "accent"} elders, opties, bereiken), de standaardwaarde of het veld waarvan het die overneemt, wat het op het scherm verandert en de bricktypen die het gebruiken. Zonder filters somt het de secties op en wat het thema niet kan veranderen (met het alternatief); filter op section, op brickType (bijv. TIMELINE) of op tekst met search
update_themeEen thema wijzigen via contentId of themeId. Dit geldt voor alle content die het gebruikt, en het antwoord zegt voor hoeveel (affectedContents). Geef je de gelezen version mee en heeft iemand anders het thema intussen gewijzigd, dan wordt er niets opgeslagen en moet je het opnieuw lezen. Wat anders wordt opgeslagen dan het binnenkwam, of met een probleem, komt veld voor veld terug in warnings: een veld dat niet bestaat (met het meest gelijkende), een waarde in een andere vorm (met de vorm die dat veld aanneemt, zoals get_theme_schema die geeft) of buiten het bereik, een waarde die anders wordt opgeslagen, wat het weglaat uit een eigen lettertype (alleen regular, regularItalic, bold en boldItalic, gewichten 400 en 700) en, als de kleuren veranderen, een ‘Tekst op accent’ die het AA-contrast (4,5:1) met het accent niet haalt; zonder eigen waarde gebruikt die tekst de tekstkleur
create_themeEen thema maken: met het standaarduiterlijk, vanuit een voorinstelling, of als kopie van een ander thema of van het thema van een content
set_content_themeHet thema van een content kiezen
apply_theme_presetEen content het uiterlijk van een voorinstelling geven: die krijgt een thema uit de bibliotheek dat gelijk is aan de voorinstelling, dat wordt gemaakt als er geen is
reset_themeEen content weer het standaardthema van de organisatie geven
delete_themeEen thema verwijderen dat geen enkele content gebruikt (ook niet in de prullenbak) en dat niet het standaardthema is

Om het uiterlijk van één content te wijzigen waarvan het thema door andere wordt gedeeld, kopieer je het thema (create_theme met fromContentId), geef je de content de kopie met set_content_theme en bewerk je de kopie. Het thema van een content wisselen verandert niets aan het thema dat niet meer wordt gebruikt: dat blijft in de bibliotheek. import_theme_from_content bestaat niet meer: het thema van een andere content gebruiken is het kiezen met set_content_theme.

Wie in de organisatie content kan bewerken, kan ook de thema's bewerken.

Bestanden uploaden

Content in Creator gebruikt bestanden — afbeeldingen, video, audio, ondertitels, downloadbare bijlagen, aangepaste lettertypen, embedpakketten — en de MCP kan deze uploaden. De binaire data gaat nooit via de MCP (geen base64): de tool genereert een kortlevende presigned upload-URL en de client stuurt het bestand rechtstreeks naar de opslag, buiten de MCP-verbinding om.

De flow voor een brick-asset:

  1. Roep request_asset_upload aan met de doel-contentId, het kind (image | video | audio | subtitle | attachment | font) en het contentType van het bestand (bijv. image/png). Voor een bestand van het thema (logo, afbeelding van de lesheader, iconen, aangepaste woff2-lettertypen) geef je themeId mee in plaats van contentId: het bestand blijft bij het thema en hangt van geen enkele content af; alleen image en font zijn toegestaan. Elk kind heeft een lijst met toegestane MIME-typen, dus een niet-passend type wordt direct geweigerd.
  2. De tool geeft { uploadUrl, path, curlCommand, expiresAt } terug. Upload het bestand — voer het teruggegeven curlCommand uit (vervang <local-file> door het echte pad) of doe een PUT van de bytes naar uploadUrl met het exacte Content-Type. De URL verloopt na 15 minuten.
  3. Plaats het teruggegeven path in het mediaveld van de brick via add_brick/update_brick (imagePath, videoPath, audioPath, filePath, posterPath, subtitlesPath, front*/back*/…), of in het thema via update_theme (logo, aangepaste woff2-lettertypen), met dezelfde themeId. De omslagafbeelding en de cursustitel horen bij elke content afzonderlijk, niet bij het thema: upload de afbeelding met de contentId en stel ze in met update_content (coverImagePath; courseTitle voor de cursustitel); get_content geeft ze terug. Om de omslagafbeelding te vervangen, zet je het nieuwe pad in coverImagePath: de afbeelding verandert en de cursustitel en de kleurlaag blijven zoals ze waren; het vorige bestand wordt niet verwijderd, de opslagopruiming ruimt het op. De kleurlaag over de afbeelding en de plaats en stijlen van de cursustitel blijven in het thema. Ook de afbeelding van de lesheaders hoort bij de content: stel ze in met update_content (lessonHeaderImagePath) en het thema toont ze met lessonHeader.background.type: image; elke les kan een eigen afbeelding hebben met update_lesson (headerImagePath; null neemt weer over), die altijd voorgaat. De kleurlaag blijft in het thema (lessonHeader.image.overlay).

list_content_assets geeft de reeds geüploade bestanden voor een content terug, zodat een bestaande asset kan worden hergebruikt in plaats van opnieuw geüpload.

SVG-afbeeldingen zijn de uitzondering: een SVG is code en wordt dus nooit via een ondertekende URL geüpload (request_asset_upload weigert image/svg+xml). Stuur hem in plaats daarvan met upload_svg_image: de SVG reist mee in de aanroep, als tekst (svg) of base64 (svgBase64), tot 5 MB, met contentId of themeId. De server schoont hem op met dezelfde regels als de editor (scripts, gebeurtenisattributen, externe links en bronnen worden verwijderd) en slaat alleen het resultaat op; het teruggegeven path werkt in elk afbeeldingsveld. Kan hij niet veilig worden gelezen, dan wordt niets opgeslagen en draagt de fout een vaste code: [svg_not_svg], [svg_malformed] of [svg_too_large]. Een SVG wordt altijd als afbeelding getoond, die geen externe lettertypen laadt: als de tekst het lettertype niet insluit (of niet naar paden is omgezet), bevat het resultaat de waarschuwing svg_text_without_font en verschijnt de tekst in het lettertype van het apparaat van de cursist. De beeld- en icoonbanken (import_stock_icon, import_stock_image) schonen SVG's op dezelfde manier op. import_stock_image accepteert alleen een downloadUrl precies zoals search_stock_images die teruggaf, met dezelfde provider, en slaat alleen afbeeldingen op: het type wordt uit de gedownloade bytes gelezen (PNG, JPEG, WebP, GIF, AVIF of een opgeschoonde SVG, tot 30 MB), nooit uit de URL of het Content-Type. Al het andere slaat niets op en faalt met een vaste code: [stock_url_not_allowed], [stock_not_image], [stock_too_large], [stock_blocked_target] (een doorverwijzing naar een adres zonder https of een intern adres) of [stock_too_many_redirects].

Embed-bricks (een zelfstandig index.html-pakket met assets) gebruiken request_embed_upload: upload elk bestand van het pakket onder dezelfde folderId, en stel dan de teruggegeven embedFolderPrefix in op de EMBED-brick. Deze komen terecht in de privé embeds-bucket met hun Content-Type vastgezet en worden aan kijkers geleverd via kortlevende URL's per map — nooit vanaf een openbaar domein. Wil je dat het pakket de brick kan voltooien (en zo zijn blokkering naleeft) of zijn eigen hoogte kan bepalen, upload dan ook een slxd-embed.json in de hoofdmap —bijv. {"protocol":"slxd-embed","version":1,"capabilities":["complete","resize"]}— voordat je de map op de brick zet: die wordt dan gelezen en bewaard in de alleen-lezen eigenschap embedPackage. add_brick en update_brick waarschuwen (warnings) als de blokkering niet kan worden nageleefd. Declareer voor een simulatie ook state, result en interaction, en schrijf simulationId (uniek binnen de inhoud: een dubbele wordt geweigerd), scored en weight in het blok — get_brick_type_schema beschrijft het protocol en de beoordeling; een blok dat is geschreven voordat het pakket de nieuwe mogelijkheden declareerde, moet zijn embedFolderPrefix opnieuw schrijven om het manifest opnieuw te lezen. De slxd-embed.json kan ook de variabelen van de status declareren, met hun type ("variables": {"trust": "number", "reused": "boolean"}), zodat voorwaardelijke inhoud ze kan lezen; grade, score, maxScore, ending en kind zijn gereserveerde namen (ze lezen altijd het resultaat van het pakket) en een pakket dat ze als variabelen declareert, wordt bij het uploaden geweigerd. Het manifest, de berichten en hun grenzen worden uitgelegd in Insluitpakketten en simulaties.

Imports volgen hetzelfde presigned-patroon:

  • Articulate Rise — start_rise_import (upload de .zip) → confirm_rise_import → poll get_rise_import totdat de status completed is om de aangemaakte contentId uit te lezen.

Het importeren van documenten (Document importeren) is bewust niet beschikbaar via MCP: de parseerstap is afhankelijk van extractie aan de browserzijde in de app, waardoor de flow niet headless kan worden voltooid — doe dit in de app.

Alle uploadtools autoriseren de doelcontent of het doelthema (scope + organisatielidmaatschap; bij een thema ook het recht om thema's te bewerken) voordat ze ondertekenen, en de server stelt de opslagsleutel samen — een client levert nooit zelf een ruw pad aan.

Toegankelijkheid

Dezelfde WCAG 2.2-checker die de toegankelijkheidscontrole van de editor aandrijft, is beschikbaar via MCP, zodat een assistent een cursus end-to-end kan controleren en verbeteren:

  1. audit_content_accessibility — aantal fouten/waarschuwingen per les binnen een content. Begin hier voor een overzicht van de hele cursus.
  2. audit_lesson_accessibility — elk probleem in één les: de regel, het WCAG-criterium, de betrokken brick, een reden en herstelinstructies (in de taal van de content), en — indien er een veilige oplossing bestaat — een autofixes-beschrijving.
  3. apply_accessibility_autofix — past een van die beschrijvingen toe (een afbeelding als decoratief markeren, een kopniveau herstellen, een tabelkop inschakelen, …) op de exacte brick/het exacte item. Eén ongedaan-maken-stap; wijzigingen bereiken een open editor in realtime, net als bij update_brick.
  4. generate_accessibility_alt_text — stuurt voor afbeeldingen zonder veilige deterministische oplossing de afbeelding naar het geconfigureerde AI-visiemodel en geeft voorgestelde alt-tekst terug. Dit schrijft niets weg — pas het resultaat toe met apply_accessibility_autofix (kind: "set-property", of "set-item-property"/"set-character-property" voor galerij-/dialoogafbeeldingen). Verbruikt organisatiecredits, net als andere AI-tools.

Een typische flow: roep audit_content_accessibility aan, kies een les met problemen, roep daarop audit_lesson_accessibility aan, pas de deterministische oplossingen toe, genereer en pas alt-tekst toe voor de rest, en voer daarna opnieuw de lesaudit uit om te bevestigen dat alles in orde is.

Instructieontwerp

Een assistent kan een heel instructieontwerp opbouwen en controleren – bijvoorbeeld er een nabouwen op basis van een Excel-bestand dat je geeft. De tools beginnen met design_matrix_. design_matrix_create, design_matrix_get, design_matrix_list, design_matrix_validate en design_matrix_generate_course zijn top-level; de rest bereik je via find_tools en run_tool.

ToolWaarvoor
design_matrix_createEen ontwerp maken: naam, duur, niveau, doelgroep, taal (idioma; standaard die van je account) en structuurpatroon (niet meer te wijzigen na de keuze)
design_matrix_getHet hele ontwerp in één aanroep lezen – gegevens, competenties, leerdoelen, structuurboom en activiteiten – met de id's die je voor elke wijziging nodig hebt
design_matrix_listOntwerpen weergeven, of de prullenbak met inTrash: true
design_matrix_update, design_matrix_delete, design_matrix_restoreDe gegevens bewerken (ook de taal); een ontwerp naar de prullenbak verplaatsen en terugzetten (definitief verwijderen alleen in de app)
design_matrix_competencia_create, _update, _delete, _reorderCompetenties
design_matrix_objetivo_create, _update, _delete, _set_competencias, _reorderLeerdoelen, met hun Bloom-niveau, hun zichtbare code (clave, optioneel) en de competenties die ze dienen
design_matrix_node_create, _rename, _update_horas, _update_objetivo_general, _set_rol, _reorder, _move, _change_level, _subdivide, _deleteDe structuurboom: modules, eenheden, secties en subsecties; _set_rol markeert een sectie als inleiding of samenvatting van haar eenheid
design_matrix_node_link_objetivo, design_matrix_node_unlink_objetivoEen leerdoel koppelen aan een blad van de boom, of de koppeling verwijderen
design_matrix_aa_*, design_matrix_ae_* (create, update, delete, set_objetivos, reorder)De leeractiviteiten (aa, van een eenheid of een sectie) en toetsactiviteiten (ae, van een eenheid) en de leerdoelen die ze dienen
design_matrix_validateDezelfde controles uitvoeren als het Validatie-paneel van de app en elke bevinding als zin lezen, in de taal van het ontwerp of de gevraagde taal (locale) en met de titel van het item waar ze over gaat
design_matrix_exportEen ondertekende downloadlink voor de Excel-werkmap (.xlsx) krijgen, met labels in de taal van het ontwerp of de gevraagde taal (locale); de link verloopt na ongeveer 24 uur
design_matrix_generate_courseDe cursussen aanmaken van een ontwerp dat de validatie doorstaat, in de taal van het ontwerp tenzij je om een andere vraagt (locale). Per ontwerp loopt er maar één generatie tegelijk; stopt er een halverwege, dan gaat een nieuw verzoek met hetzelfde bereik verder waar het ophield, zonder cursussen te verdubbelen. Met leccionActividades en leccionesEvaluacion (true, false of "separadas") kies je, zoals in het dialoogvenster van de app, of de activiteitenlessen worden aangemaakt en waar de quizzen komen
design_matrix_redaccion_statusZien hoe het schrijven van de gegenereerde cursussen door AI vordert en of de generatie nog loopt, zonder credits te gebruiken
design_matrix_review_contextHet materiaal ophalen om de formulering en afstemming te beoordelen met het eigen AI-model van de assistent: dezelfde criteria als de AI-beoordeling van de app, zonder credits te gebruiken
design_matrix_dictamen_submitDe beoordelingen van de assistent registreren als openstaande beoordelingen, met het label „Beoordeling door de agent” in het onderdeel AI-beoordeling van de app; aan het ontwerp verandert niets tot je ze daar accepteert. Zonder credits te gebruiken
design_matrix_dictamen_listDe beoordelingen van een ontwerp opsommen, van de AI van de app of van de assistent, met hun status

Het verwijderen van een ontwerp, knooppunt, competentie, leerdoel of activiteit vereist confirm: true, zoals elke andere destructieve actie. De AI-beoordeling van de app zelf en het schrijven van gegenereerde cursussen door AI zijn niet beschikbaar via MCP – ze kosten credits en hebben de bevestiging op het scherm nodig – doe ze dus in de app; de status van het schrijven zie je met design_matrix_redaccion_status. Je assistent kan de beoordeling in plaats daarvan zelf doen, met zijn eigen AI-model en zonder credits te gebruiken: hij vraagt het materiaal op met design_matrix_review_context en registreert zijn beoordelingen met design_matrix_dictamen_submit. Ze verschijnen in het onderdeel AI-beoordeling met het label „Beoordeling door de agent”, openstaand tot je ze daar accepteert, corrigeert of afwijst.

De tools die een hele set koppelingen vervangen (design_matrix_objetivo_set_competencias, design_matrix_aa_set_objetivos en design_matrix_ae_set_objetivos) accepteren expectedUpdatedAt, de updatedAt van dat item zoals design_matrix_get die teruggaf: heeft iemand het intussen gewijzigd, dan wordt de aanroep geweigerd zonder iets te schrijven en weet de assistent dat hij het opnieuw moet lezen.

De updatedAt van het ontwerp die design_matrix_get en design_matrix_list teruggeven verandert bij elke bewerking van de inhoud —competenties, leerdoelen, structuur, koppelingen, activiteiten of uren—, niet alleen van de gegevens: door ze te vergelijken zie je of er sinds de laatste keer lezen iets is veranderd.

Live samenwerking

Brickwijzigingen die via MCP worden gemaakt, worden samengevoegd via de samenwerkingsserver: als iemand de les geopend heeft in de editor, ziet die persoon de wijzigingen van de assistent in realtime verschijnen, en niemands werk wordt overschreven.

Destructieve acties

Het verwijderen van content, lessen, bricks of thema's, het terugzetten van het standaardthema, het herstellen van momentopnamen en het legen van de prullenbak vereisen allemaal een expliciete confirm: true. Zonder deze bevestiging geeft de tool een voorbeeld van wat er zou gebeuren, zodat de assistent het je eerst kan vragen.

Operationele opmerkingen

  • De OAuth-autorisatieserver maakt deel uit van de app (Better Auth mcp-plugin); tokens leven in de oauth_*-tabellen en verlopen na 1 uur (refresh-tokens: 7 dagen).
  • Het eindpunt heeft een ratelimiet per gebruiker (120 verzoeken/minuut).
  • Wanneer facturering is ingeschakeld, wordt MCP-toegang beheerst door de apiAccess-functie van het abonnement, net als bij API-sleutels.
MCP-server