Siedem konkretnych zadań, które asystent AI wykonuje przez serwer Shopware MCP, z przykładowym promptem, narzędziami, uprawnieniami i typowymi błędami.
Dzięki serwerowi Shopware MCP asystent AI, taki jak Claude lub ChatGPT, wykonuje prawdziwe zadania w sklepie: tworzy raporty, sprawdza stany magazynowe, wyszukuje klientów, księguje wysyłki, uzupełnia opisy produktów, dodaje artykuły i zmienia ustawienia. Od Shopware 6.7.14 serwer jest stałą częścią rdzenia i działa z uprawnieniami integracji, którą tworzą Państwo w panelu administracyjnym.
Każda akcja zmieniająca dane działa najpierw jako podgląd. Shopware nazywa to dry run: model pokazuje, co by zmienił, i zapisuje dopiero po drugim, potwierdzonym wywołaniu. Jedynym wyjątkiem jest przesyłanie zdjęć, które zapisuje od razu.
Korzyść zależy mniej od AI, a bardziej od dobrze zaprojektowanych ról. Kto dla każdego zadania tworzy osobną integrację z wąską listą dozwolonych narzędzi (allowlist), może korzystać z zadań tylko do odczytu od pierwszego dnia, a uprawnienia do zapisu udostępniać krok po kroku.
Ten artykuł jest skierowany do właścicieli sklepów, kierowników e-commerce i liderów zespołów obsługi klienta w Polsce, którzy prowadzą sklep na Shopware 6.7 i chcą wiedzieć, jaką pracę asystent AI może dziś konkretnie przejąć. Podstawy protokołu, klientów i konfiguracji wyjaśnia nasz artykuł Serwer MCP dla Shopware. Tutaj chodzi o praktykę: siedem zadań z przykładowym promptem, narzędziami w tle, potrzebnymi uprawnieniami i miejscami, w których warto zachować ostrożność.
Serwer MCP to interfejs w sklepie, przez który asystent AI odczytuje dane i po zatwierdzeniu je zmienia. Działa pod adresem /api/_mcp i korzysta z Admin API, czyli interfejsu administracyjnego Shopware. Shopware wprowadził go w wersji 6.7.11 za feature flagiem, od 6.7.14 jest zawsze aktywny. Wersja 6.7.16 z listopada 2026 r. przynosi według release notes m.in. lepszą obsługę dużych odpowiedzi narzędzi. Do Shopware 6.8 serwer ma status eksperymentalny, więc nazwy narzędzi mogą się jeszcze zmienić.
Shopware nie dostarcza specjalnych poleceń typu „raport dzienny” czy „wyszukaj klienta”. Są narzędzia ogólne, które działają z każdą encją, czyli każdym typem danych, takim jak produkt, zamówienie czy klient:
shopware-entity-search wyszukuje rekordy, shopware-entity-read odczytuje pojedynczy rekord, shopware-entity-schema pokazuje pola encji.shopware-entity-aggregate liczy sumy, średnie, zliczenia i przebiegi bezpośrednio w Shopware, bez przesyłania wierszy.shopware-entity-upsert tworzy lub zmienia, shopware-entity-delete usuwa, oba domyślnie jako podgląd.shopware-order-state zmienia status zamówienia, płatności i dostawy, shopware-media-upload wgrywa zdjęcia z adresu URL, shopware-system-config-read i shopware-system-config-write odczytują i zmieniają ustawienia, shopware-theme-config zmienia motyw.Do tego dochodzą zasoby (resources) z danymi referencyjnymi, takie jak shopware://sales-channels, shopware://currencies czy shopware://state-machines. Z nich model odczytuje np., jakie zmiany statusu są dozwolone dla zamówienia.
MCP jest zbudowany do dialogu. Shopware ogranicza wywołania endpointu administracyjnego do 300 na minutę i 1 000 na dziesięć minut. Do importu 20 000 cen właściwą drogą pozostaje Sync API przez Shopware Admin API. Także procesy działające w nocy bez udziału ludzi należą do interfejsu lub workflow, a nie do czatu.
Najczęstsze zadanie jest jednocześnie najbezpieczniejsze: odczyt liczb. W wielu sklepach oznacza to dziś eksport zamówień, filtrowanie w Excelu i budowę tabeli przestawnej. Z MCP zadają Państwo pytanie bezpośrednio.
Przykładowy prompt: „Jaki był wczoraj obrót w każdym kanale sprzedaży, ile było zamówień i jaka była średnia wartość koszyka? Porównaj z tym samym dniem tygodnia w poprzednim tygodniu”.
Model odczytuje kanały sprzedaży z zasobu, wywołuje shopware-entity-aggregate na encji order i liczy sumę i średnią amountTotal oraz liczbę zamówień, z filtrem według daty. Do porównania tygodniowego dochodzi drugie wywołanie. Shopware zwraca tylko wyniki, a nie pojedyncze zamówienia. Dzięki temu odpowiedź jest mała, a dane klientów chronione.
Integracja potrzebuje tylko uprawnień do odczytu zamówień i kanałów sprzedaży. Na allowliście wystarczą shopware-entity-schema, shopware-entity-search i shopware-entity-aggregate. Narzędzi zapisujących nie ma wcale.
Kto sam magazynuje towar, traci obrót przez puste półki, a kapitał przez pełne. Asystent AI nie zastąpi systemu magazynowego, ale w kilka sekund poda listę, którą inaczej ktoś musi przefiltrować i posortować.
Przykładowy prompt: „Pokaż wszystkie aktywne produkty ze stanem poniżej 10, posortowane według sprzedanej ilości z ostatnich 30 dni. Oszacuj dla każdego produktu, na ile dni wystarczy stan”.
Model wyszukuje przez shopware-entity-search produkty z filtrami active i stock mniejszym niż 10. Sprzedaną ilość ustala przez agregację na pozycjach zamówień. Zasięg zapasu model liczy sam: stan podzielony przez średnią dzienną sprzedaż. Warto rozumieć to wyliczenie, bo nie pochodzi z Shopware.
Wystarczą uprawnienia do odczytu produktów i zamówień. Jeśli model ma też korygować stan po dostawie, dochodzi shopware-entity-upsert z uprawnieniem do zmiany produktów. W praktyce wydzielamy to do osobnej integracji dla magazynu.
W obsłudze klienta czas zabiera nie sama odpowiedź, tylko zbieranie informacji: znalezienie konta klienta, otwarcie zamówienia, sprawdzenie statusu płatności, skopiowanie numeru przesyłki. Właśnie to przejmuje asystent.
Przykładowy prompt: „Znajdź klientkę z numerem zamówienia 10482. Podsumuj jej trzy ostatnie zamówienia z datą, pozycjami, statusem płatności, statusem dostawy i numerem przesyłki”.
Model wyszukuje zamówienie przez shopware-entity-search, odczytuje je przez shopware-entity-read wraz z pozycjami, płatnościami i dostawami, a następnie szuka kolejnych zamówień tego samego klienta. Z wyniku pisze krótkie podsumowanie, na podstawie którego odpowiada Państwa zespół.
Uprawnienia do odczytu zamówienia, klienta i dostawy oraz trzy narzędzia do odczytu. Shopware wprost zaleca w tym przypadku integrację tylko do odczytu. Powodem jest prompt injection: notatki do zamówień, nazwiska klientów czy linie adresu pochodzą od klientów i mogą zawierać tekst, który ma nakłonić model do innych działań. Uprawnienia ograniczają szkody, ale nie zapobiegają manipulacji.
Od tego momentu asystent zmienia dane. Zadanie nadaje się mimo to na wczesny start, bo narzędzie shopware-order-state zna tylko zmiany statusu, na które Shopware i tak pozwala.
Przykładowy prompt: „Ustaw dostawę zamówień od 10501 do 10512 na wysłane. Najpierw pokaż mi listę z aktualnym statusem”.
Model odczytuje dozwolone przejścia z shopware://state-machines i wywołuje shopware-order-state z deliveryAction: ship, najpierw z dryRun=true. Widzą Państwo, które zamówienia i jak by się zmieniły. Dopiero po potwierdzeniu następuje to samo wywołanie z dryRun=false. Jedno wywołanie może zmienić jednocześnie status zamówienia, płatności i dostawy, np. przy anulowaniu ze zwrotem pieniędzy.
Rola potrzebuje order:read i, zależnie od akcji, uprawnień do zmiany zamówienia, płatności lub dostawy. Kto może tylko księgować wysyłki, dostaje tylko order_delivery:update. Wtedy anulowanie zostanie zablokowane już przez uprawnienia, a nie dopiero przez uważność człowieka.
W prawie każdym katalogu brakuje opisów w drugim języku, meta tytuły są puste lub zduplikowane, właściwości niekompletne. Model językowy dobrze wypełnia takie luki, jeśli dostanie jasne wytyczne.
Przykładowy prompt: „Znajdź wszystkie aktywne produkty z kategorii Meble ogrodowe bez meta tytułu. Zaproponuj dla pierwszych 20 meta tytuł po polsku o długości maksymalnie 60 znaków, według wzoru: nazwa produktu, najważniejsza cecha, marka. Pokaż propozycje jako tabelę, jeszcze niczego nie zapisuj”.
Model wyszukuje produkty, odczytuje nazwę, właściwości i opis i formułuje propozycje. Po Państwa przeglądzie wywołuje shopware-entity-upsert, najpierw jako podgląd ze starymi i nowymi wartościami, potem z potwierdzeniem. Przy tłumaczeniach podają Państwo język docelowy. Model zapisuje wtedy w tłumaczeniu danego języka.
Uprawnienia do odczytu i zmiany produktów, bez uprawnień do zamówień i klientów. Na allowliście są narzędzia do odczytu i shopware-entity-upsert, ale nie shopware-entity-delete.
Nowy towar przychodzi często jako tabela od dostawcy: numer artykułu, nazwa, cena zakupu, sugerowana cena sprzedaży, URL zdjęcia. Dodanie w panelu administracyjnym zajmuje kilka minut na artykuł. Przy kilku artykułach interfejs importu się nie opłaca, ale przy 15 artykułach tygodniowo opłaca się asystent.
Przykładowy prompt: „Dodaj te osiem artykułów jako nieaktywne produkty: nazwa, numer produktu, stan 0, producent Gartenwerk, stawka VAT 23 %, cena brutto według tabeli. Najpierw pokaż mi podgląd. Potem wgraj zdjęcie z kolumny URL zdjęcia jako zdjęcie główne”.
Shopware wewnętrznie pracuje na identyfikatorach. Model najpierw szuka więc ID stawki podatkowej i producenta, odczytuje walutę z shopware://currencies i dopiero potem buduje wywołanie shopware-entity-upsert. Podgląd pokazuje każdy artykuł ze wszystkimi polami. Po zatwierdzeniu shopware-media-upload wgrywa zdjęcia i ustawia je jako zdjęcia główne.
Tworzenie i zmiana produktów, odczyt stawek podatkowych, producentów i walut oraz media:create do wgrywania. Ponieważ wgrywanie zapisuje bez podglądu, narzędzie do mediów dostaje tylko ta integracja.
Ustawienia systemowe Shopware są rozbudowane i rozproszone. Kto chce wiedzieć, ile produktów pokazuje strona kategorii albo jakie sortowanie jest domyślne, przeklikuje się przez kilka menu. Asystent odczytuje to w jednym kroku.
Przykładowy prompt: „Jakie ustawienia obowiązują dla list produktów w kanale sprzedaży Storefront PL? Zmień domyślne sortowanie na cenę rosnąco, ale najpierw pokaż, co się zmieni”.
shopware-system-config-read odczytuje wszystkie wartości pod kluczem core.listing, na życzenie dla konkretnego kanału sprzedaży. Przy zmianie shopware-system-config-write pokazuje w trybie dry run porównanie przed i po. Po potwierdzeniu zapisuje nową wartość. Do logo i kolorów służy shopware-theme-config, również z podglądem.
system_config:read do odczytu, system_config:update do zmian. Te uprawnienia powinny trafić do integracji dla osoby, która już dziś zarządza ustawieniami, zwykle kierownictwa sklepu lub agencji opiekującej się sklepem.
Najważniejsza decyzja zapada przed pierwszym promptem: która integracja może co? Shopware zaleca jedną integrację na zadanie lub rolę w zespole. Tabela pokazuje, jak dzielimy siedem zadań w projektach.
| Zadanie | Integracja | Narzędzia na allowliście | Zapisuje dane |
|---|---|---|---|
| 1 Raport dzienny | Analityka | schema, search, aggregate | nie |
| 2 Stany magazynowe | Analityka lub magazyn | schema, search, aggregate, w magazynie upsert | tylko magazyn |
| 3 Obsługa klienta | Obsługa, odczyt | schema, search, read | nie |
| 4 Wysyłka i anulowanie | Obsługa, statusy | search, read, order-state | tak, z podglądem |
| 5 Opisy produktów | Katalog | schema, search, read, upsert | tak, z podglądem |
| 6 Nowe artykuły | Katalog | schema, search, read, upsert, media-upload | tak, zdjęcia bez podglądu |
| 7 Ustawienia | Kierownictwo sklepu | system-config-read, system-config-write | tak, z podglądem |
Trzy narzędzia discovery, za pomocą których klient znajduje kolejne narzędzia i aktywuje toolsety, trafiają na każdą allowlistę. Ważne: aktywacja toolsetu nie nadaje uprawnień. Granicą pozostaje allowlist integracji. Dostęp MCP nigdy nie powinien być powiązany z kontem administratora, bo administratorzy omijają allowlist dla użytkowników.
Hipotetyczny przykład z wartościami z doświadczenia: sprzedawca z 1 500 zamówieniami miesięcznie przygotowuje w każdy poniedziałek raport tygodniowy. Dziś zajmuje to 60 minut, z asystentem 10. Dział obsługi klienta obsługuje 400 zapytań miesięcznie i oszczędza na zbieraniu informacji ok. 2 minuty na zapytanie. Razem to ponad 3 godziny na raportach i ponad 13 godzin w obsłudze klienta, czyli ok. 17 godzin miesięcznie.
Po drugiej stronie są konfiguracja z rolami, allowlistami, szablonami promptów i szkoleniem, która według naszego doświadczenia kosztuje od 6 600 do 22 000 zł netto, oraz bieżące koszty klientów AI, według dostawców ok. 20 USD na użytkownika miesięcznie za Claude Pro lub ChatGPT Plus. Przy wewnętrznej stawce godzinowej 40 € konfiguracja w dolnym zakresie zwraca się po dwóch do trzech miesiącach. W małym sklepie ze 100 zamówieniami miesięcznie opłaca się przede wszystkim część tylko do odczytu, która prawie nie wymaga konfiguracji.
Siedem zadań działa, ale nie bez nadzoru. Te ograniczenia widzimy w praktyce najczęściej.
Dla danych klientów przekazywanych do Claude lub ChatGPT potrzebna jest umowa powierzenia przetwarzania danych zgodnie z art. 28 RODO, a przy dostawcach spoza UE dodatkowo podstawa przekazania danych. Organem nadzorczym jest Prezes UODO. Jeśli rejestr audytu przypisuje zmiany konkretnym pracownikom, warto wcześnie sprawdzić z działem HR lub prawnikiem, jakie obowiązki wynikają z prawa pracy w zakresie monitorowania pracowników, i poinformować zespół. Przy dodawaniu produktów model potrzebuje polskich stawek VAT: 23 %, 8 % i 5 %, które muszą być zapisane w Shopware jako reguły podatkowe.
Dla sprzedawców, którzy nie chcą utrzymywać własnych ról i promptów, są alternatywy. Shopware Copilot w panelu administracyjnym korzysta z tego samego endpointu MCP z uprawnieniami zalogowanego użytkownika i pyta przed zmianami, a jego funkcje agentowe są częścią dodatkowej subskrypcji Intelligence+. Eksperymentalny pakiet SwagMcpMerchantTools zawiera gotowe narzędzia, takie jak merchant-revenue-report czy merchant-customer-lookup, ale Shopware zastrzega sobie możliwość jego wycofania na rzecz Copilota. Jakie funkcje AI oferuje Shopware w ogóle, porządkuje nasz artykuł Shopware AI.
Nie. Od Shopware 6.7.14 serwer MCP jest częścią rdzenia i zawsze aktywny. Tworzą Państwo integrację z rolą i allowlistą i łączą klienta, takiego jak Claude lub ChatGPT. Wtyczki, takie jak AI Connect, uzupełniają widoki podglądu, dziennik audytu i gotowe konfiguracje.
Tylko jeśli Państwo na to pozwolą. Wszystkie narzędzia zapisujące poza wgrywaniem zdjęć działają domyślnie jako podgląd, a klienci tacy jak Claude i ChatGPT przedstawiają wywołania narzędzi do zatwierdzenia. Kto wyłączy oba mechanizmy, oddaje kontrolę.
Raport dzienny. Wymaga tylko uprawnień do odczytu, przynosi korzyść od pierwszego dnia i szybko pokazuje, jak dokładnie model pracuje z Państwa danymi.
W wersji 6.6 brakuje natywnego serwera MCP. Możliwy jest osobny serwer MCP komunikujący się przez Admin API. Zwykle zalecamy aktualizację do 6.7, bo osobny serwer staje się po niej zbędny.
Sam serwer nic nie kosztuje. Na bieżąco ponoszą Państwo koszty klientów AI. Konfiguracja z rolami, allowlistami i szkoleniem kosztuje według naszego doświadczenia od 6 600 do 22 000 zł netto.
Chcą Państwo wiedzieć, które z siedmiu zadań przyniesie w Państwa sklepie największą korzyść? Sprawdzamy wersję Shopware, proponujemy integracje z odpowiednimi rolami i allowlistami i razem z zespołem przygotowujemy pierwsze szablony promptów, także po polsku. Ofertę kierujemy również do sprzedawców w Polsce, współpraca odbywa się zdalnie. Do podglądu i dziennika audytu używamy naszej wtyczki AI Connect.
Zapraszamy do kontaktu przez formularz kontaktowy. Jeśli najpierw chcą Państwo wiedzieć, w jakim punkcie jest dziś sklep, pomoże nasza bezpłatna analiza sklepu.

Besnik Bilalli jest założycielem i CEO solution25, agencji Shopware z siedzibą w Bremie. Przed założeniem agencji w 2017 roku sam zbudował sklep internetowy i rozwinął go do ponad 500 zamówień dziennie. Od tego czasu wspiera sprzedawców w projektach Shopware, od pierwszej kalkulacji po bieżące utrzymanie. Na pytania dotyczące artykułu chętnie odpowie osobiście: kontakt.
Odpowiedzialny za treść i aktualizację: Besnik Bilalli. Stan: listopad 2026. Następna weryfikacja treści: luty 2027.