Shopify MCP: kysy kauppasi dataa Claudelta ja muista tekoälysovelluksista

Shopify MCP -palvelin yhdistää kauppasi datan tekoälyavustajaan Model Context Protocolin (MCP) kautta. Esität kysymyksen tavallisella kielellä, esimerkiksi ”Mikä kampanja tuotti eniten voittoa viime kuussa?”, ja avustaja vastaa kauppasi oikeiden lukujen perusteella eikä muistinvaraisesti. ROASaurus ylläpitää MCP-palvelinta, jossa on 24 vain luku -analytiikkatyökalua, ja samat työkalut ovat Ask AI:n takana kojelaudassa.

Tämä opas selittää, mitä MCP on, miksi analytiikkakysymysten esittäminen tällä tavalla auttaa, miten Ask AI ja MCP-palvelin toimivat, miten asiakasohjelma yhdistetään, mitkä kysymykset toimivat hyvin sekä mitä tietosuojasta, tietoturvasta ja rajoituksista kannattaa tietää.

Mikä on MCP?

MCP on avoimen lähdekoodin standardi tekoälysovellusten yhdistämiseen ulkoisiin järjestelmiin. Tekoälysovellus, kuten Claude, on asiakasohjelma. Palvelu, joka tarjoaa dataa tai toimintoja, on palvelin. Palvelin kuvaa työkalunsa: jokaisella työkalulla on nimi, kuvaus ja skeema syötteilleen.

Kun esität kysymyksen, asiakasohjelma kysyy palvelimelta, mitä työkaluja on olemassa (tools/list). Malli valitsee sopivan työkalun ja asiakasohjelma kutsuu sitä (tools/call). Tulos palaa mallille, joka kirjoittaa vastauksen. Sinun ei tarvitse tuntea työkalujen nimiä. Esität vain kysymyksen.

Shopifylla on myös MCP-palvelimia. Ne keskittyvät ostosagentteihin ja kehittäjiin: tuotehakuun, ostoskoreihin, kassaan, asiakastileihin ja kehittäjädokumentaatioon. Analytiikka-MCP-palvelin vastaa erilaisiin kysymyksiin: voitto mainosten jälkeen, attribuutio ja asiakasarvo, laskettuna tilauksistasi, kuluistasi ja mainostiliesi kuluista.

Miksi kysyä kauppasi dataa tekoälyavustajalta?

Useimmat kauppaa koskevat kysymykset tarvitsevat lukuja usealta raportilta. "Tuottiko Meta rahaa viime kuussa?" tarvitsee liikevaihdon, tuotekulut, toimituksen, maksut ja mainoskulut yhdessä paikassa. Kojelaudassa avaat oikean raportin, asetat päivämäärät ja teet laskutoimitukset. Tekoälyavustajassa, joka on yhdistetty dataasi, esität kysymyksen ja saat vastauksen taustalla olevine lukuineen.

• Tavallinen kieli. Ei suodattimia, raportinrakentajia tai taulukkolaskennan kaavoja.
• Jatkokysymykset. Kysy "entä TikTokille?" tai "mikä kampanja sai tämän aikaan?" aloittamatta alusta.
• Useita raportteja yhdessä vastauksessa. Voitto, attribuutio ja asiakasarvo voidaan yhdistää yhteen vastaukseen.
• Oma kielesi. Ask AI vastaa kielellä, jolla kirjoitat.
• Muun työsi rinnalla. MCP:n kautta kaupan luvut ovat käytettävissä tekoälysovelluksessa, jossa jo kirjoitat päivityksiä tai suunnitelmia.

Vastaus on vain niin täydellinen kuin sen takana oleva data. Yhdistä ensin palvelinpuolen seuranta, mainostilisi ja tuotekulusi, jotta työkaluilla on tilauksia, kuluja ja katteita, joiden kanssa työskennellä.

Miten Ask AI ja ROASaurus MCP -palvelin toimivat?

Ask AI on keskustelusivu ROASaurusin kojelaudassa. Se toimii Claudella, Anthropicin mallilla. MCP-palvelin tarjoaa samat 24 työkalua valitsemallesi tekoälyasiakasohjelmalle. Kummassakin tapauksessa työkalut lukevat ROASaurus-raporttejasi ja palauttavat luvut JSONina. Malli kirjoittaa vastauksen näiden tulosten perusteella.

