+420 728 089 029jsme@webotvurci.cz
Vydejme se na cestu
+420 728 089 029

Shoptet MCP: připojte AI přímo k datům svého e-shopu

· ⏱ 3 min čtení

Shoptet MCP: připojte AI přímo k datům svého e-shopuAI u kormidla e-shopu

TL;DR: Vyvinuli jsme open-source MCP server pro Shoptet Premium, který připojí AI asistenta (Claude, Cursor i Claude Code) přímo na data vašeho e-shopu. Místo exportů do Excelu se prostě zeptáte přirozeným jazykem – „jaké byly minulý týden tržby po dnech?" – a AI odpoví nad živými daty. Server je záměrně read-only, takže AI může data jen číst a analyzovat, nikdy je nezmění.

AI a Shoptet jsou naše denní práce – stavíme doplňky, integrace i AI agenty pro reálné e-shopy. Pořád narážíme na stejnou bariéru: majitel e-shopu chce „použít AI", ale AI nemá jak se dostat k jeho datům. Tenhle MCP server tu bariéru řeší. Pojďme si vysvětlit, co MCP je, co server umí a jak ho nasadíte.

Co je MCP a proč na něm záleží

MCP (Model Context Protocol) je otevřený standard od Anthropicu, který funguje jako univerzální „kabel" mezi AI modelem a vašimi systémy. Bez MCP umí AI jen to, co jí napíšete do chatu. S MCP serverem se AI dokáže sama připojit ke konkrétnímu zdroji dat, zjistit, jaké nástroje má k dispozici, a použít je.

Pro e-shop to znamená zásadní posun. Místo abyste data ručně tahali ze Shoptet administrace, exportovali je a vkládali do ChatGPT, AI si data vytáhne sama – aktuální, kompletní a ve správném formátu. Vaším úkolem je jen položit otázku.

Co Shoptet MCP server umí

Server se napojuje na Shoptet Premium API a vystavuje AI sadu nástrojů rozdělených do tří skupin:

Souhrny a analytika – předpočítané přehledy, na které se nejčastěji ptáte:

  • orders_summary, revenue_trend – tržby a objednávky v čase
  • top_products, top_customers – nejprodávanější produkty a nejlepší zákazníci
  • unpaid_orders – neuhrazené objednávky
  • inventory_overview, stock_movements_summary – stav a pohyby skladu
  • reviews_summary, refunds_summary – recenze a vratky

Seznamy a detaily – přístup ke konkrétním záznamům: objednávky, produkty, zákazníci, faktury, recenze, dobropisy, reklamace, slevové kupóny, články i stránky (list_orders/get_order, list_products/get_product a další).

Číselníky a metadata – stavy objednávek, platební a dopravní metody, kategorie, značky, informace o e-shopu. Pro pokročilé je tu i shoptet_raw_get jako „úniková klapka" na libovolný API endpoint.

Pár reálných otázek, které takhle položíte AI:

  • „Jaké byly minulý týden tržby po jednotlivých dnech?"
  • „Ukaž 20 nejprodávanějších produktů podle obratu za poslední 3 měsíce."
  • „Které objednávky jsou neuhrazené déle než měsíc?"
  • „Porovnej prodeje podle prodejních kanálů za poslední měsíc."

Proč je server read-only (a proč je to dobře)

Největší obava u napojení AI na ostrá data zní: co když AI něco smaže nebo změní? Tenhle MCP server ji řeší na úrovni architektury – HTTP klient umí jedině get(). Žádné post, put, patch ani delete v něm neexistují. I kdyby se AI „rozhodla" objednávku změnit, technicky nemá jak. Může data jen číst a analyzovat.

Pro e-shop to znamená, že MCP nasadíte i na produkční data bez rizika. Hodí se přesně na to, k čemu AI dává největší smysl: reporting, analýzy a rozhodování, ne na zápis.

Jak ho nasadíte

Server je napsaný v TypeScriptu, běží na Node.js 20+ a je zdarma pod licencí MIT. Postup je krátký:

  1. Získejte API token v Shoptet administraci: Propojení → Shoptet API (privátní token ve formátu 123456-p-789012-…).
  2. Naklonujte a sestavte repozitář:
    git clone https://github.com/Webotvurci-s-r-o/shoptet-premium-readonly-mcp.git
cd shoptet-premium-readonly-mcp
npm install && npm run build
  3. Připojte do Claude Desktopu (nebo Cursoru / Claude Code) přes claude_desktop_config.json, kam přidáte cestu k dist/index.js a svůj token do proměnné SHOPTET_PRIVATE_API_TOKEN.

Detailní konfiguraci pro každou platformu najdete v README na GitHubu. Protože je projekt open source, můžete si ho upravit, rozšířit o vlastní nástroje nebo si ho nechat nasadit od nás.

Pro koho to je

MCP server oceníte, pokud na Shoptet Premium prodáváte a chcete:

  • přestat exportovat data do Excelu kvůli každému reportu,
  • ptát se na čísla přirozeným jazykem místo klikání v administraci,
  • dát AI kontext pro chytřejší rozhodování o skladu, marketingu nebo cenotvorbě.

Programovat přitom umět nemusíte – stačí jednou nastavit a pak se ptát. A pokud si s nastavením nevíte rady nebo chcete jít dál (vlastní AI agenti, automatizace, napojení na další systémy), učíme přesně tohle na Shoptet AI školení a stavíme AI řešení na míru.

MCP je teprve na začátku a my u toho chceme být – proto je tenhle server veřejný a zdarma. Vyzkoušejte ho, ozvěte se s nápady, nebo nás nechte napojit AI na váš e-shop za vás.