Näin rakensimme agenttisen kaupan WooCommercelle — koko tekninen toteutus

Verkkokauppa on siirtymässä siitä, että tekoäly löytää kaupan, siihen että tekoäly myös ostaa siitä. Tämä on tekninen läpivalaisu siitä, miten rakensimme ja pilotoimme koko ostopolun WooCommercelle — päästä päähän, oikealla maksulla, EU-sääntelyn mukaisesti. Emme piilottele reseptiä: standardit ovat julkisia, ja arvo on toteutuksessa.

Kolme kerrosta: (1) tuotedata koneluettavaksi, (2) sivuston ostosassistentti in-chat-maksulla, (3) MCP-endpoint, jonka kautta asiakkaan oma tekoäly ostaa. Käydään ne läpi.

1. Perusta: rakenteinen, kontekstuaalinen tuotedata

Tekoäly ei suosittele eikä osta tuotetta, jonka ominaisuuksia se ei löydä rakenteisesta datasta. Minimivaatimus on validi schema.org Product JSON-LD: hinta, saatavuus, brändi, GTIN, arvostelut. Mutta oikea työ on kontekstuaalinen data: sama tuote tarvitsee eri datan eri ostajasegmentille. Yhdessä sadetakissa voi olla satoja datapisteitä (hihansuun kiristystapa, hupun lipan jäykiste, taskujen sisämitat…), joita ei kannata näyttää ihmiselle tuotesivulla mutta jotka jokainen on ratkaiseva jollekin ostajan AI-kyselylle. Louhimme datan olemassa olevista lähteistä ja rakenteistamme sen: ihmiselle siisti sivu, tekoälylle täysi data.

2. Sivuston ostosassistentti + in-chat-maksu

Sivustolle rakennettu chatbot kysyy asiakkaan tarpeen, hakee tuotteet WooCommercen Store API:sta (/wp-json/wc/store/v1, vieraskori ilman autentikointia) ja suosittelee rikastetun datan perusteella. Maksu tapahtuu suoraan keskustelussa:

• Stripe korttimaksuille (PaymentElement, payment_method_types=card, 3DS kun pankki vaatii).
• Paytrail suomalaisille maksutavoille (MobilePay, verkkopankki, Klarna). Payment API on HMAC-allekirjoitettu (checkout-*-headerit + signature); create-payment palauttaa providers[] (21 FI-maksutapaa) ja hrefin.

Tilaus syntyy WooCommerceen vasta kun maksu on hyväksytty.

Sivuston ostosassistentti kysyy tarpeen, suosittelee rikastetun datan perusteella (perustelut mukana) ja ottaa maksun samassa keskustelussa. (Klikkaa suuremmaksi.)

3. Agentti-osto: WooCommerce MCP-server

Tämä on se osa, johon Anthropicin Claude Commerce viittaa mutta jota se ei tehnyt WooCommercelle (esimerkki oli vain Shopifylle, eikä sen checkout tee aitoa agentic-ostoa). Rakensimme kaupalle MCP-serverin (Model Context Protocol) — endpointin, jonka kautta ulkoinen tekoälyagentti (asiakkaan oma ChatGPT/Claude) voi asioida kaupan kanssa ilman selailua.

Serveri tarjoaa työkalut, jotka agentti näkee ja osaa kutsua:

{ "tools": [
  { "name": "search_products", "description": "Hae katalogista tuotteet (hinta, allergeenit, dieetti…)" },
  { "name": "add_to_cart",     "description": "Lisää tuote koriin product_id:llä" },
  { "name": "view_cart",       "description": "Näytä korin sisältö ja summa" },
  { "name": "pay",             "description": "Luo maksu; palauttaa asiakkaalle hyväksyttäväksi (SCA)" },
  { "name": "confirm_order",   "description": "Vahvista tilaus vasta kun ihminen on hyväksynyt maksun" }
] }

Pilotissa ulkoinen Claude-agentti haki tuotteen, kokosi ostoksen, loi maksun — ja ihmisen hyväksynnän jälkeen syntyi aito WooCommerce-tilaus.

