WooCommerce 11.3: co zmieni się w połączeniach MCP?

WooCommerce 11.3 usunie dotychczasowy endpoint MCP /wp-json/woocommerce/mcp. Jeśli klient AI łączy się z nim przy użyciu klucza WooCommerce REST API, trzeba przełączyć go na wtyczkę WordPress MCP Adapter, nowy adres serwera i hasło aplikacji WordPress. WooCommerce ogłosił tę zmianę 21 października 2026 r.; nie jest to data wydania wersji 11.3. W komunikacie zespołu WooCommerce znajdziesz listę usuwanych elementów i wskazówki dla użytkowników oraz twórców rozszerzeń.

W skrócie

Zmiana dotyczy integracji używających starego endpointu MCP WooCommerce.
Nowy adres to /wp-json/mcp/mcp-adapter-default-server, obsługiwany przez aktywną wtyczkę MCP Adapter.
Zamiast klucza REST API połączenie HTTP używa nazwy użytkownika WordPressa i hasła aplikacji.
Warto przepiąć i sprawdzić klienta przed aktualizacją do WooCommerce 11.3.

Co zmieni się w WooCommerce 11.3?

Wbudowane możliwości WooCommerce dotyczące produktów i zamówień będą domyślnie dostępne dla MCP przez współdzielony serwer MCP Adapter. Zniknie osobny endpoint WooCommerce, jego uwierzytelnianie kluczem REST API oraz dziewięć starych możliwości opartych na operacjach REST. Gdy klient wyśle żądanie do usuwanego adresu, serwer ma zwrócić HTTP 410 z informacją o nowym sposobie połączenia. WooCommerce opisuje ten zakres w komunikacie o 11.3.

Element połączenia	Stary wariant	Wariant po zmianie
Endpoint	`/wp-json/woocommerce/mcp`	`/wp-json/mcp/mcp-adapter-default-server`
Obsługa serwera	MCP w WooCommerce	Aktywna wtyczka WordPress MCP Adapter
Dane logowania HTTP	Klucz WooCommerce REST API	Użytkownik WordPressa i hasło aplikacji
Możliwości produktów i zamówień	Stare narzędzia o kształcie REST	Możliwości WooCommerce dostępne przez serwer MCP Adapter
Ustawienie funkcji MCP	Przełącznik `mcp_integration`	Możliwości rejestrowane przez WooCommerce i udostępniane przez adapter

Usunięte zostaną też filtry i część mechanizmów dla rozszerzeń, które działały wyłącznie na starym endpoincie. Jeśli wtyczka sklepu korzysta z klas WP\MCP\*, powinna sprawdzić własną zależność od MCP Adaptera, ponieważ WooCommerce przestanie dostarczać jego biblioteki. Wymagane minimum WooCommerce 11.3 obejmuje WordPress 7.0, w którym Abilities API jest częścią rdzenia WordPressa. Te szczegóły podaje oficjalny komunikat WooCommerce.

Jak przepiąć klienta MCP przed aktualizacją

Jeżeli w konfiguracji asystenta lub narzędzia integracyjnego widzisz /wp-json/woocommerce/mcp albo nagłówek X-MCP-API-Key, zaplanuj zmianę. Dla zdalnego połączenia HTTP oficjalna dokumentacja WooCommerce wskazuje następującą kolejność:

Sprawdź w Ustawienia → Bezpośrednie odnośniki, czy wybrana struktura jest inna niż „Proste”. Dokumentacja MCP WooCommerce wymaga nieprostej struktury bezpośrednich odnośników przed połączeniem HTTP.
Zainstaluj i aktywuj wtyczkę MCP Adapter. Przykładowe polecenie WP-CLI to wp plugin install mcp-adapter --activate.
Utwórz lub wybierz konto WordPressa z minimalnymi uprawnieniami potrzebnymi klientowi.
Otwórz Użytkownicy → Profil, odszukaj sekcję Hasła aplikacji, nadaj poświadczeniu rozpoznawalną nazwę i wygeneruj hasło. Skopiuj je od razu, bo WordPress pokazuje je tylko przy tworzeniu.
Zmień konfigurację klienta: wpisz nowy adres serwera, nazwę użytkownika WordPressa i hasło aplikacji.
Sprawdź połączenie oraz dostępne możliwości MCP, zanim zaktualizujesz sklep do wersji 11.3.

Hasło aplikacji jest przypisane do konta WordPressa i można je unieważnić niezależnie od głównego hasła użytkownika. Dokumentacja WordPressa opisuje jego tworzenie, przechowywanie i odwoływanie. Dla połączeń HTTP WooCommerce wymaga HTTPS; zaleca też osobne konto z uprawnieniami ograniczonymi do potrzeb klienta. Instrukcja MCP WooCommerce podaje wymagania i przykłady konfiguracji.

Schemat zmiany wygląda tak:

