Instalacja TellMyShop

TellMyShop instalujesz jak każdy inny moduł PrestaShop. Zajmie to około 15 minut. Na końcu masz adres konektora, który wklejasz w Claude.

Po instalacji Claude może tylko czytać sklep. Niczego nie zmieni, dopóki na to nie pozwolisz. To celowe: najpierw się rozglądasz, potem włączasz zmiany.

Czego potrzebujesz

• PrestaShop 8.1 lub nowszego, do 9.x.
• PHP 8.1 lub nowszego. Jeśli nie wiesz, jaką masz wersję, zapytaj hosting.
• Adresu sklepu zaczynającego się od https://.
• Konta Claude. Wystarczy konto Claude, także darmowe.
• Dostępu do panelu sklepu z prawem instalowania modułów.

Konto PrestaShop Account nie jest potrzebne.

Którą paczkę pobrać

• TellMyShop (płatna): plik ZIP pobierasz ze swojego konta, Konto > Pliki do pobrania.
• TellMyShop Audyt (darmowa): plik ZIP pobierasz ze strony tellmyshop.pl/free-audit. Claude czyta sklep i mówi, co poprawić, ale ta paczka niczego nie zmieni.

Obie instalujesz tak samo. Gdy zechcesz przejść z Audytu na wersję płatną, wgrywasz płatny ZIP na darmowy. Ustawienia i historia zostają.

Krok 1: Wgraj moduł

1. W panelu otwórz Moduły > Menedżer modułów.
2. Kliknij Załaduj moduł i upuść plik ZIP.
3. Gdy zobaczysz komunikat o instalacji, kliknij Konfiguruj.

Na liście modułów moduł nazywa się TellMyShop. Jeśli wgrywanie się nie udaje, zajrzyj do pytań i odpowiedzi.

Krok 2: Utwórz konto dla Claude

Claude pracuje w sklepie jako osobny pracownik, z własnymi uprawnieniami. Dzięki temu dziennik sklepu pokazuje dokładnie, co zrobił Claude, a Claude nie zrobi więcej, niż pozwolisz.

1. W ustawieniach TellMyShop, w karcie Start, przy kroku Utwórz konto dla Claude'a kliknij Utwórz konto Claude'a.
2. Moduł sam zakłada osobny profil Claude TellMyShop i pracownika Claude TellMyShop (imię Claude, nazwisko TellMyShop) i od razu go wybiera. Na to konto nikt się nie zaloguje, a uprawnienia ma tylko takie, jakich potrzebują włączone obszary.

Wolisz ręcznie? Załóż profil i nieaktywnego pracownika w Parametry zaawansowane > Zespół, potem wybierz go w ustawieniach modułu. Pracownik z profilem SuperAdmin nie jest dozwolony.

Krok 3: Utwórz adres konektora i włącz konektor

1. W karcie Start, przy kroku Wygeneruj adres konektora, kliknij Wygeneruj token.
2. Kliknij Kopiuj, żeby skopiować adres. Wygląda tak: https://twojsklep.pl/module/tellmyshop/mcp?token=….
3. Przechowuj go bezpiecznie, jak hasło. Widać go tylko raz. Jeśli go zgubisz, wygeneruj nowy; stary od razu przestaje działać.
4. Kliknij Włącz konektor i sprawdź połączenie. Wszystkie pozycje powinny być zielone.

Dalej: wklej adres w Claude. Zobacz Połączenie z Claude.

Krok 4 (opcjonalny): Drugi konektor do prac technicznych

Zmiany wyglądu sklepu, modułów i plików sklepu są ryzykowne, więc mają osobny konektor serwisowy. Działa tylko z zatwierdzonych adresów internetowych (domyślnie adresów Claude) i tylko wtedy, gdy któryś z tych obszarów jest włączony. Potrzebujesz go tylko wtedy, gdy ty albo twój developer chcecie, żeby Claude wykonywał prace techniczne.

W karcie Prace techniczne (zaawansowane):

1. Najpierw kliknij Wygeneruj klucz awaryjny i zapisz klucz poza sklepem, np. w menedżerze haseł. Dzięki niemu przywrócisz pliki, nawet gdy sklep przestanie działać.
2. Kliknij Wygeneruj token serwisowy, żeby dostać adres konektora serwisowego. Sam wygasa po 30 dniach (możesz ustawić od 7 do 90).
3. Dodaj go w Claude jako drugi, osobny konektor, np. „Mój sklep (serwis)”.

Pomiń ten krok, jeśli pracujesz tylko nad produktami, tekstami, cenami i promocjami.

Krok 5: Zacznij w trybie tylko do odczytu, potem włącz zmiany

Zaraz po instalacji moduł jest w trybie tylko do odczytu. Claude czyta i raportuje, ale niczego nie zapisuje. Wykorzystaj to, żeby go poznać.

Uruchom np. gotowe zadanie Przegląd sklepu i plan poprawek albo napisz:

