Skip to main content

WP-CLI en MCP: alle commando's en tools

Deze pagina beschrijft alles wat je in Spark Speed 0.73.2 zonder beheerscherm kunt doen: de WP-CLI-commando's op de server en de MCP-tools waarmee een AI-assistent zoals Claude of ChatGPT met je site werkt. Bedoeld voor beheerders en bureaus die met de commandoregel of een AI-assistent werken; voor dagelijks beheer heb je dit niet nodig.
In het kort
  • Alle commando's beginnen met wp spark-speed en draaien op de server
  • mcp token en ai apply bestaan alleen met een geldige licentie; diagnostics weigert zonder
  • MCP vraagt een geldige licentie en een geautoriseerde client die als beheerder werkt
  • start_optimization heeft een open dashboard in de browser nodig voor de browsercontrole

Status en cache

Snel zien hoe de cache ervoor staat, hem legen en controleren wat bezoekers krijgen.

wp spark-speed status

Basis · Handmatig, via WP-CLI

Wat het doet
Toont in vijf regels de stand van de cache: welke plugin de cache-drop-in (het bestand waarmee WordPress de paginacache vroeg inlaadt) beheert, of WP_CACHE aan staat, hoeveel pagina's gecachet zijn, hoeveel adressen in de wachtrij staan en of de optionele lokale worker bereikbaar is. Handig om snel te kijken zonder wp-admin te openen.
Wanneer gebruiken
Na een update, een verhuizing of een purge, of in een monitoringscript.
Effect controleren
De uitvoer is in het Engels: Drop-in owner, WP_CACHE, Cached pages, Queue pending, Worker. Worker : OFFLINE is normaal: de worker is optioneel en zit niet in de zip; Spark gebruikt dan de PHP-route.
Voorbeeld
wp spark-speed status
Terugdraaien
Niets terug te draaien: het commando leest alleen.

wp spark-speed purge

Basis · Handmatig, via WP-CLI

Wat het doet
Leegt de hele paginacache. Daarna worden pagina's opnieuw gebouwd bij het volgende bezoek of door de cache-opbouw.
Wanneer gebruiken
Als bezoekers een verouderde versie zien of na een grote wijziging aan thema of instellingen.
Effect controleren
Je ziet Page cache purged. Met wp spark-speed status zie je Cached pages dalen.
Voorbeeld
wp spark-speed purge
Let op
Tot de cache weer is opgebouwd zijn eerste bezoeken trager. De object cache wordt hiermee niet geleegd, daarvoor is flush-object-cache.
Terugdraaien
Niet terug te draaien. Bouw de cache weer op met wp spark-speed optimize --all en daarna wp spark-speed warm.

wp spark-speed flush-object-cache

Geavanceerd · Handmatig, via WP-CLI

Wat het doet
Leegt de object cache (de tijdelijke opslag van databaseresultaten, bijvoorbeeld in Redis, Memcached, APCu of SQLite) die via de object-cache-drop-in van Spark loopt. Dit staat bewust los van de paginacache.
Wanneer gebruiken
Als je vermoedt dat er verouderde gegevens in de object cache staan. Spark leegt de object cache zelf niet automatisch.
Vereisten
Een werkende object cache van Spark. Anders krijg je een waarschuwing.
Effect controleren
Een succesmelding, of een waarschuwing als er niets te legen viel.
Voorbeeld
wp spark-speed flush-object-cache
Let op
Kort na het legen vraagt WordPress weer meer aan de database.
Terugdraaien
Niet nodig: de object cache vult zich vanzelf weer.

wp spark-speed verify-cache

Geavanceerd · Handmatig, via WP-CLI

Wat het doet
Haalt één pagina van je eigen site op als desktop- en als mobiele bezoeker en geeft een oordeel in JSON: welke cachestatus werd geserveerd en of die bij de huidige code en instellingen hoort.
Wanneer gebruiken
Na een wijziging, om te controleren dat bezoekers de nieuwe gecachte versie krijgen.
Vereisten
--page met een volledig adres op deze site, zonder querystring. Zonder --page stopt het commando met een fout.
Effect controleren
In de JSON staat ok. De exitcode is 0 als alles klopt en 2 als het niet klopt, zodat je het in een script kunt gebruiken.
Voorbeeld
wp spark-speed verify-cache --page=https://example.com/product/voorbeeld/
Terugdraaien
Niets terug te draaien: het commando leest alleen.

Cache opbouwen

