Řešení technických problémů

První krok v každém případě: požádejte chat, aby spustil ps_get_shop_info a ps_check_shop_health. Společně ukážou verze, edici a stav licence, oblasti zápisu (které přepínače jsou zapnuté a do kdy), úroveň dat zákazníků, chybějící oprávnění zaměstnance, zbývající hodinové limity a moduly napojené na ukládání. Karta Protokol připojení (posledních 50) ukazuje každé volání s IP, výsledkem a časem.

Připojení

Konektor se nepřipojí z Claude ani z ChatGPT.

Zkontrolujte v tomto pořadí:

1. Adresa je https://your-shop.com/module/tellmyshop/mcp (od verze 2.8 bez tokenu; u staršího způsobu s celým tokenem). Endpoint odmítá čisté HTTP (403).
2. Hosting předává hlavičku Authorization do PHP. Pokud ne, „Ověřit připojení znovu“ hlásí, že hosting odstraňuje hlavičku s propustkou chatu, a přihlášení nefunguje. Zajistěte předávání hlavičky (například pravidlem v .htaccess nebo v konfiguraci serveru), nebo zapněte Propojené chaty > Pokročilé: způsob propojení chatu > Adresa s klíčem (starší způsob) a použijte tuto adresu.
3. Konektor je zapnutý. Krok 1 karty Start (Zapnout konektor) ho zapne; vypnutý vrací 503 „connector disabled“.
4. „Ověřit připojení znovu“ v modulu funguje (testovací token, platný 2 minuty; ověří i přihlášení). Test neodhalí blokování podle země nebo IP na CDN; první skutečné volání z chatu v protokolu připojení ano.
5. Nic před obchodem neblokuje POST na /module/tellmyshop/mcp: basic auth, stránka údržby, WAF, Cloudflare Bot Fight Mode nebo managed challenges. Přidejte výjimku jen pro tuto cestu.
6. Seznam povolených IP v Nastavení: bezpečnost, upozornění, limity je prázdný, nebo obsahuje adresy vaší aplikace chatu. S ChatGPT ho nechte prázdný: OpenAI nezveřejňuje pevný seznam adres. Pro Claude má karta nastavení tlačítko, které přidá adresy Anthropic.
7. Obchod za Cloudflare nebo jinou proxy: zapněte Obchod za proxy / Cloudflare a uveďte rozsahy proxy v Důvěryhodné proxy, jinak seznam IP vidí IP proxy.
8. V ChatGPT se obchod přidává v Plugins jako vlastní server MCP s ověřováním OAuth.

403 Forbidden.

Pravděpodobné příčiny:

• Origin. Požadavek s hlavičkou Origin se přijme jen z https://claude.ai, https://claude.com, https://chatgpt.com nebo https://chat.openai.com. Požadavky bez Origin projdou. Testovací nástroj v prohlížeči s jiným Origin se odmítne.
• Seznam povolených IP. IP na seznamu není.
• Prosté HTTP.

503 Služba nedostupná.

Konektor je vypnutý, nebo neexistuje zaměstnanec konektoru (smazaný nebo změněný na SuperAdmin). Spusťte znovu krok 1 karty Start; když účet chybí, vytvoří ho.

429 Příliš mnoho neúspěšných pokusů.

20 neúspěšných ověření z jedné IP během 10 minut tuto IP zablokuje, dokud okno neuplyne; majitel dostane upozornění. Typická příčina: starý token (adresa s klíčem) stále nastavený v aplikaci chatu nebo v monitorovacím skriptu. Opravte token a počkejte 10 minut.

Okno obchodu ukazuje chybu.

• „Adresa návratu do chatu neodpovídá registraci“: odeberte konektor v chatovací aplikaci a přidejte ho znovu.
• Žádost vypršela: žádost o propojení i kód platí 15 minut. Propojte obchod z chatu znovu.
• Upozornění, že nejde o Claude ani ChatGPT: jiné aplikace se mohou propojit jen tehdy, když je zapnuté Povolit propojení jiných aplikací než Claude a ChatGPT (ve výchozím stavu vypnuto), a i pak jen se souhlasem majitele.

