Riferimento tool
Il server MCP registra 84 tool, tutti con nome wp_*. Qui sono raggruppati per attività, con lo scope che serve a ogni gruppo. Per i parametri di ogni tool e una chiamata d’esempio, apri il catalogo completo.
In questa pagina
Come i tool arrivano al tuo sito
L’assistente non vede mai WordPress direttamente. Chiama un tool come wp_set_seo sul server MCP; il server lo trasforma in una richiesta HTTPS all’API REST del plugin sotto /wp-json/wpcb/v1, firmata con il tuo token. Il plugin controlla gli scope del token e la capability WordPress dell’utente a cui appartiene, esegue la modifica e scrive una voce nel registro delle chiamate.
In Claude Code un tool compare come mcp__<nome del server>__wp_set_seo, dove il nome del server è quello che hai dato al sito quando l’hai aggiunto. L’assistente sceglie quello giusto quando nomini il sito nel prompt.
Un tool funziona solo se il token ha il suo scope. I tool di lettura chiedono …:read; tutto ciò che cambia il sito chiede il relativo scope di scrittura. Vedi Permessi dei token.
Articoli e pagine
Leggere, scrivere e pubblicare contenuti. Le modifiche salvano prima una revisione di WordPress; un articolo creato con stato “publish” resta una bozza se il token non ha content:publish.
Categorie e tag
Elencare i termini di qualsiasi tassonomia e crearne di nuovi.
Media
Elencare la libreria, caricare da URL o in base64, impostare testo alternativo, didascalie e descrizioni, ottimizzare immagini, trovare file che nessuno usa, eliminare con conferma.
SEO
Leggere e scrivere i meta SEO nei campi che il tuo plugin SEO già usa, analizzare un articolo, controllarne molti insieme, verificare la sitemap, trovare i link rotti.
Analytics
Leggere il traffico dal plugin di statistiche del sito: panoramica, contenuti più visti, parole chiave, provenienze, un singolo articolo, confronto tra periodi, andamento per categoria, pagine senza traffico.
Multilingua
Lingue, traduzioni di articoli e media, controllo delle traduzioni delle stringhe. Funziona con WPML; sui siti senza un plugin multilingua supportato questi tool non trovano lingue.
Tema e aspetto
Il tema attivo e i suoi file, CSS personalizzato, cambio di tema, menu, widget e Customizer. La scrittura dei file del tema conserva la versione precedente.
Plugin
Elencare i plugin con gli aggiornamenti disponibili, installare dalla directory di WordPress.org, da un URL di uno zip o da uno zip locale fino a 20 MB (con conferma), attivare, disattivare, leggere e scrivere i file dei plugin, creare lo scheletro di un nuovo plugin.
File
Elencare, leggere, cercare e scaricare file; scrivere, caricare, creare cartelle, rinominare ed eliminare. Dal plugin 1.7.0, site:write cambia file solo dentro la cartella uploads (solo tipi inerti); altrove serve anche fs:admin, e lì ogni sovrascrittura, rinomina o eliminazione chiede conferma. I segreti come wp-config.php e .env non si leggono e non si cambiano mai. Tutti i tool dei file richiedono un account amministratore.
Sito e sistema
Impostazioni (cambiare l’indirizzo del sito o l’email dell’amministratore chiede conferma), controlli di salute e prestazioni, backup completi su richiesta e ripristino.
Avanzati
SQL attraverso una protezione che di default ammette solo SELECT e chiede conferma per ogni scrittura, e WP-CLI limitato a una lista di comandi e spento finché il proprietario del sito non lo attiva.
Cosa non è un tool
Alcune route REST del plugin non hanno un tool MCP, perché le usa direttamente Xaflo Desktop: la manutenzione (/maintenance), la console di debug.log (/debug/log), il registro delle chiamate e la gestione dei token. Il link monouso per entrare in wp-admin (/admin/login-link) è escluso di proposito: è una credenziale per una persona, non per un modello. Tutte le route sono nel Riferimento API REST.