Jokainen analytiikkatyökalu vain lukee. Mikään työkalu ei voi muuttaa kauppaasi, kampanjoitasi, kulujasi tai asetuksiasi. MCP-palvelin merkitsee jokaisen niistä vain luku -tilaiseksi ja käskee asiakasohjelman vastata vain työkalujen tuloksista. Avain, jolla on actions:write-oikeus, saa lisäksi työkalun propose_action, joka lisää ehdotetun mainosmuutoksen Actions-saapuneisiin; mitään ei muuteta ennen kuin omistaja tai ylläpitäjä hyväksyy sen. Se on käytössä myös kojelaudan Ask AI:ssa.

Ask AI:ssa yksi kysymys voi käyttää enintään 8 työkalukutsukierrosta. Jos kysymys vaatii enemmän, avustaja pyytää sinua tarkentamaan. Ask AI säilyttää keskustelusi käyttäjää ja kauppaa kohden ja käyttää viimeistä 12 viestiä jatkokysymyksen kontekstina. Voit tyhjentää keskustelun milloin tahansa.

Mitä kysymyksiä voit kysyä?

Hyvät kysymykset nimeävät mittarin ja jonkin tuetuista jaksoista. Taulukossa on esimerkkikysymyksiä, kunkin vastaava työkalu ja se, mihin vastaus perustuu.

Tässä on laskuesimerkki. Kysyt: "Tuottiko Meta rahaa viimeisten 30 päivän aikana?" Malli kutsuu työkalua campaign_profit jakson ollessa 30 päivää ja oletuksena viimeisen klikkauksen mallilla. Esimerkkikaupassa tuloksen Meta-rivi näyttää tältä:

Ask AI:ssa vastaus alkaa sanalla "Kyllä", antaa sitten voiton mainosten jälkeen ja POAS:in ja ehdottaa enintään kolme seuraavaa askelta. Jos haluat toisen näkökulman, esitä jatkokysymys, kuten "entä Total Impact -mallilla?". Oppaamme aiheista POAS ja attribuutiomallit selittävät nämä luvut tarkemmin.

Miten ROASaurus MCP -palvelin yhdistetään?

Palvelin käyttää MCP:n Streamable HTTP -siirtoa ja palauttaa JSON-vastauksia ilman server-sent eventsejä. Tekoälysovellukset, kuten Claude ja ChatGPT, kirjautuvat OAuthilla: kirjaudut ROASaurukseen, valitset kaupan ja sallit yhteyden. Asiakasohjelmat, joissa voit asettaa pyynnön headerin, kuten Claude Code, voivat käyttää sen sijaan API keytä alla olevien vaiheiden mukaan.

1. Luo API-avain

   Avaa ROASaurusissa Store settings › API & data ja luo nimetty avain, jolla on mcp-oikeus. Kopioi se: se näytetään vain kerran. Vain omistajat ja ylläpitäjät voivat luoda avaimia.

2. Tai käytä uudelleen Orders API -avainta

   Voit käyttää myös Orders API -kortin avainta, esimerkiksi sitä, jota WooCommerce-lisäosa käyttää. Sillä avaimella voi myös lähettää tilauksia. Regenerate API key korvaa sen ja katkaisee kaiken, mikä käyttää vanhaa.

3. Merkitse muistiin kauppa-avain

   Nimetty avain lisätään otsakkeeseen yksinään. Orders API -avaimen kanssa lisää kauppa-avain: X-Roasaurus-Key-arvo samalla kortilla, jonka MCP-osio näyttää koko otsakkeen.

4. Lisää palvelin MCP-asiakasohjelmaasi

   Syötä alla näkyvä päätepiste ja Authorization-otsake. Asiakasohjelman täytyy tukea Streamable HTTP:tä ja mukautettuja pyyntöotsakkeita.

5. Esitä testikysymys

   Kysy "Mikä oli liikevaihtoni eilen?" ja tarkista luku kojelaudaltasi.

# Endpoint
POST https://app.roasaurus.com/mcp
Authorization: Bearer <named key with the mcp scope>
# or, with the Orders API key
Authorization: Bearer <store key>:<API key>

# Claude Code
claude mcp add --transport http roasaurus https://app.roasaurus.com/mcp \
  --header "Authorization: Bearer <named key with the mcp scope>"

Voit lähettää kauppa-avaimen myös X-Roasaurus-Key-otsakkeessa ja vain API-avaimen bearer-tokenina. Claude Codessa pidä oletuksena paikallinen laajuus (local scope). Projektikohtainen palvelin tallennetaan .mcp.json-tiedostoon, joka jaetaan versionhallinnan kautta, ja se jakaisi avaimesi.

