Založte si e-shop zdarma a získejte 10 000 AI kreditů na start. Bez karty, bez závazku.E-shop zdarma + 10 000 AI kreditů na start

Začít zdarma
Přeskočit na obsah
Obsah dokumentace

Připojení Claude.ai nebo ChatGPT

Jak připojit Claude.ai, ChatGPT nebo jiného AI asistenta k obchodu adresou shopzi.cz/mcp bez API klíče: souhlas, oprávnění, odpojení a tarif Free.

V administraci:/administrace/nastaveni?tab=api-mcpUpraveno Markdown verze

Claude.ai, ChatGPT a další AI asistenti, kteří umějí připojit vlastní konektor, mohou pracovat přímo s vaším obchodem: odpovídat na otázky o objednávkách, produktech a skladu, psát popisy produktů nebo upravovat obsah webu. K připojení nepotřebujete API klíč ani nic instalovat. Asistentovi dáte jednu adresu, https://shopzi.cz/mcp, přihlásíte se do administrace obchodu a potvrdíte, co smí dělat.

Funguje to v kterémkoli tarifu, i na bezplatném tarifu Free, a v každém zkušebním období. Kdo obchod ještě nemá, založí si ho zdarma rovnou během připojení.

Claude Code, Cursor nebo VS Code?Klienty, do kterých se vkládá API klíč, připojujete jinak: klíčem z Nastavení → API a MCP. Postup je v článku Připojení AI asistenta (MCP).

Připojení krok za krokem

  1. Přidejte konektor v asistentovi. V nastavení asistenta najděte konektory a přidejte vlastní konektor (anglicky „custom connector“) s adresou https://shopzi.cz/mcp. Přesné pojmenování volby se u jednotlivých asistentů liší.
  2. Vyberte obchod. Asistent otevře v prohlížeči stránku SHOPZI s nadpisem, že asistent chce pracovat s vaším obchodem. Stránka ukáže jméno asistenta (uvádí ho asistent sám), adresu, na kterou se po souhlasu vrátí, a do kdy žádost platí. V části Obchod už mám vyplňte Adresu obchodu (třeba nazev.shopzi.cz nebo vaši vlastní doménu) a klikněte na Pokračovat k přihlášení.
  3. Přihlaste se do administrace obchodu jako obvykle, i s druhým ověřením, pokud ho máte zapnuté.
  4. Zkontrolujte, kdo žádá. Otevře se stránka Připojení asistenta. Karta Kdo žádá o přístup ukazuje Asistenta, adresu v řádku Po souhlasu se vrátí na, Obchod a Žádost platí do. Povolte jen asistenta, kterého jste právě sami připojovali; když se vrací na adresu ve vašem počítači, stránka vás na to upozorní.
  5. Nastavte, co smí v kartě Co smí asistent dělat (oddíl níž).
  6. Klikněte na Povolit přístup a krok potvrďte heslem do administrace, nebo kódem z e-mailu, pokud se přihlašujete přes Google či Apple a heslo nemáte. Stránka napíše „Vracím vás zpátky do asistenta…“ a asistent je připojený.

Připojení nechcete? Na první stránce klikněte na Nepřipojovat a vrátit se, na stránce souhlasu na Zamítnout. Asistent se dozví jen to, že jste přístup odmítli.

Asistenta připojuje jen vlastník obchodu. Kdo se přihlásí s jinou rolí, uvidí stránku Asistenta připojuje vlastník obchodu. Odkaz ze stránky výběru obchodu platí 15 minut a celá žádost hodinu; když vyprší, spusťte připojení v asistentovi znovu.

Co nastavíte na stránce souhlasu

Karta Co smí asistent dělat na stránce Připojení asistenta má tyto volby:

  • Oprávnění. Čtení je zaškrtnuté vždy: „Číst obchod: objednávky, katalog, sklad, zákazníky, doklady, obsah a nastavení“. Když asistent žádá i o zápis, je pod ním zaškrtávátko „Měnit obchod: produkty, obsah, vzhled, nastavení, objednávky a sklad. Nevratné kroky vždy potvrzujete vy“. Odškrtnete-li ho, asistent bude jen číst.
  • Měnit tarif obchodu (jen nahoru, s přesnou částkou, nejvýš jednou za 24 hodin). Ukáže se jen se zaškrtnutým zápisem a bez něj asistent tarif měnit nemůže. Víc v článku Navýšení tarifu z AI asistenta.
  • Měsíční strop AI kreditů pro tohoto asistenta, výchozí 3 000. Kredity se berou z peněženky obchodu, strop jen hlídá, kolik z ní smí utratit tenhle asistent za kalendářní měsíc. Nula generování obrázků a další placené akce vypne, čtení a zápisy zdarma nechá.

Když obchod ještě nemá zapnutý Server MCP, souhlas ho zapne. Pokud odpovědnost za server MCP v obchodě ještě nikdo nepotvrdil (při jeho prvním zapnutí nebo po změně textu), objeví se pod volbami text potvrzení odpovědnosti: asistent dostane data obchodu v rozsahu oprávnění, včetně osobních údajů zákazníků, a zapojujete ho svým jménem. Bez zaškrtnutí Rozumím a potvrzuji tlačítko Povolit přístup nepustí. Totéž shrnuje článek XXa obchodních podmínek.