Pagina's optimaliseren, de wachtrij afwerken en de cache-opbouw volgen of hervatten. Dezelfde opbouw zie je in het beheer op het tabblad Cache.

wp spark-speed optimize

Geavanceerd · Handmatig, via WP-CLI

Wat het doet
Zonder extra opties bouwt dit de homepage opnieuw op, per apparaat geoptimaliseerd en gecachet. Met --page=<adres> doe je dat voor één pagina. Met --all zet je alle pagina's van de site in de wachtrij; het echte werk doe je daarna met process of warm.
Wanneer gebruiken
Na een purge, of als je één belangrijke pagina meteen klaar wilt hebben.
Vereisten
Gebruik --page, niet --url: --url is in WP-CLI al bezet.
Effect controleren
Per apparaat een regel met de uitkomst, bijvoorbeeld ok of een reden waarom het niet lukte. Met --all zie je hoeveel adressen in de wachtrij kwamen.
Voorbeeld
wp spark-speed optimize --page=https://example.com/winkel/
Let op
Staat de noodrem (veilige modus) aan of is optimaliseren uitgeschakeld, dan worden pagina's alleen gecachet en niet geoptimaliseerd.
Terugdraaien
Leeg de cache van die pagina of de hele cache.

wp spark-speed process

Geavanceerd · Handmatig, via WP-CLI

Wat het doet
Verwerkt nu een deel van de wachtrij, standaard 20 adressen. Het gebruikt hetzelfde slot als de achtergrondverwerking, zodat ze elkaar niet in de weg zitten.
Wanneer gebruiken
Om een gevulde wachtrij in stappen af te werken, bijvoorbeeld na optimize --all.
Vereisten
Een wachtrij met adressen. Het aantal pas je aan met --limit=<aantal>.
Effect controleren
Per adres een regel met de uitkomst per apparaat, en tot slot Batch done. Remaining: N.
Voorbeeld
wp spark-speed process --limit=50
Let op
Belast de server zolang het loopt. Houdt een andere verwerking het slot vast, dan gebeurt er niets.
Terugdraaien
Niet van toepassing.

wp spark-speed warm

Geavanceerd · Handmatig, via WP-CLI

Wat het doet
Werkt de hele wachtrij af tot hij leeg is, in porties van standaard 25. Komt er geen voortgang, dan zoekt het uit waarom. Is een andere verwerking bezig, dan meldt het dat en stopt het; met --wait wacht het tot maximaal 15 minuten op het slot.
Wanneer gebruiken
Op sites met weinig bezoek, waar WP-Cron niet vanzelf vaak genoeg draait, of na een volledige purge.
Vereisten
De site moet zichzelf kunnen bereiken (loopback), want de opbouw haalt je eigen pagina's op. Portiegrootte wijzigen kan met --batch=<aantal>.
Effect controleren
Per ronde remaining: N (cached M) en een samenvatting. De exitcode is 0 als de wachtrij leeg is, 1 als er werk over is en 2 als de opbouw geblokkeerd of vastgelopen is.
Voorbeeld
wp spark-speed warm --wait
Let op
Kan lang duren en belast de server. Een site in onderhoudsmodus of achter een botbescherming die 403 geeft laat pagina's mislukken.
Terugdraaien
Stoppen met Ctrl+C. De opgebouwde cache kun je legen met purge.

wp spark-speed warm-status

Basis · Handmatig, via WP-CLI

Wat het doet
Laat zien hoe de cache-opbouw ervoor staat: de toestand en sinds wanneer, hoe lang er niets gebeurde, de reden, de wachtrij, gecachte pagina's tegenover het totaal, een eventuele pauze, mislukte adressen en de laatste test. Met --json krijg je alles als JSON.
Wanneer gebruiken
Als de opbouw niet opschiet, of in een monitor die op de exitcode let.
Effect controleren
De regels hebben Nederlandse labels (stand, sinds, wachtrij, gecached, pauze, fails, laatste toets). Exitcode 0 is gezond, 1 is een bekende oorzaak, 2 is vastgelopen en 3 betekent dat de toestand niet te bepalen is.
Voorbeeld
wp spark-speed warm-status --json
Terugdraaien
Niets terug te draaien: het commando leest alleen.

wp spark-speed warm-hervat

Geavanceerd · Handmatig, via WP-CLI

