AI-agenttirajapinta (MCP)

AI-agenttirajapinta — Model Context Protocol

Rakentaja Outlet tarjoaa Model Context Protocol (MCP) -rajapinnan AI-agenteille kuten Claude Desktop, Cursor ja ChatGPT MCP -tuki. Rajapinta noudattaa Shopify Storefront MCP:n nimeämiskäytäntöjä, joten agentit ymmärtävät työkalut ilman uutta oppimista. Endpoint https://rakentajaoutlet.fi/mcp lisätään manuaalisesti MCP-clientin asetuksiin (ks. Palvelun löydettävyys -osio alempana).

Julkiset endpointit

• MCP-endpoint: https://rakentajaoutlet.fi/mcp (JSON-RPC 2.0, Streamable HTTP stateless)
• Manifest: https://rakentajaoutlet.fi/.well-known/mcp.json
• Virallinen MCP Registry: fi.rakentajaoutlet/rakentaja-outlet — registry.modelcontextprotocol.io (status active, v1.1.0)

Kytkeytyminen Claude Desktopiin

Lisää Claude Desktopin claude_desktop_config.json -tiedostoon:

{
  "mcpServers": {
    "rakentaja-outlet": {
      "url": "https://rakentajaoutlet.fi/mcp"
    }
  }
}

Tarjolla olevat työkalut (4 kpl, kaikki read-only)

1. search_catalog

Hae ~4000 tuotetta nimen, SKU:n, EAN-koodin tai kategorian mukaan. Suodattimet: kategoria, saatavuus, järjestys (nimi/hinta nousevasti/laskevasti/uusimmat). Kategorialista: /api/categories.

2. get_product_details

Yksittäisen tuotteen täydet tiedot: kuvaus, hinta (sis. 25,5 % ALV), kuvat, saatavuus (reaaliaikainen).

3. create_cart_link

Luo esitäytetyn ostoskorilinkin (esim. ?items=9437:2,4927:1). Tärkeää: linkki ei mutatoi tilaa — ostoskori syntyy vasta kun käyttäjä avaa linkin selaimessa ja hyväksyy sisällön näkyvästi. Rajoitukset: max 20 tuoteriviä, max 50 kpl/rivi.

4. search_shop_policies_and_faqs

Hae kauppaehdot, palautus, toimitus, maksutavat, tietosuoja, yritystiedot. 8 sivun kokonaisuus (mukana AI-ohje tämä sivu) + FAQ Q&A -parit.

Palvelun löydettävyys

Kun endpoint-URL https://rakentajaoutlet.fi/mcp on lisätty MCP-clientiin (Claude Desktop, ChatGPT Developer Mode, Cursor, jne.), client löytää tarjolla olevat työkalut automaattisesti tools/list-kutsulla. Shopify-yhteensopivat työkalunimet (search_catalog, get_product_details jne.) helpottavat agenttien ymmärrystä työkaluista, mutta eivät itsessään auta MCP-clientia löytämään endpointtia — URL täytyy antaa käyttäjän tai integraation toimesta.

AI-agentit ja LLM:t voivat kuitenkin löytää palvelun automaattisesti näistä discovery-signaaleista:

• llms.txt — kertoo MCP-endpointin, työkalut ja tämän ohjeen
• /.well-known/mcp.json — MCP-manifest (Anthropicin vakiintumassa oleva discovery-polku)
• /.well-known/mcp/server-card.json — vaihtoehtoinen alias (SEP-2127 -tyyppinen)

Turvallisuusperiaatteet

• Read-only: rajapinta ei muokkaa kaupan tilaa käyttäjän puolesta. Kaikki tilamuutokset (ostoskori, tilaus) tapahtuvat selaimessa käyttäjän hyväksyminä.
• Rate-limit: 30 pyyntöä/minuutti per IP
• Tietosuoja: hakusanat lokitetaan IP-osoitteen /24-anonymisoituna, retentio 90 päivää. Ei profilointia. Lisätiedot tietosuojaselosteessa.

Suunnitteilla

• get_cart (V1.2+): ostoskorin lukeminen cart_token:illa (stateless MCP:llä ei ole identiteettiä anonyymin sessiokorin lukemiseen — vaatii cart_token-arkkitehtuurin)
• OAuth 2.1 + update_cart (V2): käyttäjän valtuutus mutatoiviin operaatioihin
• list_categories-työkalu: helpottaa agentteja löytämään category_id:t
• MySQL FULLTEXT-indeksi + typo-tolerantti fuzzy-haku: parempi hakulaatu monimutkaisiin kyselyihin

Palaute ja bug-raportit

Osoitteeseen info@rakentajaoutlet.fi. Tekninen ylläpito: Miamo Intelligence Oy.