Jos haluat kirjautua, lisää https://app.roasaurus.com/mcp mukautetuksi connectoriksi Claudessa tai ChatGPT:ssä ja kirjaudu, kun sovellus pyytää. Vain omistajat ja ylläpitäjät voivat sallia yhteyden. Store settings › API & data näyttää jokaisen yhdistetyn sovelluksen, jossa voit katkaista sen, ja yhteys päättyy myös, kun kyseinen henkilö poistuu työtilasta.

Onko se turvallista? Tietosuoja ja tietoturva

Koska analytiikkatyökalut vain lukevat, tekoälysovellus ei voi keskeyttää kampanjaa, muokata kulua tai muuttaa asetusta ROASaurusin kautta; actions:write-oikeudella se voi vain ehdottaa mainosmuutosta omistajan tai ylläpitäjän hyväksyttäväksi. Työkalut hyväksyvät myös vain kiinteitä syötteitä, kuten jakson tai attribuutiomallin listalta. Silti muutama seikka vaatii huolellisuutta.

• Minne data menee. Ask AI lähettää kysymyksesi ja kaupan koosteiset mittarit Anthropicille, joka ylläpitää Claudea. Se ei lähetä asiakkaidesi yhteystietoja. MCP:n kautta työkalujen tulokset menevät yhdistämällesi tekoälyasiakasohjelmalle sen ehtojen mukaisesti. Tarkista sen tietojen säilytys- ja koulutusasetukset.
• Mitä työkalut palauttavat. Summat jaksoittain, kanavittain, kampanjoittain, mainoksittain, tuotteittain, kohorteittain ja segmenteittäin. Ne eivät palauta asiakkaiden nimiä, sähköpostiosoitteita tai puhelinnumeroita.
• Kuka voi kysyä. Jokainen, jolla on pääsy tekoälysovellukseen, johon yhteyden lisäät, voi kysellä kaupasta. Lisää se omalle tilillesi, ei jaetulle.
• Muut liittimet. MCP-määrittely sanoo, että mukana tulee aina olla ihminen, joka voi estää työkalukutsut, ja että asiakasohjelmien täytyy käsitellä työkalumerkintöjä epäluotettavina, ellei palvelin ole luotettava. Jos tekoälysovelluksessasi on myös työkaluja, jotka lähettävät sähköpostia tai julkaisevat viestejä, pidä vahvistuskehotteet päällä niiden osalta.

Mitkä ovat rajoitukset?

• Kiinteät jaksot. Tänään, eilen tai viimeiset 7, 14, 30 tai 90 päivää kaupan aikavyöhykkeessä. Mukautettua aikaväliä, kuten yhtä viikkoa maaliskuussa, ei tueta. Asiakasarvon ja kohorttien työkalut eivät ota jaksoa: ne työskentelevät tilaushistoriasi pohjalta, enintään 12 kuukausikohortilla.
• 7 päivän ikkuna mainostaulukolle. Mainostyökalu käyttää 7 päivän tarkasteluikkunaa riippumatta siitä, minkä ikkunan olet asettanut kohdassa Store settings. Attribuutio- ja kampanjavoittotyökalut käyttävät kojelaudan attribuutioraporttien tavoin omaa asetustasi tai pyytämääsi tarkasteluikkunaa.
• Lyhennetyt listat. Kampanjalistat palauttavat enintään 25 kampanjaa, mainostaulukko 30 eniten kuluttavaa riviä ja tuotelista 25 parasta tuotetta.
• Yksi kauppa yhteyttä kohden. Useita kauppoja varten luo jokaiselle avain ja yhteys.
• Ask AI:n kysymysraja. Jokainen käyttäjä voi esittää oletuksena 40 kysymystä päivässä, laskettuna viimeisten 24 tunnin ajalta. MCP:n kautta sovelletaan sen sijaan tekoälyasiakasohjelmasi omia käyttörajoja.
• Vastaukset voivat olla vääriä. Malli voi tulkita tuloksen väärin. Tarkista tärkeät luvut raporteista, ennen kuin toimit niiden perusteella, esimerkiksi voittoanalytiikasta.

Lähteet

1. Model Context Protocol: What is the Model Context Protocol (MCP)?
2. Model Context Protocol specification (2025-06-18): Tools
3. Claude Code Docs: Connect Claude Code to tools via MCP
4. Claude Docs: Authentication for connectors
5. OpenAI: Building MCP servers for plugins and API integrations

ROASaurusissa

• Ask AI ja MCP
• Voittoanalytiikka
• POAS-laskuri

Lue lisää