Wat het doet
Test een gepauzeerde cache-opbouw met een echte poging op het eerste adres in de wachtrij en hervat de opbouw als de site goed antwoordt. Dit is de commandoregelversie van de knop om de opbouw te hervatten op het tabblad Cache.
Wanneer gebruiken
Nadat je de oorzaak van een pauze hebt opgelost, bijvoorbeeld een loopbackfout of een botbescherming.
Vereisten
Een openstaande pauze. Zonder pauze meldt het Er stond geen pauze open..
Effect controleren
Hervat het, dan zie je Hervat. met de wachtrij en het aantal gecachte pagina's (exitcode 0). Lukt het niet, dan een waarschuwing Niet hervat: <reden> (exitcode 1). Controleer daarna met warm-status.
Voorbeeld
wp spark-speed warm-hervat
Let op
Geeft de site nog steeds fouten, dan blijft de pauze staan.
Terugdraaien
Niet van toepassing.

Winkel, klanten en laadplan

Deze commando's bedienen functies die je ook in het beheer vindt, met dezelfde proef vooraf. De subcommando's zijn Nederlandse woorden: aan, uit, proef, legen.

wp spark-speed winkelwagen

Geavanceerd · Handmatig, via WP-CLI

Wat het doet
Bedient de cache voor bezoekers met een gevuld mandje, dezelfde functie als Gecachte pagina's met een gevuld mandje op de kaart Winkelwagen en ingelogde klanten. status (standaard) toont de stand en de laatste proef. proef voert de proef uit. aan zet de functie aan en uit zet hem uit.
Wanneer gebruiken
Op een WooCommerce-winkel waar kopers met iets in hun mandje anders steeds een volledig opgebouwde, trage pagina krijgen.
Vereisten
WooCommerce. aan werkt alleen na een geslaagde proef, of met --bevestigd nadat je een gevonden verschil zelf hebt bekeken.
Effect controleren
De proef meldt de uitkomst, het aantal pagina's, of het mandjesscript nodig is en welke verschillen er zijn. Bij aanzetten zie je Winkelwagencache aan; de paginacache is geleegd..
Voorbeeld
wp spark-speed winkelwagen proef
Let op
Aanzetten leegt de hele paginacache. Keur je met --bevestigd ten onrechte een verschil goed, dan kan persoonlijke inhoud in gedeelde pagina's terechtkomen.
Terugdraaien
wp spark-speed winkelwagen uit
Technische naam
woo_cart_cache

wp spark-speed klantcache

Geavanceerd · Handmatig, via WP-CLI

Wat het doet
Bedient de eigen cache voor ingelogde klanten, dezelfde functie als Eigen cache voor ingelogde klanten op de kaart Winkelwagen en ingelogde klanten. status (standaard) toont de stand, het aantal sessies met een eigen kopie en of de functie aan kan. aan, uit (zet uit en leegt) en legen (leegt alle klantkopieen).
Wanneer gebruiken
Als ingelogde klanten bij elke klik een volledig opgebouwde pagina krijgen.
Vereisten
Kan de functie op deze site niet aan, dan weigert aan met de reden. Alleen klantrollen, nooit beheerders. Een kopie is hoogstens 8 uur oud.
Effect controleren
Meldingen als Klantcache aan. of Klantcache uit en geleegd., en bij status een regel met stand, sessies met eigen kopieen en kan aan.
Voorbeeld
wp spark-speed klantcache status
Let op
Elke ingelogde sessie krijgt eigen kopieen, dus het schijfgebruik groeit met het aantal klanten.
Terugdraaien
wp spark-speed klantcache uit
Technische naam
klant_cache

wp spark-speed laadplan

Geavanceerd · Handmatig, via WP-CLI

Wat het doet
Bedient het laadplan: plugins die op de voorkant code laden maar de pagina niet veranderen, worden daar overgeslagen, na bewijs. Dit is dezelfde functie als de kaart Laadplan voorkant onder Diagnostiek. kandidaten toont plugins met hun aantal bestanden en de laatste proef. proef <plugin> test of de pagina gelijk blijft zonder die plugin. weglaten <plugin> slaat hem op de voorkant over. laden <plugin> laadt hem weer. aan en uit zetten het plan aan of uit. status toont de stand.
Wanneer gebruiken
Als een plugin veel code op de voorkant laadt die je bezoekers niet nodig hebben.
Vereisten
weglaten mag alleen na een proef met uitkomst gelijk, of met --bevestigd nadat je een verschil zelf hebt bekeken. Geldt alleen voor anonieme bezoekers. Het plan staat standaard uit.
Effect controleren
Een regel met modus, weggelaten op de voorkant en de eigenaar van de mu-plugin (een plugin die WordPress altijd als eerste laadt).
Voorbeeld
wp spark-speed laadplan proef contact-form-7
Let op
Een gelijke pagina bewijst niet dat een plugin geen onzichtbaar werk doet, zoals beveiliging, tracking aan de serverkant of logging. Laat alleen plugins weg die je kent.
Terugdraaien
wp spark-speed laadplan laden <plugin> of wp spark-speed laadplan uit.

