Skip to main content
SparkCore

WP-CLI e MCP: tutti i comandi e gli strumenti

Questa pagina descrive tutto ciò che si può fare in Spark Speed 0.73.2 senza la schermata di amministrazione: i comandi WP-CLI sul server e gli strumenti MCP con cui un assistente AI come Claude o ChatGPT lavora sul suo sito. È destinata ad amministratori e agenzie che lavorano con la riga di comando o con un assistente AI; per la gestione quotidiana non le serve.
In breve
  • Tutti i comandi iniziano con wp spark-speed e vengono eseguiti sul server
  • mcp token e ai apply esistono solo con una licenza valida; diagnostics rifiuta senza
  • MCP richiede una licenza valida e un client autorizzato che opera come amministratore
  • start_optimization richiede una dashboard aperta nel browser per il controllo del browser

Stato e cache

Vedere subito a che punto è la cache, svuotarla e verificare che cosa ricevono i visitatori.

wp spark-speed status

Base · Manuale, tramite WP-CLI

Che cosa fa
Mostra in cinque righe lo stato della cache: quale plugin gestisce il drop-in della cache (il file con cui WordPress carica presto la cache delle pagine), se WP_CACHE è attivo, quante pagine sono in cache, quanti indirizzi sono in coda e se il worker locale opzionale è raggiungibile. Utile per dare una rapida occhiata senza aprire wp-admin.
Quando usarlo
Dopo un aggiornamento, una migrazione o un purge, oppure in uno script di monitoraggio.
Come verificare l'effetto
L'output è in inglese: Drop-in owner, WP_CACHE, Cached pages, Queue pending, Worker. Worker : OFFLINE è normale: il worker è opzionale e non è incluso nello zip; Spark utilizza allora il percorso PHP.
Esempio
wp spark-speed status
Come annullare
Nulla da annullare: il comando si limita a leggere.

wp spark-speed purge

Base · Manuale, tramite WP-CLI

Che cosa fa
Svuota l'intera cache delle pagine. Poi le pagine vengono ricostruite alla visita successiva o dalla costruzione della cache.
Quando usarlo
Quando i visitatori vedono una versione obsoleta o dopo una grossa modifica a tema o impostazioni.
Come verificare l'effetto
Vede Page cache purged. Con wp spark-speed status vede Cached pages diminuire.
Esempio
wp spark-speed purge
Attenzione
Finché la cache non è stata ricostruita, le prime visite sono più lente. La object cache non viene svuotata da questo comando: per quella c'è flush-object-cache.
Come annullare
Non si può annullare. Ricostruisca la cache con wp spark-speed optimize --all e poi wp spark-speed warm.

wp spark-speed flush-object-cache

Avanzato · Manuale, tramite WP-CLI

