1. Home
  2. iThink
  3. WordPress
  4. WordPress intelligenza artificiale plugin: l'AI Client 7.0
WordPress

WordPress intelligenza artificiale plugin: l'AI Client 7.0

Codice di programmazione sullo schermo di un portatile
Immagine: Pexels · Pixabay · Licenza dei contenuti Pixabay

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:

  1. una variabile d'ambiente, per esempio ANTHROPIC_API_KEY;
  2. una costante PHP, per esempio define( 'ANTHROPIC_API_KEY', '...' ) in wp-config.php;
  3. 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:

  1. Registra una rotta REST dedicata a una sola funzione, come consiglia la nota.
  2. Nel permission_callback verifica che l'utente possa modificare proprio quell'articolo, non una capability generica.
  3. Recupera il testo, lo ripulisce dai tag e ne invia soltanto le prime 400 parole, per non mandare al provider più dati del necessario.
  4. Controlla con is_supported_for_text_generation() che un modello sia disponibile, poi genera.
  5. Gestisce il WP_Error e sanifica l'output prima di restituirlo: il testo di un modello è input non fidato come qualunque altro.
  6. 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_callback vero.
  • [ ] Il filtro wp_ai_client_prevent_prompt blocca 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_Error sono gestiti e non mostrano dettagli interni all'utente.
  • [ ] Le abilità esposte con show_in_rest o 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_callback impostato 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

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.

Condividi LinkedIn Facebook X WhatsApp Telegram Email
Cybersecurity per PMI

Quanto è esposta la tua azienda?

Un hacker etico certificato trova le falle prima di chi attacca e ti dice come chiuderle, partendo dalla più pericolosa.

Marketing & Google Ads

Le tue campagne stanno bruciando budget?

Raccontami obiettivi e numeri attuali: ti dico dove intervenire per primo.

Coding & debugging

Codice scritto con l’AI? Funziona oggi. Reggerà domani?

Audit del debito tecnico e della sicurezza di app e siti, debugging e code review.

iLife · crescita personale

Riprogramma la tua vita con il metodo di un hacker etico

Percorsi one-to-one per capire dove sei, scegliere la direzione e arrivarci con metodo.

Digital Agency

Dove sta frenando il tuo business?

Una consulenza per capire cosa sistemare prima: sicurezza, tecnologia, marketing o persone.

Continua a leggere

Tutti gli articoli del blog

Rocco Balzamà
Parli direttamente con me

Il prossimo passo?
Parliamone.

Raccontami cosa vuoi proteggere, costruire o far crescere. Ti aiuto a capire da dove partire.

Di cosa mi occupo

Da oltre trent'anni faccio tre cose. Cerco le falle della tua azienda prima che le trovi chi vuole entrare. Imposto il marketing perché i risultati si possano misurare. E aiuto persone e aziende a capire chi sono, prima ancora di decidere cosa vendere.

Da remoto e in presenzaLavoro da remoto tramite call e videocall. Quando il progetto lo richiede, intervengo anche in presenza.
Seguimi sui social
Certified Ethical HackerSicurezza informatica dal 1993
Gli strumenti con cui lavoro
  • Google Ads
  • Meta
  • WordPress
  • WooCommerce
  • Shopify
  • TikTok
Strumenti gratuiti