Metingen importeren en analyseren

Voor wie zelf meet: browsermetingen importeren zodat Spark precies de juiste afbeelding en lettertypen voorrang geeft, en het kritieke pad bekijken.

wp spark-speed image-hint

Geavanceerd · Handmatig, via WP-CLI

Wat het doet
Importeert een meting uit een echte browser die vastlegt welke afbeelding op een pagina de LCP is (het grootste zichtbare element bij het laden). Zolang de meting geldig is, laadt de gecachte pagina precies die afbeelding met voorrang.
Wanneer gebruiken
Als Spark zelf de verkeerde hoofdafbeelding kiest.
Vereisten
Een JSON-bestand van maximaal 16 KB uit een beheerdersscan. De verzamelscripts die op de kaart Gemeten keuzes genoemd worden, zitten niet in de zip van de plugin.
Effect controleren
Bij succes Observation stored; refresh and verify the affected cache variants.. Klopt het adres, de leeftijd, de instellingen of het LCP-bewijs niet, dan wordt de meting geweigerd. Ververs daarna de betrokken pagina en controleer met verify-cache.
Voorbeeld
wp spark-speed image-hint --file=lcp.json
Let op
Het commando leegt de cache niet en wijzigt geen instellingen. Metingen vervallen na zes uur en bij wijzigingen aan inhoud, media, menu, thema, plugins of instellingen.
Terugdraaien
Er is geen apart commando om een meting te verwijderen; na het vervallen geldt weer de automatische keuze.

wp spark-speed font-hint

Geavanceerd · Handmatig, via WP-CLI

Wat het doet
Importeert een meting van de lokale lettertypen die echt zichtbaar geladen worden, zodat alleen die vooraf worden geladen.
Wanneer gebruiken
Als er te veel of de verkeerde lettertypen vooraf geladen worden.
Vereisten
Een JSON-bestand van maximaal 16 KB. De verzamelscripts die op de kaart Gemeten keuzes genoemd worden, zitten niet in de zip van de plugin.
Effect controleren
Font observation stored; refresh and verify affected cache variants. of Font observation rejected..
Voorbeeld
wp spark-speed font-hint --file=fonts.json
Let op
Een verouderde meting kan het verkeerde lettertype vooraf laden. Metingen vervallen na zes uur en bij wijzigingen aan de site.
Terugdraaien
Geen apart commando; na het vervallen geldt weer de automatische keuze.

wp spark-speed font-metrics

Geavanceerd · Handmatig, via WP-CLI

Wat het doet
Importeert gemeten maten van het terugvallettertype, zodat tekst minder verspringt terwijl het webfont laadt.
Wanneer gebruiken
Als tekst zichtbaar verspringt zodra het webfont binnenkomt.
Vereisten
Een JSON-bestand van maximaal 16 KB. Waarden buiten het toegestane bereik worden geweigerd. De verzamelscripts die op de kaart Gemeten keuzes genoemd worden, zitten niet in de zip van de plugin.
Effect controleren
Font metrics stored; refresh the affected cache variants and verify the layout. Bekijk daarna de pagina.
Voorbeeld
wp spark-speed font-metrics --file=metrics.json
Let op
Verkeerde maten kunnen tekst juist laten verschuiven. Controleer de opmaak.
Terugdraaien
Geen apart commando gevonden; leeg de cache van de betrokken pagina's.

wp spark-speed kritiek-pad

Geavanceerd · Handmatig, via WP-CLI

Wat het doet
Laat zien wat er vóór de LCP moet laden (het kritieke pad). Met --file analyseert het een Lighthouse-JSON (een export uit DevTools of een PageSpeed-antwoord) en bewaart het resultaat voor de kaart Wat houdt groen tegen onder Diagnostiek. Met --page haalt het de pagina op als mobiele bezoeker en schat het op basis van de HTML, zonder tijden.
Wanneer gebruiken
Als je wilt weten wat de score tegenhoudt.
Vereisten
Een van beide opties. Het Lighthouse-bestand moet de netwerkverzoeken bevatten. --page werkt alleen met adressen op deze site.
Effect controleren
Compacte JSON in de terminal.
Voorbeeld
wp spark-speed kritiek-pad --file=lighthouse.json
Terugdraaien
Niet nodig: het commando verandert verder niets aan de site.