Co asistent smí a co ne

Připojený asistent dostane tytéž nástroje jako Agent v administraci, v rozsahu oprávnění, která jste mu dali. Co přesně který nástroj umí, ukazuje článek Co Agent umí změnit. Platí přitom:

  • Co něco přepisuje nebo maže, se napřed zeptá. Když asistent otázku ve svém okně ukázat neumí, dostanete odkaz na schválení v administraci, viz Schválení změn z AI asistenta.
  • Nevratné kroky (vystavení dokladu, vrácení peněz, rozeslání kampaně, změny týmu) jdou vždy jen přes schválení v prohlížeči.
  • Hledání na webu připojený asistent nemá. Kdo ho potřebuje, vydá API klíč s tímhle oprávněním v Nastavení → API a MCP.
  • Každá změna je v deníku změn a většinu jde vrátit.

Karta Připojení asistenti a odpojení

Připojené asistenty najdete v Nastavení → API a MCP, v části Přístup a klíče, v kartě Připojení asistenti pod tabulkou klíčů. U každého je jméno (začíná „Asistent:“), jestli Jen čte, nebo Čte i mění obchod, měsíční strop kreditů, kdy byl připojen a kdy naposledy pracoval.

Asistenta odpojíte tlačítkem Odpojit. Potvrzení se zeptá, jestli ho opravdu odpojit, a po kliknutí na Odpojit asistenta ztratí přístup hned. Změny, které už v obchodě provedl, zůstanou. Znovu se připojí jen novým souhlasem po přihlášení. Odpojit smí vlastník, manažer i účet podpory SHOPZI.

  • Najednou může být připojeno nejvýš pět asistentů. Do počtu API klíčů podle tarifu se nepočítají.
  • Smazání konektoru v asistentovi přístup v obchodě zrušit nemusí. Asistenta, kterého už nepoužíváte, odpojte i v kartě.
  • Vypnete-li v kartě Externí přístup přepínač Server MCP, přestanou pracovat všichni připojení asistenti naráz; po zapnutí pokračují.
  • O každém připojení i odpojení dostanou vlastníci obchodu e-mail a upozornění v administraci.

Když asistent měsíc nepracoval, může vás požádat o nové přihlášení. Pak vznikne nové připojení a to staré v kartě odpojte.

Obchod ještě nemáte

Na stránce výběru obchodu je vedle části Obchod už mám i část Založit nový obchod zdarma:

  1. Vyplňte Název obchodu a Adresu obchodu (malá písmena bez diakritiky, číslice a pomlčky; vlastní doménu připojíte později v administraci) a klikněte na Založit obchod zdarma.
  2. Ověřte e-mail kódem, nebo pokračujte účtem Google či Apple, doplňte jméno a přijměte podmínky.
  3. Na konci klikněte na Založit obchod zdarma. Obchod vznikne na tarifu Free, zdarma navždy a bez platební karty, a je zatím zavřený pro veřejnost.
  4. Tlačítko Připojit asistenta vás přihlásí do administrace nového obchodu, rovnou na stránku Připojení asistenta. Po souhlasu se vrátíte do asistenta a ten vám může pomoct obchod nastavit.

Na placený tarif přejdete kdykoli později v Nastavení → Předplatné, viz Tarif, limity a úložiště.

Tarif a limity

  • Připojení funguje v kterémkoli tarifu včetně tarifu Free a v každém zkušebním období, s uloženou kartou i bez ní. Nejde jen obchodu se zrušeným nebo pozastaveným předplatným.
  • Asistent má stejný strop počtu volání za hodinu a za den jako API klíč na tomtéž tarifu a vedle toho svůj měsíční strop kreditů ze stránky souhlasu.
  • REST API pro účetní a skladové systémy je součástí placených tarifů; s připojeným asistentem nesouvisí.

Časté potíže

Asistent píše, že se připojit nepodařilo. Spusťte připojení znovu z nastavení konektorů. Když SHOPZI připojování nových asistentů dočasně vypnulo, stránka to řekne; už připojení asistenti pracují dál a do té doby se k obchodu připojíte API klíčem.

Stránka píše „Asistenta připojuje vlastník obchodu“. Jste přihlášeni s jinou rolí než vlastník. Požádejte vlastníka obchodu, ať připojení dokončí sám.

Stránka píše „Odkaz patří k jinému obchodu“. V adrese obchodu jste zadali jiný obchod, než do kterého jste se přihlásili. Spusťte připojení znovu a zadejte adresu správného obchodu.

Stránka píše, že obchod má připojených už pět asistentů. Odpojte v kartě Připojení asistenti toho, kterého nepoužíváte, a připojení spusťte znovu.

Asistent přestal pracovat. Podívejte se do karty Připojení asistenti, jestli ho někdo neodpojil, a do karty Externí přístup, jestli je zapnutý Server MCP. Když je obojí v pořádku, připojte ho znovu a staré připojení odpojte.

Technický popis připojení (OAuth, tokeny, adresy) je v článku MCP server v dokumentaci pro vývojáře.