Il WordPress MCP Adapter è il plugin ufficiale che, sfruttando le Abilities API introdotte in WordPress 6.9, permette a strumenti AI come Claude, Cursor e VS Code di leggere ed eseguire funzioni del tuo sito in modo sicuro e controllato. In pratica apri WordPress all’automazione tramite il Model Context Protocol (MCP), senza esporre il database né perdere il controllo sui permessi. È la base per gestire contenuti e operazioni del sito con l’intelligenza artificiale.
WordPress 6.9 ha introdotto le Abilities API, un sistema che permette di registrare funzionalità in modo standardizzato, scopribile e tipizzato. Questo rappresenta un passo fondamentale per rendere WordPress compatibile con l’automazione basata sull’intelligenza artificiale.
Il vero punto di svolta arriva con il WordPress MCP Adapter, un plugin ufficiale che implementa il Model Context Protocol (MCP) e consente agli strumenti AI come Claude, Cursor e VS Code di scoprire ed eseguire direttamente le Abilities registrate sul tuo sito WordPress.
Cos’è il Model Context Protocol (MCP)?
Il Model Context Protocol (MCP) è uno standard aperto con cui un assistente AI scopre e usa strumenti e dati esterni. Permette di fornire contesto aggiuntivo ai modelli linguistici che alimentano gli strumenti AI.
Grazie a MCP, è possibile dare all’intelligenza artificiale accesso sicuro ai dati del tuo sito WordPress, per esempio per leggere dati del sito e lanciare operazioni ripetitive.
Immagina di poter chiedere a un assistente AI di generare un report sulle vendite del tuo ecommerce WordPress, e che questo possa accedere direttamente ai dati degli ordini dell’anno. Con MCP e WordPress, è un esempio ipotetico di ciò che si può costruire, non una funzione dell’adapter.
Come funziona il WordPress MCP Adapter?
Il WordPress MCP Adapter trasforma le Abilities registrate tramite le API di WordPress in MCP tools, rendendo le funzionalità del tuo sito accessibili agli agenti AI.
Il plugin crea automaticamente un server MCP di default che espone tre strumenti fondamentali:
- mcp-adapter/discover-abilities: per scoprire quali Abilities sono disponibili
- mcp-adapter/get-ability-info: per ottenere informazioni su una specifica Ability
- mcp-adapter/execute-ability: per eseguire un’Ability
Il flusso è lineare: il client MCP chiede le abilità disponibili, ottiene l’elenco e poi esegue quella scelta. Le abilities diventano così tool, resource e prompt MCP.
Per esporre un’Ability tramite il server di default, è sufficiente aggiungere un flag meta.mcp.public durante la registrazione con wp_register_ability().
Connessione agli strumenti AI
Il plugin supporta due metodi di trasporto:
- STDIO: ideale per ambienti di sviluppo locali, utilizza WP-CLI
- HTTP: per installazioni WordPress pubbliche
La configurazione specifica per ciascun client è descritta nel repository ufficiale.
Come creare un server MCP personalizzato per i tuoi plugin?
Oltre al server di default, è possibile creare server MCP personalizzati per i propri plugin. Questo offre maggiore controllo su come le Abilities vengono esposte e permette di costruire soluzioni su misura.
Il server di default basta per la maggior parte dei casi, mentre quello personalizzato serve quando si vuole controllare quali abilities esporre.
La creazione di un server personalizzato richiede l’installazione del pacchetto MCP Adapter tramite Composer e la registrazione del server tramite l’hook mcp_adapter_init. Per i dettagli e gli esempi pratici, compresa l’implementazione per il plugin “List All URLs”, rimando al repository ufficiale e all’annuncio sul blog ufficiale degli sviluppatori WordPress.
Come installare il WordPress MCP Adapter passo passo?
Si scarica il pacchetto da GitHub, oppure lo si installa con Composer o WP-CLI, lo si attiva e si controlla che l’endpoint risponda. Conviene sempre partire da un ambiente di staging.
Prima di cominciare, conferma sul repository ufficiale i requisiti: WordPress 6.9 o superiore e PHP 7.4 o superiore. Poi procedi in quest’ordine:
- Fai un backup completo del sito e lavora su una copia di staging, non sul sito reale.
- Scarica il pacchetto da GitHub oppure installalo con Composer o WP-CLI, come preferisci.
- Attiva il plugin dalla bacheca o da riga di comando.
- Apri l’indirizzo /wp-json/mcp/mcp-adapter-default-server sul tuo dominio e verifica che risponda.
- Scegli il trasporto: STDIO usa WP-CLI in locale, HTTP espone un endpoint remoto.
Solo quando tutto funziona in staging ha senso collegare l’AI al sito reale.
Come si collega Claude Desktop a WordPress tramite MCP?
Si crea sul sito un utente dedicato con permessi minimi, si genera una Application Password e si inseriscono indirizzo e credenziali nella configurazione del client MCP di Claude Desktop.
- Crea un utente WordPress dedicato, con il ruolo più limitato che basta al lavoro da fare.
- Dal profilo di quell’utente genera una Application Password e conservala subito, perché non viene mostrata una seconda volta.
- Configura il client MCP con l’indirizzo del sito e le credenziali, scegliendo il trasporto adatto: STDIO se lavori in locale, HTTP se il sito è remoto.
- Riavvia Claude Desktop e chiedigli di eseguire mcp-adapter/discover-abilities.
Se l’assistente elenca le abilità esposte dal sito, il collegamento funziona. Per i nomi esatti dei parametri di configurazione fai riferimento al repository ufficiale, perché possono cambiare tra una versione e l’altra.
WordPress MCP in pratica: un plugin che lavora sul sito
La teoria si capisce meglio con un caso reale. Novamira è il plugin che ho sviluppato per esporre le funzioni di WordPress e WooCommerce via MCP: da un client come Claude posso interrogare il database del negozio, aggiornare i contenuti dei blocchi ACF ed eseguire codice PHP controllato, senza aprire la bacheca e senza scrivere endpoint REST a mano per ogni funzione. Ho raccontato com’è nato e cosa fa nel post sullo sviluppo plugin WordPress con AI.
Il punto pratico è questo: MCP non serve a far scrivere articoli all’AI, serve a farle fare il lavoro ripetitivo che oggi fai a mano. Sistemare duecento meta description, controllare quali pagine non hanno link interni, allineare i prezzi di un catalogo: sono operazioni che da bacheca costano ore e che via MCP diventano una richiesta in linguaggio naturale, con il risultato verificabile riga per riga.
Quali permessi concedere e come usare il WordPress MCP Adapter in sicurezza?
I client MCP agiscono come utenti WordPress autenticati, quindi ti consiglio di seguire alcune regole di sicurezza:
- Utilizzare sempre permission_callback per verificare le capability necessarie
- Creare utenti dedicati con permessi limitati per l’accesso MCP
- Preferire Abilities di sola lettura per endpoint pubblici
- Implementare autenticazione personalizzata quando necessario
- Monitorare e registrare l’utilizzo tramite handler personalizzati
- Fare un backup prima di collegare l’AI al sito
WordPress e intelligenza artificiale: dove sta andando lo sviluppo
L’introduzione del WordPress MCP Adapter cambia il modo di lavorare nello sviluppo WordPress. Come ho già approfondito nell’articolo sui plugin WordPress scritti con AI, l’AI sta trasformando il modo in cui sviluppiamo per questa piattaforma.
La differenza principale è che ora non si tratta più solo di usare l’AI per generare codice WordPress, ma di integrare WordPress direttamente negli workflow AI, permettendo agli assistenti intelligenti di interagire con i dati e le funzionalità del tuo sito in modo strutturato e sicuro.
Questa evoluzione permette di creare strumenti di amministrazione assistiti da AI, automazioni complesse e workflow che combinano intelligenza artificiale e gestione dei contenuti.
Il WordPress MCP Adapter oggi permette di far eseguire all’AI le operazioni già registrate come abilities, ad esempio report, analisi dei dati e aggiornamenti in blocco, e rappresenta già una base solida per sperimentare l’integrazione tra WordPress e intelligenza artificiale. Per gli sviluppatori che lavorano con WordPress, questo significa poter automatizzare task complessi partendo da funzioni che il sito già espone.
Domande frequenti su WordPress MCP Adapter
Cos’è il WordPress MCP Adapter?
È il plugin ufficiale che collega WordPress al Model Context Protocol, lo standard aperto con cui strumenti AI come Claude, Cursor e VS Code scoprono ed eseguono le funzioni del sito. Le funzioni vengono registrate come Abilities, introdotte con WordPress 6.9, e l’adapter le rende disponibili all’assistente.
È sicuro dare a uno strumento AI accesso al sito?
Sì, se l’accesso è configurato con cura. L’AI può fare solo ciò che l’adapter espone in modo esplicito e non ha accesso diretto al database né al filesystem. Le operazioni distruttive richiedono una conferma manuale prima di essere eseguite. Conviene comunque usare un utente dedicato con permessi limitati e lavorare prima su una copia di staging.
Funziona con qualsiasi AI o solo con Claude?
MCP è un protocollo aperto, quindi funziona con qualsiasi strumento AI che lo supporti, come Claude, Cursor e altri client compatibili. Claude ha oggi il supporto MCP più maturo. Ogni client richiede una configurazione specifica, descritta nel repository ufficiale del plugin.
Serve uno sviluppatore per configurarlo?
L’installazione del plugin è semplice, ma la scelta delle abilità da esporre e la gestione dei permessi richiedono conoscenza di WordPress e del protocollo MCP. Un errore di configurazione può esporre più del necessario. Per questo il passaggio di staging e backup va fatto prima di collegare l’AI al sito reale.
WordPress MCP serve a far scrivere i contenuti all’AI?
No, non è questo il suo valore. MCP dà all’assistente un accesso controllato alle funzioni del sito, utile per operazioni ripetitive come aggiornare meta tag in blocco, verificare link interni o allineare dati di catalogo. La scrittura dei contenuti resta una scelta editoriale, da dichiarare se generata con l’AI.
Che differenza c’è fra MCP e le REST API di WordPress?
Le REST API espongono endpoint fissi, che qualcuno deve scrivere e mantenere per ogni funzione. Con MCP il client scopre da solo quali abilità il sito mette a disposizione e le richiama, senza bisogno di un endpoint per ogni caso. È la differenza fra dare a un assistente un elenco di comandi predefiniti e dargli un manuale che sa leggere.
Quali sono i limiti del WordPress MCP Adapter?
Il primo limite è tecnico: servono WordPress 6.9 o superiore e PHP 7.4 o superiore, requisiti da confermare sul repository ufficiale. Il server di default espone solo le abilità con il flag meta.mcp.public, mentre un server personalizzato richiede l’installazione tramite Composer. I nomi dei parametri di configurazione possono cambiare da una versione all’altra.
Vuoi integrare l’AI nel tuo sito WordPress in modo sicuro e controllato?
Sì, puoi integrare l’AI nel tuo sito WordPress in modo sicuro e controllato, a patto di farti seguire da chi conosce dall’interno lo stack su cui il sito lavora.
Chiamami al 329 6277 257. Conosco questo stack dall’interno.
Scrivimi per un preventivo gratuitoCondividi