Commando's die een geldige licentie nodig hebben

Spark Speed heeft één licentieniveau. De commando's mcp token en ai apply bestaan alleen zolang de licentie geldig is (of in de grace-periode van 14 dagen); diagnostics bestaat altijd maar weigert zonder geldige licentie.

wp spark-speed diagnostics

Geavanceerd · Handmatig, via WP-CLI · werkt alleen met geldige licentie

Wat het doet
Geeft het diagnostisch rapport als JSON (server, PHP, cache, plugins), of bewaart het in een bestand met --save=<pad>. Het is hetzelfde rapport als Diagnostisch rapport downloaden in het beheer.
Wanneer gebruiken
Voor support, of om aan een AI te geven.
Vereisten
Een geldige licentie. Het commando bestaat ook zonder licentie, maar weigert dan met een foutmelding.
Effect controleren
JSON in de terminal, of Saved to <pad>.
Voorbeeld
wp spark-speed diagnostics --save=spark-rapport.json
Let op
Het bestand bevat server- en instellingsgegevens. Behandel het als vertrouwelijk.
Terugdraaien
Verwijder het bestand.

wp spark-speed mcp token

Geavanceerd · Handmatig, via WP-CLI · alleen met geldige licentie

Wat het doet
Beheert MCP-sleutels vanaf de commandoregel. create maakt een nieuwe sleutel en toont hem één keer. list toont de sleutels zonder het geheim. revoke <id> trekt een sleutel in. Met --label geef je de sleutel een naam (standaard WP-CLI). Dit is hetzelfde als Sleutel maken op de kaart Claude of ChatGPT koppelen (MCP).
Wanneer gebruiken
Als je een AI-programma op je eigen computer, zoals Claude Code, met de site wilt koppelen.
Vereisten
Bestaat alleen zolang de licentie geldig is. Je moet --user=<beheerder> meegeven van een gebruiker met beheerrechten. create weigert naar een scherm te schrijven: stuur de uitvoer direct door naar je wachtwoordkluis of geheimenopslag. Maximaal vijf sleutels.
Effect controleren
list toont per sleutel een id, een hint (eerste en laatste vier tekens), naam, eigenaar, aanmaakmoment en laatste gebruik.
Voorbeeld
wp spark-speed mcp token list --user=admin
Let op
Een sleutel kan alles wat de MCP-tools kunnen, als de beheerder van wie hij is. Een kwijtgeraakte sleutel is niet terug te halen, alleen in te trekken. Verliest de eigenaar zijn beheerrechten, dan werkt de sleutel niet meer.
Terugdraaien
wp spark-speed mcp token revoke <id> --user=admin (het id, niet de sleutel zelf).

wp spark-speed ai apply

Geavanceerd · Handmatig, via WP-CLI · alleen met geldige licentie

Wat het doet
Past een configuratievoorstel van een AI toe via dezelfde veiligheidspoort als de MCP-tool apply_config: verboden en sitegebonden instellingen worden geweigerd, er gaat hoogstens één riskante schakelaar per keer aan en elke wijziging krijgt een change_id. Het voorstel komt uit --file of via standaardinvoer.
Wanneer gebruiken
Als je met een AI een voorstel hebt gemaakt en dat gecontroleerd wilt toepassen zonder het beheer te openen.
Vereisten
Bestaat alleen zolang de licentie geldig is. --user=<beheerder> met beheerrechten. Het voorstel is JSON van maximaal 64 KB.
Effect controleren
JSON met onder meer applied, change_id, changed, rejected en next_step. Controleer daarna de site op mobiel: menu, sliders, formulieren en winkelwagen.
Voorbeeld
wp spark-speed ai apply --file=voorstel.json --json --user=admin
Let op
Een riskante instelling kan de voorkant breken. Na elke geslaagde wijziging wordt de cache opnieuw opgebouwd, wat de server even belast.
Terugdraaien
Er is geen WP-CLI-commando om terug te draaien. Gebruik de MCP-tool revert_change met het change_id, of zet de instelling in het beheer terug.

MCP: koppelen en voorwaarden

Wat je nodig hebt voordat een AI-assistent de tools hieronder kan gebruiken.

MCP-koppeling

Geavanceerd · Geen schakelaar: actief zolang de licentie geldig is

