document.modelContext. Er is niets te installeren en geen sleutel te bemachtigen: een agent die WebMCP ondersteunt, vindt de tools op de pagina waar hij al is.
Hoe het werkt
De tools werken op het tabblad waar de klant naar kijkt, niet op een kopie ervan.- Reads antwoorden vanuit de eigen state van de pagina — de venue die geladen is, het menu zoals het voor deze klant gefilterd is, de basket zoals die er nu bij ligt. Een agent krijgt nooit te horen dat een item bestelbaar is dat de pagina zou weigeren.
- Writes gaan via dezelfde acties als de eigen knoppen van de pagina, dus een regel die een agent toevoegt gedraagt zich als een die de klant heeft toegevoegd: dezelfde prijzen, dezelfde optievalidatie, dezelfde basket die de klant voor zijn ogen ziet bijwerken.
- Prijzen komen terug als geformatteerde strings in de valuta van de venue, en beschrijvingen zijn ontdaan van markup en ingekort. Resultaten zijn bedoeld om voor te lezen, niet om te renderen.
Tools
De agent kiest een tool op basis van de beschrijving. Elke tool hieronder is geregistreerd op elke ordering-pagina waar WebMCP is ingeschakeld.Venue en menu
Basket
De drie basket-tools zijn de enige writes en zijn ook als writes gemarkeerd — een client die
readOnlyHint respecteert, vraagt de klant om toestemming voordat er een wordt aangeroepen. Betaling, kortingscodes en het openen van checkout worden niet blootgesteld: de klant controleert en betaalt op de pagina.
Items worden bij een write benoemd met het id dat de reads publiceren, met eventuele gekozen opties tussen haakjes — BURGER(CHEESE;BACON:2) — dezelfde grammatica die de basket-prefill-links gebruiken. Een item waarvan de opties meer dan één niveau diep genest zijn, wordt teruggegeven met een link naar de eigen pagina, omdat een keuzeboom die zo diep is baskets oplevert die niemand besteld heeft.
Waar de tools beschikbaar zijn
WebMCP is een voorstel, geen uitgebrachte browser-API. De uitrol hieronder volgt die van Chrome en zal breder worden zodra de API zonder gate wordt uitgebracht.
De pagina opt-in’t ook voor een origin-isolated agent cluster, wat WebMCP vereist. Op een browser zonder WebMCP wordt niets gedownload: feature detection gebeurt eerst, en de tools worden pas opgehaald nadat de pagina interactief is.
De tools uitproberen
1
Schakel WebMCP in in Chrome
Zet
chrome://flags/#enable-webmcp-testing aan, of gebruik een WebMCP-compatibele agent-extensie.2
Open een store op order.storekit.com
Laad de ordering-pagina van een venue en laat die klaar renderen.
3
Bevestig dat de tools geregistreerd zijn
Vraag de agent welke tools de pagina aanbiedt. De zeven hierboven zouden vermeld moeten worden. Als er geen worden vermeld, loop de tabel hierboven door voordat je iets aanneemt: een browser zonder WebMCP, een ander domein dan
order.storekit.com, een kiosk- of in-app-pagina, of een pagina die niet klaar is met laden, registreren allemaal niets, en de tools staan ook uit totdat storekit ze voor het account inschakelt — neem contact op met support.4
Bestel iets
“Wat is hier veganistisch?”, dan “voeg er twee van toe” — de basket in het tabblad vult zich terwijl de agent werkt, en de klant betaalt op de pagina.
Wat er nog niet is
- Checkout. Geen tool opent of voltooit checkout. Betalen blijft een menselijke stap, op de pagina.
- Custom domains. Whitelabel-domeinen krijgen geen tools zolang de origin trial per origin is.
- Catering en Pay at Table. Geen van beide flows wordt blootgesteld; de tools dekken bestellen via Delivery, Pickup en InStore.
- Bestelgeschiedenis. Er is geen tool voor eerdere bestellingen of orderstatus.