Un plugin WordPress per l'intelligenza artificiale deve risolvere tre problemi che prima ogni sviluppatore affrontava a modo suo: parlare con un modello, custodire una chiave API e decidere chi può usare quella chiave. Con WordPress 7.0, uscito il 20 maggio 2026, le prime due sono nel core: un AI Client indipendente dal provider e una schermata Impostazioni > Connectors dove l'amministratore inserisce le chiavi. La terza resta a te.
In questo articolo trovi come funziona l'AI Client, dove vanno le chiavi, come bloccare i prompt che non vuoi far partire, come esporre una funzione del sito agli agenti con l'Abilities API e quali errori evitare in un plugin che costruisci per un cliente.
La risposta breve è questa: il plugin descrive la richiesta con wp_ai_client_prompt(), WordPress la inoltra al modello del provider che il sito ha configurato, e i permessi li controlli tu, con una capability sull'endpoint che chiama l'AI e con il filtro wp_ai_client_prevent_prompt come ultima barriera.
Come funziona un plugin WordPress con intelligenza artificiale: l'AI Client della 7.0
L'AI Client è un'interfaccia centrale con cui i plugin dialogano con i modelli generativi senza legarsi a un provider, e tu non devi scrivere codice diverso per ciascuno. Lo descrive il Field Guide di WordPress 7.0: il core si occupa di instradare la richiesta, il plugin dichiara che cosa vuole ottenere. Se cambi modello o fornitore, è una scelta di configurazione del sito e non devi riscrivere il codice.
Il punto d'ingresso è la funzione wp_ai_client_prompt(), che restituisce un oggetto WP_AI_Client_Prompt_Builder. Su quell'oggetto concateni le istruzioni e chiudi con un metodo di generazione. Secondo la nota per sviluppatori del 24 marzo 2026, per un testo si usa generate_text(), per più varianti generate_texts(), per un output strutturato as_json_response() con uno schema. Se qualcosa va storto il metodo restituisce un WP_Error, quindi tu controlli sempre il risultato con is_wp_error(): è parte del codice normale, non un caso limite.
Il requisito di base è PHP 7.4 o superiore, che è anche il minimo del core dalla 7.0. Se il tuo plugin richiede WordPress 7.0, la nota consiglia di impostare 7.0 come versione minima e di togliere la dipendenza Composer wordpress/php-ai-client. Se devi restare compatibile con versioni precedenti, ti serve un caricamento condizionale: il pacchetto wordpress/wp-ai-client gestisce la transizione da solo.
Dove si configurano chiavi e provider?
In Impostazioni > Connectors, dove tu, come amministratore, trovi l'elenco. La schermata elenca i provider AI; i tre predefiniti sono Anthropic, Google e OpenAI, ciascuno con un plugin ufficiale (AI Provider for Anthropic, for Google, for OpenAI), e si possono configurare anche altri. La nota sulla Connectors API spiega che per i connettori con metodo api_key la chiave viene cercata in quest'ordine:
- una variabile d'ambiente, per esempio
ANTHROPIC_API_KEY; - una costante PHP, per esempio
define( 'ANTHROPIC_API_KEY', '...' )inwp-config.php; - il database, inserita dalla schermata di amministrazione.
Per te che sviluppi questo significa una cosa precisa: il plugin non chiede, non salva e non mostra credenziali. Chiama l'AI Client e basta.
Se invece amministri il sito, devi scegliere dove vive la chiave. La nota precisa che le chiavi salvate nel database compaiono mascherate nell'interfaccia, ma non dice che siano cifrate: nei commenti alla nota si legge che la cifratura è allo studio in un ticket di Core. Sempre nei commenti, uno degli autori chiarisce che l'impostazione appartiene al sito e quindi ogni plugin installato può leggerla, e lo stesso vale per variabili d'ambiente e costanti. Un plugin di terzi poco curato è quindi un rischio anche per la chiave del tuo provider.
Come limiti chi può far partire un prompt?
Hai due livelli, e ti conviene usarli entrambi.
Il primo è la capability sull'endpoint, che decidi tu. La nota avverte che esiste anche un'API JavaScript lato client, ma richiede un controllo di capability ad alto privilegio che per impostazione predefinita hanno solo gli amministratori, non fa parte del core ed è sconsigliata nei plugin distribuiti. La raccomandazione è creare un endpoint REST per ogni funzione AI, con controlli di permesso granulari, e chiamarlo dal JavaScript del plugin.
Il secondo è il filtro wp_ai_client_prevent_prompt, che tu registri con add_filter() e che riceve un booleano e il builder e restituisce un booleano. Se lo fai tornare true, il prompt non parte: nessuna chiamata al modello, is_supported_*() risponde false e i metodi generate_*() restituiscono un WP_Error. È il posto giusto per una regola valida per tutto il sito, per esempio "solo chi gestisce le opzioni usa l'AI" (è l'esempio della nota ufficiale, con manage_options), anche se un plugin dimentica il suo controllo. Attenzione: la regola vale per ogni prompt, anche per quelli lanciati da altri plugin o da attività pianificate, dove non c'è un utente collegato; prima di attivarla verifica che non blocchi funzioni che ti servono.
Prima di generare, tu puoi anche chiedere se la funzione è disponibile con i metodi is_supported_for_text_generation(), is_supported_for_image_generation() e simili. La nota dice che usano una logica deterministica, senza chiamate API e senza costi, quindi li puoi usare per mostrare o nascondere un pulsante senza spendere nulla.
Come fare, passo per passo: un endpoint AI protetto
Questo esempio, che puoi copiare e adattare, genera una proposta di meta description per un articolo. È un esempio didattico: se lo adatti, ricordati che la logica è mia, mentre le funzioni dell'AI Client e il filtro sono quelli descritti nella nota ufficiale. Prima di metterlo in un sito vero, provalo su una copia di sviluppo.
add_action( 'rest_api_init', function () {
register_rest_route( 'miopiano/v1', '/meta-description', array(
'methods' => 'POST',
'callback' => 'miopiano_meta_description',
'permission_callback' => function ( $request ) {
return current_user_can( 'edit_post', absint( $request['id'] ) );
},
'args' => array(
'id' => array( 'required' => true, 'sanitize_callback' => 'absint' ),
),
) );
} );
function miopiano_meta_description( WP_REST_Request $request ) {
$post = get_post( absint( $request['id'] ) );
if ( ! $post ) {
return new WP_Error( 'miopiano_no_post', 'Articolo non trovato.', array( 'status' => 404 ) );
}
$builder = wp_ai_client_prompt(
'Scrivi una meta description in italiano, massimo 155 caratteri, per questo testo: '
. wp_strip_all_tags( wp_trim_words( $post->post_content, 400 ) )
);
if ( ! $builder->is_supported_for_text_generation() ) {
return new WP_Error( 'miopiano_no_ai', 'Nessun modello disponibile.', array( 'status' => 503 ) );
}
$text = $builder->generate_text();
if ( is_wp_error( $text ) ) {
return $text;
}
return rest_ensure_response( array( 'suggestion' => sanitize_text_field( $text ) ) );
}
add_filter( 'wp_ai_client_prevent_prompt', function ( bool $prevent, $builder ): bool {
return $prevent || ! current_user_can( 'edit_posts' );
}, 10, 2 );
Che cosa fa il codice, passo dopo passo, e che cosa devi controllare tu:
- Registra una rotta REST dedicata a una sola funzione, come consiglia la nota.
- Nel
permission_callbackverifica che l'utente possa modificare proprio quell'articolo, non una capability generica. - Recupera il testo, lo ripulisce dai tag e ne invia soltanto le prime 400 parole, per non mandare al provider più dati del necessario.
- Controlla con
is_supported_for_text_generation()che un modello sia disponibile, poi genera. - Gestisce il
WP_Errore sanifica l'output prima di restituirlo: il testo di un modello è input non fidato come qualunque altro. - Il filtro, valido per tutti i prompt del sito, blocca chi non può nemmeno modificare articoli.
Nota che l'esempio non contiene nessuna chiave. Se il tuo sito non ha un provider configurato in Connectors, l'endpoint risponde con l'errore 503 e non succede altro.
Cosa aggiunge l'Abilities API, e dove entra MCP?
L'Abilities API, introdotta in WordPress 6.9 secondo la nota del 10 novembre 2025, è un registro in cui i tuoi plugin e temi dichiarano che cosa sanno fare in un formato leggibile dalle macchine. Ogni abilità si registra con wp_register_ability() sull'azione wp_abilities_api_init e ha un'etichetta, una descrizione, una categoria, uno schema JSON per l'input e uno per l'output, una funzione di esecuzione e, soprattutto, una permission_callback. Gli endpoint REST sotto wp-abilities/v1 esistono solo se l'abilità dichiara show_in_rest nei metadati (meta), e richiedono un utente autenticato.
Il Field Guide della 7.0 aggiunge due elementi che ti riguardano: l'Abilities API è integrata nell'AI Client, così le abilità possono essere eseguite in sequenza dentro un flusso di lavoro, e arriva una versione JavaScript, la Client-Side Abilities API, con i pacchetti @wordpress/core-abilities e @wordpress/abilities.
Per gli agenti esterni esiste l'MCP Adapter. Ti chiedo di tenere questo punto separato dal resto: dal repository ufficiale WordPress/mcp-adapter risulta un plugin, che espone le abilità come strumenti, risorse e prompt del Model Context Protocol, e non una funzione del core. Il Field Guide della 7.0 non nomina MCP. Le abilità, secondo la documentazione dell'adapter, sono private per impostazione predefinita e vanno rese pubbliche con un'opzione esplicita nei metadati. Quando valuti un collegamento con un client come Claude o simili, ragiona così: ogni abilità che rendi visibile è una porta, e la porta ha il suo controllo dei permessi.
Esempi concreti per una PMI italiana
Sono scenari ipotetici, non risultati misurati: ti servono a capire dove mettere i controlli.
- Studio professionale con un sito di articoli. Un plugin come quello sopra aiuta la redazione a ottenere bozze di meta description o riassunti. Resti tu, o un collega, a rivedere e a pubblicare.
- Negozio WooCommerce. Un'abilità che restituisce lo stato di un ordine ha senso solo con un controllo severo: i dati dei clienti non devono finire in un prompt senza una decisione esplicita. Prima di collegare un agente al catalogo, definisci quali campi può leggere. Se ti interessano le novità della 7.2, leggi l'articolo su WordPress 7.2 beta e i test per WooCommerce.
- Azienda con più plugin. Prima di installare un nuovo plugin AI controlla che cosa fa con la chiave del sito, perché come hai visto ogni plugin può leggerla. Lo stesso vale per gli aggiornamenti: WordPress 7.1.4 e i controlli dopo l'update mostra la sequenza che uso dopo una patch.
Checklist prima di mettere un plugin AI in produzione
- [ ] Il sito è su WordPress 7.0 o successivo e su PHP 7.4 o superiore.
- [ ] Il provider è configurato in Impostazioni > Connectors e hai deciso dove sta la chiave (variabile d'ambiente, costante o database), sapendo che ogni plugin installato può leggerla.
- [ ] Ogni funzione AI ha il proprio endpoint REST con una capability precisa e un
permission_callbackvero. - [ ] Il filtro
wp_ai_client_prevent_promptblocca i prompt degli utenti che non devono usarli. - [ ] Nel prompt entrano solo i dati necessari, senza dati personali dei clienti se non servono.
- [ ] L'output del modello viene sanificato e riletto da una persona prima della pubblicazione.
- [ ] Gli errori
WP_Errorsono gestiti e non mostrano dettagli interni all'utente. - [ ] Le abilità esposte con
show_in_resto tramite MCP sono solo quelle volute. - [ ] La prova è stata fatta su una copia del sito, non su quello online.
Errori da evitare
- Chiamare l'AI da un endpoint con
permission_callbackimpostato a__return_true. Chiunque raggiunga la rotta consuma la tua chiave e il tuo credito. - Affidarsi all'API JavaScript lato client in un plugin distribuito: la nota la sconsiglia.
- Salvare una chiave API nelle opzioni del tuo plugin invece di usare Connectors.
- Inviare al modello contenuti riservati, ordini o dati personali senza averlo deciso. Il provider è un soggetto esterno: se tratti dati dei clienti, verifica con il tuo consulente privacy che cosa prevede il contratto del provider.
- Pubblicare l'output del modello senza rilettura. Il testo generato può contenere errori o markup indesiderato.
- Dare per scontato che MCP sia nel core. Oggi, in base alla documentazione ufficiale, si installa come plugin separato.
- Rendere pubblica un'abilità "per comodità" e dimenticare di verificarne la
permission_callback.
Consigli per cominciare
Parti da una sola funzione, a basso rischio e utile a chi lavora sul sito ogni giorno, come il suggerimento di una meta description o di un testo alternativo. Scrivi il test del permesso prima del test dell'AI: un utente senza ruolo adeguato deve ricevere un errore, sempre. Se puoi, tieni la chiave fuori dal database, dove la nota ufficiale dice che non è cifrata, e documenta, per il cliente, chi può cambiarla.
Poi guarda cosa succede al sito quando il provider non risponde: se l'AI Client restituisce un WP_Error, devi poter continuare a lavorare nell'editor. Una funzione AI che ti blocca la pubblicazione di un articolo è un guasto, non un'assistenza. Infine, per ogni plugin di terzi che dichiara funzioni AI, leggi il codice o chiedi a chi lo mantiene come usa i Connectors.
Domande frequenti
Serve un plugin per usare l'AI Client in WordPress 7.0?
No per il client in sé: wp_ai_client_prompt() è nel core. Ti serve però un plugin provider, per esempio quelli ufficiali per Anthropic, Google o OpenAI, e una chiave configurata in Connectors.
Dove vanno inserite le chiavi API?
In Impostazioni > Connectors, oppure in una variabile d'ambiente o in una costante PHP, che hanno la precedenza sul valore nel database. Il plugin che scrivi tu non deve gestire credenziali.
Come blocco i prompt di un certo utente o di un certo plugin?
Con il filtro wp_ai_client_prevent_prompt: se restituisce true, il prompt non parte e generate_*() restituisce un WP_Error. Il builder che ricevi come secondo argomento ti permette di decidere in base alla richiesta.
L'MCP Adapter è già nel core di WordPress?
Dalla documentazione ufficiale che ho consultato risulta un plugin separato, che tu installi a parte, e il Field Guide della 7.0 non lo cita. Controlla sempre la pagina del repository WordPress/mcp-adapter prima di installarlo, perché è un progetto in evoluzione.
Considerazioni finali
L'AI Client toglie al plugin il lavoro di parlare con ciascun provider e di raccogliere le credenziali. Resta la parte che il core non può decidere per te: chi può usare l'intelligenza artificiale nel tuo sito, con quali dati e con quale controllo umano sul risultato. Se costruisci funzioni AI per i clienti, hai oggi l'opportunità di farle con permessi chiari, endpoint dedicati e abilità dichiarate, senza nascondere la chiave in un'opzione del plugin.
Se vuoi collegare il tuo sito o il tuo gestionale a un modello con questa impostazione, trovi il lavoro che faccio sulle API REST e i connettori; per un plugin su misura c'è la pagina sullo sviluppo di plugin WordPress, e se ti serve un assistente che risponda ai clienti guarda chatbot e agenti AI. Scrivimi da una di queste pagine, con una descrizione della funzione che vorresti e dei dati che coinvolge: partiamo da lì.
Fonti
- WordPress Core, Introducing the AI Client in WordPress 7.0, 24 marzo 2026.
- WordPress Core, WordPress 7.0 Field Guide, pubblicato il 14 maggio 2026.
- WordPress Core, Introducing the Connectors API in WordPress 7.0, 18 marzo 2026, compresi i commenti.
- WordPress Core, Abilities API in WordPress 6.9, 10 novembre 2025.
- WordPress.org, WordPress 7.0 "Armstrong", 20 maggio 2026.
- Repository ufficiale, WordPress/mcp-adapter.
Verifica delle fonti: 11 novembre 2026. Il codice di esempio è didattico e va provato su una copia di sviluppo; nomi di funzioni e comportamento delle API possono cambiare con le versioni di WordPress.