Wat het doet
MCP (Model Context Protocol) is een standaard waarmee een AI-assistent zoals Claude of ChatGPT met vaste tools met je site kan werken. Spark Speed heeft een eigen MCP-adres in WordPress. Het geeft de AI alleen de tools die hieronder staan: meten, instellingen zetten, terugdraaien en de cache legen, geen servertoegang.
Vereisten
Een geldige licentie, en een geautoriseerde client die als beheerder werkt. Dat kan op drie manieren: een eigen sleutel (via Sleutel maken of wp spark-speed mcp token) in de header X-Spark-Token of als Bearer-token; een WordPress-applicatiewachtwoord van een beheerder; of de koppeling vanuit Claude.ai of ChatGPT, waarbij je inlogt op WordPress en toestemming geeft. Zonder geldige licentie weigert het adres elk verzoek.
Effect controleren
Het adres en de regels voor Claude Code en Claude Desktop staan op de kaart Claude of ChatGPT koppelen (MCP) op het tabblad Optimalisatie. Na het eerste verzoek ziet je sleutel daar een tijd bij laatst gebruikt.
Voorbeeld
claude mcp add --transport http spark-speed https://example.com/wp-json/spark-speed/v1/mcp --header "X-Spark-Token: <sleutel>"
Let op
Per sleutel of gebruiker zijn maximaal 120 verzoeken per minuut toegestaan. Een verzoek uit een browser van een ander domein wordt geweigerd. Een AI kan sommige instellingen nooit wijzigen, waaronder de noodrem, het automatisch terugdraaien en de instellingen die bij deze server horen.
Terugdraaien
Trek een sleutel of verbinding in op dezelfde kaart, of met wp spark-speed mcp token revoke.

MCP-tools die alleen lezen

Deze tools veranderen niets aan je site. Een AI gebruikt ze om te meten en een voorstel te onderbouwen.

get_optimization_guide

Basis · Handmatig, via MCP · alleen lezen

Wat het doet
Geeft de handleiding voor optimaliseren: de werkwijze, wat elke instelling doet, welke instellingen riskant zijn en hoe je controleert. Dezelfde handleiding zit in het diagnostisch rapport.
Wanneer gebruiken
Als eerste in een gesprek, zodat de AI weet hoe Spark Speed werkt.
Effect controleren
Gewone tekst, geen JSON.
Voorbeeld
Vraag: "Lees eerst de Spark Speed-handleiding."
Terugdraaien
Niets terug te draaien: deze tool leest alleen.

get_site_overview

Basis · Handmatig, via MCP · alleen lezen

Wat het doet
Geeft een overzicht: siteadres, versies van plugin, WordPress en PHP, de herkende combinatie van builder, WooCommerce en host, de cachedekking, de belangrijkste schakelaars en de laatste wijzigingen.
Wanneer gebruiken
Aan het begin van elke sessie.
Effect controleren
JSON met onder meer de versie en de schakelaars.
Voorbeeld
Vraag: "Geef een overzicht van mijn site in Spark Speed."
Terugdraaien
Niets terug te draaien: deze tool leest alleen.

get_optimization_status

Basis · Handmatig, via MCP · alleen lezen

Wat het doet
Laat zien of de ingebouwde optimizer (de knop Optimaliseer mijn site) aan staat en hoe een lopende ronde ervoor staat, met een link naar het dashboard. Instellingen en browsergegevens geeft deze tool bewust niet.
Wanneer gebruiken
Voor en na start_optimization.
Effect controleren
JSON met de status en een volgende stap. Een ronde die niet meer loopt is nog geen bewijs dat alles gelukt is.
Voorbeeld
Vraag: "Hoe staat de optimalisatie ervoor?"
Terugdraaien
Niets terug te draaien: deze tool leest alleen.

get_config

Geavanceerd · Handmatig, via MCP · alleen lezen

Wat het doet
Geeft alle huidige instellingen, plus welke instellingen een AI niet mag wijzigen, welke aan deze site of server gebonden zijn en welke riskant zijn.
Wanneer gebruiken
Voordat de AI een wijziging voorstelt.
Effect controleren
JSON.
Voorbeeld
Vraag: "Welke instellingen staan nu aan?"
Let op
De AI ziet hiermee je volledige Spark Speed-configuratie.
Terugdraaien
Niets terug te draaien: deze tool leest alleen.

get_diagnostics

Geavanceerd · Handmatig, via MCP · alleen lezen

