Skip to main content
SparkCore

Controllare Spark Speed tramite MCP (per le agenzie)

Se gestisce molti siti, dalla versione 0.73.2 può controllare Spark Speed anche da un assistente AI tramite MCP (Model Context Protocol), ad esempio da Claude o ChatGPT. È un approfondimento per le agenzie, non un requisito: tutto si può fare anche semplicemente dalla dashboard. Tutto ciò che è descritto in questa guida è stato provato sul nostro sito di prova con una chiave temporanea.
In breve
  • Richiede una licenza valida e un collegamento autorizzato
  • Le modifiche richiedono un motivo, possono essere provate prima a secco e sono annullabili tramite MCP
  • È possibile avviare un ciclo di ottimizzazione, ma il controllo del browser richiede una dashboard aperta
  • Un servizio AI collegato vede i dati richiesti

Dove si trova

Il collegamento si trova nella scheda Optimization, nella card Connect Claude or ChatGPT (MCP). Non esiste un interruttore on/off separato: con una licenza valida il collegamento è disponibile, ma non succede nulla finché non autorizza un client.
La card Connect Claude or ChatGPT (MCP) nella scheda Optimization
Optimization, Connect Claude or ChatGPT (MCP).

Creare e revocare una chiave

Un client si collega con una propria chiave che inizia con spk_, come Bearer token. Con WP-CLI la crea così: wp spark-speed mcp token create --label="nome". Il comando rifiuta di mostrare la chiave in un terminale; invii l'output direttamente al suo gestore di password o archivio di segreti. Con wp spark-speed mcp token list vede le chiavi (id ed etichetta, mai il segreto) e con wp spark-speed mcp token revoke <id> ne revoca una. Non inserisca mai una chiave in un ticket, in un'e-mail o in uno screenshot.

Cosa può fare l'assistente

Sul sito di prova il server si è presentato come Spark Speed 0.73.2 con tredici strumenti. Il server stesso indica all'assistente il modo di lavorare: prima recuperare la guida e la panoramica del sito, prima misurare e, per ogni modifica, al massimo un interruttore a rischio.
  • Consultare: get_optimization_guide, get_site_overview, get_diagnostics, get_config, get_site_findings, get_warm_status, check_page
  • Ottimizzazione: get_optimization_status e start_optimization
  • Modificare e annullare: apply_config, list_changes, revert_change
  • Cache: purge_cache

Applicare una modifica in sicurezza

Ecco come è andata sul sito di prova:
  1. apply_config con dry_run: Spark Speed ha risposto indicando che cosa cambierebbe (da disattivato ad attivato) senza salvare nulla.
  2. apply_config senza dry_run, con un motivo obbligatorio. La risposta ha fornito un change_id, che cosa è cambiato, che cosa è stato rifiutato e, come passo successivo: verifichi con check_page.
  3. list_changes ha mostrato la modifica con id, utente, motivo e chiavi, e nella cronologia come eseguita da ai-mcp.
  4. revert_change con il change_id ha ripristinato il vecchio valore. Se da allora una chiave è stata modificata da qualcun altro, Spark Speed la lascia stare e lo segnala.
Attenzione: revert_change annulla solo le modifiche eseguite tramite MCP. Per le altre modifiche valgono i percorsi descritti in Risoluzione dei problemi.

Avviare un ciclo di ottimizzazione

start_optimization richiede una conferma esplicita (confirm: true). Poi il ciclo procede, ma il controllo del browser delle modifiche a rischio viene eseguito nella dashboard di Spark Speed aperta. Lo dice anche il server stesso: aprire la dashboard per misurazioni, verifica ed esito; un ciclo non più attivo non dimostra ancora un'ottimizzazione riuscita. Apra quindi l'Overview di Spark Speed (l'indirizzo che il server restituisce come dashboard_url) in un browser finché il ciclo non è terminato; su un'altra scheda di Spark Speed il controllo non viene eseguito. Poi controlli lei stesso il sito.

Privacy e responsabilità

Se collega un servizio AI esterno, quel servizio vede i dati che l'assistente richiede, come la sua configurazione e la diagnosi. Crei una chiave separata per ogni client o per ogni persona, così da poterne revocare una senza toccare le altre, e revochi le chiavi che non usa più.
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. Tutto si può fare dalla dashboard. MCP è utile se gestisce molti siti e vuole esaminarli e regolarli da un assistente AI.

No. Le modifiche passano per lo stesso controllo delle impostazioni della dashboard, richiedono un motivo e, per ogni volta, è consentito al massimo un interruttore a rischio.

Consultare, modificare e annullare sì. Il controllo del browser di un ciclo di ottimizzazione richiede una dashboard aperta.