Che cosa fa
Svuota la object cache (l'archivio temporaneo dei risultati del database, ad esempio in Redis, Memcached, APCu o SQLite) che passa dal drop-in object cache di Spark. È volutamente separata dalla cache delle pagine.
Quando usarlo
Quando sospetta che nella object cache ci siano dati obsoleti. Spark non svuota da sé la object cache in automatico.
Requisiti
Una object cache di Spark funzionante. In caso contrario riceve un avviso.
Come verificare l'effetto
Un messaggio di successo, oppure un avviso se non c'era nulla da svuotare.
Esempio
wp spark-speed flush-object-cache
Attenzione
Subito dopo lo svuotamento WordPress chiede di nuovo più dati al database.
Come annullare
Non serve: la object cache si riempie di nuovo da sola.

wp spark-speed verify-cache

Avanzato · Manuale, tramite WP-CLI

Che cosa fa
Recupera una pagina del suo sito come visitatore desktop e come visitatore mobile e dà un giudizio in JSON: quale stato della cache è stato servito e se corrisponde al codice e alle impostazioni attuali.
Quando usarlo
Dopo una modifica, per verificare che i visitatori ricevano la nuova versione in cache.
Requisiti
--page con un indirizzo completo di questo sito, senza query string. Senza --page il comando si interrompe con un errore.
Come verificare l'effetto
Nel JSON compare ok. Il codice di uscita è 0 se tutto è corretto e 2 se non lo è, così può usarlo in uno script.
Esempio
wp spark-speed verify-cache --page=https://example.com/product/example/
Come annullare
Nulla da annullare: il comando si limita a leggere.

Costruzione della cache

Ottimizzare le pagine, smaltire la coda e seguire o riprendere la costruzione della cache. La stessa costruzione la vede nell'area di amministrazione, nella scheda Cache.

wp spark-speed optimize

Avanzato · Manuale, tramite WP-CLI

Che cosa fa
Senza opzioni aggiuntive ricostruisce la homepage, ottimizzata e messa in cache per ogni dispositivo. Con --page=<address> lo fa per una sola pagina. Con --all mette in coda tutte le pagine del sito; il lavoro vero e proprio lo svolge poi con process o warm.
Quando usarlo
Dopo un purge, oppure quando vuole avere subito pronta una pagina importante.
Requisiti
Usi --page, non --url: --url è già riservato in WP-CLI.
Come verificare l'effetto
Per ogni dispositivo una riga con il risultato, ad esempio ok o il motivo per cui non è riuscito. Con --all vede quanti indirizzi sono stati messi in coda.
Esempio
wp spark-speed optimize --page=https://example.com/shop/
Attenzione
Se il freno di emergenza (modalità sicura) è attivo o l'ottimizzazione è disattivata, le pagine vengono solo messe in cache e non ottimizzate.
Come annullare
Svuoti la cache di quella pagina o l'intera cache.

wp spark-speed process

Avanzato · Manuale, tramite WP-CLI

Che cosa fa
Elabora subito una parte della coda, per impostazione predefinita 20 indirizzi. Usa lo stesso lock dell'elaborazione in background, così non si ostacolano a vicenda.
Quando usarlo
Per smaltire a tappe una coda piena, ad esempio dopo optimize --all.
Requisiti
Una coda con indirizzi. Il numero si modifica con --limit=<number>.
Come verificare l'effetto
Per ogni indirizzo una riga con il risultato per dispositivo e, alla fine, Batch done. Remaining: N.
Esempio
wp spark-speed process --limit=50
Attenzione
Appesantisce il server finché è in esecuzione. Se un'altra elaborazione tiene il lock, non succede nulla.
Come annullare
Non applicabile.

wp spark-speed warm

Avanzato · Manuale, tramite WP-CLI

Che cosa fa
Smaltisce l'intera coda fino a svuotarla, in blocchi da 25 per impostazione predefinita. Se non c'è avanzamento, ne cerca la causa. Se un'altra elaborazione è in corso, lo segnala e si ferma; con --wait attende fino a 15 minuti il lock.
Quando usarlo
Sui siti con poche visite, dove WP-Cron non gira da solo abbastanza spesso, oppure dopo un purge completo.
Requisiti
Il sito deve poter raggiungere se stesso (loopback), perché la costruzione recupera le sue pagine. La dimensione dei blocchi si modifica con --batch=<number>.
Come verificare l'effetto
Per ogni ciclo remaining: N (cached M) e un riepilogo. Il codice di uscita è 0 se la coda è vuota, 1 se resta del lavoro e 2 se la costruzione è bloccata o si è inceppata.
Esempio
wp spark-speed warm --wait
Attenzione
Può richiedere molto tempo e appesantisce il server. Un sito in modalità di manutenzione o dietro una protezione anti-bot che risponde 403 fa fallire le pagine.
Come annullare
Si interrompe con Ctrl+C. La cache già costruita si può svuotare con purge.

wp spark-speed warm-status

Base · Manuale, tramite WP-CLI

Che cosa fa
Mostra a che punto è la costruzione della cache: lo stato e da quando, da quanto tempo non succede nulla, il motivo, la coda, le pagine in cache rispetto al totale, un'eventuale pausa, gli indirizzi falliti e l'ultimo test. Con --json ottiene tutto come JSON.
Quando usarlo
Quando la costruzione non avanza, oppure in un monitor che controlla il codice di uscita.
Come verificare l'effetto
Le righe hanno etichette in olandese (stand, sinds, wachtrij, gecached, pauze, fails, laatste toets). Il codice di uscita 0 indica stato sano, 1 una causa nota, 2 uno stallo e 3 che lo stato non è determinabile.
Esempio
wp spark-speed warm-status --json
Come annullare
Nulla da annullare: il comando si limita a leggere.

wp spark-speed warm-hervat

Avanzato · Manuale, tramite WP-CLI

Che cosa fa
Verifica una costruzione della cache in pausa con un tentativo reale sul primo indirizzo in coda e la riprende se il sito risponde correttamente. È la versione da riga di comando del pulsante per riprendere la costruzione nella scheda Cache.
Quando usarlo
Dopo aver risolto la causa di una pausa, ad esempio un errore di loopback o una protezione anti-bot.
Requisiti
Una pausa aperta. Senza pausa segnala Er stond geen pauze open..
Come verificare l'effetto
Se riprende, vede Hervat. con la coda e il numero di pagine in cache (codice di uscita 0). Se non riesce, un avviso Niet hervat: <reason> (codice di uscita 1). Verifichi poi con warm-status.
Esempio
wp spark-speed warm-hervat
Attenzione
Se il sito continua a dare errori, la pausa resta.
Come annullare
Non applicabile.

Negozio, clienti e piano di caricamento

Questi comandi gestiscono funzioni che trova anche nell'area di amministrazione, con la stessa prova preliminare. I sottocomandi sono parole olandesi: aan, uit, proef, legen.

wp spark-speed winkelwagen

Avanzato · Manuale, tramite WP-CLI

Che cosa fa
Gestisce la cache per i visitatori con il carrello pieno, la stessa funzione di Cached pages with a filled cart nella card Cart and logged-in customers. status (predefinito) mostra lo stato e l'ultima prova. proef esegue la prova. aan attiva la funzione e uit la disattiva.
Quando usarlo
Su un negozio WooCommerce dove gli acquirenti con qualcosa nel carrello altrimenti ricevono ogni volta una pagina costruita da zero e lenta.
Requisiti
WooCommerce. aan funziona solo dopo una prova riuscita, oppure con --bevestigd dopo che ha esaminato personalmente una differenza rilevata.
Come verificare l'effetto
La prova segnala il risultato, il numero di pagine, se lo script del carrello è necessario e quali differenze ci sono. All'attivazione vede Winkelwagencache aan; de paginacache is geleegd..
Esempio
wp spark-speed winkelwagen proef
Attenzione
L'attivazione svuota l'intera cache delle pagine. Se approva con --bevestigd una differenza per errore, contenuti personali possono finire in pagine condivise.
Come annullare
wp spark-speed winkelwagen uit
Nome tecnico
woo_cart_cache

wp spark-speed klantcache

Avanzato · Manuale, tramite WP-CLI

Che cosa fa
Gestisce la cache dedicata ai clienti con accesso effettuato, la stessa funzione di Own cache for logged-in customers nella card Cart and logged-in customers. status (predefinito) mostra lo stato, il numero di sessioni con una copia propria e se la funzione può essere attivata. aan, uit (disattiva e svuota) e legen (svuota tutte le copie dei clienti).
Quando usarlo
Quando i clienti con accesso effettuato ricevono a ogni clic una pagina costruita da zero.
Requisiti
Se la funzione non può essere attivata su questo sito, rifiuta aan con il motivo. Solo ruoli cliente, mai amministratori. Una copia ha al massimo 8 ore.
Come verificare l'effetto
Messaggi come Klantcache aan. o Klantcache uit en geleegd., e con status una riga con stand, sessies met eigen kopieen e kan aan.
Esempio
wp spark-speed klantcache status
Attenzione
Ogni sessione con accesso effettuato riceve copie proprie, quindi l'uso del disco cresce con il numero di clienti.
Come annullare
wp spark-speed klantcache uit
Nome tecnico
klant_cache

wp spark-speed laadplan

Avanzato · Manuale, tramite WP-CLI

Che cosa fa
Gestisce il piano di caricamento: i plugin che caricano codice sul front-end ma non modificano la pagina vengono saltati lì, dopo una prova. È la stessa funzione della card Front-end load plan sotto Diagnostics. kandidaten mostra i plugin con il numero di file e l'ultima prova. proef <plugin> verifica se la pagina resta uguale senza quel plugin. weglaten <plugin> lo salta sul front-end. laden <plugin> lo carica di nuovo. aan e uit attivano o disattivano il piano. status mostra lo stato.
Quando usarlo
Quando un plugin carica sul front-end molto codice di cui i visitatori non hanno bisogno.
Requisiti
weglaten è consentito solo dopo una prova con esito gelijk, oppure con --bevestigd dopo che ha esaminato personalmente una differenza. Vale solo per i visitatori anonimi. Il piano è disattivato per impostazione predefinita.
Come verificare l'effetto
Una riga con modus, weggelaten op de voorkant e il proprietario del mu-plugin (un plugin che WordPress carica sempre per primo).
Esempio
wp spark-speed laadplan proef contact-form-7
Attenzione
Una pagina uguale non dimostra che un plugin non svolga un lavoro invisibile, come sicurezza, tracciamento lato server o logging. Ometta solo plugin che conosce.
Come annullare
wp spark-speed laadplan laden <plugin> o wp spark-speed laadplan uit.

Importare e analizzare le misurazioni

Per chi misura da sé: importare misurazioni del browser in modo che Spark dia priorità esattamente all'immagine e ai caratteri giusti, e consultare il percorso critico.

wp spark-speed image-hint

Avanzato · Manuale, tramite WP-CLI

Che cosa fa
Importa una misurazione da un browser reale che registra quale immagine di una pagina è l'LCP (l'elemento visibile più grande durante il caricamento). Finché la misurazione è valida, la pagina in cache carica con priorità proprio quell'immagine.
Quando usarlo
Quando Spark sceglie da sé l'immagine principale sbagliata.
Requisiti
Un file JSON di al massimo 16 KB da una scansione dell'amministratore. Gli script di raccolta citati nella card Measured choices non sono inclusi nello zip del plugin.
Come verificare l'effetto
In caso di successo Observation stored; refresh and verify the affected cache variants.. Se l'indirizzo, l'età, le impostazioni o la prova LCP non corrispondono, la misurazione viene rifiutata. Aggiorni poi la pagina interessata e verifichi con verify-cache.
Esempio
wp spark-speed image-hint --file=lcp.json
Attenzione
Il comando non svuota la cache e non modifica le impostazioni. Le misurazioni scadono dopo sei ore e in caso di modifiche a contenuti, media, menu, tema, plugin o impostazioni.
Come annullare
Non esiste un comando separato per eliminare una misurazione; dopo la scadenza torna valida la scelta automatica.