401 po změně adresy s klíčem (starší způsob).

Nový token okamžitě zneplatní starý a vypnutí Adresy s klíčem (starší způsob) adresu smaže. Chat propojený přes přihlášení, který byl odpojen na kartě Propojené chaty, také dostane 401: propojte ho z chatu znovu. Aktualizujte URL konektoru v Claude nebo hlavičku Authorization: Bearer v konfiguraci Claude Code / Claude Desktop.

Claude Code nebo Claude Desktop (lokálně) se nepřipojí.

Pokud se klient neumí přihlásit přes okno, zapněte adresu s klíčem (starší způsob) a místo tokenu v URL použijte --header "Authorization: Bearer <token>". Endpoint potřebuje HTTPS i lokálně (mkcert). Požadavky bez hlavičky Origin projdou. Pokud je nastavený seznam povolených IP, přidejte veřejnou IP počítače.

Chyba verze protokolu.

Podporované: 2026-07-28 a 2025-11-25, 2025-06-18, 2025-03-26. Nepodporovaná verze vrátí 400 se seznamem podporovaných verzí.

Ukládání nefunguje

Chat jen čte a plánuje.

Buď licence není aktivní (Pro bez aktivní licence funguje jako Free), nebo jde o TellMyShop Free, který nemá nástroje pro zápis. ps_get_shop_info řekne, o co jde (edice audit nebo audit_free). Zkontrolujte kartu Licence a klikněte na Obnovit.

„Writing in the … area is off. Nothing was saved.“

Prodej, Šablona, Moduly a Servis ukládají, jen když je jejich přepínač zapnutý v kartě Zápis v oblastech. Prodej zůstane zapnutý, dokud ho nevypnete; Šablona a Moduly na 24 hodin; Servis na 3 hodiny. Přepínač, který vyprší uprostřed rozhovoru, okamžitě zastaví ukládání. Náhled dál funguje, takže chat může ukázat plán dřív, než přepínač zapnete. Od 2.7.0 už neexistuje samostatný servisní konektor: jedna adresa pokrývá všechny oblasti.

Šablona, Moduly nebo Servis se nezapnou.

Zapnutí vyžaduje zaškrtnuté potvrzení a dokončenou zálohu databáze. Ve velkém obchodě se záloha dělá po částech: nechte stránku otevřenou, nebo klikněte na Dokončit zálohu. Bez volného místa na disku zhruba dvojnásobku velikosti databáze zůstanou tyto přepínače vypnuté; Obsah, Katalog a Prodej fungují dál.

ps_restore_file_backup odmítnut.

Obnova potřebuje přepínač zóny souboru: Šablona pro soubory šablony, Moduly pro soubory modulů, Servis pro ostatní soubory obchodu. Karta Zálohy souborů v panelu obnovuje bez přepínače, s oprávněními přihlášeného zaměstnance.

Nástroj zákaznického servisu odmítá.

ps_customer_service odmítá, dokud je úroveň dat zákazníků Vypnuto. V kartě Data zákazníků (GDPR) nastavte Pseudonymizace nebo Plný přístup (dočasný).

Chybějí nástroje blogu.

5 nástrojů blogu se zaregistruje, jen když je rozpoznán SmartBlog. Jiné moduly blogu nejsou podporovány. ps_check_shop_health hlásí „žádný blog“ jako informaci.

Limity

Dosažen limit.

Výchozí hodnoty za hodinu: 300 volání, 150 zápisů, 20 zápisů souborů (rozsahy 10–2000, 1–500, 1–200), nastavitelné v Nastavení: bezpečnost, upozornění, limity. Zápis s dávkou až 50 položek se počítá jako jeden a limit zápisů se kontroluje před uložením, takže se dávka nikdy nezastaví v polovině. Velké práce rozdělte do více hodin, nebo na dobu práce limity zvyšte; ps_check_capacity naplánovanou práci předem ověří.