flowchart TD
    A[Sprawdź obecny endpoint] --> B[Zainstaluj MCP Adapter]
    B --> C[Utwórz konto i hasło aplikacji]
    C --> D[Wpisz nowy adres serwera]
    D --> E[Sprawdź możliwości MCP]
    E --> F[Aktualizuj WooCommerce]

Przykładowa konfiguracja zdalnego klienta pokazuje pola, które trzeba zmienić. Zastąp przykładowy adres, nazwę konta i hasło własnymi danymi:

{
  "mcpServers": {
    "woocommerce_store": {
      "command": "npx",
      "args": [
        "-y",
        "@automattic/mcp-wordpress-remote@latest"
      ],
      "env": {
        "WP_API_URL": "https://twoj-sklep.pl/wp-json/mcp/mcp-adapter-default-server",
        "WP_API_USERNAME": "nazwa-uzytkownika",
        "WP_API_PASSWORD": "haslo-aplikacji"
      }
    }
  }
}

To przykład dla klienta, który obsługuje konfigurację mcpServers i zdalny proxy WordPressa. Nie umieszczaj prawdziwego hasła w repozytorium ani publicznym pliku konfiguracyjnym. Dokumentacja WooCommerce zawiera ten wariant oraz osobny opis połączeń lokalnych przez WP-CLI.

Kto powinien sprawdzić integrację?

Najprostszy audyt polega na sprawdzeniu adresu i rodzaju poświadczeń zapisanych w kliencie MCP. Jeżeli konfigurację przygotował programista lub agencja, poproś o potwierdzenie konkretnego endpointu i sposobu uwierzytelniania.

Co sprawdzić	Sygnał, że trzeba działać
Adres serwera	Zawiera `/wp-json/woocommerce/mcp`
Uwierzytelnianie	Klient używa klucza WooCommerce REST API lub `X-MCP-API-Key`
Kod własnej wtyczki	Odwołuje się do usuwanych klas, filtrów lub identyfikatorów możliwości
Nowe połączenie HTTP	Brak MCP Adaptera, hasła aplikacji albo HTTPS

Po zmianie sprawdź w kliencie, czy może nawiązać sesję i odkryć dostępne możliwości. Nie zakładaj, że lista narzędzi musi wyglądać dokładnie tak jak dawniej: nowy serwer opiera się na możliwościach WordPressa, a każde z nich może mieć własne sprawdzanie uprawnień. Opis serwera MCP WooCommerce wyjaśnia sposób odkrywania możliwości i kontrolę dostępu.

Zmiana dotyczy warstwy integracji AI ze sklepem. Sama obecność MCP Adaptera nie oznacza, że każdy asystent będzie wykonywać wszystkie działania dotyczące produktów i zamówień. Zakres zależy od dostępnych możliwości, uprawnień użytkownika i konfiguracji klienta. Sklepowy jest asystentem zakupowym AI dla sklepów WooCommerce; pomaga klientom znaleźć produkt, sprawdzić cenę i dostępność, wyjaśnia warianty oraz pomaga przygotować dodanie produktu do koszyka. Opis Sklepowego pozwala sprawdzić ten zakres przed rozmową o integracji.

FAQ

Czy po aktualizacji do WooCommerce 11.3 stary endpoint MCP zadziała?

Nie. WooCommerce zapowiada usunięcie /wp-json/woocommerce/mcp; żądania wysyłane na ten adres mają zwracać HTTP 410. Przed aktualizacją przepnij klienta na endpoint MCP Adaptera.

Czy trzeba zmienić klucz WooCommerce REST API?

Klucz używany przez stare połączenie MCP zastąp nazwą użytkownika WordPressa i hasłem aplikacji. Inne integracje korzystające z klucza REST API nie są automatycznie objęte tą zmianą, o ile nie korzystają z usuwanego endpointu MCP.

Czy MCP Adapter trzeba zainstalować jako wtyczkę?

Tak, dla połączenia z WooCommerce 11.3 adapter ma być aktywną wtyczką WordPressa. Projekt MCP Adapter oznaczył używanie go jako dołączonej biblioteki Composer jako przestarzałe i kieruje do instalacji wtyczki. Potwierdzają to informacje o wydaniu MCP Adapter 0.7.0.

Czy zmiana endpointu wpływa na Sklepowy?

Sama zmiana endpointu WooCommerce nie określa sposobu działania każdego asystenta AI. Warto sprawdzić, czy dana integracja korzysta ze starego adresu i jakie dane oraz możliwości ma otrzymywać. Sklepowy działa na WooCommerce i korzysta z katalogu sklepu, aby pomagać w wyborze produktu.

Co dalej

Po sprawdzeniu połączenia MCP uporządkuj dane, z których korzysta asystent zakupowy. Przeczytaj jak przygotować produkty WooCommerce dla asystenta AI, a następnie zobacz jak asystent zakupowy prowadzi od wyszukania produktu do koszyka.

Fakty sprawdzone 23 października 2026 r.