wp spark-speed font-hint

Avanzato · Manuale, tramite WP-CLI

Che cosa fa
Importa una misurazione dei caratteri locali caricati davvero in modo visibile, così che vengano precaricati solo quelli.
Quando usarlo
Quando vengono precaricati troppi caratteri o quelli sbagliati.
Requisiti
Un file JSON di al massimo 16 KB. Gli script di raccolta citati nella card Measured choices non sono inclusi nello zip del plugin.
Come verificare l'effetto
Font observation stored; refresh and verify affected cache variants. o Font observation rejected..
Esempio
wp spark-speed font-hint --file=fonts.json
Attenzione
Una misurazione obsoleta può precaricare il carattere sbagliato. Le misurazioni scadono dopo sei ore e in caso di modifiche al sito.
Come annullare
Nessun comando separato; dopo la scadenza torna valida la scelta automatica.

wp spark-speed font-metrics

Avanzato · Manuale, tramite WP-CLI

Che cosa fa
Importa le misure rilevate del carattere di ripiego, così che il testo si sposti meno mentre il web font si carica.
Quando usarlo
Quando il testo si sposta visibilmente non appena arriva il web font.
Requisiti
Un file JSON di al massimo 16 KB. I valori fuori dall'intervallo consentito vengono rifiutati. Gli script di raccolta citati nella card Measured choices non sono inclusi nello zip del plugin.
Come verificare l'effetto
Font metrics stored; refresh the affected cache variants and verify the layout. Poi guardi la pagina.
Esempio
wp spark-speed font-metrics --file=metrics.json
Attenzione
Misure sbagliate possono invece far spostare il testo. Controlli il layout.
Come annullare
Nessun comando separato trovato; svuoti la cache delle pagine interessate.

