Kowal MCP Server dla Magento 2 udostępnia dane i funkcje sklepu kompatybilnym aplikacjom AI przez Model Context Protocol (MCP).
Analizuj sprzedaż, przygotowuj opisy produktów i SEO, rozwijaj CMS oraz e-maile za pomocą naturalnych poleceń. Ty określasz zakres dostępu i zatwierdzasz zmiany w panelu Magento.
Dane sklepu · Treści i katalog · Kontrola zmian
Asystent AI ↔ Kowal MCP Server ↔ Twój sklep Magento 2
Co możesz zrobić z MCP Server w Magento 2?
Od analizy danych po przygotowanie zmian w sklepie — w zakresie uprawnień nadanych Twojemu asystentowi.
Analiza sprzedaży w rozmowie
Pytaj o zamówienia, produkty, klientów, koszyki i stany magazynowe. Filtruj i agreguj dane, porównuj okresy oraz sprawdzaj wartość zamówień. Kolejne pytania pozwalają przejść od ogólnego wyniku do wybranej grupy produktów lub zamówień.
Przykład polecenia: „Porównaj wartość zamówień z ostatnich trzech miesięcy, osobno dla każdego miesiąca”.
Opisy produktów, atrybuty i SEO
Przygotowuj nazwy, krótkie i pełne opisy, metadane SEO oraz obsługiwane atrybuty produktów prostych i wirtualnych. Oprzyj treść na danych katalogowych i stylu marki.
Pracuj nad wersjami językowymi w konkretnych widokach sklepu, z uwzględnieniem dziedziczenia wartości Magento.
Przykład polecenia: „Przygotuj polskie opisy tych produktów na podstawie ich atrybutów i pokaż plan zmian”.
Strony CMS i kategorie Magento
Twórz nieaktywne szkice stron i bloków CMS. Edytuj treść, tytuły i metadane SEO; przygotowuj zatwierdzane publikacje i wycofania.
Zarządzaj nazwami i opisami kategorii, SEO, widocznością w menu oraz strukturą w obrębie jednego korzenia. Dodawaj i usuwaj przypisania produktów, zmieniaj ich kolejność lub zastępuj zestaw przypisań.
Media Gallery i treści blogowe
Wyszukuj grafiki w natywnej galerii Magento i osadzaj je w opisach produktów, CMS lub wpisach blogowych. Przygotuj dodanie obrazu PNG, JPEG albo WebP wraz z osadzeniem w jednym planie. Zarządzaj tytułami, opisami i dostępem do folderów. Galeria treści jest odrębna od galerii zdjęć produktu.
Adapter Kowal Blog 1.0.79–1.0.83 obsługuje szkice, treść, SEO, publikację i wycofanie, a także istniejące kategorie, tagi i obrazy z galerii wpisu. Wymaga osobnego modułu Kowal Blog i włączonego adaptera.
Zmiany masowe: do 1000 produktów
Wykonuj zmiany do 25 produktów w jednej transakcji lub przygotuj zadanie w kolejce dla maksymalnie 1000 produktów. Plan obejmuje jeden atrybut na produkt.
Sprawdzaj postęp, wyniki i błędy w panelu. Możesz anulować pozostałą część zadania; zakończone pozycje pozostają zapisane. Konflikty wymagają nowego planu, a ponowienie zależy od rodzaju błędu.
E-maile transakcyjne Magento 2
Odczytuj szablony i przypisania, przygotowuj szkice oraz wersje tematu, treści i stylów. Sprawdzaj podgląd przed i po na danych syntetycznych.
Zamówienia klienta i gościa, faktury, wysyłki i korekty.
Przypisania do widoków sklepu, wspólny nagłówek i stopka.
Przywracanie dziedziczenia i przygotowanie cofnięcia zmiany.
Wysyłka testowa wymaga osobnego zatwierdzenia. Odbiorców wskazuje administrator.
AI proponuje. Ty zatwierdzasz.
1. Zlecasz zadanie. Asystent korzysta z dostępnych narzędzi i przygotowuje plan zmiany.
2. Sprawdzasz propozycję w Magento. Oceniasz zakres i różnice, a następnie zatwierdzasz lub odrzucasz plan.
3. Moduł wykonuje zatwierdzoną zmianę. Ponownie sprawdza uprawnienia i stan danych. Konflikt blokuje nadpisanie równoległej edycji.
Role i centralny panel kontroli
Nadaj każdemu klientowi AI osobną rolę: od samego odczytu po wybrane operacje zapisu. Obsługiwane funkcje pozwalają ograniczać dostęp do widoków sklepu, folderów galerii lub korzeni kategorii.
W jednym panelu zarządzaj klientami AI, rolami, sesjami OAuth, planami zmian, historią i zadaniami masowymi. Unieważnij sesję, wyłącz klienta lub globalnie zablokuj zapisy i operacje masowe.
Połączenie MCP i uwierzytelnianie OAuth
Przewodnik pomaga dobrać ustawienia połączenia. Sekcja OAuth Credentials udostępnia identyfikator klienta, adres MCP, adresy OAuth i metadanych oraz wskazówki konfiguracji.
Korzystaj z Authorization (OTP), OAuth z PKCE S256 albo ręcznie generowanych, czasowych tokenów Bearer. Niezależne sesje OAuth możesz przeglądać i unieważniać w panelu Magento.
Co zawiera moduł Kowal MCP Server?
Pakiet Composer kowal/module-mcp zawiera rdzeń serwera, moduły CMS, Catalog, Email, Content Media oraz integrację Blog z adapterem Kowal Blog. Administrator włącza potrzebne moduły i nadaje uprawnienia.
Model językowy i abonament dostawcy AI nie są częścią pakietu. Moduł nie wymaga własnego klucza API do modelu po stronie Magento.
Moduł wymaga Magento 2.4.x, PHP 8.1+ oraz rozszerzeń PHP dom, curl, fileinfo i gd. Composer instaluje zależność kowal/base. Do połączenia potrzebny jest klient MCP obsługujący zdalne połączenie HTTP i wybraną metodę uwierzytelnienia.
Polecenia wykonaj w katalogu głównym Magento. Wersja PHP musi być zgodna z używaną wersją Magento. Dane dostępowe do repozytorium — e-mail klienta i token licencyjny — otrzymasz po zakupie. Są również dostępne w panelu klienta na kowal.store.
W trybie production wykonaj kompilację i wdrożenie plików statycznych zgodnie z procedurą sklepu. W przykładzie użyto języków pl_PL i en_US — zastąp je językami swojej instalacji.
Pakiet zawiera moduły rozszerzające możliwości serwera, m.in. CMS, katalog, e-mail i media. Włącz te, których chcesz używać. Przykład dla CMS i katalogu:
Adaptery Blog i FAQ wymagają odpowiednich modułów źródłowych. Przed ich aktywacją sprawdź zgodność wersji w dokumentacji pakietu.
Utwórz rolę dostępu
Otwórz kowal.store → Modules → Kowal MCP → ACL Rules. Utwórz rolę i wybierz potrzebne narzędzia oraz zakresy sklepu. Dla operacji zapisu użyj roli Specified i zaznacz konkretne akcje, w tym przygotowanie i wykonanie zmian. Sama instalacja modułu nie nadaje klientowi AI uprawnień.
Dodaj klienta AI
W Kowal MCP → AI MCP Clients utwórz klienta i przypisz przygotowaną rolę. Zapisz jego Client ID oraz Client Secret. Jeżeli używasz OAuth, wpisz dokładny adres callback podany przez aplikację w OAuth Redirect URLs i wygeneruj OTP do autoryzacji.
Alternatywą jest ręcznie generowany token dostępu, ważny 24 godziny. Token jest pokazywany jednokrotnie — zachowaj go w konfiguracji swojego klienta.
Połącz aplikację z Magento
Otwórz Kowal MCP → AI Connection Guide i wybierz instrukcję dla używanej aplikacji. Serwer korzysta ze zdalnego transportu Streamable HTTP. Zastąp domenę poniżej adresem własnego sklepu:
https://twoj-sklep.pl/kowal_mcp/index/index
Wprowadź endpoint i dane uwierzytelnienia zgodnie z przewodnikiem. Obsługa transportu i OAuth zależy od wersji klienta, dlatego sprawdź zgodność swojej aplikacji w aktualnej dokumentacji modułu.
Ustaw zatwierdzanie zmian i prywatność
W Kowal MCP → Configuration ustaw Write Operations Require Manual Approval. Yes wymaga zatwierdzania przygotowanych planów w Change Plans; domyślne No umożliwia zatwierdzanie planów po walidacji. Wykonanie nadal wymaga właściwych uprawnień roli i zakresu sesji.
W sekcji Privacy skonfiguruj anonimizację danych przekazywanych do klienta. Ustawienia dopasuj do zakresu pracy aplikacji.
Sprawdź połączenie i działanie kolejki
Rozpocznij od operacji odczytu, następnie zweryfikuj uprawnienia potrzebne do planowanej edycji. Sesje i wykonane operacje znajdziesz w OAuth Sessions oraz Operation Audit. Dostępne lokalnie możliwości możesz sprawdzić poleceniami:
Wynik CLI pokazuje możliwości instalacji; faktyczny dostęp klienta zależy od jego roli i sesji. Dla masowych zmian w kolejce zapewnij działający cron i obsługę konsumenta kowal.mcp.bulk. Postęp sprawdzaj w Bulk Jobs.
Zmiany opisane w tym module przechodzą przez plan zatwierdzany w panelu Magento. Asystent pracuje w zakresie nadanej roli, a przed wykonaniem moduł ponownie sprawdza uprawnienia i stan danych.
Pytanie
Czy moduł zawiera asystenta lub model AI?
Odpowiedź
Nie. Kowal MCP Server łączy Magento 2 z kompatybilną aplikacją AI przez MCP. Model językowy i ewentualny abonament dostawcy AI zapewniasz osobno.
Pytanie
Czy można pracować nad opisami w różnych językach?
Odpowiedź
Tak. Obsługiwane operacje uwzględniają widoki sklepu oraz zakres i dziedziczenie wartości Magento, dzięki czemu możesz przygotowywać treści dla wybranej wersji językowej.
Pytanie
Czy funkcje blogowe wymagają dodatkowego modułu?
Odpowiedź
Tak. Wymagają osobnego modułu Kowal Blog w obsługiwanej wersji 1.0.79–1.0.83 oraz włączonego adaptera dołączonego do pakietu MCP.
