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 nowszy, także 9. Wersja 8.0 nie jest obsługiwana.
• PHP 8.1 lub nowszego. Jeśli nie wiesz, jaką masz wersję, zapytaj hosting.
• Adresu sklepu zaczynającego się od https://.
• Konta Claude. Wystarczy darmowe.
• Dostępu do panelu sklepu z prawem instalowania modułów.

Konto PrestaShop Account nie jest potrzebne.

Krok 1: Wgraj moduł

1. Pobierz plik ZIP ze swojego konta: Konto > Pliki do pobrania.
2. W panelu otwórz Moduły > Menedżer modułów.
3. Kliknij Załaduj moduł i upuść plik ZIP.
4. Gdy zobaczysz komunikat o instalacji, kliknij Konfiguruj.

Do ustawień modułu wrócisz później tą samą drogą: Moduły > Menedżer modułów, wyszukaj na liście „TellMyShop” i kliknij Konfiguruj.

Jeśli wgrywanie się nie udaje, zajrzyj do pytań i odpowiedzi.

Krok 2: Załóż osobnego pracownika 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. Otwórz Parametry zaawansowane > Zespół > Profile i dodaj profil „Claude”.

2. Otwórz Parametry zaawansowane > Zespół > Uprawnienia, wybierz „Claude” i zaznacz, co Claude może oglądać i edytować, np. Katalog i Strony.

3. Otwórz Parametry zaawansowane > Zespół > Pracownicy i dodaj pracownika, np. „Claude MCP”, z profilem „Claude”.

4. W ustawieniach TellMyShop wybierz tego pracownika jako pracownika konektora.

Jeśli brakuje jakiegoś uprawnienia, Claude powie o tym w pierwszej rozmowie.

Krok 3: Utwórz adres konektora

1. W ustawieniach TellMyShop kliknij Wygeneruj token przy konektorze codziennym.
2. Skopiuj adres konektora, który się pojawi. 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.
4. Kliknij Test połączenia, żeby sprawdzić, czy sklep odpowiada.

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

Krok 4 (opcjonalny): Drugi konektor do zmian wyglądu sklepu

Zmiany w plikach motywu są ryzykowne, więc działają tylko przez osobny konektor serwisowy. Działa tylko z zatwierdzonych adresów internetowych (adresów IP). Potrzebujesz go tylko wtedy, gdy ty albo twój developer chcecie, żeby Claude zmieniał wygląd sklepu.

1. Wygeneruj token dla konektora serwisowego.
2. Sprawdź listę dozwolonych adresów IP. Domyślnie jest na niej zakres adresów Anthropic, z którego łączy się Claude.ai.
3. Włącz blok Wygląd i wdrożenia. Po instalacji jest wyłączony, tak jak bloki Moduły i Tryb serwisowy, które też działają tylko przez konektor serwisowy. Tryb serwisowy włączasz na 1, 4, 8 albo 24 godziny.
4. Dodaj konektor serwisowy w Claude jako drugi, osobny konektor.

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

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ć.

Napisz na przykład:

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

Gdy chcesz, żeby Claude wprowadzał zmiany:

1. W ustawieniach TellMyShop wyłącz Tryb tylko do odczytu.
2. Wybierz, co Claude może zmieniać. Treści i SEO są włączone. Ceny, promocje i stany magazynowe (blok Handel) są wyłączone, dopóki ich nie włączysz. Zobacz Co Claude może zrobić w twoim sklepie.

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. Wklej go w ustawieniach TellMyShop i kliknij Aktywuj.

Ekran licencji pojawi się w wersji modułu 0.4.0. Bez ważnej licencji moduł działa w trybie tylko do odczytu. Darmowa wersja Audit to tryb tylko do odczytu na stałe. Szczegóły: Licencje.

Aktualizacja i usunięcie modułu

• Aktualizacja: wgraj nowy ZIP w Menedżerze modułów, tak samo jak za pierwszym razem.
• Usunięcie: w Menedżerze modułów rozwiń menu obok przycisku Konfiguruj przy module i wybierz Odinstaluj.

Szczegóły techniczne

• 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. Token testowy za przyciskiem „Test połączenia” jest ważny 2 minuty.
• Token codzienny: rdzeń, Treści i SEO, Handel. Token serwisowy: dodatkowo bloki 3-5, tylko z IP z listy (domyślnie 160.79.104.0/21).
• Stan po instalacji: tryb tylko do odczytu włączony, Treści i SEO włączone, Handel wyłączony, bloki 3-5 wyłączone.
• Uprawnienia sprawdzane per zakładka i akcja panelu, np. AdminCartRules add/edit dla kodów rabatowych. Dokładna lista per narzędzie:.
• Co aktualizacja i odinstalowanie robią z historią zmian, kopiami i tokenami:.
• 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.