De leeshulp-code zet Tolkie Leeshulp op je website, voor je bezoekers. Met een API haalt je eigen systeem, zoals je CMS, teksten op bij Tolkie, en jij bepaalt waar je die laat zien. De MCP brengt de leesbaarheidsanalyse van Tolkie naar Microsoft Copilot, voor je medewerkers. Wil je alleen de leeshulp op je website? Dan heb je geen API nodig. Eén regel code is genoeg.
Deze drie begrippen lopen in gesprekken vaak door elkaar. Vraagt je webbouwer om “de API-documentatie van Tolkie”? Dan bedoelt hij meestal de leeshulp-code. Hieronder lees je wat elk begrip betekent en welke documentatie je doorstuurt.
Leeshulp-code | API | MCP | |
Wat is het? | Eén regel code met het token van je website | Een koppeling tussen je eigen systeem en Tolkie | Een koppeling tussen een AI-assistent en Tolkie |
Voor wie? | Bezoekers van je website | Je eigen systemen en je redactie | Medewerkers die met een AI-assistent werken |
Waar zie je het resultaat? | Als knoppen op je website | Waar je het zelf toont, bijvoorbeeld op je website of in een app | In het gesprek met de AI-assistent |
Wie bouwt het in? | Je webbouwer, met de instellingen die Tolkie klaarzet | Je eigen developers of je webbouwer | Je ICT-afdeling, één keer |
Beschikbaar? | Ja | Ja, drie API's. De Tolkie RE API komt eraan. | Nog niet, verwacht in het eerste kwartaal van 2027 |
Wat is de leeshulp-code?
De leeshulp-code is één regel code die je webbouwer op alle pagina's van je website zet. Het is een script met daarin het token van jullie website. Dat script laadt de knoppen van Tolkie Leeshulp, zoals Lees voor, Uitleg woorden, Simpele tekst en Vertalen. Alles gebeurt in de browser van de bezoeker. Aan je CMS of andere systemen verandert niets.
<script id="tolkie-script" type="module" src="https://app.tolkie.nl" crossorigin="anonymous" data-tolkie-token="jouw-token" data-tolkie-state="separateButtons" defer></script>
Je vindt de code van je eigen website in Mijn Tolkie, bij Code/token. Wat de leeshulp doet en hoe hij eruitziet, stel je daarna in Mijn Tolkie in. Daar hoeft je webbouwer niets meer voor te doen.
Wat is een API?
Met een API vraagt je eigen systeem rechtstreeks iets aan Tolkie, zonder knoppen op een website. Je systeem stuurt een tekst naar Tolkie en krijgt een nieuwe tekst terug, zoals een vertaling of een eenvoudige versie. Wat je daarmee doet, bepaal je zelf. Tolkie levert dus de tekst, niet de knoppen of de vormgeving.
Een voorbeeld: Omroep Brabant heeft eigen knoppen in het CMS. Met één klik maakt een redacteur via de API een eenvoudige versie van een nieuwsartikel. Die versie wordt opgeslagen, en lezers openen hem op de website met de knop Hulp bij lezen.
Tolkie heeft nu deze drie API's:
Text Simplification API: herschrijft een volledig artikel of een lange pagina naar eenvoudig Nederlands op taalniveau A2.
Simpele tekst API: maakt van een lange pagina een korte beschrijving met de belangrijkste punten, in eenvoudige taal.
Translation API: vertaalt losse teksten of hele pagina's naar tientallen talen.
Daarnaast komt de Tolkie RE API eraan. RE staat voor Readability Engine. Daarmee meet je de leesbaarheid van een tekst al vóór publicatie, met dezelfde scores als in Tolkie Webmonitoring. Past je wens nergens bij? Dan kan Tolkie een API op maat bouwen.
Wat is de Tolkie MCP?
MCP staat voor Model Context Protocol. Dat is een open standaard waarmee AI-assistenten andere diensten kunnen gebruiken. Met de Tolkie MCP gebruikt Microsoft Copilot de leesbaarheidsanalyse van Tolkie, gewoon in het gesprek. Een medewerker vraagt bijvoorbeeld: “Is deze brief B1?” Copilot antwoordt dan met de analyse van Tolkie en wijst lange zinnen en moeilijke woorden aan.
Je ICT-afdeling koppelt Tolkie één keer. Medewerkers loggen in met hun gewone Microsoft-account via Entra ID, en ICT bepaalt wie toegang krijgt. De MCP kan alleen lezen: hij past niets aan in Tolkie of in jullie systemen.
De Tolkie MCP is gemaakt voor Microsoft Copilot en verwachten we in het eerste kwartaal van 2027. Wil je Tolkie in een andere AI-assistent gebruiken? Neem dan contact op via de contactpagina.
Heb ik een API nodig voor…?
Vaak niet. Dit vragen klanten ons het meest:
Eigen knoppen op mijn website, bijvoorbeeld een vertaalknop in het menu? Nee. Je geeft een eigen knop een speciale class, en de leeshulp-code doet de rest. Lees Kan ik ook eigen knoppen maken die bepaalde functies van Tolkie aanzetten?
De leeshulp bij pdf's? Nee. Je opent de pdf met een link in de pdf-viewer van Tolkie. Lees Tolkie Leeshulp bij pdf-documenten: hoe werkt dat?
De leeshulp bij een nieuwsbrief? Nee. Je maakt een pdf van je nieuwsbrief en zet een link naar de versie met leeshulp bovenaan. Lees Hoe voeg je Tolkie Leeshulp toe aan een nieuwsbrief?
Een eenvoudige versie van nieuwsartikelen in mijn eigen CMS? Ja, daarvoor is de Text Simplification API.
Welke documentatie stuur ik naar mijn webbouwer?
Voor de leeshulp op je website: Wat houdt het toevoegen van Tolkie Leeshulp technisch in? en Hoe voeg ik de code of het token voor Tolkie Leeshulp toe aan mijn website?
Voor een koppeling met een API: het artikel over die API: de Text Simplification API, de Simpele tekst API of de Translation API.
Voor de MCP: die is nog niet beschikbaar. Wil je er nu al meer over weten? Neem dan contact op via de contactpagina.
Twijfel je welke route past? Mail [email protected] en vertel wat je wilt bereiken. Dan zoeken we het samen uit.