Skip to main content
SparkCore

WP-CLI i MCP: wszystkie polecenia i narzędzia

Ta strona opisuje wszystko, co możesz zrobić w Spark Speed 0.73.2 bez ekranu administracyjnego: polecenia WP-CLI na serwerze oraz narzędzia MCP, których asystent AI, taki jak Claude lub ChatGPT, używa do pracy z Twoją witryną. Przeznaczona dla administratorów i agencji, które pracują z wierszem poleceń lub asystentem AI; do codziennego zarządzania tego nie potrzebujesz.
W skrócie
  • Każde polecenie zaczyna się od wp spark-speed i działa na serwerze
  • mcp token i ai apply istnieją tylko z ważną licencją; diagnostics odmawia bez niej
  • MCP wymaga ważnej licencji i autoryzowanego klienta działającego jako administrator
  • start_optimization wymaga otwartego pulpitu w przeglądarce dla kontroli przeglądarki

Status i cache

Szybko zobacz, jak wygląda cache, wyczyść go i sprawdź, co dostają odwiedzający.

wp spark-speed status

Podstawowe · Ręcznie, przez WP-CLI

Co robi
Pokazuje stan cache w pięciu wierszach: która wtyczka zarządza plikiem drop-in cache (plikiem, który WordPress ładuje wcześnie dla cache stron), czy WP_CACHE jest włączone, ile stron jest w cache, ile adresów czeka w kolejce i czy opcjonalny lokalny worker jest osiągalny. Przydatne do szybkiego podglądu bez otwierania wp-admin.
Kiedy używać
Po aktualizacji, migracji lub czyszczeniu cache albo w skrypcie monitorującym.
Jak sprawdzić efekt
Wynik jest po angielsku: Drop-in owner, WP_CACHE, Cached pages, Queue pending, Worker. Worker : OFFLINE jest normalne: worker jest opcjonalny i nie ma go w pliku zip; Spark używa wtedy ścieżki PHP.
Przykład
wp spark-speed status
Jak cofnąć
Nie ma czego cofać: polecenie tylko odczytuje.

wp spark-speed purge

Podstawowe · Ręcznie, przez WP-CLI

Co robi
Czyści cały cache stron. Strony są potem budowane od nowa przy następnej wizycie lub przez rozgrzewacz cache.
Kiedy używać
Gdy odwiedzający widzą nieaktualną wersję albo po dużej zmianie motywu lub ustawień.
Jak sprawdzić efekt
Zobaczysz Page cache purged. Za pomocą wp spark-speed status zobaczysz spadek Cached pages.
Przykład
wp spark-speed purge
Uwaga
Dopóki cache nie zostanie odbudowany, pierwsze wizyty są wolniejsze. Nie czyści to pamięci podręcznej obiektów; służy do tego flush-object-cache.
Jak cofnąć
Nie można cofnąć. Odbuduj cache poleceniem wp spark-speed optimize --all a potem wp spark-speed warm.

wp spark-speed flush-object-cache

Zaawansowane · Ręcznie, przez WP-CLI

Co robi
Czyści pamięć podręczną obiektów (tymczasowy magazyn wyników bazy danych, na przykład w Redis, Memcached, APCu lub SQLite), która działa przez drop-in pamięci podręcznej obiektów Spark. Jest to celowo oddzielone od cache stron.
Kiedy używać
Gdy podejrzewasz nieaktualne dane w pamięci podręcznej obiektów. Spark nie czyści jej automatycznie.
Wymagania
Działająca pamięć podręczna obiektów Spark. W przeciwnym razie dostaniesz ostrzeżenie.
Jak sprawdzić efekt
Komunikat o powodzeniu albo ostrzeżenie, gdy nie było czego czyścić.
Przykład
wp spark-speed flush-object-cache
Uwaga
Zaraz po wyczyszczeniu WordPress znów więcej odpytuje bazę danych.
Jak cofnąć
Niepotrzebne: pamięć podręczna obiektów napełnia się sama.

wp spark-speed verify-cache

Zaawansowane · Ręcznie, przez WP-CLI

Co robi
Pobiera jedną stronę Twojej witryny jako odwiedzający na komputerze i na telefonie i zwraca ocenę w JSON: jaki status cache został podany i czy pasuje do obecnego kodu i ustawień.
Kiedy używać
Po zmianie, aby sprawdzić, czy odwiedzający dostają nową wersję z cache.
Wymagania
--page z pełnym adresem w tej witrynie, bez query stringa. Bez --page polecenie kończy się błędem.
Jak sprawdzić efekt
JSON zawiera ok. Kod wyjścia to 0, gdy wszystko się zgadza, i 2, gdy nie, więc możesz użyć tego w skrypcie.
Przykład
wp spark-speed verify-cache --page=https://example.com/product/example/
Jak cofnąć
Nie ma czego cofać: polecenie tylko odczytuje.

