S SoftSolid
Serwer MCP

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.

Bez zaplecza

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.

od 200 PLN

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.

0 PLN

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