Czego Państwo potrzebują
- Sklepu Shopware w wersji 6.7.11 lub nowszej (6.7.x).
- Wtyczki Shopware Solution25 MCP Workflows w wersji 1.9.1 lub nowszej: [LINK DO POBRANIA / SHOPWARE STORE].
- Konta administratora w tym sklepie.
- Klienta AI, który obsługuje zdalne konektory MCP:
- Claude (claude.ai, aplikacja desktopowa, mobilna, Claude Code);
- ChatGPT;
- aplikacji Gemini (obecnie dla prywatnych kont Google w USA, w języku angielskim);
- lub Gemini CLI.
Krok 1: instalacja wtyczki
- W Shopware proszę otworzyć Rozszerzenia > Moje rozszerzenia.
- Proszę przesłać lub zainstalować Solution25 MCP Workflows i aktywować wtyczkę.
- Podczas aktywacji włączany jest serwer MCP Shopware i przygotowywana jest rola dla klientów AI.
Wtyczka dodaje w Ustawienia > System trzy strony:
- MCP Connector: łączenie klientów AI i zarządzanie nimi.
- MCP Protokół: każda akcja klienta AI w Państwa sklepie.
- MCP Storefront: opcjonalna wyszukiwarka AI i czat w sklepie.
Krok 2: dodanie konektora w kliencie AI
Adres konektora to:
[https://mcp.solution25.com/shopware]
- Claude (web, desktop, mobile): Proszę otworzyć Ustawienia > Konektory.
- Gdy konektor będzie dostępny w katalogu: Przeglądaj konektory, następnie Solution25 for Shopware, następnie Połącz.
- Do tego czasu: wybrać Dodaj własny konektor i wkleić adres.
- Claude Code: Proszę uruchomić następujące polecenie:
claude mcp add --transport http solution25-shopware [https://mcp.solution25.com/shopware]
Następnie należy zalogować się poleceniem /mcp.
- ChatGPT: Proszę dodać własny konektor (aplikację) z powyższym adresem. [SPRAWDZIĆ AKTUALNĄ ŚCIEŻKĘ MENU I OBSŁUGIWANE PLANY.]
- Aplikacja Gemini: Proszę otworzyć Ustawienia > Połączone aplikacje > Dodaj własną aplikację i wkleić adres.
- Gemini CLI: Proszę uzupełnić plik
~/.gemini/settings.json o poniższy wpis; Gemini CLI sam otworzy stronę logowania:
{ "mcpServers": { "shopware": { "httpUrl": "[https://mcp.solution25.com/shopware]" } } }
Krok 3: określenie, co może klient AI
Klient AI otwiera naszą stronę logowania. Wyświetla ona:
- Jednorazowy kod połączenia, ważny 30 minut.
- Uprawnienia: Dla każdego obszaru (Products, Categories, Manufacturers, Media, Reviews, Orders, Customers) wybierają Państwo View, Edit, Create lub Delete (podgląd, edycja, tworzenie, usuwanie).
- Gotowe zestawy:
- Read only (tylko odczyt, domyślnie);
- Catalogue editor (edycja katalogu);
- Order management (obsługa zamówień);
- Everything (wszystko).
Proszę pozostawić stronę otwartą.
Krok 4: potwierdzenie połączenia w Shopware
- W Shopware proszę otworzyć Ustawienia > System > MCP Connector.
- Proszę wkleić kod połączenia. Strona pokaże:
- który klient AI prosi o dostęp;
- czy jego domena jest zweryfikowana;
- dokąd wraca logowanie;
- o jakie uprawnienia prosi.
- Proszę sprawdzić, czy to Państwa własne żądanie, i kliknąć Połącz.
Klient AI sam kończy logowanie. Mogą Państwo nadać tylko te uprawnienia, które sami posiadają.
Korzystanie
Kilka przykładów do wypróbowania:
- „Które produkty są wyprzedane albo się kończą?”
- „Pokaż dzisiejsze zamówienia i wszystko, co utknęło.”
- „Ustaw cenę SW10011 na 24,90 i stan magazynowy na 50.” (Najpierw zobaczą Państwo podgląd.)
- „Znajdź opinie oczekujące na zatwierdzenie.”
- „Pokaż sprzedaż z tego tygodnia w porównaniu z poprzednim.”
Gotowe polecenia: Daily report (raport dzienny), Weekly sales (sprzedaż tygodniowa) i Connect another shop (połącz kolejny sklep). W Claude, ChatGPT i innych klientach, które to obsługują, karta sklepu w czacie pokazuje połączone sklepy i ma przycisk Add another shop.
Co potrafi klient AI
To, które z tych narzędzi otrzyma klient AI, zależy od nadanych uprawnień.
| Obszar |
Narzędzia |
| Sklepy |
Wyświetlanie połączonych sklepów, łączenie kolejnego sklepu, test połączenia (ping) |
| Produkty |
Wyszukiwanie produktów; tworzenie produktów; zmiana nazwy, ceny, stanu magazynowego, statusu lub opisu; dodawanie zdjęć z adresów internetowych |
| Kategorie i producenci |
Wyszukiwanie kategorii; przypisywanie produktów do kategorii lub usuwanie z nich; wyszukiwanie producentów; tworzenie producentów |
| Opinie |
Wyszukiwanie opinii; publikowanie lub ukrywanie i dodawanie odpowiedzi |
| Zamówienia i klienci |
Wyszukiwanie zamówień, szczegóły zamówienia, raport sprzedaży, wyszukiwanie klientów, szczegóły klienta |
| Procesy sklepu (wtyczka) |
Codzienny przegląd sklepu, raport ryzyka braków magazynowych, kontrola i korekta jakości katalogu, raport problemów z zamówieniami, plan rozwiązania problemów z zamówieniami i jego realizacja, diagnostyka |
Jak zmiany pozostają bezpieczne
- Najpierw podgląd: Każda zmiana jest najpierw podglądem. W sklepie nic się nie zmienia, dopóki Państwo nie wyrażą zgody, a klient AI nie potwierdzi zmiany jednorazowym tokenem ważnym 15 minut.
- Ponowna kontrola: Jeśli sklep zmienił się od momentu podglądu, zmiana zostaje odrzucona i potrzebny jest nowy podgląd.
- Rejestrowane: Każda akcja jest widoczna w Ustawienia > System > MCP Protokół.
- Ograniczone: Klient AI widzi tylko narzędzia, na które pozwalają jego uprawnienia, a system uprawnień Shopware dodatkowo sprawdza każde wywołanie.
Kilka sklepów
Jedno logowanie może obejmować do 10 sklepów.
- Mogą Państwo poprosić klienta AI o połączenie kolejnego sklepu albo użyć przycisku Add another shop na karcie sklepu. Otrzymają Państwo jednorazowy link ważny 60 minut.
- Proszę otworzyć link, wybrać uprawnienia i wkleić kod w drugim sklepie w Ustawienia > System > MCP Connector.
Zmiana uprawnień lub rozłączenie
- Zmiana uprawnień: W Shopware w Ustawienia > System > MCP Connector proszę kliknąć przy połączeniu Zmień uprawnienia.
- Rozłączenie: Proszę kliknąć Rozłącz. Połączenie zostanie wtedy usunięte również na naszym serwerze.
- W kliencie AI: Konektor można też usunąć bezpośrednio tam.
- Czas trwania logowania: Logowanie jest ważne maksymalnie 90 dni. Potem klient AI poprosi o ponowne zalogowanie.
Rozwiązywanie problemów
| Problem |
Rozwiązanie |
| „Ten kod jest nieznany, został już użyty lub wygasł” |
Kody są ważne 30 minut i tylko raz. Proszę ponownie rozpocząć łączenie w kliencie AI. |
| Brakuje narzędzia |
Połączenie nie ma tego uprawnienia. Proszę kliknąć w Shopware Zmień uprawnienia i rozpocząć nowy czat. |
| Serwer konektora nie może połączyć się ze sklepem |
Sklep potrzebuje publicznego adresu HTTPS. Jeśli różni się on od głównego adresu sklepu, proszę wpisać go w Ustawienia > System > MCP Connector. Musi to być jedna z domen należących do sklepu. |
| „Automatyczna rejestracja nie powiodła się” (Gemini) |
Proszę sprawdzić, czy użyto pełnego adresu z /shopware na końcu. |
Ochrona danych i bezpieczeństwo
- Co przechowujemy: Nasz serwer przechowuje tylko to, czego potrzebuje do połączenia. Klucze dostępu są szyfrowane, a kody i tokeny przechowujemy wyłącznie jako hash.
- Czego nie przechowujemy: Dane sklepu, takie jak produkty, zamówienia i klienci, są na Państwa żądanie przekazywane do klienta AI i nie są u nas zapisywane.
- Szczegóły: w naszej polityce prywatności: Polityka prywatności Solution25 for Shopware.
Wsparcie
info@solution25.com · Strona kontaktowa · +49 421 438 1919-0