wp spark-speed kritiek-pad

Avanzato · Manuale, tramite WP-CLI

Che cosa fa
Mostra che cosa deve caricarsi prima dell'LCP (il percorso critico). Con --file analizza un JSON di Lighthouse (un'esportazione da DevTools o una risposta di PageSpeed) e conserva il risultato per la card What keeps the score from green sotto Diagnostics. Con --page recupera la pagina come visitatore mobile e stima in base all'HTML, senza tempi.
Quando usarlo
Quando vuole sapere che cosa frena il punteggio.
Requisiti
Una delle due opzioni. Il file di Lighthouse deve contenere le richieste di rete. --page funziona solo con indirizzi di questo sito.
Come verificare l'effetto
JSON compatto nel terminale.
Esempio
wp spark-speed kritiek-pad --file=lighthouse.json
Come annullare
Non serve: il comando non modifica nient'altro nel sito.

Comandi che richiedono una licenza valida

Spark Speed ha un solo livello di licenza. I comandi mcp token e ai apply esistono solo finché la licenza è valida (o nel periodo di tolleranza di 14 giorni); diagnostics esiste sempre ma rifiuta senza una licenza valida.

wp spark-speed diagnostics

Avanzato · Manuale, tramite WP-CLI · funziona solo con licenza valida