Budowanie cache

Optymalizuj strony, przetwarzaj kolejkę oraz śledź i wznawiaj budowanie cache. To samo budowanie zobaczysz w panelu na karcie Cache.

wp spark-speed optimize

Zaawansowane · Ręcznie, przez WP-CLI

Co robi
Bez dodatkowych opcji przebudowuje stronę główną, zoptymalizowaną i zapisaną w cache dla każdego urządzenia. Za pomocą --page=<address> robisz to dla jednej strony. Za pomocą --all kolejkujesz każdą stronę witryny; właściwą pracę wykonujesz potem za pomocą process lub warm.
Kiedy używać
Po czyszczeniu cache albo gdy chcesz mieć jedną ważną stronę od razu gotową.
Wymagania
Użyj --page, a nie --url: WP-CLI już rezerwuje --url.
Jak sprawdzić efekt
Jeden wiersz na urządzenie z wynikiem, na przykład ok lub powód, dla którego się nie udało. Za pomocą --all zobaczysz, ile adresów trafiło do kolejki.
Przykład
wp spark-speed optimize --page=https://example.com/shop/
Uwaga
Gdy hamulec bezpieczeństwa (tryb bezpieczny) jest włączony lub optymalizacja jest wyłączona, strony są tylko zapisywane w cache, a nie optymalizowane.
Jak cofnąć
Wyczyść cache tej strony lub cały cache.

wp spark-speed process

Zaawansowane · Ręcznie, przez WP-CLI

Co robi
Przetwarza teraz część kolejki, domyślnie 20 adresów. Używa tej samej blokady co przetwarzanie w tle, więc nigdy sobie nie przeszkadzają.
Kiedy używać
Aby przetwarzać pełną kolejkę etapami, na przykład po optimize --all.
Wymagania
Kolejka z adresami. Liczbę zmienisz za pomocą --limit=<number>.
Jak sprawdzić efekt
Jeden wiersz na adres z wynikiem dla każdego urządzenia, a na końcu Batch done. Remaining: N.
Przykład
wp spark-speed process --limit=50
Uwaga
Obciąża serwer, dopóki działa. Jeśli inny proces trzyma blokadę, nic nie jest przetwarzane.
Jak cofnąć
Nie dotyczy.

wp spark-speed warm

Zaawansowane · Ręcznie, przez WP-CLI

Co robi
Przetwarza całą kolejkę aż do opróżnienia, domyślnie w porcjach po 25. Gdy nie ma postępu, ustala dlaczego. Jeśli zajęty jest inny proces, informuje o tym i kończy; z --wait czeka na blokadę do 15 minut.
Kiedy używać
Na witrynach o małym ruchu, gdzie WP-Cron sam nie działa wystarczająco często, albo po pełnym czyszczeniu cache.
Wymagania
Witryna musi móc połączyć się sama ze sobą (loopback), ponieważ rozgrzewacz pobiera Twoje własne strony. Rozmiar porcji zmienisz za pomocą --batch=<number>.
Jak sprawdzić efekt
W każdej rundzie remaining: N (cached M) oraz podsumowanie. Kod wyjścia to 0, gdy kolejka jest pusta, 1, gdy zostało coś do zrobienia, i 2, gdy rozgrzewacz jest zablokowany lub utknął.
Przykład
wp spark-speed warm --wait
Uwaga
Może trwać długo i obciąża serwer. Witryna w trybie konserwacji lub za ochroną przed botami, która zwraca 403, powoduje błędy stron.
Jak cofnąć
Zatrzymaj za pomocą Ctrl+C. Zbudowany cache możesz wyczyścić poleceniem purge.

wp spark-speed warm-status

Podstawowe · Ręcznie, przez WP-CLI

Co robi
Pokazuje, jak idzie budowanie cache: stan i od kiedy, jak długo nic się nie działo, przyczynę, kolejkę, strony w cache w stosunku do całości, ewentualną pauzę, nieudane adresy i ostatni test. Za pomocą --json dostaniesz wszystko jako JSON.
Kiedy używać
Gdy budowanie nie postępuje albo w monitorze, który śledzi kod wyjścia.
Jak sprawdzić efekt
Wiersze mają niderlandzkie etykiety (stand, sinds, wachtrij, gecached, pauze, fails, laatste toets). Kod wyjścia 0 oznacza stan zdrowy, 1 znaną przyczynę, 2 zablokowanie, a 3, że nie da się ustalić stanu.
Przykład
wp spark-speed warm-status --json
Jak cofnąć
Nie ma czego cofać: polecenie tylko odczytuje.

wp spark-speed warm-hervat

Zaawansowane · Ręcznie, przez WP-CLI