Dávka odmítnuta s chybou limitu.

Limity na volání, například: ps_update_product_content 50, ps_update_category_content 20, ps_update_image_legends 100, ps_set_product_categories 200, ps_update_prices 100, ps_update_stock 100, ps_manage_combinations 100, ps_set_product_redirect 100, ps_translate_catalog_items 200, ps_manage_redirects 100, ps_db_query 200 řádků, ps_db_execute 1000 zálohovaných řádků. Úplná tabulka: Specifikace §11.1.

Zápisy

change_token vypršel, byl použit nebo nesouhlasí.

Token je HMAC nástroje, argumentů a hashe stavu „před“, platí 30 minut, jednorázově. Zopakujte se stejnými argumenty nebo vytvořte nový náhled.

Provedení zablokováno: data se od náhledu změnila.

Stav „před“ už nesouhlasí, například kvůli úpravě v administraci, importu nebo modulu feedů. Vytvořte nový náhled.

Výsledek ukazuje změny mimo náhled.

Záznam řádků zachytil během zápisu změněné řádky, které náhled neukázal, obvykle hookem jiného modulu. Chat je ukáže majiteli a zeptá se, co dělat; sám je neobnoví. Vrácení operace vrátí všechny zaznamenané řádky do předchozího stavu.

Změna ceny odmítnuta.

ps_update_prices odmítá cenu 0 a změny nad 30 % bez allow_big_change. ps_manage_specific_prices a ps_manage_catalog_price_rules vyžadují allow_big_change nad 90 % slevy (varování nad 50 %). Chat příznak nastaví až po tom, co obchodník změnu takové velikosti schválí.

Pravidlo košíku vytvořené, ale neaktivní / nejde smazat.

ps_manage_cart_rules vytváří pravidla záměrně neaktivní; použijte action=set_active. Akce mazání neexistuje; pravidlo vypněte. Pravidlo bez kódu potřebuje auto_apply.

Chyba validace při ukládání.

ObjectWriter validuje každé pole pravidly třídy (validateField, isCleanHtml, délky). Názvy produktů nesmí obsahovat <>;=#{} a mají nejvýš 128 znaků. Zpráva uvádí pole.

Jiný modul na změnu nereaguje.

ObjectWriter volá update(), které spouští actionObject<Class>Update* (a u produktů actionProductSave / actionProductUpdate). Moduly, které poslouchají jen hooky formulářů administrace, změnu nevidí. ps_check_shop_health je vypíše.

Oprávnění zamítnuto.

ExecutionContext::requirePermissions kontroluje zaměstnance konektoru podle záložky a akce. Od 2.7.0 dostane profil vytvořený krokem 1 oprávnění všech oblastí; pokud byl profil upravený ručně, ps_get_shop_info vypíše, co chybí. V některých verzích PrestaShop moduly ignorují uložení zaměstnancem bez oprávnění „zobrazit“ u modulů; karta Start nabízí opravu jedním kliknutím.

Vrácení odmítnuto.

ps_revert_change nevrátí: vytvoření podřízené šablony, instalaci, aktualizaci nebo odinstalaci modulu, DDL, smazané obrázky, vytvořený produkt, který už je v objednávce, změny URL (použijte nové ps_change_url), úpravy souborů (použijte zálohy souborů). Vrácení změny v oblasti Prodej, Šablona, Moduly nebo Servis potřebuje ten přepínač; karta Historie změn a vrácení zpět vrátí cokoli s oprávněními přihlášeného zaměstnance. Šifrované položky historie potřebují soubor s klíčem.

URL

Změna URL zablokována.