Che cosa fa
Fornisce il report diagnostico come JSON (server, PHP, cache, plugin), oppure lo salva in un file con --save=<path>. È lo stesso report di Download diagnostic report nell'area di amministrazione.
Quando usarlo
Per il supporto, oppure da dare a un'AI.
Requisiti
Una licenza valida. Il comando esiste anche senza licenza, ma in quel caso rifiuta con un messaggio di errore.
Come verificare l'effetto
JSON nel terminale, oppure Saved to <path>.
Esempio
wp spark-speed diagnostics --save=spark-report.json
Attenzione
Il file contiene dati del server e delle impostazioni. Lo tratti come riservato.
Come annullare
Elimini il file.

wp spark-speed mcp token

Avanzato · Manuale, tramite WP-CLI · solo con licenza valida

Che cosa fa
Gestisce le chiavi MCP dalla riga di comando. create crea una nuova chiave e la mostra una sola volta. list mostra le chiavi senza il segreto. revoke <id> revoca una chiave. Con --label assegna un nome alla chiave (per impostazione predefinita WP-CLI). È lo stesso di Create key nella card Connect Claude or ChatGPT (MCP).
Quando usarlo
Quando vuole collegare al sito un programma AI sul suo computer, come Claude Code.
Requisiti
Esiste solo finché la licenza è valida. Deve indicare --user=<admin> per un utente con diritti di amministratore. create rifiuta di scrivere su uno schermo: inoltri l'output direttamente al suo gestore di password o archivio di segreti. Al massimo cinque chiavi.
Come verificare l'effetto
list mostra per ogni chiave un id, un suggerimento (primi e ultimi quattro caratteri), nome, proprietario, momento di creazione e ultimo utilizzo.
Esempio
wp spark-speed mcp token list --user=admin
Attenzione
Una chiave può fare tutto ciò che possono fare gli strumenti MCP, come l'amministratore a cui appartiene. Una chiave smarrita non si può recuperare, solo revocare. Se il proprietario perde i diritti di amministratore, la chiave smette di funzionare.
Come annullare
wp spark-speed mcp token revoke <id> --user=admin (l'id, non la chiave stessa).

wp spark-speed ai apply

Avanzato · Manuale, tramite WP-CLI · solo con licenza valida

Che cosa fa
Applica una proposta di configurazione di un'AI tramite lo stesso controllo di sicurezza dello strumento MCP apply_config: le impostazioni vietate e legate al sito vengono rifiutate, al massimo un interruttore a rischio per volta viene attivato e ogni modifica riceve un change_id. La proposta proviene da --file o dallo standard input.
Quando usarlo
Quando ha creato una proposta con un'AI e vuole applicarla in modo controllato senza aprire l'area di amministrazione.
Requisiti
Esiste solo finché la licenza è valida. --user=<admin> con diritti di amministratore. La proposta è un JSON di al massimo 64 KB.
Come verificare l'effetto
JSON con, tra l'altro, applied, change_id, changed, rejected e next_step. Controlli poi il sito su mobile: menu, slider, moduli e carrello.
Esempio
wp spark-speed ai apply --file=proposal.json --json --user=admin
Attenzione
Un'impostazione a rischio può rompere il front-end. Dopo ogni modifica riuscita la cache viene ricostruita, il che appesantisce brevemente il server.
Come annullare
Non esiste un comando WP-CLI per annullare. Usi lo strumento MCP revert_change con il change_id, oppure ripristini l'impostazione nell'area di amministrazione.

MCP: collegamento e requisiti

Di che cosa ha bisogno prima che un assistente AI possa usare gli strumenti qui sotto.

Collegamento MCP

Avanzato · Nessun interruttore: attivo finché la licenza è valida

Che cosa fa
MCP (Model Context Protocol) è uno standard con cui un assistente AI come Claude o ChatGPT può lavorare sul suo sito con strumenti predefiniti. Spark Speed ha un proprio indirizzo MCP in WordPress. All'AI fornisce solo gli strumenti elencati qui sotto: misurare, impostare, annullare e svuotare la cache, senza accesso al server.
Requisiti
Una licenza valida e un client autorizzato che opera come amministratore. Ci sono tre modi: una chiave propria (tramite Create key o wp spark-speed mcp token) nell'header X-Spark-Token oppure come Bearer token; una password applicativa di WordPress di un amministratore; oppure il collegamento da Claude.ai o ChatGPT, in cui accede a WordPress e concede il consenso. Senza licenza valida l'indirizzo rifiuta qualsiasi richiesta.
Come verificare l'effetto
L'indirizzo e le righe per Claude Code e Claude Desktop si trovano nella card Connect Claude or ChatGPT (MCP) nella scheda Optimization. Dopo la prima richiesta, la sua chiave mostra lì un orario di ultimo utilizzo.
Esempio
claude mcp add --transport http spark-speed https://example.com/wp-json/spark-speed/v1/mcp --header "X-Spark-Token: <key>"
Attenzione
Per ogni chiave o utente sono consentite al massimo 120 richieste al minuto. Una richiesta proveniente da un browser di un altro dominio viene rifiutata. Un'AI non può mai modificare alcune impostazioni, tra cui il freno di emergenza, l'annullamento automatico e le impostazioni legate a questo server.
Come annullare
Revochi una chiave o un collegamento nella stessa card, oppure con wp spark-speed mcp token revoke.

Strumenti MCP di sola lettura

Questi strumenti non modificano nulla nel suo sito. Un'AI li usa per misurare e per motivare una proposta.

get_optimization_guide

Base · Manuale, tramite MCP · sola lettura

Che cosa fa
Fornisce la guida all'ottimizzazione: il metodo di lavoro, che cosa fa ogni impostazione, quali impostazioni sono a rischio e come si verifica. La stessa guida è contenuta nel report diagnostico.
Quando usarlo
All'inizio di una conversazione, così che l'AI sappia come funziona Spark Speed.
Come verificare l'effetto
Testo semplice, non JSON.
Esempio
Richiesta: "Legga prima la guida di Spark Speed."
Come annullare
Nulla da annullare: questo strumento si limita a leggere.

get_site_overview

Base · Manuale, tramite MCP · sola lettura

Che cosa fa
Fornisce una panoramica: indirizzo del sito, versioni di plugin, WordPress e PHP, la combinazione riconosciuta di builder, WooCommerce e host, la copertura della cache, gli interruttori principali e le ultime modifiche.
Quando usarlo
All'inizio di ogni sessione.
Come verificare l'effetto
JSON con, tra l'altro, la versione e gli interruttori.
Esempio
Richiesta: "Mi dia una panoramica del mio sito in Spark Speed."
Come annullare
Nulla da annullare: questo strumento si limita a leggere.

get_optimization_status

Base · Manuale, tramite MCP · sola lettura

Che cosa fa
Mostra se l'optimizer integrato (il pulsante Optimize my site) è attivo e a che punto è un ciclo in corso, con un link alla dashboard. Impostazioni e dati del browser questo strumento non li fornisce volutamente.
Quando usarlo
Prima e dopo start_optimization.
Come verificare l'effetto
JSON con lo stato e un passo successivo. Un ciclo non più in corso non è ancora la prova che tutto sia riuscito.
Esempio
Richiesta: "A che punto è l'ottimizzazione?"
Come annullare
Nulla da annullare: questo strumento si limita a leggere.

get_config

Avanzato · Manuale, tramite MCP · sola lettura

Che cosa fa
Fornisce tutte le impostazioni attuali, più quali impostazioni un'AI non può modificare, quali sono legate a questo sito o server e quali sono a rischio.
Quando usarlo
Prima che l'AI proponga una modifica.
Come verificare l'effetto
JSON.
Esempio
Richiesta: "Quali impostazioni sono attive adesso?"
Attenzione
Con questo strumento l'AI vede la sua intera configurazione di Spark Speed.
Come annullare
Nulla da annullare: questo strumento si limita a leggere.

get_diagnostics

Avanzato · Manuale, tramite MCP · sola lettura

Che cosa fa
Fornisce il report diagnostico completo: server, cache, che cosa si carica nelle pagine e risultati, comprese le decisioni prese in precedenza dall'optimizer. Voluminoso; lo usi quando la panoramica non basta.
Quando usarlo
Nella ricerca di una causa, oppure per rileggere le decisioni di Optimize my site.
Come verificare l'effetto
JSON.
Esempio
Richiesta: "Che cosa ha deciso l'optimizer nell'ultimo ciclo?"
Attenzione
Contiene dati del server.
Come annullare
Nulla da annullare: questo strumento si limita a leggere.

check_page

Avanzato · Manuale, tramite MCP · sola lettura

Che cosa fa
Recupera una pagina del suo sito come visitatore desktop e mobile: stato della cache (HIT o MISS), la versione servita e ciò che l'HTML carica (script, script rinviati, fogli di stile, preload, immagine LCP). Con measure esegue anche una misurazione tramite Google PageSpeed Insights.
Quando usarlo
Dopo ogni modifica, per ogni pagina importante.
Requisiti
Un indirizzo completo di questo sito senza query string. Per measure: una chiave PageSpeed configurata e un sito raggiungibile pubblicamente.
Come verificare l'effetto
JSON con una parte sulla cache, un'analisi dell'HTML ed eventualmente una misurazione.
Esempio
{"url": "https://example.com/", "measure": true, "strategy": "mobile"}
Attenzione
Con measure l'indirizzo pubblico viene inviato a Google. Si può misurare al massimo due volte al minuto per utente.
Come annullare
Nulla da annullare: questo strumento si limita a leggere.

get_site_findings

Avanzato · Manuale, tramite MCP · sola lettura

Che cosa fa
Fornisce i problemi del sito stesso, con nomi di file e costi misurati: errori 404, catene di reindirizzamenti e file pesanti.
Quando usarlo
Quando il punteggio resta basso per qualcosa che Spark non può risolvere.
Come verificare l'effetto
JSON.
Esempio
Richiesta: "Quali problemi ci sono nel mio sito stesso?"
Come annullare
Nulla da annullare: questo strumento si limita a leggere.

get_warm_status

Avanzato · Manuale, tramite MCP · sola lettura

Che cosa fa
Fornisce lo stato della costruzione della cache: pagine in cache rispetto al totale, se la costruzione procede o è bloccata e gli indirizzi falliti. Gli stessi dati di wp spark-speed warm-status.
Quando usarlo
Dopo un purge o una modifica.
Come verificare l'effetto
JSON, oppure available: false se lo stato non è determinabile.
Esempio
Richiesta: "La cache è già stata costruita?"
Come annullare
Nulla da annullare: questo strumento si limita a leggere.

list_changes

Base · Manuale, tramite MCP · sola lettura

Che cosa fa
Fornisce le modifiche eseguite tramite MCP o ai apply con change_id, ora, utente, motivo e se sono state annullate, più la cronologia di tutte le modifiche alle impostazioni del sito.
Quando usarlo
Per cercare un change_id da usare con revert_change.
Requisiti
Facoltativo limit da 1 a 60 (predefinito 15).
Come verificare l'effetto
JSON con un elenco delle modifiche e la cronologia.
Esempio
{"limit": 20}
Come annullare
Nulla da annullare: questo strumento si limita a leggere.

Strumenti MCP che modificano qualcosa

Questi quattro strumenti modificano il sito. Un buon assistente AI le chiede prima il consenso e procede un passo alla volta.

start_optimization

Base · Manuale, tramite MCP · modifica qualcosa

Che cosa fa
Attiva l'optimizer integrato e avvia un ciclo, lo stesso del pulsante Optimize my site nella card Smart optimization. L'optimizer usa le proprie regole e il proprio controllo del browser. Se un ciclo è già in corso, viene riutilizzato.
Quando usarlo
Solo dopo il suo consenso esplicito; l'AI deve inviare confirm: true.
Requisiti
Un browser con la dashboard di Spark Speed aperta. Il controllo del browser viene eseguito in quella schermata di amministrazione aperta e il ciclo non viene completato se nessuno apre la dashboard. MCP da solo non basta quindi per concludere un ciclo senza browser.
Come verificare l'effetto
La risposta contiene run_id e lo stato. Segua il ciclo con get_optimization_status e nella dashboard; un avvio riuscito non è la prova che il controllo sia terminato.
Esempio
{"confirm": true}
Attenzione
L'optimizer può modificare le impostazioni. Nella 0.73.2 l'area di amministrazione non mostra un elenco delle decisioni né un pulsante per annullare un intero ciclo; le decisioni si rileggono nel report diagnostico o tramite get_diagnostics.
Come annullare
Ripristini le impostazioni interessate nella scheda Optimization o Cache.

apply_config

Avanzato · Manuale, tramite MCP · modifica qualcosa

Che cosa fa
Modifica le impostazioni di Spark Speed tramite lo stesso controllo di sicurezza della proposta AI nell'area di amministrazione. Gli elenchi vengono integrati, a meno che non siano in replace_lists. Con dry_run vede prima che cosa cambierebbe. Ogni modifica reale riceve un change_id e compare con il motivo nella cronologia; poi la cache viene ricostruita.
Quando usarlo
Dopo aver misurato con gli strumenti di lettura, un passo alla volta.
Requisiti
changes e un reason di una frase. Solo impostazioni da get_config, al massimo 40 per volta e al massimo un interruttore a rischio che si attiva per volta. Le impostazioni vietate e legate al sito vengono rifiutate con un motivo.
Come verificare l'effetto
JSON con applied, change_id, changed (vecchio e nuovo valore per impostazione) e rejected. Controlli poi il sito su mobile: menu, slider, moduli e carrello.
Esempio
{"changes": {"delay_js": true}, "reason": "Reduce main-thread work", "dry_run": true}
Attenzione
Un'impostazione a rischio può rompere il front-end. La ricostruzione della cache appesantisce il server.
Come annullare
revert_change con il change_id.

revert_change

Base · Manuale, tramite MCP · modifica qualcosa

Che cosa fa
Annulla una modifica precedente di apply_config o ai apply. Vengono ripristinate solo le impostazioni di quella modifica. Se un'impostazione è stata poi modificata di nuovo, da qualcun altro o da un passaggio successivo, resta così com'è e viene segnalato.
Quando usarlo
Quando una modifica rompe qualcosa o non porta alcun vantaggio.
Requisiti
Un change_id (vedi list_changes). Sono note solo le ultime 30 modifiche eseguite tramite MCP o WP-CLI.
Come verificare l'effetto
JSON con reverted, restored e left_alone_because_changed_since. Una seconda volta segnala che la modifica era già stata annullata.
Esempio
{"change_id": "mcp-20261010-101500-ab12cd"}
Attenzione
Le modifiche eseguite nell'area di amministrazione o dall'optimizer non si annullano con questo strumento.
Come annullare
Applichi di nuovo la modifica con apply_config.

purge_cache

Base · Manuale, tramite MCP · modifica qualcosa

Che cosa fa
Svuota la cache delle pagine di un indirizzo, oppure dell'intero sito se non indica alcun indirizzo. Per l'intero sito tutto viene rimesso in coda. Compare nella cronologia.
Quando usarlo
Quando una pagina mostra una versione obsoleta.
Requisiti
L'indirizzo deve appartenere a questo sito.
Come verificare l'effetto
La risposta contiene purged con l'indirizzo oppure all.
Esempio
{"url": "https://example.com/shop/"}
Attenzione
Dopo un purge completo le pagine sono più lente finché la costruzione non è terminata.
Come annullare
Non serve: la costruzione della cache riempie di nuovo la cache.
Ha dubbi su un passaggio? Annulli la modifica, controlli il suo sito e ce lo chieda tramite la pagina dei contatti.
Non ha ancora Spark Speed? Scopra che cosa fa e quanto costa.

Domande frequenti

No. Tramite MCP un'AI può misurare, modificare le impostazioni e avviare un ciclo di ottimizzazione, ma il controllo del browser di quel ciclo viene eseguito nella dashboard di Spark Speed. Questa deve restare aperta in un browser finché il ciclo è in corso.

mcp token e ai apply esistono solo con una licenza valida, e diagnostics rifiuta senza. Gli altri comandi ci sono, ma la gestione e le nuove ottimizzazioni richiedono una licenza valida o il periodo di tolleranza di 14 giorni.

Cerchi il change_id con list_changes e usi revert_change. Vengono ripristinate solo le impostazioni di quella modifica. Le modifiche del pulsante Optimize my site, nella 0.73.2, si annullano ripristinando personalmente le impostazioni.

Una chiave viene mostrata una sola volta e non si può recuperare. La revochi nella card Connect Claude or ChatGPT (MCP) oppure con wp spark-speed mcp token revoke, e ne crei una nuova.

Sono costruiti così nella 0.73.2: winkelwagen, klantcache, laadplan e warm-hervat usano parole olandesi come aan, uit, proef e legen. Anche una parte dell'output è in olandese.