Wat het doet
Geeft het volledige diagnostisch rapport: server, cache, wat er op de pagina's laadt en bevindingen, inclusief wat de optimizer eerder besloot. Groot; gebruik het als het overzicht niet genoeg is.
Wanneer gebruiken
Bij het zoeken naar een oorzaak, of om de beslissingen van Optimaliseer mijn site na te lezen.
Effect controleren
JSON.
Voorbeeld
Vraag: "Wat heeft de optimizer besloten bij de laatste ronde?"
Let op
Bevat servergegevens.
Terugdraaien
Niets terug te draaien: deze tool leest alleen.

check_page

Geavanceerd · Handmatig, via MCP · alleen lezen

Wat het doet
Haalt één pagina van je site op als desktop- en mobiele bezoeker: cachestatus (HIT of MISS), de geserveerde versie, en wat de HTML laadt (scripts, uitgestelde scripts, stylesheets, preloads, LCP-afbeelding). Met measure doet het ook een meting via Google PageSpeed Insights.
Wanneer gebruiken
Na elke wijziging, per belangrijke pagina.
Vereisten
Een volledig adres op deze site zonder querystring. Voor measure: een ingestelde PageSpeed-sleutel en een openbaar bereikbare site.
Effect controleren
JSON met een cachedeel, een HTML-analyse en eventueel een meting.
Voorbeeld
{"url": "https://example.com/", "measure": true, "strategy": "mobile"}
Let op
Met measure gaat het openbare adres naar Google. Meten kan hoogstens twee keer per minuut per gebruiker.
Terugdraaien
Niets terug te draaien: deze tool leest alleen.

get_site_findings

Geavanceerd · Handmatig, via MCP · alleen lezen

Wat het doet
Geeft problemen in de site zelf, met bestandsnamen en gemeten kosten: 404-fouten, ketens van doorverwijzingen en zware bestanden.
Wanneer gebruiken
Als de score achterblijft door iets wat Spark niet kan oplossen.
Effect controleren
JSON.
Voorbeeld
Vraag: "Welke problemen zitten er in mijn site zelf?"
Terugdraaien
Niets terug te draaien: deze tool leest alleen.

get_warm_status

Geavanceerd · Handmatig, via MCP · alleen lezen

Wat het doet
Geeft de stand van de cache-opbouw: gecachte pagina's tegenover het totaal, of de opbouw loopt of vastzit, en mislukte adressen. Dezelfde gegevens als wp spark-speed warm-status.
Wanneer gebruiken
Na een purge of een wijziging.
Effect controleren
JSON, of available: false als de stand niet te bepalen is.
Voorbeeld
Vraag: "Is de cache al opgebouwd?"
Terugdraaien
Niets terug te draaien: deze tool leest alleen.

list_changes

Basis · Handmatig, via MCP · alleen lezen

Wat het doet
Geeft de wijzigingen die via MCP of ai apply zijn gedaan, met change_id, tijd, gebruiker, reden en of ze zijn teruggedraaid, plus de tijdlijn van alle instellingswijzigingen op de site.
Wanneer gebruiken
Om een change_id op te zoeken voor revert_change.
Vereisten
Optioneel limit van 1 tot 60 (standaard 15).
Effect controleren
JSON met een lijst wijzigingen en de tijdlijn.
Voorbeeld
{"limit": 20}
Terugdraaien
Niets terug te draaien: deze tool leest alleen.

MCP-tools die iets wijzigen

Deze vier tools veranderen de site. Een goede AI-assistent vraagt je eerst toestemming en doet één stap tegelijk.

start_optimization

Basis · Handmatig, via MCP · wijzigt iets

Wat het doet
Zet de ingebouwde optimizer aan en start een ronde, dezelfde als de knop Optimaliseer mijn site op de kaart Slim optimaliseren. De optimizer gebruikt zijn eigen regels en browsercontrole. Loopt er al een ronde, dan wordt die hergebruikt.
Wanneer gebruiken
Alleen na jouw uitdrukkelijke toestemming; de AI moet confirm: true meesturen.
Vereisten
Een browser met het Spark Speed-dashboard open. De browsercontrole draait in dat geopende beheerscherm en de ronde wordt niet afgemaakt als niemand het dashboard opent. MCP alleen is dus niet genoeg om een ronde zonder browser af te ronden.
Effect controleren
Het antwoord bevat run_id en de status. Volg de ronde met get_optimization_status en op het dashboard; een geslaagde start is geen bewijs dat de controle klaar is.
Voorbeeld
{"confirm": true}
Let op
De optimizer kan instellingen wijzigen. In 0.73.2 toont het beheer geen beslissingenlijst en geen knop om een hele ronde ongedaan te maken; de beslissingen lees je na in het diagnostisch rapport of via get_diagnostics.
Terugdraaien
Zet de betreffende instellingen terug op het tabblad Optimalisatie of Cache.

