Implementatie · Nieuws en duiding

W3C-polyfill voor WebMCP: wat kun je er nu mee testen?

In het kort

De polyfill van de W3C voor WebMCP is sinds 3 november als npm-pakket beschikbaar. Ontwikkelaars kunnen er toolregistratie en uitvoering mee testen, maar de polyfill maakt een browseragent niet vanzelf WebMCP-compatibel. Dit is een hulpmiddel om te experimenteren, geen bewijs dat klanten jouw tools al kunnen gebruiken.

De W3C-polyfill is als npm-pakket te installeren. Daarmee kun je onderzoeken of jouw JavaScript-tools zich registreren en uitvoeren via `document.modelContext`. Maar de polyfill werkt aan de websitekant: een browseragent moet de API nog steeds zelf ondersteunen. Een geslaagde polyfilldemo bewijst dus niet dat ChatGPT, Chrome of een andere agent jouw site al kan bedienen.

Van pilotplan naar installeerbaar pakket

Op 27 oktober maakte de W3C bekend dat de WebMCP-polyfill het tweede project is in de proef met haar Open Source Program. Het eerste doel was publicatie als npm-pakket. Dat is gelukt: sinds 3 november staat versie 0.1.0 van `@w3c/webmcp-polyfill` op npm. De W3C wil met de pilot ontwikkelaars laten experimenteren en de code laten meegroeien met de specificatie en de Web Platform Tests.

Dat is een concrete stap voor ontwikkelaars, maar geen besluit dat WebMCP een W3C-standaard wordt. De actuele specificatie is een Draft Community Group Report van 9 november 2026 en zegt expliciet dat WebMCP geen W3C-standaard is en niet op het standaardtraject staat. Volgens de W3C kan de polyfill geleidelijk verdwijnen als WebMCP dat traject wel op gaat en browsers het zelf op dezelfde manier ondersteunen.

Wat kun je er nu mee testen?

Een polyfill bootst een browserinterface na met JavaScript. De project-README laat zien hoe je het pakket installeert en document.modelContext gebruikt om een tool te registreren, op te vragen en uit te voeren. Zo kun je in een lokale of afgeschermde testomgeving controleren of je applicatiecode de bedoelde invoer accepteert, het juiste resultaat teruggeeft en toolregistraties weer opruimt. De pagina moet daarvoor in een veilige context draaien, zoals HTTPS of localhost. Heeft de browser zelf al document.modelContext, zoals Chrome met WebMCP ingeschakeld, dan laat de polyfill die staan. Test de polyfill dus in een browser zonder WebMCP.

De huidige implementatie heeft grenzen. Volgens de project-README zijn declaratieve formulieren en de events toolactivated en toolcancel nog niet geïmplementeerd. Belangrijker: de polyfill levert zelf geen verbinding met een browseragent. Daarvoor moet de browser van die agent de API zelf ondersteunen; welke dat doen, houden we bij op browsersupport. De actuele specificatie beschrijft alleen JavaScript-tools. De formuliervariant is voorlopig uit de specificatie, dus bouw daar nu niet op.

Reken ook op wijzigingen. Zolang de versie met 0 begint, kunnen brekende wijzigingen volgens de README al in een versie als 0.2.0 zitten. Leg de versie daarom vast in je project. En de naam document.modelContext zelf kan nog veranderen: op 6 november kwam een voorstel om hem te vervangen door `window.toolRegistry` en `window.tools`.

ControleWat je daarmee aantoontWat het niet aantoont
Pagina met polyfillJe toolcode kan zich aanmelden en uitvoeren in deze testopstelling.Dat de browser native WebMCP heeft.
Browser met WebMCPDe browser kan de relevante API aanbieden.Dat een agent de tools ook gebruikt.
Agent met jouw websiteDe gekozen agent kan een concrete taak uitvoeren.Dat andere agents of browsers hetzelfde doen.

Zo maak je er een bruikbare pilot van

Kies één afgebakende, laag-risico taak die al werkt op je website, bijvoorbeeld een product zoeken of afspraakbeschikbaarheid opvragen. Gebruik de polyfill in een lokale of testomgeving om registratie, invoercontrole, resultaat en opruimen van de tool te controleren. Test native WebMCP daarnaast apart met een browser en agent die de API daadwerkelijk ondersteunen. Noteer per combinatie welke stap je hebt getest; houd de polyfilltest en de agenttest gescheiden.

Laat de website invoer valideren en de actuele bedrijfsregels toepassen. De README zegt het zelf: je functie moet de invoer controleren, want het schema levert alleen controles in TypeScript op. Een polyfill verandert die verantwoordelijkheden niet en geeft op zichzelf geen beveiligingsgarantie. Laat een aanroep die een bestelling plaatst, geld uitgeeft of een afspraak definitief vastlegt daarom niet ongemerkt doorgaan. Ontwerp menselijke controle in het proces en test ook weigering, verouderde gegevens en mislukte uitvoering.

Wat je nu kunt besluiten

Voor ontwikkelaars is de polyfill een manier om vroeg een afgebakend prototype te bouwen. Voor productowners is de nuttigste uitkomst geen demo, maar een besluit: welke klanttaak wordt door een expliciete tool begrijpelijker of beter testbaar, en welke browser-agentcombinatie moet je daarvoor aantoonbaar ondersteunen? Houd de pakkettest en de agenttest apart. Wacht met brede uitrol totdat die combinatie een echte taak betrouwbaar uitvoert.

Bronnen

Deel dit artikelLinkedInX
Volgende stap

Meer context bij dit onderwerp: Wat is WebMCP? De complete uitleg. Benieuwd hoe jouw site ervoor staat? Doe de gratis AI-Ready Websitescan.