ps_change_url odmítá, když je kanonické přesměrování 302 (Nastavení obchodu > Provoz a SEO, nastavte 301), je zapnutý vývojářský režim (_PS_MODE_DEV_) nebo modul přepisuje routy (UrlGuard; ps_check_shop_health ho uvede). Změny URL blogu vyžadují zapnuté „Přesměrování 301 pro blog“ v nastavení.

Přesměrování odmítnuté nástrojem ps_manage_redirects.

Náhled přijme jen zdroje, které teď vracejí 404 nebo 410, a cíle, které na doméně obchodu vracejí 200. Řetězce a smyčky jsou blokované. Až 100 položek na add, 100 ID na disable/enable; zdroj až 1 024 znaků, cílová URL až 2 048. Mazání neexistuje: použijte disable, nebo změnu vraťte přes historii změn.

Soubory, šablona a cache

Změna po zápisu do šablony není vidět.

Spusťte ps_clear_cache (rozsah smarty; all vymaže i cache Symfony). Moduly cache celých stránek a cache CDN vymažte zvlášť.

Chyba validace Smarty.

Povolené jsou jen tagy a modifikátory z whitelistu, pak následuje zkušební kompilace; {php}, {include_php} a statický přístup ke třídám se odmítnou. Nic se neuložilo.

„search must appear exactly once“.

Použijte delší úryvek, nebo zapište celý soubor přes content.

Přístup k souboru zamítnut.

Cesty musí být relativní, bez .., musí vést dovnitř zóny (realpath) a mít textovou příponu. Vždy zakázané: parameters.php/yml, settings.inc.php, .env*, klíče a certifikáty, výpisy SQL, archivy a .bak, .git, var/logs, upload, download, soukromý adresář modulu a modul samotný.

Zápis souboru PHP odmítnut.

Kontrola syntaxe (token_get_all(TOKEN_PARSE)) našla chybu parsování. Chyby za běhu (například nedefinovaná funkce) se nezjistí; proto má každý zápis PHP zálohu a existuje záchranný klíč.

Obnova po změně, která rozbila obchod.

ps_list_file_backups, pak ps_restore_file_backup (nejdřív zazálohuje aktuální verzi), pak ps_clear_cache. Pokud nefunguje administrace: otevřete záchrannou adresu a zadejte nouzový klíč; obnoví soubory změněné konektorem a vypne Servis, ale databáze se nedotkne. Pro databázi použijte zálohy databáze modulu (karta Zápis v oblastech, Stáhnout, pak import vašimi obvyklými nástroji).

SQL (Servis)

Dotaz odmítnut.

Jen jeden příkaz, bez komentářů, které skrývají obsah. Nikdy přístupné: tabulky zaměstnanců, relací, přístupů a profilů, configuration (použijte ps_config), tabulky webservice a API, tabulky konektoru. Nikdy zapisovatelné: daně, vazby platebních modulů, objednávky, stavy, platby, faktury. Operace se soubory a uživateli MySQL blokované. Tabulky s osobními údaji jen na úrovni dat zákazníků pseudo (maskované) nebo full.

ps_db_execute vrácen (rollback).

Změnilo se víc řádků, než bylo uvedeno, nebo by bylo potřeba zálohovat víc než 1000 řádků. Zužte WHERE, nebo změnu rozdělte.

Co se změnilo od 2.6

Nahlášení problému

Pošlete na [email protected]: doménu, verze PrestaShop a PHP, verzi modulu, balíček (Pro nebo Free), aplikaci chatu (Claude nebo ChatGPT), název nástroje, přesný text chyby a čas. Nikdy neposílejte adresu s klíčem ani celý token; u staršího způsobu stačí prefix tokenu.

---

PrestaShop je registrovaná ochranná známka společnosti PrestaShop SA. Claude je ochranná známka společnosti Anthropic. ChatGPT je ochranná známka společnosti OpenAI. TellMyShop není s žádnou z nich spojen.