Co robi
Testuje wstrzymane budowanie cache prawdziwą próbą na pierwszym adresie w kolejce i wznawia budowanie, gdy witryna odpowiada poprawnie. To wersja wiersza poleceń przycisku wznawiającego budowanie na karcie Cache.
Kiedy używać
Po usunięciu przyczyny pauzy, na przykład błędu loopback lub ochrony przed botami.
Wymagania
Otwarta pauza. Bez pauzy zgłasza Er stond geen pauze open..
Jak sprawdzić efekt
Gdy wznowi, zobaczysz Hervat. z kolejką i liczbą stron w cache (kod wyjścia 0). Gdy się nie uda, pojawi się ostrzeżenie Niet hervat: <reason> (kod wyjścia 1). Potem sprawdź za pomocą warm-status.
Przykład
wp spark-speed warm-hervat
Uwaga
Jeśli witryna nadal zwraca błędy, pauza pozostaje.
Jak cofnąć
Nie dotyczy.

Sklep, klienci i plan ładowania

Te polecenia obsługują funkcje, które znajdziesz też w panelu, z tym samym testem na początku. Podpolecenia to niderlandzkie słowa: aan (włączone), uit (wyłączone), proef (test), legen (wyczyść).

wp spark-speed winkelwagen

Zaawansowane · Ręcznie, przez WP-CLI

Co robi
Obsługuje cache dla odwiedzających z pełnym koszykiem, tę samą funkcję co Cached pages with a filled cart na karcie Cart and logged-in customers. status (domyślnie) pokazuje stan i ostatni test. proef uruchamia test. aan włącza funkcję, a uit ją wyłącza.
Kiedy używać
W sklepie WooCommerce, gdzie kupujący z czymś w koszyku w przeciwnym razie za każdym razem dostaliby w pełni zbudowaną, wolną stronę.
Wymagania
WooCommerce. aan działa tylko po udanym teście lub z --bevestigd po samodzielnym przejrzeniu znalezionej różnicy.
Jak sprawdzić efekt
Test zgłasza wynik, liczbę stron, czy skrypt koszyka jest potrzebny i jakie znaleziono różnice. Przy włączaniu zobaczysz Winkelwagencache aan; de paginacache is geleegd..
Przykład
wp spark-speed winkelwagen proef
Uwaga
Włączenie czyści cały cache stron. Jeśli błędnie zatwierdzisz różnicę za pomocą --bevestigd, treści osobiste mogą trafić na wspólne strony.
Jak cofnąć
wp spark-speed winkelwagen uit
Nazwa techniczna
woo_cart_cache

wp spark-speed klantcache

Zaawansowane · Ręcznie, przez WP-CLI

Co robi
Obsługuje własny cache dla zalogowanych klientów, tę samą funkcję co Own cache for logged-in customers na karcie Cart and logged-in customers. status (domyślnie) pokazuje stan, liczbę sesji z własną kopią i to, czy można go włączyć. aan (włączone), uit (wyłączone i wyczyszczone) oraz legen (czyści wszystkie kopie klientów).
Kiedy używać
Gdy zalogowani klienci przy każdym kliknięciu dostają w pełni zbudowaną stronę.
Wymagania
Jeśli funkcji nie można włączyć w tej witrynie, aan odmawia i podaje powód. Tylko role klientów, nigdy administratorzy. Kopia ma co najwyżej 8 godzin.
Jak sprawdzić efekt
Komunikaty takie jak Klantcache aan. lub Klantcache uit en geleegd., a z status wiersz z stand, sessies met eigen kopieen i kan aan.
Przykład
wp spark-speed klantcache status
Uwaga
Każda zalogowana sesja dostaje własne kopie, więc zajęte miejsce na dysku rośnie wraz z liczbą klientów.
Jak cofnąć
wp spark-speed klantcache uit
Nazwa techniczna
klant_cache

wp spark-speed laadplan

Zaawansowane · Ręcznie, przez WP-CLI

Co robi
Obsługuje plan ładowania: wtyczki, które ładują kod na froncie bez zmieniania strony, są tam pomijane, po dowodzie. To ta sama funkcja co karta Front-end load plan w Diagnostics. kandidaten wyświetla wtyczki z liczbą ich plików i ostatnim testem. proef <plugin> sprawdza, czy strona pozostaje taka sama bez tej wtyczki. weglaten <plugin> pomija ją na froncie. laden <plugin> ładuje ją ponownie. aan i uit włącza lub wyłącza plan. status pokazuje stan.
Kiedy używać
Gdy wtyczka ładuje dużo kodu frontu, którego Twoi odwiedzający nie potrzebują.
Wymagania
weglaten jest dozwolone tylko po teście z wynikiem gelijk (równe) lub z --bevestigd po samodzielnym przejrzeniu różnicy. Dotyczy tylko anonimowych odwiedzających. Plan jest domyślnie wyłączony.
Jak sprawdzić efekt
Wiersz z modus, weggelaten op de voorkant oraz właścicielem wtyczki must-use (wtyczki, którą WordPress zawsze ładuje jako pierwszą).
Przykład
wp spark-speed laadplan proef contact-form-7
Uwaga
Identyczna strona nie dowodzi, że wtyczka nie wykonuje niewidocznej pracy, takiej jak bezpieczeństwo, śledzenie po stronie serwera czy logowanie. Pomijaj tylko wtyczki, które znasz.
Jak cofnąć
wp spark-speed laadplan laden <plugin> lub wp spark-speed laadplan uit.

