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
- Ga naar Instellingen > Connectors > Aangepaste connector toevoegen
- Plak de eindpunt-URL
- 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-tool | Doel |
|---|---|
find_tools | Doorzoek de hele catalogus op trefwoord (publiceren, momentopnamen, vertaling, sjablonen, prullenbak…) |
tool_schema | Haal het invoerschema van elke catalogustool op |
run_tool | Voer 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.
| Tool | Waarvoor |
|---|---|
list_themes | De thema's van de bibliotheek bekijken, hoeveel contents elk thema gebruiken en welk het standaardthema is (het thema dat nieuwe content krijgt) |
get_theme | Een 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_schema | Zien 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_theme | Een 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_theme | Een thema maken: met het standaarduiterlijk, vanuit een voorinstelling, of als kopie van een ander thema of van het thema van een content |
set_content_theme | Het thema van een content kiezen |
apply_theme_preset | Een 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_theme | Een content weer het standaardthema van de organisatie geven |
delete_theme | Een 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:
- Roep
request_asset_uploadaan met de doel-contentId, hetkind(image|video|audio|subtitle|attachment|font) en hetcontentTypevan het bestand (bijv.image/png). Voor een bestand van het thema (logo, afbeelding van de lesheader, iconen, aangepastewoff2-lettertypen) geef jethemeIdmee in plaats vancontentId: het bestand blijft bij het thema en hangt van geen enkele content af; alleenimageenfontzijn toegestaan. Elkkindheeft een lijst met toegestane MIME-typen, dus een niet-passend type wordt direct geweigerd. - De tool geeft
{ uploadUrl, path, curlCommand, expiresAt }terug. Upload het bestand — voer het teruggegevencurlCommanduit (vervang<local-file>door het echte pad) of doe eenPUTvan de bytes naaruploadUrlmet het exacteContent-Type. De URL verloopt na 15 minuten. - Plaats het teruggegeven
pathin het mediaveld van de brick viaadd_brick/update_brick(imagePath,videoPath,audioPath,filePath,posterPath,subtitlesPath,front*/back*/…), of in het thema viaupdate_theme(logo, aangepastewoff2-lettertypen), met dezelfdethemeId. De omslagafbeelding en de cursustitel horen bij elke content afzonderlijk, niet bij het thema: upload de afbeelding met decontentIden stel ze in metupdate_content(coverImagePath;courseTitlevoor de cursustitel);get_contentgeeft ze terug. Om de omslagafbeelding te vervangen, zet je het nieuwe pad incoverImagePath: 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 metupdate_content(lessonHeaderImagePath) en het thema toont ze metlessonHeader.background.type: image; elke les kan een eigen afbeelding hebben metupdate_lesson(headerImagePath;nullneemt 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→ pollget_rise_importtotdat de statuscompletedis om de aangemaaktecontentIduit 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:
audit_content_accessibility— aantal fouten/waarschuwingen per les binnen een content. Begin hier voor een overzicht van de hele cursus.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 — eenautofixes-beschrijving.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 bijupdate_brick.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 metapply_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.
| Tool | Waarvoor |
|---|---|
design_matrix_create | Een ontwerp maken: naam, duur, niveau, doelgroep, taal (idioma; standaard die van je account) en structuurpatroon (niet meer te wijzigen na de keuze) |
design_matrix_get | Het 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_list | Ontwerpen weergeven, of de prullenbak met inTrash: true |
design_matrix_update, design_matrix_delete, design_matrix_restore | De 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, _reorder | Competenties |
design_matrix_objetivo_create, _update, _delete, _set_competencias, _reorder | Leerdoelen, 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, _delete | De 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_objetivo | Een 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_validate | Dezelfde 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_export | Een 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_course | De 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_status | Zien hoe het schrijven van de gegenereerde cursussen door AI vordert en of de generatie nog loopt, zonder credits te gebruiken |
design_matrix_review_context | Het 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_submit | De 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_list | De 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 deoauth_*-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.