¶ Asystent AI - serwer MCP
Asystent AI w Hummerce, przez serwer MCP, łączy sztuczną inteligencję (np. Claude) bezpośrednio ze sklepem. Obsługa pisze polecenie zwykłym językiem - "pokaż zamówienia z ostatniego tygodnia, które czekają na płatność" - a asystent sam pobiera dane albo wprowadza zmiany, z uprawnieniami konta, którym jest połączony. To skraca zadania, które w panelu wymagają wielu kroków, do jednej rozmowy.
Stan na wersję Hummerce 2.34-2.35 (ostatnie zmiany w module: 2.35.63), aktualizacja 2026-10-07.
¶ Korzyści i zastosowania
- Obsługa zamówień - wyszukanie zamówień po statusie, kliencie, e-mailu lub numerze telefonu w dowolnym formacie; zmiana statusu, płatności i dostawy; notatka do zamówienia; edycja pozycji i adresów; wystawienie zamówienia za klienta.
- Obsługa klienta - jedno pytanie przeszukuje klientów, zamówienia, reklamacje i zwroty po e-mailu lub telefonie - szybka odpowiedź na telefon klienta bez szukania w kilku miejscach.
- Oferta dla klienta - wycena koszyka dla konkretnego klienta (z jego cenami i promocjami) i link, którym klient wczyta gotowy koszyk w sklepie.
- Raporty sprzedaży - podsumowanie sprzedaży za okres, bestsellery, najcenniejsi klienci, segmenty klientów, porzucone koszyki, prognoza wyczerpania stanów - bez eksportu do arkusza.
- Diagnoza "dlaczego" - dlaczego towar nie jest widoczny lub nie da się go kupić (asystent podaje wszystkie przyczyny naraz), skąd wzięła się cena dla danego klienta i które reguły cenowe mogą za nią odpowiadać.
- Zmiany w katalogu - edycja towarów, zmiany masowe po wzorcu symbolu, parametry, warianty, opisy kategorii, przypisanie do kategorii i widoków, zdjęcia, nowe towary.
- Ceny i promocje - ceny w cennikach, reguły cenowe, promocje koszykowe, kupony.
- Treści - audyt treści (np. kategorie bez opisu, strony niewidoczne), odczyt stron, bloków treści i canvasów.
- Kontrola zmian - kto, kiedy i co zmienił, na jednym obiekcie albo przekrojowo w całym sklepie.
- Wdrożenia i utrzymanie - odczyt i zmiana konfiguracji, lista modułów, stan wdrożenia sklepu, zadania cykliczne, czyszczenie cache, przenoszenie towarów, parametrów i konfiguratorów między sklepem testowym a produkcyjnym (z wcześniejszym sprawdzeniem, czego brakuje w sklepie docelowym), zmiana tekstów sklepu (komunikatów) oraz przegląd kont administratorów.
- Automatyzacje - ten sam serwer może obsługiwać narzędzia automatyzacji korzystające z MCP (np. agent AI w n8n) - np. codzienny raport sprzedaży albo wstępna obsługa zwrotów.
¶ Jak to wygląda
Zrzuty ze sklepu demonstracyjnego Hummerce (panel administracyjny).
¶ Przebieg polecenia
¶ Klucz API MCP na profilu administratora
¶ Historia zmian po operacji asystenta
¶ Zasady działania
- Asystent łączy się z adresem serwera MCP sklepu i przedstawia się kluczem API wygenerowanym na koncie administratora panelu.
- Każde polecenie asystent zamienia na wywołanie konkretnego narzędzia sklepu. Sklep przy każdym wywołaniu sprawdza, czy klucz jest ważny i czy konto ma uprawnienie wymagane przez to narzędzie - to samo, którego panel wymaga dla odpowiadającego mu ekranu.
- Asystent widzi tylko narzędzia, do których konto ma uprawnienia. Pracownik obsługi zamówień zobaczy kilkanaście narzędzi, administrator - wszystkie.
- Odmowa podaje nazwę brakującego uprawnienia - wiadomo, o co poprosić administratora. Nadane uprawnienie działa od razu, po odświeżeniu listy narzędzi w asystencie.
- Zmiany wprowadzone przez asystenta trafiają do historii zmian obiektu jak zmiany z panelu, z oznaczeniem, że przyszły zdalnie - widać, co zmienił asystent, a co człowiek.
- Operacje ryzykowne mają dodatkowe zabezpieczenie: usunięcie kategorii, metody płatności lub dostawy oraz elementu konfiguratora, a także zapis i import konfiguracji wymagają jawnego potwierdzenia w wywołaniu; import paczek towarów i plików parametrów oraz zmiana filtra kategorii wirtualnej domyślnie tylko pokazują, co by się zmieniło; usunięcie towaru to oznaczenie go jako usuniętego (jak w panelu) - można je cofnąć.
- Wycena koszyka dla klienta liczy ceny tym samym mechanizmem co koszyk w sklepie i niczego nie zapisuje.
- Od wersji 2.35.61 asystent, tworząc towary, kategorie, parametry, cenniki i komponenty konfiguratorów, pilnuje jednolitej postaci symboli (zapis camelCase, np.
kolorGlowny). Symbol w innej postaci odrzuca i podaje poprawną formę, bo symbole służą integracjom i szablonom, a ich różne warianty sklep traktuje jak osobne obiekty. Wyjątek dotyczy symbolu towaru będącego zewnętrznym kodem katalogowym (np. z ERP): zaczyna się od cyfry, dalej może zawierać litery, cyfry i znaki.,_,/,-(np.800.ABC.01) - taki kod przechodzi bez zmian, bo musi odpowiadać kodowi w systemie źródłowym. W kategoriach, parametrach, cennikach i komponentach kody zaczynające się od cyfry nie są dopuszczone. Zobacz też Unikalne symbole w sklepie. - Narzędzia modułów dodatkowych (np. Allegro, InPost Buy) pojawiają się tylko w sklepach, w których te moduły są włączone.
¶ Bezpieczeństwo klucza i konta
- Klucz per konto - każdy użytkownik panelu generuje klucz sam, na własnym profilu. Na profilach innych osób klucza nie widać - administrator nie wygeneruje klucza za kogoś.
- Jeden klucz na konto - wygenerowanie nowego klucza natychmiast unieważnia poprzedni.
- Klucz jest równoważny hasłu - kto go ma, działa w sklepie jako właściciel konta. Nie przesyłaj go mailem ani na czacie.
- Uprawnienia jak w panelu - zakres pracy asystenta wyznaczają role i uprawnienia konta (Konfiguracja -> Role, Konfiguracja -> Administratorzy, zobacz Uprawnienia administratorów). Nie ma uprawnień "tylko dla MCP" - nadając uprawnienie, nadajesz je też w panelu.
- Konto serwisowe - do automatyzacji zalecamy osobne konto z minimalnym zakresem uprawnień, wtedy w historii zmian widać jednoznacznie, co zrobiła automatyzacja.
- Konta klientów sklepu nie mają dostępu do narzędzi MCP, niezależnie od ustawień.
- Operacje zapisujące wymagają uprawnienia do zmian w danym obszarze. Szczególnej ostrożności wymagają: wysyłka e-maili (może pójść na dowolny adres), zmiany masowe towarów i cen oraz zapis i import konfiguracji lub paczek do sklepu produkcyjnego.
- Połączenie zabezpiecza wymóg HTTPS, limit liczby żądań na minutę i - zalecane - wygasanie kluczy po ustalonej liczbie dni.
- Wartości wrażliwe (np. hasła, tokeny) są maskowane w historii zmian - asystent nie odczyta ich z historii.
¶ Jak połączyć asystenta
Potrzebne są:
- sklep z uruchomionym serwerem MCP (patrz Wdrożenie),
- konto administratora panelu z rolą obejmującą zakres pracy asystenta,
- klucz API wygenerowany na tym koncie (profil konta, sekcja Klucz API MCP),
- adres serwera MCP sklepu - przekazujemy go przy uruchomieniu,
- asystent AI lub narzędzie obsługujące zdalne serwery MCP przez HTTP, z możliwością dodania własnego nagłówka z kluczem (np. Claude Code, Claude Desktop, agent AI w n8n). Asystenci, którzy łączą się z serwerami MCP wyłącznie przez logowanie OAuth, nie połączą się bezpośrednio.
Po połączeniu dobrym pierwszym poleceniem jest prośba o informacje o sklepie - potwierdza, że adres i klucz są poprawne.
¶ Wersja
- Serwer MCP działa od wersji 2.34 - w starszych wersjach nie występuje.
- Zalecamy wersję 2.35.55 lub nowszą - uprawnienia sprawdzane osobno dla każdego narzędzia, tak jak w panelu.
- Kontrola symboli przy tworzeniu obiektów - od wersji 2.35.61.
- Narzędzia komunikatów sklepu oraz eksportu i importu konfiguratora - od wersji 2.35.62.
- Narzędzia kont administratorów, sprawdzania gotowości przenoszenia danych i kopiowania zdjęć między towarami - od wersji 2.35.63.
- Ostatnie zmiany w module: wersja 2.35.63.
¶ Zależności
- Moduł uprawnień administratorów panelu - serwer MCP uruchamiamy zawsze razem z nim.
- Połączenie HTTPS sklepu.
- Narzędzia poszczególnych obszarów wymagają włączonych modułów tych obszarów (np. zwroty, kupony, Allegro, InPost Buy, zapisywanie koszyków dla linku do koszyka).
- Asystent AI i jego subskrypcja - po stronie sklepu, poza Hummerce.
¶ Wdrożenie
- Wymaga wdrożenia - serwer MCP nie włącza się sam po aktualizacji. Zakres:
- włączenie serwera MCP w konfiguracji sklepu i ustawienie zabezpieczeń (HTTPS, limit żądań, wygasanie kluczy),
- przygotowanie ról z zakresem pracy asystenta (np. obsługa zamówień, katalog, treści) i przypisanie ich osobom,
- pomoc w podłączeniu asystenta AI i test połączenia na koncie z ograniczonymi uprawnieniami,
- opcjonalnie: ustawienie parametrów zamówień tworzonych przez asystenta (np. oznaczenie źródła zamówienia).
- Minimalny szacowany czas:
- uruchomienie z jedną rolą i testem połączenia - od 2 h,
- z przygotowaniem kilku ról i podłączeniem zespołu - od 4 h.
- Czas konkretnego wdrożenia zależy od jego zakresu - wyceniamy go indywidualnie.
- Od czego zależy czas:
- wersja sklepu - starsze wydanie wymaga najpierw aktualizacji (wycena osobno),
- liczba ról i osób, które mają pracować z asystentem,
- to, czy sklep ma już włączony moduł uprawnień administratorów,
- dodatkowe prace, np. automatyzacje w n8n, szkolenie zespołu, własne narzędzia dla indywidualnych modułów sklepu (wycena osobno).
¶ Ograniczenia
- Asystent działa wyłącznie w granicach uprawnień konta - nie obejdzie ich, ale też nie odróżni polecenia błędnego od zamierzonego. Za zmiany odpowiada właściciel konta, którym asystent jest połączony.
- Serwer przyjmuje klucz tylko w nagłówku żądania - asystenci łączący się wyłącznie przez logowanie OAuth nie połączą się bezpośrednio.
- Jeden klucz na konto - kilka urządzeń lub asystentów na jednym koncie korzysta z tego samego klucza, a jego wymiana wymaga podmiany wszędzie.
- Diagnoza ceny wskazuje reguły, które mogą odpowiadać za cenę, ale nie wskazuje jednoznacznie, która reguła zadziałała.
- Nie wszystkie obszary panelu mają narzędzia - asystent nie obsłuży np. obszarów modułów indywidualnych sklepu, dopóki nie zostaną dla nich dodane narzędzia.
- Po nadaniu uprawnienia asystent zobaczy nowe narzędzia dopiero po odświeżeniu sesji.
- Jakość odpowiedzi i poprawność interpretacji poleceń zależą od asystenta AI i jego modelu - Hummerce odpowiada za dane i operacje po stronie sklepu, nie za działanie asystenta.
- Dane sklepu, w tym dane osobowe klientów, przekazywane asystentowi trafiają do dostawcy usługi AI. Nie weryfikujemy konfiguracji pod kątem zgodności z prawem - wybór dostawcy AI, umowa powierzenia danych i zasady RODO leżą po stronie sklepu.
¶ Potencjał rozwoju
- Logowanie asystenta przez OAuth, bez ręcznego kopiowania klucza.
- Kilka kluczy na jedno konto (osobny klucz dla każdego urządzenia lub automatyzacji).
- Narzędzia dla kolejnych modułów i integracji (np. ERP, kurierzy, reklamacje, program lojalnościowy).
- Gotowe zestawy ról dla typowych zadań (obsługa zamówień, katalog, treści, ceny) dostępne od razu po uruchomieniu.
- Raporty i automatyzacje oparte o asystenta (np. codzienne podsumowanie sprzedaży, alerty o niskich stanach).
¶ Najczęstsze pytania
Czy dane klientów, które widzi asystent, trafiają gdzieś na zewnątrz?
Tak. Dane sklepu, w tym dane osobowe klientów, przekazywane asystentowi trafiają do dostawcy usługi AI. Wybór dostawcy, umowa powierzenia danych i zgodność z RODO leżą po stronie sklepu.
Ile trwa uruchomienie asystenta AI w Hummerce?
Uruchomienie z jedną rolą i testem połączenia - od 2 h. Przygotowanie kilku ról i podłączenie całego zespołu - od 4 h.
Czy asystent może zrobić więcej, niż pozwala konto, którym się łączy?
Nie. Asystent działa dokładnie w granicach uprawnień konta, którym jest połączony - tych samych, co w panelu.
Czy widać, co zmienił asystent, a co pracownik?
Tak. Zmiany wprowadzone przez asystenta trafiają do historii zmian z oznaczeniem, że przyszły zdalnie.
Czy klienci sklepu mogą korzystać z asystenta AI?
Nie. Konta klientów sklepu nie mają dostępu do narzędzi MCP, niezależnie od ustawień.
Czy da się połączyć dowolnego asystenta AI?
Częściowo. Serwer MCP przyjmuje klucz w nagłówku żądania - działa z asystentami, które obsługują ten sposób logowania (np. Claude Code, Claude Desktop). Asystenci łączący się wyłącznie przez logowanie OAuth nie połączą się bezpośrednio.
¶ Powiązane
- Allegro - integracja bezpośrednia, REST API - inne sposoby połączenia sklepu z systemami zewnętrznymi.
- Uprawnienia administratorów - role i uprawnienia, z których korzysta też asystent AI.
- Na hummerce.com: Asystent AI (MCP).
Chcesz zobaczyć, jak asystent AI może pracować w Waszym sklepie? Umów bezpłatną prezentację.
¶ Szczegóły konfiguracji
¶ Dostęp w panelu
- Klucz API: Konfiguracja -> Administratorzy -> własny profil, sekcja Klucz API MCP (Wygeneruj klucz MCP, Wygeneruj ponownie).
- Uprawnienia: Konfiguracja -> Role oraz Konfiguracja -> Administratorzy - drzewo uprawnień i sekcja Zaawansowane.
- Konfiguracja w panelu: grupa Serwer MCP:
- Włącz serwer MCP,
- Wymagaj HTTPS - domyślnie włączone,
- Maksymalna liczba żądań na minutę,
- Domyślna ważność klucza MCP (dni),
- Włącz wygasanie kluczy MCP - zalecamy włączenie,
- Strategia rozpoznawania obiektów (symbol / ID) - domyślnie Tylko po symbolu (zalecane),
- Cechy zamówienia dla MCP - dodatkowe parametry zamówienia widoczne dla asystenta i przyjmowane przy tworzeniu zamówienia,
- Domyślne wartości cech zamówień MCP - wartości ustawiane na zamówieniach tworzonych przez asystenta,
- Ścieżka bazowa serwera MCP - ustawienie techniczne, nie zmieniaj bez potrzeby.
- Historia zmian: zmiany asystenta widoczne w historii obiektów w panelu jako zmiany zdalne.
¶ REST API i MCP
Serwer MCP jest niezależny od REST API sklepu - do integracji systemów (ERP, hurtownie) nadal służy REST API. Zaznaczenie pozycji menu w drzewie uprawnień roli daje pełny dostęp do obszaru (odczyt i zmiany); dostęp wyłącznie do odczytu nadaje się, wpisując uprawnienie ręcznie w sekcji Zaawansowane.
Grupy narzędzi dostępnych przez MCP:
| Obszar | Co można zrobić | Przykładowe narzędzia |
|---|---|---|
| Zamówienia | przegląd, status, pozycje i dane zamówienia; zmiana statusów, notatki, edycja, tworzenie | ec2_orders_recent, ec2_orders_status, ec2_orders_update_status, ec2_orders_add_note, ec2_orders_edit, ec2_orders_create |
| Klienci | dane klienta, historia zakupów, najcenniejsi i nowi klienci, segmentacja, szukanie po e-mailu i telefonie | ec2_customers_details, ec2_customers_order_history, ec2_customers_segment, ec2_search_by_email, ec2_search_by_phone |
| Zwroty | lista, szczegóły, zwroty zamówienia, zmiana statusu | ec2_returns_list, ec2_returns_get_by_order, ec2_returns_update_status |
| Sprzedaż i analizy | podsumowanie sprzedaży, bestsellery, porzucone koszyki, prognoza stanów | ec2_analytics_sales_summary, ec2_analytics_best_sellers, ec2_abandoned_carts, ec2_inventory_forecast |
| Koszyk | wycena koszyka dla klienta, zapis koszyka z linkiem dla klienta | ec2_cart_price_preview, ec2_cart_save_and_link |
| Diagnostyka | przyczyny niewidoczności towaru, pochodzenie ceny | ec2_diagnose_item_visibility, ec2_diagnose_price |
| Towary | wyszukiwanie, szczegóły, edycja, zmiany masowe, parametry, warianty, tworzenie, usuwanie | ec2_products_search, ec2_products_update, ec2_products_bulk_update, ec2_products_set_property, ec2_products_create |
| Kategorie | drzewo kategorii, opisy, tworzenie, przenoszenie, kategorie wirtualne i ich filtry | ec2_categories_list, ec2_category_description_set, ec2_category_move, ec2_virtual_category_criteria_set |
| Ceny i promocje | cenniki i ceny towarów, cena dla klienta, reguły cenowe, promocje, kupony | ec2_pricelist_entry_set, ec2_price_for_customer, ec2_price_rules_list, ec2_promotions_list, ec2_coupons_create |
| Magazyn | stan towaru, korekta stanu, raport niskich stanów, przegląd magazynu | ec2_inventory_check_stock, ec2_inventory_update_stock, ec2_inventory_low_stock_report, ec2_warehouse_stock_overview |
| Treści i zdjęcia | strony, bloki treści, canvasy, audyt treści, wgrywanie zdjęć | ec2_pages_list, ec2_content_audit, ec2_canvas_details, ec2_image_upload |
| Parametry i słowniki | parametry i ich lokacje, producenci, stawki VAT, waluty, jednostki, grupy towarowe, widoki, płatności, dostawy, konfiguratory produktów | ec2_property_create, ec2_property_location_add, ec2_producers_list, ec2_payment_methods, ec2_delivery_methods, ec2_combinations_get_slots |
| Wiadomości e-mail | wysłanie wiadomości oraz powiadomień o zamówieniu i dla klienta z szablonów sklepu | ec2_email_send, ec2_email_send_order_notification, ec2_email_send_customer_notification |
| Historia zmian | historia obiektu, wyszukiwanie zmian (kto, kiedy, co) | ec2_history_list, ec2_history_search |
| Konfiguracja i utrzymanie | ustawienia modułów, lista modułów, stan wdrożenia, zadania cykliczne, cache | ec2_config_get, ec2_config_set, ec2_modules_list, ec2_deployment_status, ec2_task_run, ec2_cache_clear |
| Przenoszenie danych | paczki towarów i pliki parametrów między sklepem testowym a produkcyjnym; cały zestaw komponentów konfiguratora jednym dokumentem (import bez potwierdzenia tylko raportuje, z potwierdzeniem zapisuje wszystko w jednej transakcji); sprawdzenie gotowości sklepu docelowego bez zapisu - sklep źródłowy wylicza, czego używa zestaw towarów (typy komponentów i ich parametry, definicje parametrów, kategorie z kryteriów, towary, stawki VAT, jednostki, widoki, języki, pliki zdjęć, liczbę pozycji cennika), a docelowy raportuje braki; kopiowanie zdjęć i plików parametrów z jednego towaru na inne (bez potwierdzenia tylko raport, który wskazuje wartości z brakującym plikiem) | ec2_item_bundle_export, ec2_item_bundle_import, ec2_changeset_plan, ec2_combination_export, ec2_combination_import, ec2_transfer_readiness, ec2_item_media_copy |
| Komunikaty sklepu | odczyt i zapis nadpisań tekstów sklepu, jak ekran Treść -> Komunikaty; zapis wsadowy listą i usuwanie nadpisania (powrót do tekstu fabrycznego) | ec2_messages_get, ec2_messages_set, ec2_messages_delete |
| Konta administratorów | lista kont z rolami, datą ostatniego logowania i informacją o zamkniętym logowaniu hasłem; właściwości kont. Narzędzia nie zmieniają haseł, kluczy MCP, ustawień dwuskładnikowych, ról ani uprawnień, a właściwości chronione (np. data logowania) są tylko do odczytu; flagę wyłączenia logowania zmienia wyłącznie rola admin |
ec2_users_list, ec2_users_get_properties, ec2_users_set_property, ec2_users_delete_property |
| Integracje | stan integracji i oferty Allegro, stan InPost Buy - gdy moduł jest włączony w sklepie | ec2_allegro_status, ec2_allegro_offers, ec2_inpostbuy_status |
| Informacje o systemie | wersja i dane sklepu, przewodnik konfiguracji, bieżąca data | ec2_system_info, ec2_setup_guide, ec2_utils_now |
Pełną, aktualną listę narzędzi dostępnych dla danego konta zawsze podaje sam serwer.
Uprawnienia wymagane przez poszczególne narzędzia (do wpisania ręcznie w sekcji Zaawansowane, gdy potrzebny jest dostęp tylko do odczytu):
| Zakres pracy | Uprawnienie |
|---|---|
| przegląd zamówień / zmiany / nowe zamówienia | order:view / order:update / order:create |
| klienci, wyszukiwanie po e-mailu i telefonie, segmenty | customer:view |
| porzucone koszyki | purchaseBaskets:view lub customerCart:view |
| wycena i zapis koszyka dla klienta | customerCart:view / customerCart:update |
| zwroty - odczyt / zmiana statusu | return:view / return:update (lub ro_reclamation:...) |
| towary - odczyt i diagnoza widoczności / zmiany / nowe | item:view / item:update / item:create |
| kategorie i kategorie wirtualne | category:view, category:create, category:update, category:move |
| cenniki - lista / ceny towarów, cena dla klienta, diagnoza ceny | priceList:view / priceListEntry:view, priceListEntry:update |
| reguły cenowe | itemPriceRule:..., customerPriceRule:... lub cartPromotion:... |
| promocje / kupony | cartPromotion:view / coupons:... lub newCoupons:... |
| magazyn - stany, korekty, prognoza / magazyny | warehouseEntry:view, warehouseEntry:update / warehouse:view |
| strony, treści, canvasy | page:..., content:..., canvas:... |
| zdjęcia | image:update, imageUpload:view lub itemImages:view |
| parametry / lokacje parametrów | property:... / property:edit |
| widoki (przypisanie obiektu do widoku wymaga uprawnienia do tego obiektu) | view:view |
| słowniki: producenci, VAT, waluty, jednostki, grupy, płatności, dostawy, konfiguratory | producer:..., taxGroup:..., currency:..., unitOfMeasure:..., itemGroup:..., payment:..., delivery:..., combination:... |
| statystyki sprzedaży / bestsellery | statistics:orders / statistics:items |
| historia zmian | history:view |
| konfiguracja, moduły, stan wdrożenia | configurables:view |
| zadania cykliczne - lista / uruchomienie / czyszczenie cache | tasks:view / tasks:Action / cacheAction:view |
| przenoszenie danych - eksport / import | transfer:view / transfer:* |
| wysyłka e-maili | ro_mailForm:update |
| komunikaty sklepu - odczyt / zapis i usuwanie | bundlesEditor:view / bundlesEditor:update |
| konta administratorów - odczyt / zmiana właściwości | user:view / user:update |
| informacje o systemie, przewodnik, data, słownik historii | bez dodatkowych uprawnień |