Importowanie i analiza pomiarów

Dla tych, którzy mierzą sami: importuj pomiary z przeglądarki, aby Spark nadawał priorytet dokładnie właściwemu obrazowi i czcionkom, i przeglądaj ścieżkę krytyczną.

wp spark-speed image-hint

Zaawansowane · Ręcznie, przez WP-CLI

Co robi
Importuje pomiar z prawdziwej przeglądarki, który rejestruje, który obraz na stronie jest LCP (największym widocznym elementem podczas ładowania). Dopóki pomiar jest ważny, strona z cache ładuje dokładnie ten obraz z priorytetem.
Kiedy używać
Gdy Spark sam wybiera niewłaściwy obraz główny.
Wymagania
Plik JSON o rozmiarze co najwyżej 16 KB ze skanu administratora. Skrypty zbierające wymienione na karcie Measured choices nie są dołączone do pliku zip wtyczki.
Jak sprawdzić efekt
Przy powodzeniu Observation stored; refresh and verify the affected cache variants.. Jeśli adres, wiek, ustawienia lub dowód LCP się nie zgadzają, pomiar jest odrzucany. Wtedy odśwież daną stronę i sprawdź za pomocą verify-cache.
Przykład
wp spark-speed image-hint --file=lcp.json
Uwaga
Polecenie nie czyści cache ani nie zmienia ustawień. Pomiary wygasają po sześciu godzinach oraz po zmianach treści, mediów, menu, motywu, wtyczek lub ustawień.
Jak cofnąć
Nie ma osobnego polecenia do usunięcia pomiaru; po jego wygaśnięciu znów obowiązuje wybór automatyczny.

wp spark-speed font-hint

Zaawansowane · Ręcznie, przez WP-CLI

Co robi
Importuje pomiar lokalnych czcionek, które faktycznie są widocznie ładowane, aby tylko one były ładowane z wyprzedzeniem.
Kiedy używać
Gdy ładowanych jest z wyprzedzeniem zbyt wiele czcionek lub niewłaściwe.
Wymagania
Plik JSON o rozmiarze co najwyżej 16 KB. Skrypty zbierające wymienione na karcie Measured choices nie są dołączone do pliku zip wtyczki.
Jak sprawdzić efekt
Font observation stored; refresh and verify affected cache variants. lub Font observation rejected..
Przykład
wp spark-speed font-hint --file=fonts.json
Uwaga
Nieaktualny pomiar może spowodować wczytanie z wyprzedzeniem niewłaściwej czcionki. Pomiary wygasają po sześciu godzinach i po zmianach w witrynie.
Jak cofnąć
Brak osobnego polecenia; po wygaśnięciu znów obowiązuje wybór automatyczny.

wp spark-speed font-metrics

Zaawansowane · Ręcznie, przez WP-CLI

Co robi
Importuje zmierzone rozmiary dla czcionki zapasowej, aby tekst przesuwał się mniej podczas ładowania czcionki webowej.
Kiedy używać
Gdy tekst widocznie przesuwa się, gdy tylko pojawi się czcionka webowa.
Wymagania
Plik JSON o rozmiarze co najwyżej 16 KB. Wartości spoza zakresu są odrzucane. Skrypty zbierające wymienione na karcie Measured choices nie są dołączone do pliku zip wtyczki.
Jak sprawdzić efekt
Font metrics stored; refresh the affected cache variants and verify the layout. Potem obejrzyj stronę.
Przykład
wp spark-speed font-metrics --file=metrics.json
Uwaga
Błędne rozmiary mogą zamiast tego powodować przesuwanie się tekstu. Sprawdź układ.
Jak cofnąć
Nie znaleziono osobnego polecenia; wyczyść cache danych stron.

wp spark-speed kritiek-pad

Zaawansowane · Ręcznie, przez WP-CLI

Co robi
Pokazuje, co musi się załadować przed LCP (ścieżka krytyczna). Za pomocą --file analizuje JSON Lighthouse (eksport z DevTools lub odpowiedź PageSpeed) i zapisuje wynik dla karty What keeps the score from green w Diagnostics. Za pomocą --page pobiera stronę jako odwiedzający na telefonie i szacuje na podstawie HTML, bez czasów.
Kiedy używać
Gdy chcesz wiedzieć, co obniża wynik.
Wymagania
Jedna z dwóch opcji. Plik Lighthouse musi zawierać żądania sieciowe. --page działa tylko z adresami w tej witrynie.
Jak sprawdzić efekt
Kompaktowy JSON w terminalu.
Przykład
wp spark-speed kritiek-pad --file=lighthouse.json
Jak cofnąć
Niepotrzebne: polecenie niczego więcej w witrynie nie zmienia.

