Dai all’assistente una chiave, non la casa.
Il plugin gratuito, con licenza MIT, che trasforma il tuo sito in 84 strumenti tipizzati. Ogni chiamata porta un token con permessi limitati e finisce nel registro, anche quando viene rifiutata, e ciò che non si può annullare aspetta il tuo sì.
Gratis · MIT · nessuna chiave di licenza · nessuna telemetria · WordPress 6.0+ · PHP 8.1+
Aggiorni da una versione precedente? Ruota il segreto di firma in Xaflo → Impostazioni, poi crea nuovi token e sostituiscili in ogni client. Le versioni precedenti permettevano a un token amministratore di sola lettura di leggere il file che contiene il segreto. Cosa è cambiato
Attiva e disattiva i permessi. Si accendono gli strumenti che quel token può chiamare; quelli rischiosi mostrano la doppia conferma che devono superare.
{
"iss": "https:\/\/your-site.example",
"sub": 1,
"name": "seo-agent",
"scopes": [
"content:read",
"seo:read",
"seo:write",
"analytics:read"
],
"jti": "3f9c2b1e-8d4a-4f6b-9a2e-7c1d5e0b4a91",
"iat": 1794304800,
"exp": 1796896800
}Mostrato con il preset Agente SEO. Con JavaScript attivo, accendi e spegni i permessi per vedere cambiare gli strumenti.
- Chiamata 1428 · confirmation_tokenNon cambia ancora nulla. Il server restituisce un token monouso legato a questa operazione, a questo utente e a questa risorsa.
- Confermi tunella chatL’assistente ti mostra cosa succederà e aspetta.
- Chiamata 2200 · fatto, registratoStessa chiamata più il token, entro cinque minuti. Il token si brucia all’uso.
Definiti anche, ma non richiesti da nessuno strumento MCP: auth:read, audit:read, dashboard:read. admin:login serve solo all’accesso rapido di Xaflo Desktop; il server MCP non lo espone, di proposito.
Ogni strumento, raggruppato per ciò che tocca.
84 strumenti MCP sopra 94 route REST. Ognuno dichiara il permesso che gli serve, così un token può fare un solo lavoro.
Articoli, pagine, termini e ricerca.
Media7Caricamenti, testi alternativi, ottimizzazione immagini, pulizia.
SEO6Meta tramite il tuo plugin SEO, audit, link rotti.
Statistiche9Il traffico dal plugin di statistiche che usi già.
Tema e design13File del tema, CSS personalizzato, menu, widget, Customizer.
Plugin8Elenca, leggi, crea, installa, attiva.
Sito e sistema6Impostazioni, stato, prestazioni, database, WP-CLI.
File9Sfoglia e modifica i file: i caricamenti con site:write, ovunque con fs:admin.
Backup3Istantanee di database e file, e ripristino.
Multilingua10Traduzioni di articoli, media e stringhe (WPML).
I paletti sono codice, non una promessa nel prompt.
Cosa impone il plugin a ogni richiesta, qualunque cosa decida di fare l’assistente.
Token limitati e a scadenza
Ogni token è un JWT firmato con un segreto in wp-config.php, con i soli permessi che spunti e una durata da 1 a 365 giorni (30 di default). Lo revochi quando vuoi. Il sito conserva i metadati del token, mai il token, e può accettare token solo dagli indirizzi IP che indichi.
HS256 · lista di IP ammessi · ruotando il segreto si annullano tutti i token
File: i caricamenti di default, il resto solo su richiesta
site:write modifica file semplici (immagini, documenti, testo) solo dentro wp-content/uploads. Per tutto il resto serve fs:admin, concesso a parte e mai di default. I file protetti restano fuori portata per ogni token: wp-config.php, .env, backup, dump SQL, debug.log e la cartella del plugin stesso.
fuori dai caricamenti senza fs:admin: 403 xaflo_fs_outside_uploads
Le chiamate irreversibili aspettano il tuo sì
Cancellazioni definitive, ripristini di backup, cambi di tema, installazioni di plugin da un link o dalla directory, sostituzioni di un plugin installato, scritture sul database, un nuovo indirizzo del sito, cancellazioni di file e cartelle non vuoti, e ogni sovrascrittura, rinomina, cancellazione o modifica al codice con fs:admin rispondono prima 428 con un token monouso. Gli strumenti MCP ti mostrano la modifica e devono chiedere; Xaflo Desktop chiede sempre.
monouso · cinque minuti · legato a operazione, utente e contenuto
Una guardia davanti al database
Solo SELECT, INSERT, UPDATE e DELETE sulle tabelle del sito, per gli amministratori. Gli hash delle password non escono mai. Le scritture girano in una transazione e vengono annullate se toccano utenti, ruoli, capacità, token o opzioni protette. È un filtro sul testo della query, non un parser completo: db:write può comunque modificare la maggior parte delle tabelle.
le scritture richiedono InnoDB sulle tabelle protette
Un registro di ogni chiamata, rifiuti compresi
Ogni richiesta viene salvata una volta con ora, token, utente, route, permesso richiesto ed esito, comprese quelle respinte. Password e chiavi sono oscurate; contenuti dei file, valori SQL e argomenti dei comandi sono sostituiti dalla loro dimensione. Conservato 90 giorni di default.
identità solo da dati verificati
Limiti di frequenza, HTTPS, link di accesso
60 richieste al minuto per token di default, meno per i permessi rischiosi, e un limite anche per gli amministratori connessi. L’API rifiuta l’HTTP in chiaro fuori dagli host locali. admin:login rilascia link monouso per wp-admin che scadono in 60 secondi, mai su un sito senza HTTPS o con un plugin a due fattori attivo.
oltre il limite: 429 con Retry-After
Questi permessi possono fare tutto ciò che fa un amministratore, qualunque cosa manchi al token. Dalli solo a token a cui affideresti un account amministratore:
Le conferme proteggono dagli incidenti, non da chi possiede il token: può chiederne una e usarla in due chiamate.
Tre passaggi, poi chiedi.
- Versione1.7.0
- RilascioNovember 11, 2026
- LicenzaMIT
5448186ab0bb3c6ffef58cc183eb9e49dbc0e3db17abe25f140a90fc8ba08766Gli aggiornamenti arrivano dal feed di questo sito, ognuno con il suo checksum pubblicato.
Carica e attiva
In WordPress vai su Plugin → Aggiungi nuovo → Carica plugin, scegli il .zip e attivalo. Per controllare prima il file:
Get-FileHash .xaflo-wp-connect-1.7.0.zip -Algorithm SHA256shasum -a 256 xaflo-wp-connect-1.7.0.zipImposta il segreto di firma
I token sono firmati con
WPCB_JWT_SECRET, di almeno 32 caratteri. La schermata delle impostazioni del plugin può scriverlo per te inwp-config.php, tenendo un backup del file; oppure aggiungilo tu:define( 'WPCB_JWT_SECRET', 'incolla-qui-64-caratteri-esadecimali-casuali' );Crea un token e collegati
In Xaflo → Tokens crea un token con i soli permessi che servono e copialo: viene mostrato una volta sola. Poi passalo a Xaflo Desktop, o direttamente a Claude Code:
Oppure lascia fare a Xaflo Desktop, senza installare altroclaude mcp add my-wp claude-wp-mcp --site https://example.com --token <il-tuo-token>
Gira dove gira WordPress.
Le versioni arrivano direttamente dal manifest di aggiornamento che legge il plugin stesso.
- WordPress6.0+ · testato fino a 7.0
- PHP8.1+
- HTTPSobbligatorio per l’API (esclusi .test, .local e localhost)
- Segreto di firmaWPCB_JWT_SECRET, almeno 32 caratteri
- Backupl’estensione PHP ZipArchive
- Scritture sul databaseInnoDB per le tabelle users, usermeta, options e dei token
- WP-CLIfacoltativo;
wp_cli_execresta spento finché non lo attivi
Prima di installare.
È davvero gratis?
Sì. Il plugin ha licenza MIT e il codice è lo stesso qualunque edizione di Xaflo Desktop usi, o anche senza.
Invia dati a Xaflo?
Nessuna telemetria. Le richieste vanno dal server MCP sul tuo computer direttamente al tuo sito. Il plugin contatta questo sito solo per controllare i propri aggiornamenti.
Quali assistenti possono usarlo?
Qualsiasi client MCP. Claude Code, Claude Desktop e ChatGPT Desktop sono quelli che Xaflo Desktop configura per te; l’API REST funziona anche da curl, Python o Node con gli stessi token.
Mi serve Xaflo Desktop?
No. Bastano il plugin e il server MCP. Desktop tiene tanti siti, token e backup in un’unica finestra e scrive per te la configurazione dell’assistente.
E se un token finisce in mani sbagliate?
Revocalo in Xaflo → Tokens e smette di funzionare dalla richiesta successiva. Fino ad allora può fare solo ciò che i suoi permessi consentono, entro i limiti di frequenza, e ogni sua chiamata resta nel registro.
L’assistente può rompere il sito?
Solo dentro i permessi che gli dai. Tieni gli agenti su permessi di lettura e contenuti. Le chiamate irreversibili richiedono una seconda chiamata con un token monouso, che l’assistente deve chiederti; Xaflo Desktop lo chiede sempre a te. Prima di una sessione importante fai un backup completo con wp_backup_create.