Połącz sklep z Claude

Sklep dodajesz do Claude raz, jako konektor. Potem otwierasz czat i piszesz, czego potrzebujesz, albo wybierasz gotowe zadanie z menu.

Zanim zaczniesz, przygotuj adres konektora z ustawień modułu. Wygląda tak: https://twojsklep.pl/module/tellmyshop/mcp?token=…. Jeśli go nie zapisałeś, wygeneruj nowy w karcie Start.

Czy potrzebuję płatnego Claude?

Nie. Wystarczy konto Claude, także darmowe. TellMyShop kupujesz raz i nie płacisz abonamentu.

Dodaj konektor w Claude.ai

  1. Zaloguj się na claude.ai.
  2. Otwórz Ustawienia > Konektory (Settings > Connectors).
  3. Kliknij Dodaj własny konektor (Add custom connector).
  4. Nazwa: np. „Mój sklep”.
  5. Adres (URL): wklej adres konektora.
  6. Kliknij Dodaj.
  7. Otwórz nowy czat i sprawdź, czy konektor jest włączony w menu narzędzi pod polem wiadomości.

Teraz napisz:

Połącz się z moim sklepem i powiedz, co możesz zrobić.

Claude odpowie wersją PrestaShop, językami i tym, co mu wolno. Zaraz po instalacji oznacza to: tylko czytanie.

Konektor działa też w aplikacji desktop i mobilnej Claude na tym samym koncie.

Gotowe zadania w menu Claude

TellMyShop dodaje do Claude 14 gotowych zadań, np. Przegląd sklepu i plan poprawek, Opisy i SEO produktów seriami albo Przygotuj Black Friday. Znajdziesz je w menu konektora w czacie („+” > twój sklep). Wybierasz zadanie, a Claude prowadzi sprawdzony plan: najpierw czyta, pokazuje ci plan, potem podgląd każdej zmiany. Pełna lista: Gotowe zadania. Wymienia je też karta Gotowe zadania w module.

Jeśli twoja aplikacja Claude nie pokazuje menu, po prostu napisz zwykłymi słowami, np. „Przejrzyj sklep i powiedz, co poprawić najpierw”. Claude pobierze ten sam plan narzędziem tylko do odczytu ps_get_ready_job.

Sprawdź połączenie

W karcie Start kliknij Sprawdź połączenie ponownie. Sklep wysyła do siebie to samo zapytanie, które wysyła Claude. Jeśli test się nie uda, zajrzyj do pytań i odpowiedzi.

Karta Start pokazuje też, kiedy Claude połączył się pierwszy raz.

Drugi konektor do prac technicznych

Zmiany wyglądu sklepu, modułów i plików sklepu działają tylko przez konektor serwisowy, który dodajesz w Claude jako drugi, osobny konektor. Użyj adresu serwisowego z ustawień modułu i nazwij go wyraźnie, np. „Mój sklep (serwis)”. Włączaj go w czacie tylko na czas prac technicznych, a do reszty używaj konektora codziennego.

Konektor serwisowy działa tylko z zatwierdzonych adresów IP (adresy Claude.ai są na liście domyślnie), tylko gdy włączony jest któryś z obszarów technicznych, i wygasa po 30 dniach. Gdy go tworzysz, dostajesz e-mail.

O co zapytać na początek

Wszystkie te polecenia tylko czytają:

Zrób audyt SEO produktów i podaj pięć najpilniejszych poprawek.

Które strony najczęściej zwracały „nie znaleziono” w tym miesiącu?

Dlaczego klienci nie widzą produktu ref:ABC-1 w jego kategorii?

Gdy poprosisz o zmianę, Claude pokaże podgląd ze starymi i nowymi wartościami. Odpisz „tak”, żeby zapisać, albo napisz, co poprawić. Podgląd jest ważny 30 minut.

Nie udostępniaj adresu

Adres konektora zawiera tajny klucz. Każdy, kto go ma, może użyć konektora. Nie wklejaj go w e-maile ani czaty. Jeśli wycieknie, wygeneruj nowy w ustawieniach modułu (stary od razu przestaje działać) i zaktualizuj konektor w Claude.

Praca w zespole

Sklep ma jeden adres konektora codziennego. Na koncie zespołowym Claude administrator może dodać go raz dla wszystkich; na kontach indywidualnych każda osoba dodaje ten sam adres u siebie. Wszystkie zmiany widać w sklepie jako zmiany konta Claude, a nie osoby, która je zatwierdziła. Gdy ktoś odchodzi z zespołu, wygeneruj nowy adres.

Szczegóły techniczne

Nagłówek zamiast tokenu w adresie. Token w adresie URL może trafić do logów serwera i proxy. Gdzie klient obsługuje nagłówki, użyj adresu bez ?token= i wysyłaj Authorization: Bearer <token>.

Claude Code

claude mcp add --transport http moj-sklep https://twojsklep.pl/module/tellmyshop/mcp \
  --header "Authorization: Bearer <token-codzienny>"

Sprawdzisz to przez claude mcp list. --scope project udostępni serwer przez .mcp.json (nie commituj tokenu), --scope user we wszystkich projektach. Jeśli ustawiłeś listę IP, dopisz IP komputera, na którym działa Claude Code.

Claude Desktop z lokalną konfiguracją (sklep na twoim komputerze albo za VPN). Edytuj claude_desktop_config.json (Ustawienia > Developer > Edit Config):

{
  "mcpServers": {
    "moj-sklep": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://twojsklep.local/module/tellmyshop/mcp",
               "--header", "Authorization: Bearer <token-codzienny>"]
    }
  }
}

Wymaga Node.js. Punkt dostępu nadal wymaga HTTPS; użyj zaufanego certyfikatu lokalnego (np. mkcert). Żądania bez nagłówka Origin (Claude Code, lokalne mostki, serwery Anthropic) są przyjmowane; żądanie z nagłówkiem Origin musi pochodzić z claude.ai albo claude.com.

Transport. Streamable HTTP, JSON-RPC; wersje protokołu 2026-07-28 oraz starsze 2025-11-25, 2025-06-18, 2025-03-26. Gotowe zadania to prompty MCP (prompts/list, prompts/get) oraz narzędzie rdzenia tylko do odczytu ps_get_ready_job, które zwraca ten sam plan klientom bez menu promptów.

Zasady punktu dostępu: włączony konektor; tylko HTTPS; blokada IP po 20 nieudanych próbach w 10 minut (z e-mailem do właściciela); opcjonalna lista IP dla obu konektorów; token serwisowy wymaga dodatkowo własnej listy (domyślnie 160.79.104.0/21) i aktywnego bloku 3–5; kontrola Origin jak wyżej; godzinowe limity wywołań i zapisów (do zmiany w ustawieniach). W 2.6.0 nie ma OAuth (Plan rozwoju). Jeden token na konektor; osobnych tokenów dla każdej osoby w 2.6.0 nie planujemy.

Więcej: Bezpieczeństwo, Rozwiązywanie problemów technicznych.

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

Aktualizacja: 2026-10-04