Polecenia wymagające ważnej licencji

Spark Speed ma jeden poziom licencji. Polecenia mcp token i ai apply istnieją tylko, dopóki licencja jest ważna (lub w 14-dniowym okresie karencji); diagnostics istnieje zawsze, ale odmawia bez ważnej licencji.

wp spark-speed diagnostics

Zaawansowane · Ręcznie, przez WP-CLI · works only with a valid licence

Co robi
Wypisuje raport diagnostyczny jako JSON (serwer, PHP, cache, wtyczki) albo zapisuje go do pliku za pomocą --save=<path>. To ten sam raport co Download diagnostic report w panelu administracyjnym.
Kiedy używać
Dla supportu albo do przekazania AI.
Wymagania
Ważna licencja. Polecenie istnieje także bez licencji, ale wtedy odmawia z błędem.
Jak sprawdzić efekt
JSON w terminalu albo Saved to <path>.
Przykład
wp spark-speed diagnostics --save=spark-report.json
Uwaga
Plik zawiera szczegóły serwera i ustawień. Traktuj go jako poufny.
Jak cofnąć
Usuń plik.

wp spark-speed mcp token

Zaawansowane · Ręcznie, przez WP-CLI · only with a valid licence

Co robi
Zarządza kluczami MCP z wiersza poleceń. create tworzy nowy klucz i pokazuje go raz. list pokazuje klucze bez sekretu. revoke <id> unieważnia klucz. Użyj --label aby nazwać klucz (domyślnie WP-CLI). To to samo co karta Create key na karcie Connect Claude or ChatGPT (MCP).
Kiedy używać
Gdy chcesz połączyć z witryną program AI na własnym komputerze, taki jak Claude Code.
Wymagania
Istnieje tylko, dopóki licencja jest ważna. Musisz podać --user=<admin> dla użytkownika z uprawnieniami administratora. create odmawia wypisania na ekran: przekaż wynik od razu do menedżera haseł lub magazynu sekretów. Co najwyżej pięć kluczy.
Jak sprawdzić efekt
list pokazuje dla każdego klucza id, wskazówkę (pierwsze i ostatnie cztery znaki), nazwę, właściciela, czas utworzenia i ostatnie użycie.
Przykład
wp spark-speed mcp token list --user=admin
Uwaga
Klucz może robić wszystko, co potrafią narzędzia MCP, działając jako administrator, który jest jego właścicielem. Zgubionego klucza nie można odzyskać, można go tylko unieważnić. Jeśli właściciel straci uprawnienia administratora, klucz przestaje działać.
Jak cofnąć
wp spark-speed mcp token revoke <id> --user=admin (id, nie sam klucz).

wp spark-speed ai apply

Zaawansowane · Ręcznie, przez WP-CLI · only with a valid licence

Co robi
Stosuje propozycję konfiguracji od AI przez tę samą bramkę bezpieczeństwa co narzędzie MCP apply_config: zabronione ustawienia i ustawienia powiązane z witryną są odrzucane, naraz włączany jest co najwyżej jeden ryzykowny przełącznik, a każda zmiana dostaje change_id. Propozycja pochodzi z --file lub ze standardowego wejścia.
Kiedy używać
Gdy masz propozycję przygotowaną z AI i chcesz zastosować ją w kontrolowany sposób bez otwierania panelu administracyjnego.
Wymagania
Istnieje tylko, dopóki licencja jest ważna. --user=<admin> z uprawnieniami administratora. Propozycja to JSON o rozmiarze co najwyżej 64 KB.
Jak sprawdzić efekt
JSON zawierający między innymi applied, change_id, changed, rejected i next_step. Potem sprawdź witrynę na telefonie: menu, suwaki, formularze i koszyk.
Przykład
wp spark-speed ai apply --file=proposal.json --json --user=admin
Uwaga
Ryzykowne ustawienie może zepsuć front. Po każdej udanej zmianie cache jest budowany od nowa, co przez pewien czas obciąża serwer.
Jak cofnąć
Nie ma polecenia WP-CLI do cofania. Użyj narzędzia MCP revert_change z change_id, albo przywróć ustawienie w panelu administracyjnym.

MCP: łączenie i wymagania

Czego potrzebujesz, zanim asystent AI będzie mógł używać poniższych narzędzi.

MCP-koppeling

Zaawansowane · Bez przełącznika: aktywne, dopóki licencja jest ważna

