Wat is WebMCP? Uitleg in het Nederlands
WebMCP is een voorgestelde open webstandaard waarmee een website eigen functies, zoals een afspraak plannen of een offerte aanvragen, als tools registreert in de browser. Een AI-agent roept die tools rechtstreeks aan binnen de sessie van de bezoeker, in plaats van knoppen en formulieren na te bootsen. De specificatie is nog een concept, geen afgeronde W3C-standaard.
Door Enrico Clein, oprichter van WebMCP.nl. Elke claim op deze pagina verwijst naar een primaire bron of naar een kennisbankartikel waarin die bron staat.
- AI-agentkiest een tool en vult argumenten in
- Browserdocument.modelContext
- Geregistreerde toolexecute() draait in de pagina
- Backend van je sitebestaande API, sessie en rechten
resultaat gaat terug naar de agent
- Wat
- Een voorgestelde open standaard: je website biedt eigen functies aan als tools, zodat een AI-agent ze direct kan aanroepen.
- Wie
- De Web Machine Learning Community Group, met Microsoft als co-auteur. Nog een concept, geen W3C-standaard.
- Status
- Origin trial in Chrome en Edge; ChatGPT Site Tools ondersteunt een deel. Firefox is neutraal, Safari afwijzend.
- Wat moet ik doen?
- Begin met één controleerbare taak, als progressive enhancement. Doe eerst de gratis scan.
Hoe werkt WebMCP?
Je pagina registreert tools; de agent roept ze aan.Een pagina die WebMCP ondersteunt, registreert een of meer tools op document.modelContext. Elke tool heeft een naam, een feitelijke beschrijving, een inputSchema dat vastlegt welke invoer nodig is, en een execute-functie.
- name
- plan_afspraak
- title
- Afspraak plannen
- invoer
- datum (JJJJ-MM-DD)
tijd (UU:MM) - hint
- consequentialHint
- aanroep
- datum "2026-11-04"
tijd "10:30" - antwoord
- bevestigd, ref AF-2291
De browser voert de tool uit in jouw pagina.Een ondersteunende browser-agent kiest op basis van de vraag van de gebruiker een passende tool en vult de argumenten in volgens het schema. De browser voert daarna de execute-functie uit in de pagina zelf. Die roept doorgaans dezelfde backend aan als je gewone formulier, met de sessie en rechten die de bezoeker al heeft. Het resultaat gaat terug naar de agent, die het aan de gebruiker meldt of een volgende stap zet.
Zonder ondersteuning verandert er niets.De feature-check slaat de registratie over en je site werkt zoals altijd. Daarom bouw je WebMCP als progressive enhancement bovenop je bestaande site.
Voorspelbaarder, niet vanzelf correct.Zonder WebMCP moet een agent je interface afleiden: welk veld is de datum, welke knop verstuurt, wat betekent deze foutmelding? Met WebMCP vertelt je site zelf welke handeling er bestaat, welke invoer die verwacht en wat er terugkomt.
Een tool maakt bestaande bedrijfslogica niet betrouwbaarder. Als een prijsberekening fout is of een endpoint te ruime rechten accepteert, blijft dat probleem bestaan. De browserlaag maakt de functie toegankelijker voor een agent; jouw applicatie blijft verantwoordelijk voor het resultaat.
Wie staat erachter, en hoe ‘af’ is het?
WebMCP is een voorstel van de Web Machine Learning Community Group. Het document heeft de status Draft Community Group Report: geen W3C Standard en geen standards-track Recommendation. Microsoft is co-auteur van het voorstel; Google draait de eerste origin trial in Chrome. Het voorstel, de issues en de wijzigingsgeschiedenis staan openbaar in de repository webmachinelearning/webmcp op GitHub.
Die geschiedenis laat zien dat de API nog beweegt. Op 5 maart 2026 verdwenen provideContext() en clearContext() uit de spec (PR #132). Op 26 maart 2026 kwam AbortSignal als manier om een registratie op te ruimen en verdween unregisterTool() (PR #147). Op 17 september 2026 kwamen de events toolactivated en toolcancel erbij, en de annotatie debugging (PR #245 en #253). Op 20 oktober 2026 werd Samuel Dallstream van Microsoft redacteur van de specificatie (PR #352).
Op 21 juli 2026 verhuisde de API-root naar document.modelContext; navigator.modelContext is sinds Chrome 150 deprecated maar werkt nog tijdens de origin trial. En Chrome markeert JSON-tekst als invoer voor executeTool vanaf versie 155 als verouderd, ten gunste van een JavaScript-object. Tutorials die een van die oude vormen gebruiken, zijn verouderd. Zo controleer je welke API-versie je code gebruikt.
Twee manieren om tools aan te bieden
Chrome documenteert twee routes: een JavaScript-route (de imperatieve API) en een declaratieve route via HTML-formulieren. Ze lossen hetzelfde probleem op, maar verschillen in controle, onderhoud en ondersteuning door agents.
Sinds 8 oktober 2026 staat alleen de JavaScript-route nog in de specificatie. De formulierroute is voorlopig naar een apart voorstel verplaatst, en het Chrome-team wil eerst de JavaScript-API uitbrengen en de formulierroute kort daarna. Lees wat dat voor je formulieren betekent.
De imperatieve API: registerTool()
Met document.modelContext.registerTool() registreer je een tool in JavaScript. Je bepaalt zelf de naam, de beschrijving, het invoerschema en wat execute doet. Doe eerst een feature-check, zodat bezoekers zonder ondersteuning niets merken, en koppel execute aan de bestaande backend-logica van je formulier.
Toon code: registerTool() met feature-checkjavascript · 36 regels
// document.modelContext is de actuele API-root.
const mc = document.modelContext;
if (typeof mc?.registerTool === "function") {
const controller = new AbortController();
await mc.registerTool({
name: "plan_afspraak",
title: "Afspraak plannen",
description: "Plan een afspraak. Retourneert bevestiging en tijdslot.",
inputSchema: {
type: "object",
properties: {
datum: { type: "string", format: "date" },
tijd: { type: "string" }
},
required: ["datum", "tijd"]
},
// Plant echt iets in: een agent kan eerst om akkoord vragen.
annotations: { consequentialHint: true },
async execute({ datum, tijd }, { signal }) {
// Dezelfde backend als het gewone formulier. Breekt de agent
// de aanroep af, dan stopt signal ook dit verzoek.
const res = await fetch("/api/afspraak", {
method: "POST",
body: JSON.stringify({ datum, tijd }),
signal
});
// Elke waarde die naar JSON kan, mag terug.
return await res.json();
}
}, { signal: controller.signal });
// Verdwijnt deze view (bijv. navigatie in een SPA)? Dan:
// controller.abort();
}Drie ontwerpregels maken het verschil. Houd schema's strak, met types, enums en verplichte velden, zodat de agent niets hoeft te raden. Schrijf beschrijvingen feitelijk (wat doet de tool, wat komt terug) en nooit als instructiekanaal richting de agent.
En geef in een single-page-app een AbortSignal mee, zodat je de tool opruimt wanneer de bijbehorende view verdwijnt. Alleen als je aantoonbaar Chrome 149 moet ondersteunen, is een aparte compatibiliteitslaag voor navigator.modelContext zinvol.
Naast de verplichte velden zijn er twee nuttige extra's. Met title geef je een leesbare naam die een browser in zijn eigen interface kan tonen. Met annotations vertel je wat de tool doet: readOnlyHint als hij alleen leest, untrustedContentHint als het resultaat tekst van anderen bevat, consequentialHint bij een actie met echte gevolgen, en debugging voor een tool die alleen voor ontwikkelaars bedoeld is (in Chrome vanaf versie 156). Het zijn hints, geen beveiliging: je backend controleert nog altijd zelf. Het tweede argument van execute bevat een signal. Breekt de agent de aanroep af, dan stop je daarmee je eigen verzoek.
Laten zien dat een agent bezig is
Sinds 17 september 2026 kent de specificatie twee events op document.modelContext. toolactivated volgt zodra een agent een tool op je pagina start, toolcancel als die aanroep wordt afgebroken. Beide geven de naam van de tool mee. Zo kun je bezoekers laten zien dat er een agent aan het werk is. Chrome noemt deze events nog niet in zijn handleiding; controleer dus of je doelbrowser ze al verstuurt. Het bestaande toolchange-event volgt als de lijst met tools verandert.
Toon code: een melding tonen als een agent een tool gebruiktjavascript · 12 regels
const mc = document.modelContext;
const melding = document.getElementById("agent-melding");
mc?.addEventListener("toolactivated", (event) => {
melding.textContent = "Een agent gebruikt nu: " + event.toolName;
melding.hidden = false;
});
mc?.addEventListener("toolcancel", () => {
melding.hidden = true;
});
// Klaar zonder afbreken? Verberg de melding aan het eind van execute.De declaratieve API: je bestaande formulier annoteren
Bij de declaratieve route voeg je attributen toe aan een bestaand HTML-formulier, zoals tooldescription op het formulier en toolparamdescription op de velden. De browser zet die om naar toolmetadata. Dat is aantrekkelijk als je al een goed, gelabeld formulier hebt.
Toon code: een geannoteerd formulierhtml · 10 regels
<form id="offerte"
toolname="vraag_offerte_aan"
tooldescription="Vraag een vrijblijvende offerte aan. Plaatst geen opdracht.">
<label for="dienst">Dienst</label>
<input id="dienst" name="dienst"
toolparamdescription="De gewenste dienst, bijvoorbeeld onderhoud">
<label for="email">E-mail</label>
<input id="email" name="email" type="email">
<button type="submit">Offerte aanvragen</button>
</form>Controleer de exacte attribuutnamen in de Chrome-documentatie over de declaratieve API. Die route staat sinds 8 oktober 2026 niet meer in de specificatie, dus namen en gedrag kunnen nog veranderen. Een open issue gaat bijvoorbeeld over taal en tekstrichting van declaratieve metadata, relevant voor meertalige sites.
De declaratieve route heeft een meetbaar extraatje: bij een door een agent gestarte inzending zet de browser SubmitEvent.agentInvoked. Gebruik dat voor analytics, nooit voor toegang, en tel ‘onbekend’ apart.
Toon code: agentInvoked metenjavascript · 8 regels
const form = document.getElementById("offerte");
form?.addEventListener("submit", (event) => {
const signal = typeof event.agentInvoked === "boolean"
? (event.agentInvoked ? "webmcp" : "not-marked")
: "unknown";
console.info("form-submit-observation", { formId: form.id, signal });
});Welke kies je?
Let vooral op de agent die je wilt bedienen. ChatGPT Site Tools ondersteunt momenteel een subset: JavaScript-tools op de hoofdpagina, zonder declaratieve tools en zonder tools in iframes. Een geannoteerd formulier kan dus binnen de browser-API passen en toch niet door die client worden ontdekt.
Begin daarom imperatief: die route staat in de specificatie, komt in Chrome als eerste uit en werkt in ChatGPT. De declaratieve route blijft interessant voor eenvoudige formulieren en voor het agentInvoked-signaal, in browsers die de declaratieve API ondersteunen. Lees wat ChatGPT precies ondersteunt.
Browserstatus
WebMCP is geen afgeronde standaard, dus ‘ondersteuning’ betekent per partij iets anders. Onderstaande samenvatting komt uit onze browsersupport-matrix, waar elke claim naast zijn primaire bron staat (laatst gecontroleerd 15 oktober 2026).
Chrome 149Origin trial (live)
Sinds begin juni 2026, met een token test je op je echte site. Op 28 september 2026 verlengd tot en met Chrome 162, dat op 2 februari 2027 uitkomt. Geen afgeronde standaard: de API kan nog veranderen.
Edge 152Origin trial (live)
Sinds 27 augustus 2026 (Edge 152 Stable). Registratie via Microsofts origin-trial-portaal; de trial loopt volgens Microsoft tot 30 maart 2027. Een trial met registratie, geen native support. De WebMCP Explorer uit Microsofts blog van 21 september is testgereedschap, geen agent-ondersteuning.
FirefoxNeutraal standpunt
Mozilla nam in zijn standards-positions het standpunt ‘neutral’ in. Geen implementatietoezegging en geen bekend implementatiesignaal.
SafariAfwijzend standpunt
WebKit nam in juni 2026 formeel een afwijzend standards-standpunt in over WebMCP.
ChatGPT Site ToolsOndersteund (live)
Sinds 25 augustus 2026 in de ingebouwde browser van de ChatGPT-desktopapp, wanneer Site Tools beschikbaar zijn voor account en model. Declaratieve tools en tools in iframes worden nog niet ondersteund.
Gemini in ChromeAangekondigd
Google positioneerde de agentrol op I/O 2026 bij Gemini in Chrome. Een brede uitrol waarin Gemini WebMCP-tools van willekeurige sites aanroept, is er volgens de primaire bronnen nog niet.
Voor je planning betekent dit: bouw voor wat vandaag echt kan (Chrome en Edge via de origin trial, ChatGPT Site Tools in de desktopapp) en zorg dat elke andere browser gewoon je normale site ziet. Trialdeelname, browserondersteuning en ondersteuning door een agent zijn drie aparte voorwaarden; test ze afzonderlijk.
WebMCP vs MCP vs llms.txt
- llms.txtWijst informatie aan. Leesvoer, geen loket; een voorstel, geen standaard.
- MCPKoppelt je backend via een server, ook als niemand op je site is.
- WebMCPMaakt je site bedienbaar zolang die openstaat, binnen de sessie en rechten van je bezoeker. Vervangt MCP niet.
Je hebt ze niet automatisch alle drie nodig. Bekijk de volledige vergelijking met tabel en vragen of lees wanneer WebMCP iets toevoegt aan je API.
Veiligheid
Een tool geeft een agent macht over je site, dus begrens die macht. Drie regels dekken het meeste:
- Autoriseer op de serverBij iedere actie. Een bestaande sessie is geen toestemming voor elk dossier, en een door de agent meegegeven account-ID mag nooit de autorisatie bepalen.
- Reken op promptinjectieTekst die een tool teruggeeft kan instructies bevatten. Geef een leestool geen verzendrechten en lever alleen de data die de taak vraagt.
- Stuur alleen wat nodig isUitsluiten, niet maskeren. En schakel WebMCP uit met Permissions-Policy: tools=() waar je het niet gebruikt.
Alle maatregelen, met bronnen: WebMCP beveiligen en gevoelige velden uitsluiten of maskeren.
Aan de slag
Begin klein, met één taak waarvan je de uitkomst eenvoudig kunt controleren, en bouw pas daarna tools met klantgegevens of gevolgen.
- Meet waar je staat.De gratis AI-Ready Websitescan laat zien of je site al tools registreert en hoe de technische basis eromheen ervoor staat.
- Kies de juiste tools.Begin bij het doel van de gebruiker, niet bij je formulieren: van klantdoel naar toetsbare toolset.
- Test lokaal en daarna in de origin trial.Het stappenplan begint met een alleen-lezen demo en scheidt een lokale test van een test met een echte agent.
- Controleer het resultaat, niet alleen de aanroep.Testen vanuit de terminal met agent-browser laat zien waarom een geslaagde uitvoering nog geen correct resultaat is.
- Betrek je webbouwer.Stuur de technische one-pager door: actuele spec-surface, origin trial, valkuilen en voorbeeldcode.
Verdieping: alle WebMCP-artikelen per onderwerp
Per onderwerp dieper, elk artikel met een eigen bronnenlijst en wijzigingsdatum.
Implementeren & ondersteuning
- W3C-polyfill voor WebMCP: wat kun je er nu mee testen?
- Chrome kiest eerst voor JavaScript: de formuliervariant van WebMCP is voorlopig uit de specificatie
- Je ticketwidget heeft WebMCP. Wat kan een agent op jouw website dan echt?
- Je eerste WebMCP-tool testen: van lokale demo naar origin trial
Toolontwerp & betrouwbaarheid
- Je WebMCP-tool navigeert naar de volgende pagina. Krijgt de agent nog een resultaat?
- Stripe Checkout gebruikt WebMCP: je toolset moet meeveranderen
- Welke WebMCP-tools moet je bouwen? Van klantdoel naar toetsbare toolset
- Twaalf apps bruikbaar gemaakt voor agents: zes lessen voor je eigen WebMCP-tools
Testen & meten
- Test op WebArena: met WebMCP-tools slagen meer taken, maar niet elke tool helpt
- WebMCP in Cloudflare Kitesurf: welke klanttaak kun je er echt mee testen?
- WebMCP-tools testen vanuit de terminal met agent-browser
- Wat de Lighthouse-audit voor agentic browsing wel en niet bewijst
Security
- hCaptcha voegt WebMCP-verificatie toe: de agent stopt waar de mens moet overnemen
- WebMCP beveiligen: houd je browser bij en begrens je tools
- Gevoelige velden in WebMCP: maskeren is niet hetzelfde als uitsluiten
- WebMCP-tools gevonden? Controleer wie ze heeft gebouwd
Vergelijken & beslissen
- Cashfree zet WebMCP-tools op zijn betaalpagina. Wat vraag je je eigen betaalprovider?
- Safari is tegen WebMCP, en de W3C wil het breder maken. Wat betekent dat voor je site?
- Poppy: Meta en Sierra laten AI-agents voortaan aanbellen. Waar past WebMCP?
- Verzekeraar Kin laat AI-agents een offerte starten met WebMCP. Wat kun je daarvan leren?
Bronnen (18)
- WebMCP: actuele conceptspecificatie (Web Machine Learning Community Group)
- WebMCP: voorstel, issues en pull requests op GitHub
- Chrome for Developers: WebMCP-overzicht en experimentele toegang
- Chrome for Developers: imperatieve API (registerTool, executeTool)
- Chrome for Developers: declaratieve API en SubmitEvent.agentInvoked
- WebMCP PR #338: declaratieve API voorlopig uit de specificatie, 8 oktober 2026
- Chrome Platform Status: WebMCP-origin trial, verlengd tot en met Chrome 162
- Chrome for Developers: WebMCP tool security
- Chrome for Developers: WebMCP evals
- Chrome: Join the WebMCP origin trial, 9 juni 2026
- Microsoft Edge 152: web platform release notes
- OpenAI: WebMCP in ChatGPT
- WebMCP PR #132: verwijdering provideContext en clearContext, 5 maart 2026
- WebMCP PR #147: AbortSignal en verwijdering unregisterTool, 26 maart 2026
- WebMCP PR #275: uitschakelen met Permissions Policy, 15 september 2026
- WebMCP PR #245: events toolactivated en toolcancel, 17 september 2026
- WebMCP PR #253: annotatie debugging, 17 september 2026
- WebMCP PR #352: Samuel Dallstream (Microsoft) wordt redacteur, 20 oktober 2026
WebMCP gaat over bruikbaar zijn voor agents. Wil je eerst weten of AI-assistenten je überhaupt vinden en citeren, lees dan over AI-vindbaarheid.
Doe de gratis AI-Ready WebsitescanStuur dit naar je webbouwer