Sprawdź sklep pod kątem SEO i podaj pięć najpilniejszych poprawek.

Gdy chcesz, żeby Claude wprowadzał zmiany:

1. W karcie Zakres pracy i uprawnienia, w części Tryb pracy, wybierz Odczyt i zmiany i kliknij Zapisz zakres pracy.
2. Wybierz, co Claude może zmieniać. Treści i SEO są włączone. Handel (ceny, promocje, wysyłka) jest wyłączony, dopóki go nie włączysz. Zobacz Co Claude może zrobić w twoim sklepie.

Za każdym razem, gdy luzujesz zabezpieczenie, tak jak tutaj, właściciel sklepu dostaje e-mail. Także po wyłączeniu trybu tylko do odczytu Claude pokazuje podgląd każdej zmiany i zapisuje dopiero po twojej zgodzie.

Aktywacja licencji

1. Skopiuj klucz licencji z e-maila po zakupie albo z Konto > Licencje.
2. W ustawieniach otwórz kartę Licencja, wklej klucz i kliknij Aktywuj.

Bez ważnego klucza płatna paczka działa jak darmowy Audyt: Claude czyta i raportuje, ale niczego nie zmienia. Darmowa paczka Audyt w ogóle nie ma funkcji zapisu; panel i Claude mówią, co odblokuje licencja. Szczegóły: Licencje.

Aktualizacja i usunięcie modułu

• Aktualizacja: wgraj nowy ZIP w Menedżerze modułów, tak samo jak za pierwszym razem. Ustawienia, historia i konektor w Claude zostają.
• Usunięcie: Menedżer modułów > TellMyShop > Odinstaluj. Adresy konektorów przestają działać, a konto pracownika Claude zostaje usunięte. Historia zmian, kopie plików, przekierowania i licencja domyślnie zostają; jeśli chcesz usunąć wszystko, przed odinstalowaniem odznacz Przy odinstalowaniu zachowaj historię, kopie i przekierowania w karcie Ustawienia: bezpieczeństwo, alarmy, limity. Odinstalowanie nie zwalnia domeny w licencji: najpierw kliknij Zwolnij domenę w karcie Licencja albo zwolnij ją w koncie. Zatwierdzone wcześniej zmiany zostają w sklepie.

Szczegóły techniczne

• Nazwa techniczna tellmyshop. Adres: https://twoj-sklep.pl/module/tellmyshop/mcp, token jako ?token=… albo Authorization: Bearer ….
• Tokeny: zapisywany jest tylko skrót SHA-256 i prefiks; pełny token widać raz; nowy token od razu unieważnia stary. Token testowy do sprawdzenia połączenia jest ważny 2 minuty. Token serwisowy domyślnie wygasa po 30 dniach (7–90).
• Token codzienny: rdzeń, blok 1 Treści i SEO, blok 2 Handel. Token serwisowy: dodatkowo bloki 3–5, tylko z IP z jego listy (domyślnie 160.79.104.0/21) i tylko przy włączonym którymś z bloków 3–5.
• Stan po instalacji: konektor wyłączony do kroku 3, tryb tylko do odczytu włączony, blok 1 włączony (bez grupy Obsługa klienta), Handel wyłączony, bloki 3–5 wyłączone, dostęp do danych klientów wyłączony, alarmy e-mail i podsumowanie dzienne włączone.
• Pracownik z kroku 2 jest nieaktywny; uprawnienia per zakładka panelu są nadawane przy włączeniu grupy albo bloku i zabierane przy wyłączeniu.
• Instalacja rejestruje hooki registerGDPRConsent, actionDeleteGDPRCustomer, actionExportGDPRData (psgdpr) i actionFrontControllerInitBefore (przekierowania i 301 bloga). Tworzy katalog prywatny var/tellmyshop/ na kopie i klucze; klucz szyfrowania to var/tellmyshop/keys/history.key. Pracownik i profil powstają później, po kliknięciu Utwórz konto Claude'a.
• Odinstalowanie zawsze usuwa tokeny i klucz podpisu, pracownika i profil utworzone przez moduł, skrypt awaryjny z jego kluczem oraz dziennik połączeń. Przy włączonym TELLMYSHOP_KEEP_ON_UNINSTALL (domyślnie) zostają historia zmian, kopie plików, przekierowania, dziennik audytu, katalog prywatny z kluczem, licencja i pozostałe ustawienia; po wyłączeniu usuwane są wszystkie tabele modułu, wszystkie ustawienia TELLMYSHOP_* i var/tellmyshop/. Odinstalowanie nie łączy się z serwerem licencji, więc domena zostaje aktywna, dopóki nie zwolnisz jej w karcie Licencja albo w koncie.
• Pełne szczegóły: Specyfikacja techniczna.

---

PrestaShop jest zastrzeżonym znakiem towarowym PrestaShop SA. Claude jest znakiem towarowym Anthropic. TellMyShop nie jest powiązany z żadną z tych firm.