apply_config

Geavanceerd · Handmatig, via MCP · wijzigt iets

Wat het doet
Wijzigt Spark Speed-instellingen via dezelfde veiligheidspoort als het AI-voorstel in het beheer. Lijsten worden aangevuld, tenzij ze in replace_lists staan. Met dry_run zie je eerst wat er zou veranderen. Elke echte wijziging krijgt een change_id en komt met de reden in de tijdlijn; daarna wordt de cache opnieuw opgebouwd.
Wanneer gebruiken
Na meten met de leestools, één stap tegelijk.
Vereisten
changes en een reason van één zin. Alleen instellingen uit get_config, hoogstens 40 per keer, en hoogstens één riskante schakelaar die per keer aangaat. Verboden en sitegebonden instellingen worden geweigerd met een reden.
Effect controleren
JSON met applied, change_id, changed (oud en nieuw per instelling) en rejected. Controleer daarna de site op mobiel: menu, sliders, formulieren en winkelwagen.
Voorbeeld
{"changes": {"delay_js": true}, "reason": "Minder werk op de hoofdthread", "dry_run": true}
Let op
Een riskante instelling kan de voorkant breken. Het opnieuw opbouwen van de cache belast de server.
Terugdraaien
revert_change met het change_id.

revert_change

Basis · Handmatig, via MCP · wijzigt iets

Wat het doet
Draait één eerdere wijziging van apply_config of ai apply terug. Alleen de instellingen van die wijziging gaan terug. Is een instelling daarna opnieuw gewijzigd, door iemand anders of een latere stap, dan blijft die staan en wordt dat gemeld.
Wanneer gebruiken
Als een wijziging iets kapotmaakt of geen winst geeft.
Vereisten
Een change_id (zie list_changes). Alleen de laatste 30 wijzigingen via MCP of WP-CLI zijn bekend.
Effect controleren
JSON met reverted, restored en left_alone_because_changed_since. Een tweede keer meldt dat de wijziging al was teruggedraaid.
Voorbeeld
{"change_id": "mcp-20261010-101500-ab12cd"}
Let op
Wijzigingen die in het beheer of door de optimizer zijn gedaan, draai je hiermee niet terug.
Terugdraaien
Pas de wijziging opnieuw toe met apply_config.

purge_cache

Basis · Handmatig, via MCP · wijzigt iets

Wat het doet
Leegt de paginacache van één adres, of van de hele site als je geen adres meegeeft. Bij de hele site wordt alles opnieuw in de wachtrij gezet. Het komt in de tijdlijn.
Wanneer gebruiken
Als een pagina een verouderde versie toont.
Vereisten
Het adres moet op deze site staan.
Effect controleren
Antwoord purged met het adres of all.
Voorbeeld
{"url": "https://example.com/winkel/"}
Let op
Na een volledige purge zijn pagina's trager tot de opbouw klaar is.
Terugdraaien
Niet nodig: de cache-opbouw vult de cache weer.
Twijfel je over een stap? Draai terug, controleer je site en vraag het ons via de contactpagina.
Nog geen Spark Speed? Bekijk wat het doet en wat het kost.

Veelgestelde vragen

Nee. Een AI kan via MCP meten, instellingen wijzigen en een optimalisatieronde starten, maar de browsercontrole van die ronde draait in het Spark Speed-dashboard. Dat moet in een browser open staan zolang de ronde loopt.

mcp token en ai apply bestaan alleen met een geldige licentie, en diagnostics weigert zonder. De overige commando's zijn er wel, maar beheer en nieuwe optimalisaties vragen een geldige licentie of de grace-periode van 14 dagen.

Zoek het change_id op met list_changes en gebruik revert_change. Alleen de instellingen van die wijziging gaan terug. Wijzigingen van de knop Optimaliseer mijn site draai je in 0.73.2 terug door de instellingen zelf terug te zetten.

Een sleutel wordt maar één keer getoond en is niet terug te halen. Trek hem in op de kaart Claude of ChatGPT koppelen (MCP) of met wp spark-speed mcp token revoke, en maak een nieuwe.

Zo zijn ze in 0.73.2 gebouwd: winkelwagen, klantcache, laadplan en warm-hervat gebruiken Nederlandse woorden zoals aan, uit, proef en legen. Ook een deel van de uitvoer is Nederlands.