Uitleg · bijgewerkt

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 , oprichter van WebMCP.nl. Elke claim op deze pagina verwijst naar een primaire bron of naar een kennisbankartikel waarin die bron staat.

  1. AI-agentkiest een tool en vult argumenten in
  2. Browserdocument.modelContext
  3. Geregistreerde toolexecute() draait in de pagina
  4. Backend van je sitebestaande API, sessie en rechten

resultaat gaat terug naar de agent

De agent bedient geen knoppen, maar roept een functie aan die jouw pagina zelf aanbiedt.
In 30 seconden
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.

Wat je bezoeker ziet
jouwbedrijf.nl/afspraakPlan je afspraakDatum4 november 2026Tijd10:30Afspraak plannen
registerTool()
Wat de agent ziet
tool in document.modelContext
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
Links de pagina zoals je bezoeker die ziet, rechts dezelfde taak als tool. De agent hoeft geen velden te zoeken: hij krijgt een naam, de invoer die nodig is en een antwoord.

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.

Registreert jouw site al tools?De gratis AI-Ready Websitescan laat het zien, samen met de technische basis eromheen.
Doe de gratis scan

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
javascript
// 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
javascript
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
html
<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
javascript
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.

  1. 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.
  2. Kies de juiste tools.Begin bij het doel van de gebruiker, niet bij je formulieren: van klantdoel naar toetsbare toolset.
  3. 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.
  4. 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.
  5. 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

Alle 8 artikelen

Toolontwerp & betrouwbaarheid

Alle 8 artikelen

Testen & meten

Alle 6 artikelen

Security

Meer in de kennisbank

Vergelijken & beslissen

Alle 15 artikelen

Bronnen (18)

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