Twój sklep CS-Cart
w zasięgu modeli AI
Serwer MCP jest tłumaczem między modelem językowym a sklepem. Model pyta o produkty, zamówienia i klientów zwykłym zdaniem, a serwer zamienia to pytanie na wywołanie API sklepu i oddaje gotową odpowiedź. Działa jako osobna usługa obok sklepu, więc nic nie instalujesz w samym CS-Carcie i nie ruszasz jego kodu.
- Dwanaście narzędzi odczytu, zapis wyłączony domyślnie
- Gotowy pod n8n i pod lokalnego klienta MCP
- Wersja PHP sklepu nie ma znaczenia, także 7.4
Co daje serwer MCP
Jedna usługa, która otwiera dane sklepu na automatyzacje i asystentów, nie oddając im przy tym prawa do zmiany czegokolwiek.
Sklep, o który można po prostu zapytać
Zamiast klikać po panelu i składać raport ręcznie, pytasz asystenta o stan magazynu, ostatnie zamówienia albo obrót z minionego tygodnia. Serwer pobiera dane ze sklepu i podaje je modelowi w postaci, którą ten rozumie.
Osobno od sklepu, bez ingerencji w kod
Serwer stoi obok sklepu i rozmawia z nim przez publiczne REST API. Dzięki temu wersja PHP samego sklepu nie ma znaczenia i obsłużone są także starsze instalacje na PHP 7.4, w których nowoczesnych bibliotek nie dałoby się uruchomić.
Analityka, której API sklepu nie ma wcale
Rdzeniowe API CS-Carta nie oddaje ani sprzedaży w podziale na produkty, ani wydatków pojedynczego klienta, ani gotowej sumy obrotu. Nasz dodatek sklepowy ss_mcp dokłada do niego cztery encje tylko do odczytu, które liczą to jednym zapytaniem, tymi samymi funkcjami rdzenia, z których korzysta panel administracyjny. Serwer sięga po nie, gdy tylko sklep je ma, a kiedy ich nie zastanie, wraca na wolniejszą drogę i mówi o tym wprost w odpowiedzi.
Odczyt domyślnie, zapis pod przełącznikiem
Dwanaście narzędzi, które model dostaje po podłączeniu, wyłącznie czyta. Dwa narzędzia zapisujące, zmiana statusu zamówienia i korekta stanu magazynowego, w ogóle nie pojawiają się na liście, dopóki administrator nie włączy ich osobnym przełącznikiem. Model nie sięgnie po narzędzie, o którym nie wie, że istnieje.
Nazwane tokeny dostępu
Bez ustawionego tokenu serwer po HTTP w ogóle nie wstaje. Tokeny są nazwane, więc możesz wydać osobny dla każdego narzędzia i unieważnić pojedynczy bez ruszania pozostałych, od razu i bez restartu. Na dysku leżą wyłącznie ich skróty kryptograficzne, nigdy same tokeny.
Gotowy pod n8n
Serwer wystawia dwa transporty. Streamable HTTP obsługuje klientów zdalnych, w tym n8n, a wejście i wyjście standardowe zostaje dla klienta lokalnego, który uruchamia serwer jako własny proces potomny.
Pośrednik, nie magazyn danych
Serwer nie ma bazy danych i nie kopiuje do siebie zawartości sklepu: pobiera to, o co pytasz, oddaje modelowi i na tym kończy. Cała konfiguracja idzie przez zmienne środowiskowe, więc ten sam obraz Dockera obsłuży kolejny sklep bez przebudowy.
Pytania, które możesz zadać
Każde z nich dziś wymaga zalogowania do panelu, ustawienia filtra i przejrzenia tabeli. Po podłączeniu serwera wystarczy zapytać zwykłym zdaniem, a odpowiedź powstaje z danych pobranych w tej samej chwili.
- Ile zamówień wpadło wczoraj i na jaką kwotę?
- Pokaż zamówienia czekające na płatność dłużej niż trzy dni.
- Jakie koszyki zostały porzucone w ciągu ostatniej doby i czy mamy do nich adresy e-mail?
- Co zamawiał klient jan.kowalski@example.com i pod jaki adres?
- Ile sztuk tego produktu zostało na magazynie i jaką ma cenę?
- Jakie oceny zebrał ten produkt i co dokładnie piszą klienci?
- Jakie mamy kategorie i ile produktów siedzi w każdej z nich?
- Co sprzedawało się najlepiej w tym miesiącu i za jaką kwotę?
- Jak nam poszło wobec poprzedniego miesiąca?
- Ile ten klient u nas wydał i co kupuje najczęściej?
Odpowiedzi pochodzą z Twojego sklepu, pobrane w chwili zadania pytania. Model nie zgaduje, tylko czyta. Trzy ostatnie pytania odpowiadają liczbami policzonymi w samym sklepie, przez dodatek ss_mcp, bo rdzeniowe API takich sum nie wystawia.
Narzędzia, które dostaje model
Model nie ma wolnej ręki w sklepie. Dostaje zamknięty zestaw narzędzi o ustalonym zakresie i tylko tyle może zrobić. Dwanaście pierwszych wyłącznie czyta i działa od razu, dwa ostatnie zapisują i są domyślnie wyłączone.
health_check Kontrola połączenia
Sprawdza, czy sklep odpowiada i mierzy czas odpowiedzi. Pierwsze narzędzie, po które sięga się przy diagnozie.
get_products Lista produktów
Nazwa, cena, stan magazynowy i status. Podstawa pytań o dostępność i o to, czego brakuje na półce.
get_product_details Szczegóły produktu
Pełne dane jednej pozycji: kod magazynowy, obie ceny, waga oraz opis oczyszczony ze znaczników HTML.
get_categories Drzewo kategorii
Struktura kategorii sklepu razem z liczbą produktów w każdej z nich. Stąd wiadomo, gdzie asortyment rośnie, a gdzie półka świeci pustkami.
get_product_reviews Opinie o produkcie
Oceny i treść komentarzy przy wybranym produkcie. Opinie daje dodatek recenzji, więc sklep bez niego dostanie informację o jego braku zamiast listy.
get_orders Lista zamówień
Zamówienia z filtrem po statusie, adresie e-mail klienta i okresie. Stąd biorą się odpowiedzi o to, co działo się w sklepie wczoraj.
get_order_details Szczegóły zamówienia
Pozycje zamówienia, kwoty, dane klienta i adres wysyłki, czyli komplet potrzebny do odpowiedzi na pytanie o konkretną sprawę.
get_abandoned_carts Porzucone koszyki
Koszyki bez ruchu dłużej niż zadany czas, domyślnie godzinę, razem z zawartością i kontaktem, jeśli klient go zostawił. Ze sklepem, w którym stoi dodatek ss_mcp, z listy znika klient stojący w tej chwili w kasie, a koszyk gościa da się znaleźć po jego adresie.
get_customer_info Dane klienta
Klient wyszukany po adresie e-mail albo numerze użytkownika, razem z danymi potrzebnymi obsłudze.
get_customer_summary wymaga dodatku ss_mcp Podsumowanie zakupów klienta
Ile klient wydał, ile złożył zamówień, kiedy kupił ostatnio i co kupuje najczęściej, w jednej odpowiedzi. Rdzeniowe API takiej sumy nie liczy, więc bez dodatku trzeba by pobrać wszystkie jego zamówienia i dodać je samemu.
get_store_stats Statystyki sklepu
Liczba produktów, liczba zamówień i obrót w wybranym okresie. Ze sklepem, w którym stoi dodatek ss_mcp, obrót liczy sam sklep, a odpowiedź zyskuje porównanie z okresem poprzednim razem z gotową różnicą kwotową i procentową.
get_top_products wymaga dodatku ss_mcp Ranking sprzedaży produktów
Najlepiej sprzedające się produkty w okresie, z liczbą sztuk i wartością sprzedaży, opcjonalnie zawężone do kategorii. Warianty produktu liczą się osobno. Sprzedaży w podziale na produkty rdzeniowe API nie wystawia w ogóle.
update_order_status zapis, wyłączony domyślnie Zmiana statusu zamówienia
Przestawia zamówienie na wybrany status. Dostępne dopiero po świadomym włączeniu zapisu, a wykonana zmiana trafia do logu razem ze statusem sprzed operacji.
update_product_stock zapis, wyłączony domyślnie Korekta stanu magazynowego
Ustawia stan magazynowy produktu na podaną wartość. Tak samo wymaga włączonego zapisu, a log zachowuje stan przed zmianą i po niej.
Okresy w zapytaniach o zamówienia i statystyki podaje się kodami CS-Carta, od dzisiaj i wczoraj po poprzedni rok. Nazwy statusów nie są zaszyte w serwerze, bo sklepy dodają własne: serwer czyta je wprost ze sklepu i podaje obok kodu. Narzędzia zapisujące włącza się jedną zmienną środowiskową, a każdy zapis trafia do logu serwera z wartością przed i po zmianie. Dwa narzędzia oznaczone dodatkiem liczą to, czego rdzeniowe API nie wystawia wcale, więc bez ss_mcp odpowiadają informacją o jego braku, a nie liczbą wziętą z sufitu.
Granice, o których mówimy od razu
Każde z tych ograniczeń wyszłoby przy pierwszym poważnym użyciu, więc wolimy powiedzieć je teraz, niż tłumaczyć później.
Bez dodatku obrót liczymy z pobranych zamówień
Rdzeniowe API sklepu nie oddaje gotowej sumy sprzedaży, więc na tej drodze obrót powstaje z zamówień pobranych za dany okres, najwyżej pięciuset, a odpowiedź mówi wprost, czy suma objęła wszystkie. Ograniczenie znika w sklepie z dodatkiem ss_mcp, bo wtedy liczbę podaje sam sklep, jednym zapytaniem i niezależnie od tego, ile zamówień jest w okresie.
Bez dodatku porzucony koszyk to nasza ocena, nie stan sklepu
CS-Cart nie zapisuje porzucenia jako statusu, więc bez dodatku liczymy je po czasie bezczynności koszyka, domyślnie po godzinie, i podajemy użyty próg razem z odpowiedzią. Kryterium jest wtedy słabe, bo na liście ląduje także klient, który właśnie wrócił do starego koszyka i stoi w kasie. Dodatek ss_mcp zamienia to na odpowiedź ze sklepu, w której koszyk musi być stary i jednocześnie pozbawiony właściciela obecnego w tej chwili w sklepie.
Opinie zależą od dodatku recenzji
Komentarze i oceny produktów pochodzą z dodatku, a nie z rdzenia sklepu. Sklep bez tego dodatku dostanie w odpowiedzi informację o jego braku zamiast pustej listy udającej, że opinii nie ma.
Jedna instancja obsługuje jeden sklep
Adres API, użytkownik i klucz są konfiguracją instancji, więc drugi sklep to druga instancja. Ten sam obraz Dockera obsłuży go bez przebudowy, ale rozdzielenie jest tu celowe, bo trzyma dane sklepów osobno.
W Multi-Vendor sprzedawca nie zobaczy koszyków
Sprzedawca pytający własnym kluczem API dostaje statystyki sprzedaży, ranking produktów i podsumowanie klienta zawężone wyłącznie do swojej firmy. Porzucone koszyki są dla niego zamknięte na stałe i nie jest to nasza ostrożność, tylko konsekwencja bazy: w Multi-Vendor koszyk nie ma pola wiążącego go ze sprzedawcą, więc nie da się go uczciwie przypisać. Rdzeń sklepu ma tutaj dokładnie to samo ograniczenie.
Cennik
Kod serwera jest otwarty i darmowy. Płacisz za to, żeby rzecz działała: za hosting, wdrożenie, aktualizacje pod nowe wersje CS-Carta i wsparcie.
Instancja hostowana
Dla sklepu, który chce mieć serwer MCP działający od zaraz, bez własnego Dockera i bez utrzymywania kolejnej usługi.
miesięcznie · netto
Wdrożenie od 800 PLN jednorazowo
- Instancja na naszej infrastrukturze, z własnym adresem i certyfikatem
- Konfiguracja klucza API po Twojej stronie i testy na Twoim sklepie
- Aktualizacje pod nowe wersje CS-Carta
- Gotowe workflow n8n na start
- Wsparcie w razie problemów z połączeniem
Samodzielny hosting
Dla firmy, która ma własne zaplecze i woli trzymać usługę u siebie, obok sklepu.
za sam serwer · netto
Wdrożenie i wsparcie rozliczane godzinowo
- Otwarty kod serwera, bez opłaty licencyjnej
- Docker albo PHP 8.1 z rozszerzeniami curl i json
- Wdrożenie i szkolenie zespołu rozliczane godzinowo
- Opcjonalna umowa wsparcia ze stałą kwotą roczną
- Dokumentacja publiczna i paczka do samodzielnego uruchomienia
Ceny netto. Przy umowie rocznej abonament jest niższy. Samodzielny hosting nic nie kosztuje i taki jest sens modelu open core: kod zostaje otwarty, a płatne jest wdrożenie, utrzymanie i wsparcie.
Najczęstsze pytania
Czym właściwie jest MCP i po co mi to w sklepie?
Model Context Protocol to otwarty standard, którym asystenci AI rozmawiają z zewnętrznymi systemami. Bez niego model zna tylko to, co mu wkleisz do okna czatu. Z serwerem MCP potrafi sam sięgnąć po dane sklepu i odpowiedzieć na pytanie o konkretne zamówienie albo o stan magazynu, a automatyzacja w n8n może zrobić to samo bez pisania integracji od zera.
Czy serwer może coś zmienić w moim sklepie?
Domyślnie nie. Dwanaście narzędzi, które model dostaje po podłączeniu, wyłącznie czyta. Zapis istnieje, dziś w postaci zmiany statusu zamówienia i korekty stanu magazynowego, ale jest wyłączony jedną zmienną środowiskową i takie narzędzia w ogóle nie pojawiają się na liście widocznej dla modelu. Włączenie ich jest Twoją świadomą decyzją, a wtedy każda zmiana trafia do logu serwera z wartością sprzed operacji i po niej.
Gdzie trafiają dane moich klientów?
Serwer jest pośrednikiem, nie magazynem. Nie ma bazy danych i nie kopiuje do siebie zawartości sklepu: pobiera to, o co pytasz, oddaje modelowi i na tym kończy, a na dysku instancji zostają wyłącznie skróty tokenów i techniczne pliki sesji. Dane, o które zapytasz, trafiają natomiast do modelu, którego używasz, więc przy wdrożeniu ustalamy, jaki to model i jakie pytania mają w ogóle padać. Jeśli dane osobowe nie mogą opuścić firmy, zostaje wariant z modelem uruchomionym na Twojej infrastrukturze, bo protokół jest otwarty i nie wiąże Cię z żadnym dostawcą.
Czym jest dodatek ss_mcp i czy muszę go instalować?
To dodatek do samego sklepu, który rozszerza jego REST API o cztery encje tylko do odczytu. Nie musisz go mieć: serwer bez niego działa i odpowiada na wszystkie pytania poza dwoma, których rdzeniowe API nie umie policzyć wcale, czyli rankingiem sprzedaży i podsumowaniem wydatków klienta. Reszta różnicy jest kwestią dokładności i tempa, bo obrót bez dodatku liczymy z pobranych zamówień, a porzucenie koszyka oceniamy czasem bezczynności zamiast pytać o nie sklep. Dodatek niczego w sklepie nie zmienia i niczego nie gromadzi, tylko liczy na danych, które i tak w nim leżą, a jego wyłączenie w panelu jest bezpieczne, bo serwer po prostu wraca na wolniejszą drogę.
Czy muszę aktualizować PHP albo instalować coś w sklepie?
Nie musisz. Serwer działa jako osobna usługa i łączy się ze sklepem przez jego publiczne REST API, więc wersja PHP sklepu nie ma znaczenia i obsłużone są także instalacje na PHP 7.4. Po Twojej stronie potrzebny jest tylko użytkownik panelu z dostępem do API oraz jego klucz.
Czy to zadziała na Multi-Vendor?
Zadziała, i sprawdziliśmy to na działającej instalacji Multi-Vendor, nie tylko w źródłach. Klucz API sprzedawcy sam ustawia kontekst jego firmy, więc pytający własnym kluczem dostaje statystyki sprzedaży, ranking produktów i podsumowanie klienta policzone wyłącznie z jego zamówień. Właściciel marketplace'u widzi całość, a każdą z tych trzech rzeczy może sprzedawcom wyłączyć zwykłym uprawnieniem w panelu. Jedno ograniczenie zostaje: porzuconych koszyków sprzedawca nie zobaczy, bo baza sklepu nie wiąże koszyka ze sprzedawcą i to samo ograniczenie ma rdzeń.
Czy mogę uruchomić serwer u siebie, bez waszego hostingu?
Tak, i nie jest to obejście naszego modelu, tylko jego część. Kod serwera jest otwarty, więc jeśli masz Dockera albo PHP 8.1 z rozszerzeniami curl i json, postawisz go samodzielnie. Zarabiamy wtedy na wdrożeniu i wsparciu, a nie na licencji.
Jak wygląda bezpieczeństwo dostępu do danych?
Na trzech poziomach. Serwer po HTTP wymaga tokenu przy każdym zapytaniu i bez ustawionego tokenu w ogóle nie wystartuje, a połączenia spoza listy dozwolonych domen odrzuca. Dalej działa klucz API sklepu, wystawiony osobnemu użytkownikowi założonemu wyłącznie dla tej usługi, bez prawa kasowania zamówień i zarządzania użytkownikami, więc nawet wyciek klucza nie otwiera drogi do szkód nieodwracalnych. Na końcu jest sam zakres narzędzi, w którym operacje zapisu są domyślnie niewidoczne.
Na jakim etapie jest projekt?
Serwer stoi na wersji 0.9.0 i mówimy wprost, co w niej jest. Oba transporty działają, dostęp po HTTP chroni nazwany token, dwanaście narzędzi odczytu jest sprawdzonych przeciwko API działających instalacji CS-Carta i Multi-Vendor, razem z Claude i z n8n po drugiej stronie, a dwa narzędzia zapisu czekają wyłączone. Mówimy też drugą część prawdy: projekt jest młody i nie ma jeszcze wdrożenia u klienta, więc pierwsze umowy zawieramy na warunkach wczesnego wejścia. Jeśli chcesz mieć wpływ na to, co powstanie najpierw, napisz do nas.
Porozmawiajmy o wdrożeniu
Umów prezentację na żywo albo napisz do nas z pytaniem. Odpowiadamy szybko i konkretnie.
office@cs-cart.com.pl · +48 661 661 964
SoftSolid · ul. Sportowa 14, 62-090 Rokietnica
NIP PL8421361047