CTXR handleiding

Deze handleiding laat zien hoe je werkt in de beheeromgeving van je eigen CTXR-site: inloggen, een key aanmaken, content aanpassen en veilig publiceren. Je beheert je site op twee manieren, die precies dezelfde rechten en dezelfde regels delen: zelf in de browser via /edit, of via je eigen AI-agent.

1. Inloggen met je e-mailadres en een authenticator

Je site draait op jouwnaam.ctxr.app. De beheeromgeving vind je op jouwnaam.ctxr.app/edit. Er is geen wachtwoord: je logt in met je e-mailadres en een code uit een authenticator-app (2FA).

1. Open jouwnaam.ctxr.app/edit en vul het e-mailadres in waarmee je je hebt aangemeld. Kies Next.
2. De eerste keer krijg je een zescijferige code per e-mail. Die is tien minuten geldig en werkt één keer. Vul de code in.
3. Je zit nu in een sessie waarin je alleen kunt lezen. Kies Set up 2FA, scan de QR-code met een authenticator-app (bijvoorbeeld Google Authenticator) en vul de eerste code uit die app in.
4. Zodra die eerste code klopt, krijg je in dezelfde sessie al je eigen rechten: aanpassen, publiceren en je instellingen beheren.

Volgende keer log je in met alleen je e-mailadres en de code uit je authenticator. Er wordt dan geen e-mail meer gestuurd. Een sessie duurt maximaal acht uur en eindigt als je het tabblad sluit of uitlogt.

Als het niet lukt

• Na vijf foute authenticatorcodes moet je even wachten (een minuut, bij herhaling langer). In die tijd krijg je een code per e-mail; als die klopt, wordt de wachttijd opgeheven.
• Nieuwe telefoon of authenticator kwijt? Reset je authenticator bij je eigen gegevens in Actors. De eerstvolgende keer log je weer in met een code per e-mail en stel je een nieuwe authenticator in.
• Elke code per e-mail werkt maar tien minuten en één keer. Een nieuwe code aanvragen kan maximaal één keer per minuut.

2. Een key aanmaken bij Actors

Een actor is iemand (of iets) met rechten op je site. Jij bent de eerste actor en hebt als eigenaar alle rechten. Een key is een lange geheime sleutel die bij een actor hoort. Eén key doet twee dingen tegelijk:

• Inloggen zonder 2FA. Op het inlogscherm kies je Open with a key instead en plak je de key. Er wordt dan geen authenticator gevraagd; je hebt de rechten van je actor.
• Agentic werken. Dezelfde key gebruikt je AI-agent om te verbinden met je site via MCP, op jouwnaam.ctxr.app/mcp. Je agent kan dan lezen en in drafts schrijven met precies de rechten die je actor heeft.

1. Log in met e-mail en authenticator (stap 1). Een sessie die alleen met een e-mailcode is geopend kan nog geen keys maken.
2. Open Actors in de menubalk en kies je eigen actor.
3. Maak een key aan en geef hem een duidelijk label, bijvoorbeeld claude.
4. Kopieer de key meteen. Hij wordt maar één keer getoond; ben je hem kwijt, dan maak je een nieuwe.

Goed om te weten

• Behandel een key als een wachtwoord: bewaar hem in een wachtwoordmanager en deel hem nooit in chat of mail.
• Je kunt maximaal vijf keys per actor hebben. Maak je een key met hetzelfde label opnieuw aan, dan vervangt die de oude: de oude werkt direct niet meer.
• Vermoed je dat een key is gelekt? Vervang hem meteen of verwijder hem bij Actors.
• Wil je dat een medewerker of een AI-agent minder mag dan jij? Maak een aparte actor met alleen de rechten die nodig zijn (zie hoofdstuk 5).

3. Rondleiding door de editor

Bovenin staat een menubalk. Dit zijn de onderdelen:

• Add page: een nieuwe pagina of nieuw item maken. Je kiest een type en vult de velden in, in alle talen van je site.
• Look at pages: alle pagina's van je site. Open een pagina om de velden aan te passen en naast de pagina te zien hoe de site eruitziet, op desktop, tablet of telefoon.
• View all media: alle afbeeldingen, video's en documenten. Sleep bestanden erin om ze toe te voegen; ze komen eerst als draft binnen. Je ziet ook waar een bestand wordt gebruikt.
• See your lists: handmatig samengestelde lijsten, zoals uitgelichte items. Je geeft de lijst een naam, kiest welke items erin staan en bepaalt de volgorde.
• Types: de soorten inhoud op je site en wat elk type bevat.
• Browse files: alle bestanden achter je site, in vier mappen: data (de inhoud, één bestand per ding), theme (het ontwerp, voorzichtig mee), assets (afbeeldingen, media, documenten, lettertypen) en guide (de eigen regels voor agenten).
• Organisation: de gegevens van je organisatie.
• Actors: wie er toegang heeft en wat diegene mag.
• Check usage: wat je plan toestaat en hoeveel je gebruikt: opslag, aantal items en aantal actors.
• Go to… (⌘K): snel naar een pagina of onderdeel springen door te typen.
• Documentation: uitleg over hoe alles werkt, inclusief hoe je je eigen AI-agent koppelt.

4. Werken met drafts: wijzigen, bekijken, publiceren

Niets wat je aanpast staat meteen live. Elke wijziging begint als draft.

1. Wijzigen. Pas een pagina, tekst of bestand aan en sla op. De wijziging wordt als draft bewaard; bezoekers zien niets.
2. Bekijken. Controleer het resultaat in de preview van je eigen site.
3. Publiceren. Klopt het, dan publiceer je. Het systeem controleert eerst of alles in orde is; pas daarna gaat de wijziging live. Je kunt één wijziging publiceren of een hele ronde tegelijk.

Iets liever toch niet? Verwerp de draft, of haal een gepubliceerd bestand terug naar draft. Zo kun je rustig werken zonder dat je bezoekers iets zien.

5. Rechten

Rechten staan per onderdeel in drie niveaus: read (lezen), write (wijzigen in draft) en delete (draft verwerpen). Voor deze onderdelen kun je ze instellen: data, theme, assets, guide, live (publiceren en terughalen), actors, plan, journal en inbox (formulierinzendingen).

• Je geeft nooit meer rechten door dan je zelf hebt.
• Geef read ruim, write naar rol en delete bij voorkeur nooit standaard.
• Een redacteur die teksten schrijft maar niet publiceert, heeft bijvoorbeeld data lezen en schrijven en assets lezen. Alleen wie live mag schrijven kan publiceren.

6. Back-ups en journal

• Back-up. Je site wordt elk kwartier automatisch in een privé-omgeving bewaard.
• Terugzetten. Bij een ernstige misser kan een eerdere versie worden teruggezet, tot de start van je site.
• Journal. Elke wijziging wordt vastgelegd: wie, wat en wanneer.

7. Je eigen AI-agent

Je kunt je site ook beheren in gewone taal, met een AI-agent die MCP spreekt (zoals Claude). De agent leest en schrijft direct aan de pagina's en gegevens, werkt in drafts en laat jou bekijken en publiceren. Gebruik daarvoor de key uit hoofdstuk 2. Hoe je koppelt, staat onder Documentation in de editor.

Sandbox

De gratis Sandbox is bedoeld om te leren en te proberen en mag niet voor commerciële doeleinden worden gebruikt. Bij Check usage zie je hoeveel ruimte en items je plan toestaat. Wil je meer, dan kun je later overstappen op een betaald plan.

Vragen of loop je vast? Mail naar service@ctxr.app.