Co robi
MCP (Model Context Protocol) to standard, dzięki któremu asystent AI, taki jak Claude lub ChatGPT, pracuje z Twoją witryną przez stałe narzędzia. Spark Speed ma w WordPressie własny adres MCP. Daje AI tylko narzędzia wymienione poniżej: mierzenie, zmianę ustawień, cofanie i czyszczenie cache, bez dostępu do serwera.
Wymagania
Ważna licencja i autoryzowany klient działający jako administrator. Są trzy sposoby: własny klucz (przez Create key lub wp spark-speed mcp token) w nagłówku X-Spark-Token lub jako token Bearer; hasło aplikacji WordPress administratora; albo konektor z Claude.ai lub ChatGPT, w którym logujesz się do WordPressa i udzielasz dostępu. Bez ważnej licencji adres odrzuca każde żądanie.
Jak sprawdzić efekt
Adres i wiersze dla Claude Code i Claude Desktop znajdziesz w karcie Connect Claude or ChatGPT (MCP) na karcie Optimization. Po pierwszym żądaniu Twój klucz pokazuje tam czas ostatniego użycia.
Przykład
claude mcp add --transport http spark-speed https://example.com/wp-json/spark-speed/v1/mcp --header "X-Spark-Token: <key>"
Uwaga
Każdy klucz lub użytkownik może wysłać co najwyżej 120 żądań na minutę. Żądanie z przeglądarki na innej domenie jest odrzucane. AI nigdy nie może zmieniać niektórych ustawień, w tym hamulca bezpieczeństwa, automatycznego wycofania i ustawień należących do tego serwera.
Jak cofnąć
Klucz lub połączenie unieważnisz w tej samej karcie albo za pomocą wp spark-speed mcp token revoke.

Narzędzia MCP tylko do odczytu

Te narzędzia niczego nie zmieniają w Twojej witrynie. AI używa ich do mierzenia i uzasadniania propozycji.

get_optimization_guide

Podstawowe · Ręcznie, przez MCP · tylko odczyt

Co robi
Zwraca scenariusz optymalizacji: przebieg pracy, co robi każde ustawienie, które ustawienia są ryzykowne i jak je zweryfikować. Ten sam scenariusz jest dołączony do raportu diagnostycznego.
Kiedy używać
Na początku rozmowy, aby AI wiedziało, jak działa Spark Speed.
Jak sprawdzić efekt
Zwykły tekst, nie JSON.
Przykład
Poproś: „Najpierw przeczytaj przewodnik Spark Speed.”
Jak cofnąć
Nie ma czego cofać: to narzędzie tylko odczytuje.

get_site_overview

Podstawowe · Ręcznie, przez MCP · tylko odczyt

Co robi
Zwraca przegląd: adres witryny, wtyczkę, wersje WordPressa i PHP, wykryty builder, WooCommerce i hosting, pokrycie cache, główne przełączniki i ostatnie zmiany.
Kiedy używać
Na początku każdej sesji.
Jak sprawdzić efekt
JSON zawierający między innymi wersję i przełączniki.
Przykład
Poproś: „Pokaż mi przegląd mojej witryny w Spark Speed.”
Jak cofnąć
Nie ma czego cofać: to narzędzie tylko odczytuje.

get_optimization_status

Podstawowe · Ręcznie, przez MCP · tylko odczyt

Co robi
Pokazuje, czy wbudowany optimizer (przycisk Optimize my site) jest włączony i jak idzie trwająca runda, z linkiem do pulpitu. Celowo nie zwraca ustawień ani danych przeglądarki.
Kiedy używać
Przed i po start_optimization.
Jak sprawdzić efekt
JSON ze statusem i następnym krokiem. Runda, która już nie trwa, nie dowodzi, że wszystko się udało.
Przykład
Poproś: „Jak idzie optymalizacja?”
Jak cofnąć
Nie ma czego cofać: to narzędzie tylko odczytuje.

get_config

Zaawansowane · Ręcznie, przez MCP · tylko odczyt

Co robi
Zwraca wszystkie bieżące ustawienia oraz informację, których ustawień AI nie może zmieniać, które są powiązane z tą witryną lub serwerem i które są ryzykowne.
Kiedy używać
Zanim AI zaproponuje zmianę.
Jak sprawdzić efekt
JSON.
Przykład
Poproś: „Które ustawienia są teraz włączone?”
Uwaga
Pokazuje to AI Twoją pełną konfigurację Spark Speed.
Jak cofnąć
Nie ma czego cofać: to narzędzie tylko odczytuje.

get_diagnostics

Zaawansowane · Ręcznie, przez MCP · tylko odczyt

