Yhdistä Claude tai ChatGPT Shopifyiin — operoi kauppaa tekoälyllä

Devaajalle

1. Luo Custom Distribution -app (Partner/Dev Dashboard tai CLI) ja asenna se kauppaan — in-admin 'Develop apps' on estetty 1/2026 alkaen.
2. Grantaa laajat Admin-scopet asennuksessa (kaikki paitsi read_all_orders), jotta agentti voi ajaa tuotteita, varastoa, sisältöä, teemoja ja käännöksiä ilman uudelleenasennusta.
3. Hae Admin API -token client_credentialsilla (Client ID + API-secret → /admin/oauth/access_token; ~24 h, refresh). Laita .env:iin SHOPIFY_ACCESS_TOKEN.
4. Osoita tekoälyagenttisi (Claude / ChatGPT) kauppaan: se autentikoi tuolla tokenilla Admin GraphQL API:a vasten (ja Theme Asset API:a teemamuokkauksiin). MCP on kuljetus, ei tunnus — token pitää silti mintata.

Oikeaan operointiin grantaa laajat Admin-scopet asennuksessa — käytännössä kaikki Admin-scopet PAITSI read_all_orders. Scope-lisäys jälkikäteen = uusi app-versio + kaupan hyväksyntä, joten suunnittele etukäteen. read_all_orders vaatii Shopifyn erikoishyväksynnän (muuten ~60 pv tilaushistoriaa). Suojattua asiakasdataa koskevat appit hyväksyy kaupan OMISTAJA, ei staff-admin.

Aja ensin read-only ja tarkista tulos; kirjoita vasta backupin + esikatselun jälkeen.

Tarkka koodi

Prompti tekoälyagentillesi — yhdistä Shopify & toteuta

Valmis kopioi–liitä-prompti omalle tekoälyagentillesi (Claude / ChatGPT). Se kertoo agentille miten se yhdistää Shopify-kauppaasi ja toteuttaa JSON-LD:n puolestasi — turvakurilla: varmuuskopio, esikatselu, verifiointi ja sinun hyväksyntäsi ennen julkaisua.

You are helping me connect my AI agent to my Shopify store so it can operate the store for me, safely.

SAFE-OPERATING DISCIPLINE (follow in order):
  1. Read first: point the agent at read-only tasks and confirm it sees your real data before any write.
  2. Back up before every write; rehearse unfamiliar jobs on a dev/staging store first.
  3. Plan the ring of keys for what you'll let the agent do over the coming months (re-scoping is painful on some platforms), and grant that at connect time.
  4. Batch writes in small clusters, not one giant run; respect the platform's rate meter.
  5. Store the credential in .env, reference it by name, never print it; keep it revocable from a UI you own.

CONNECT:
  1. Create a Custom Distribution app (Partner/Dev Dashboard or CLI) and install it on the store — the in-admin 'Develop apps' path is blocked as of Jan 2026.
  2. Grant broad Admin scopes at install (all except read_all_orders) so your agent can run products, inventory, content, themes and translations without a reinstall later.
  3. Fetch the Admin API access token via client_credentials (Client ID + API secret → /admin/oauth/access_token; ~24h, refresh). Put it in .env as SHOPIFY_ACCESS_TOKEN.
  4. Point your AI agent (Claude / ChatGPT) at the store: it authenticates with that token against the Admin GraphQL API (and the Theme Asset API for theme edits). MCP is a transport, not a credential — you still mint this token.

SCOPES: For real operations, grant broad Admin scopes at install — in practice all Admin scopes EXCEPT read_all_orders. Re-scoping later means a new app version + store re-approval, so plan ahead. read_all_orders needs Shopify's special approval (without it you get ~60 days of order history). Apps touching protected customer data must be approved by the store OWNER, not a staff admin.

Then operate read-first, back up before writes, batch small, and ask me before anything customer-facing goes live.

Mitä ihmiset kysyvät tekoälyltään

Mikä on prompti jolla yhdistän Clauden Shopifyiin operoidakseni kauppaani?

Käytä tämän sivun runbookia: mintaa scopetettu tunnus, lataa se .env:istä, ja pyydä Claudea autentikoimaan kaupan API:a vasten, lukemaan ensin, varmuuskopioimaan ennen kirjoituksia ja kysymään sinulta ennen julkaisua.

Mitä scopeja tekoälyagentti tarvitsee Shopify-kaupan operointiin?

Oikeaan operointiin grantaa laajat Admin-scopet asennuksessa — käytännössä kaikki Admin-scopet PAITSI read_all_orders. Scope-lisäys jälkikäteen = uusi app-versio + kaupan hyväksyntä, joten suunnittele etukäteen. read_all_orders vaatii Shopifyn erikoishyväksynnän (muuten ~60 pv tilaushistoriaa). Suojattua asiakasdataa koskevat appit hyväksyy kaupan OMISTAJA, ei staff-admin.

Onko turvallista antaa tekoälyagentin operoida live-kauppaani?

Kyllä, The AI-Run Store -kirjan kurilla: read-first, varmuuskopio ennen jokaista kirjoitusta, harjoittelu dev-storessa, pienet erät ja ihminen hyväksymässä kaiken asiakkaalle näkyvän. Tämän sivun runbook rakentaa ne sisään.

Lähteet

• The AI-Run Store — ch. 6 'Wiring in' (giving agents the keys to your platform)
• Legacy custom apps can't be created after Jan 1 2026 (Shopify changelog)
• Shopify Admin API — access tokens (incl. client_credentials)
• Shopify themeFilesUpsert (theme file writes; needs write_themes_assets)
• Shopify — manage translated content (metafields via translationsRegister)
• Shopify Liquid translate filter (only locale-file strings translate)