Pilotti: ulkoinen Claude-agentti löytää MCP-endpointin, hakee tuotteen ja luo maksun — ihmisen hyväksynnän jälkeen syntyy tilaus #64. (Klikkaa suuremmaksi.)

4. Löytö → transaktio: miten agentti löytää ostopolun

Yleisin väärinkäsitys: "miten agentti muka löytää kaupan MCP-serverin?" Vastaus: et nojaa keskusrekisteriin — mainostat ostoendpointin siinä samassa datassa, jonka agentti jo lukee. Käytämme neljää julkista, standardinmukaista pintaa (ala kutsuu tätä agenttisen kaupan "kolminaisuudeksi"):

a) schema.org BuyAction tuotteen JSON-LD:ssä. Osto-endpoint upotetaan suoraan Offeriin potentialActionina, targetina EntryPoint:

{ "@type": "Offer", "price": "19.00", "priceCurrency": "EUR",
  "potentialAction": { "@type": "BuyAction",
    "target": { "@type": "EntryPoint", "httpMethod": "POST",
                "urlTemplate": "https://kauppa.fi/wp-json/wc/store/v1/cart/add-item" } } }

BuyAction-target upotettuna tuotteen JSON-LD:hen — ostoendpoint elää samassa datassa jonka agentti lukee. (Klikkaa suuremmaksi.)

b) /.well-known/ucp.json — Google/Shopifyn UCP-manifesti kertoo mitä kauppa myy ja mitä toimintoja se tarjoaa.

c) /.well-known/mcp.json — MCP-serverin "server card" (SEP-1649), josta agentti löytää endpointin suoraan domainista.

/.well-known/mcp.json: agentti löytää kaupan MCP-endpointin ja sen työkalut suoraan domainista — ilman keskusrekisteriä. (Klikkaa suuremmaksi.)

d) WebMCP (navigator.modelContext) — Chrome 146:ssa (helmikuu 2026) toimitettu selain-API, jolla sivu rekisteröi kutsuttavat työkalut suoraan sivulla olevalle agentille — ei kuvakaappaus-arvausta DOM:ista.

Näin sama datakerros tekee kaksoistyön: hakee kaupan löydetyksi JA kertoo agentille miten ostaa.

5. EU:n reunaehto: PSD2/SCA

Tässä moni kompastuu. EU:ssa autonomisella agentilla, joka autentikoi omat maksunsa, ei ole selkeää laillista perustaa (PSD2 vahva tunnistautuminen). Siksi toteutuksessamme agentti ei koskaan maksa itse: se luo maksun, ja ihminen hyväksyy sen omalla vahvalla tunnistautumisellaan (MobilePay-pyyhkäisy, pankkitunnistus tai 3DS). Vasta hyväksynnän jälkeen tilaus syntyy. Sama periaate kuin Visan agenttiohjelmassa, joka meni EU:ssa liveksi 2.7.2026 per-transaktio-passkeyllä. MobilePay ja Paytrailin pankkimaksut ovat käytännössä valmis SCA-kerros tähän.

Rehellinen varaus

Nämä ovat 2026 nousevia standardeja. Osa on jo livenä (Chromen WebMCP), osa vielä spec-vaiheessa (MCP-löytö, kesäkuu 2026). ChatGPT löytää tuotteet tänään pääosin syötetystä feedistä, ei crawlaamalla BuyAction-targettiasi. Emme siis lupaa, että ChatGPT ostaa kaupastasi automaattisesti tänään. Väite jonka takana seisomme: teemme kaupasta valmiin nyt — maksimaalisen löydettävän ja standardinmukaisesti ostettavan — niin että se käy kauppaa sillä hetkellä kun agentit toimivat näiden mukaan.

Tämä on se työ, jota teemme kauppiaille. Haluatko nähdä koko ostopolun livenä? Varaa kartoitus tai lue lisää agenttisesta kaupasta ja AI-näkyvyydestä.