Co robi
Zwraca pełny raport diagnostyczny: serwer, cache, co ładuje się na stronach i ustalenia, w tym co optimizer zdecydował wcześniej. Duży; użyj go, gdy przegląd nie wystarcza.
Kiedy używać
Gdy szukasz przyczyny albo chcesz odczytać decyzje Optimize my site.
Jak sprawdzić efekt
JSON.
Przykład
Poproś: „Co optimizer zdecydował w ostatniej rundzie?”
Uwaga
Zawiera szczegóły serwera.
Jak cofnąć
Nie ma czego cofać: to narzędzie tylko odczytuje.

check_page

Zaawansowane · Ręcznie, przez MCP · tylko odczyt

Co robi
Pobiera jedną stronę Twojej witryny jako odwiedzający na komputerze i na telefonie: status cache (HIT lub MISS), podaną wersję i to, co ładuje HTML (skrypty, opóźnione skrypty, arkusze stylów, preloady, obraz LCP). Za pomocą measure wykonuje też pomiar Google PageSpeed Insights.
Kiedy używać
Po każdej zmianie, dla każdej ważnej strony.
Wymagania
Pełny adres w tej witrynie bez query stringa. Dla measure: skonfigurowany klucz PageSpeed i publicznie dostępna witryna.
Jak sprawdzić efekt
JSON z częścią dotyczącą cache, analizą HTML i opcjonalnie pomiarem.
Przykład
{"url": "https://example.com/", "measure": true, "strategy": "mobile"}
Uwaga
Za pomocą measure publiczny adres jest wysyłany do Google. Pomiary są ograniczone do dwóch na minutę na użytkownika.
Jak cofnąć
Nie ma czego cofać: to narzędzie tylko odczytuje.

get_site_findings

Zaawansowane · Ręcznie, przez MCP · tylko odczyt

Co robi
Zwraca problemy w samej witrynie, z nazwami plików i zmierzonym kosztem: błędy 404, łańcuchy przekierowań i ciężkie pliki.
Kiedy używać
Gdy wynik jest niski z powodu czegoś, czego Spark nie może naprawić.
Jak sprawdzić efekt
JSON.
Przykład
Poproś: „Jakie problemy są w samej mojej witrynie?”
Jak cofnąć
Nie ma czego cofać: to narzędzie tylko odczytuje.

get_warm_status

Zaawansowane · Ręcznie, przez MCP · tylko odczyt

Co robi
Zwraca stan budowania cache: strony w cache w stosunku do całości, czy budowanie trwa, czy utknęło, i nieudane adresy. Te same dane co wp spark-speed warm-status.
Kiedy używać
Po czyszczeniu cache lub zmianie.
Jak sprawdzić efekt
JSON albo available: false gdy nie da się ustalić stanu.
Przykład
Poproś: „Czy cache został już zbudowany?”
Jak cofnąć
Nie ma czego cofać: to narzędzie tylko odczytuje.

list_changes

Podstawowe · Ręcznie, przez MCP · tylko odczyt

Co robi
Zwraca zmiany wykonane przez MCP lub ai apply, z change_id, czasem, użytkownikiem, uzasadnieniem i informacją, czy zostały cofnięte, oraz oś czasu wszystkich zmian ustawień w witrynie.
Kiedy używać
Aby znaleźć change_id dla revert_change.
Wymagania
Opcjonalny limit od 1 do 60 (domyślnie 15).
Jak sprawdzić efekt
JSON z listą zmian i osią czasu.
Przykład
{"limit": 20}
Jak cofnąć
Nie ma czego cofać: to narzędzie tylko odczytuje.

Narzędzia MCP, które coś zmieniają

Te cztery narzędzia zmieniają witrynę. Dobry asystent AI najpierw prosi o Twoją zgodę i wykonuje jeden krok naraz.

start_optimization

Podstawowe · Ręcznie, przez MCP · coś zmienia

Co robi
Włącza wbudowany optimizer i uruchamia rundę, tak samo jak przycisk Optimize my site w karcie Smart optimization. Optimizer używa własnych reguł i kontroli przeglądarki. Jeśli runda już trwa, używana jest ta sama.
Kiedy używać
Tylko po Twojej wyraźnej zgodzie; AI musi wysłać confirm: true.
Wymagania
Przeglądarka z otwartym pulpitem Spark Speed. Kontrola przeglądarki działa na tym otwartym ekranie administracyjnym, a runda nie zostanie ukończona, jeśli nikt nie otworzy pulpitu. Samo MCP nie wystarcza więc do ukończenia rundy bez przeglądarki.
Jak sprawdzić efekt
Odpowiedź zawiera run_id oraz status. Śledź rundę za pomocą get_optimization_status oraz na pulpicie; udany start nie dowodzi, że kontrola się zakończyła.
Przykład
{"confirm": true}
Uwaga
Optimizer może zmieniać ustawienia. W 0.73.2 panel nie pokazuje listy decyzji ani przycisku do cofnięcia całej rundy; decyzje odczytasz w raporcie diagnostycznym lub przez get_diagnostics.
Jak cofnąć
Przywróć dane ustawienia na karcie Optimization lub Cache.

apply_config

Zaawansowane · Ręcznie, przez MCP · coś zmienia

Co robi
Zmienia ustawienia Spark Speed przez tę samą bramkę bezpieczeństwa co propozycja AI w panelu administracyjnym. Do list dopisywane są nowe wpisy, chyba że są wymienione w replace_lists. Za pomocą dry_run najpierw zobaczysz, co by się zmieniło. Każda rzeczywista zmiana dostaje change_id i trafia na oś czasu wraz z uzasadnieniem; potem cache jest budowany od nowa.
Kiedy używać
Po zmierzeniu narzędziami odczytu, jeden krok na raz.
Wymagania
changes oraz jednozdaniowe reason. Tylko ustawienia z get_config, co najwyżej 40 naraz i co najwyżej jeden włączony ryzykowny przełącznik na wywołanie. Zabronione ustawienia i ustawienia powiązane z witryną są odrzucane z podaniem powodu.
Jak sprawdzić efekt
JSON z applied, change_id, changed (stara i nowa wartość dla każdego ustawienia) oraz rejected. Potem sprawdź witrynę na telefonie: menu, suwaki, formularze i koszyk.
Przykład
{"changes": {"delay_js": true}, "reason": "Reduce main-thread work", "dry_run": true}
Uwaga
Ryzykowne ustawienie może zepsuć front. Odbudowa cache obciąża serwer.
Jak cofnąć
revert_change z change_id.

revert_change

Podstawowe · Ręcznie, przez MCP · coś zmienia

Co robi
Cofa jedną wcześniejszą zmianę wykonaną za pomocą apply_config lub ai apply. Wracają tylko ustawienia tej zmiany. Jeśli ustawienie zostało potem zmienione ponownie, przez kogoś innego lub w późniejszym kroku, zostaje nietknięte i jest zgłaszane.
Kiedy używać
Gdy zmiana coś psuje albo nie przynosi korzyści.
Wymagania
Wymagane change_id (zobacz list_changes). Znanych jest tylko ostatnie 30 zmian wykonanych przez MCP lub WP-CLI.
Jak sprawdzić efekt
JSON z reverted, restored i left_alone_because_changed_since. Drugie wywołanie zgłasza, że zmiana została już cofnięta.
Przykład
{"change_id": "mcp-20261010-101500-ab12cd"}
Uwaga
Nie cofa to zmian wykonanych w panelu administracyjnym ani przez optimizer.
Jak cofnąć
Zastosuj zmianę ponownie za pomocą apply_config.

purge_cache

Podstawowe · Ręcznie, przez MCP · coś zmienia

Co robi
Czyści cache stron dla jednego adresu albo dla całej witryny, gdy nie podasz adresu. Dla całej witryny wszystko jest kolejkowane od nowa. Trafia to na oś czasu.
Kiedy używać
Gdy strona pokazuje nieaktualną wersję.
Wymagania
Adres musi należeć do tej witryny.
Jak sprawdzić efekt
Odpowiedź purged z adresem lub all.
Przykład
{"url": "https://example.com/shop/"}
Uwaga
Po pełnym czyszczeniu cache strony są wolniejsze, dopóki budowanie się nie zakończy.
Jak cofnąć
Niepotrzebne: budowanie cache napełnia go ponownie.
Masz wątpliwości co do jakiegoś kroku? Cofnij zmianę, sprawdź swoją witrynę i napisz do nas przez stronę kontaktową.
Nie masz jeszcze Spark Speed? Zobacz, co robi i ile kosztuje.

Najczęściej zadawane pytania

Nie. Przez MCP AI może mierzyć, zmieniać ustawienia i uruchamiać rundę optymalizacji, ale kontrola przeglądarki tej rundy działa w pulpicie Spark Speed. Musi on być otwarty w przeglądarce, dopóki runda trwa.

mcp token i ai apply istnieją tylko z ważną licencją, a diagnostics odmawia bez niej. Pozostałe polecenia są dostępne, ale zarządzanie i nowe optymalizacje wymagają ważnej licencji lub 14-dniowego okresu karencji.

Znajdź change_id za pomocą list_changes i użyj revert_change. Wracają tylko ustawienia tej zmiany. Zmiany z przycisku Optimize my site w 0.73.2 cofasz, samodzielnie przywracając te ustawienia.

Klucz jest pokazywany tylko raz i nie można go odzyskać. Unieważnij go w karcie Connect Claude or ChatGPT (MCP) lub za pomocą wp spark-speed mcp token revoke i utwórz nowy.

Tak zostały zbudowane w 0.73.2: winkelwagen (koszyk), klantcache (cache klientów), laadplan (plan ładowania) i warm-hervat (wznowienie rozgrzewania) używają niderlandzkich słów, takich jak aan, uit, proef i legen. Część wyniku też jest po niderlandzku.