Se suona tutto troppo complesso, non preoccuparti. In questo tutorial ti forniremo le istruzioni per configurare il tuo sito WordPress e il client MCP di Claude, e per eseguire operazioni sul tuo sito tramite Claude Desktop.<\/p>\n
Ma prima di iniziare con le istruzioni pratiche, definiamo i concetti fondamentali del Model Context Protocol.
\n
Concetti fondamentali e definizioni dell\u2019MCP<\/h2>\n
Se hai deciso di aprire il tuo sito WordPress all\u2019interazione con un modello di AI tramite il Model Context Protocol<\/a>, \u00e8 importante comprendere chiaramente la catena di componenti<\/a> coinvolti.<\/p>\n Client MCP:<\/strong> \u00e8 un componente software<\/a> che permette a un host AI di connettersi a un server MCP. L\u2019host di AI \u00e8 l\u2019applicazione con cui interagisci (come Claude Desktop<\/a>), mentre il client \u00e8 il componente a livello di protocollo che rende possibile la connessione effettiva al server.<\/p>\n Server MCP:<\/strong> \u00e8 un\u2019applicazione software<\/a> (o processo) che espone funzionalit\u00e0 specifiche a un\u2019applicazione di AI tramite un protocollo standardizzato. Ne sono un esempio i server di file system, i server di database, i server di calendario e altro ancora.<\/p>\n Adattatore MCP:<\/strong> \u00e8 il ponte di traduzione<\/a> bidirezionale tra il client MCP e il nucleo del tuo sito WordPress. Il suo scopo \u00e8 adattare le funzionalit\u00e0 del tuo sito WordPress alle primitive del Model Context Protocol, consentendo agli agenti di AI di individuare ed eseguire le funzionalit\u00e0 del tuo sito come strumenti MCP<\/a> e di leggere i suoi dati come risorse MCP<\/a>.<\/p>\n API Abilities:<\/strong> \u00e8 il livello architetturale<\/a> che permette a tutti i componenti di WordPress \u2014 sia del core che dei plugin \u2014 di esporre le proprie funzionalit\u00e0 in modo unificato e comprensibile sia per gli esseri umani che per le macchine. Consente agli sviluppatori di registrare azioni standardizzate e autodescrittive con schemi di input\/output rigorosi che l’AI pu\u00f2 individuare ed eseguire in modo autonomo.<\/p>\n Collegando un agente di AI al tuo sito WordPress, puoi sfruttare tutta la potenza dell’AI per leggere dati o eseguire operazioni complesse direttamente dalla tua applicazione host AI.<\/p>\n Attraverso il tuo host AI, puoi gestire i contenuti, occuparti delle attivit\u00e0 amministrative e di manutenzione, monitorare lo stato del sito, gestire gli utenti, aggiornare i cataloghi dei prodotti, analizzare gli ordini e molto altro ancora. Non si tratta solo di eseguire azioni isolate, ma di gestire l\u2019infrastruttura del tuo sito senza mai aprire la dashboard di amministrazione di WordPress.<\/p>\n Potresti chiedere all’AI di redigere una bozza di post in base alle tue linee guida generali, specificando la lunghezza, il tono e il livello di approfondimento dell\u2019analisi. Potresti anche chiederle di generare immagini, eseguire calcoli in tempo reale e arricchire i contenuti con tabelle riassuntive che mostrano percentuali e valori assoluti.<\/p>\n Pensa anche all\u2019efficienza dell\u2019automazione delle operazioni: gestire l\u2019onboarding dei nuovi utenti assegnando automaticamente i ruoli in base alle loro responsabilit\u00e0 all\u2019interno dell’organizzazione, analizzare le prestazioni di vendita per prodotto nell\u2019ultimo trimestre o generare automaticamente report riassuntivi per il team.<\/p>\n Ma puoi puntare ancora pi\u00f9 in alto. Grazie all\u2019API Abilities, WordPress \u00e8 diventato un hub agentico che si integra perfettamente nei flussi di lavoro automatizzati gestiti dall\u2019AI. L\u2019agente AI pu\u00f2 monitorare contesti esterni \u2014 come le tendenze di mercato, le fluttuazioni dei prezzi o le condizioni meteorologiche \u2014 interrogare il database per verificare i livelli delle scorte o la cronologia degli acquisti e prendere decisioni autonome basate sui dati.<\/p>\n Il proprietario del sito dovr\u00e0 solo fornire istruzioni in linguaggio naturale all\u2019agente IA, che poi coordiner\u00e0 l\u2019intero flusso di lavoro operativo.<\/p>\n Prima di metterci all\u2019opera con il codice e le configurazioni, diamo un\u2019occhiata ai requisiti di sistema. Per collegare il tuo sito WordPress a un client AI tramite MCP, avrai bisogno di quanto segue:<\/p>\n Dato che lavoreremo con l\u2019API Abilities<\/a> di WordPress, avrai bisogno di un ambiente di staging o di sviluppo<\/a> con WordPress 6.9<\/a> o versioni successive. Se stai lavorando in locale, assicurati che la riscrittura degli URL sia abilitata.<\/p>\n Per prima cosa, scarica il file .zip del plugin<\/a> MCP Adapter da GitHub e installalo sul tuo sito WordPress. Quando lo attivi, il plugin registra automaticamente un server MCP predefinito accessibile al seguente indirizzo:<\/p>\n Il server richiede richieste autenticate. Se invii questa richiesta senza autenticazione, riceverai il seguente oggetto di risposta:<\/p>\n Ci torneremo tra un attimo.<\/p>\n Ora devi verificare che lo spazio dei nomi Nella risposta, cerca lo spazio dei nomi Se lo vedi, significa che il server MCP funziona come previsto. Altrimenti, controlla che il plugin sia attivo o che tu stia usando la versione corretta di WordPress.<\/p>\n Ora che hai trasformato il sito WordPress in un server MCP, passiamo alla registrazione dell\u2019Ability necessaria per consentire al client MCP di Claude Desktop di comunicare con il tuo sito ed eseguire azioni. Nel nostro esempio, creerai una bozza di post.<\/p>\n Apri il tuo editor di codice preferito, crea un nuovo file e scrivi il seguente codice:<\/p>\n Ecco i punti chiave di questo plugin:<\/p>\n Non approfondiremo ulteriormente l\u2019API Abilities. Se vuoi o hai bisogno di saperne di pi\u00f9, dai un\u2019occhiata al nostro tutorial approfondito Guida introduttiva all\u2019API Abilities di WordPress<\/a>.<\/p>\n Ora salva il file, comprimilo in un file zip e caricalo sul sito come plugin. Una volta attivato, sar\u00e0 tutto pronto per passare agli step successivi.<\/p>\n Tutte le richieste inviate al server MCP di WordPress devono essere autenticate utilizzando una password dell\u2019applicazione. Per generare una password dell\u2019applicazione, apri la tua dashboard di WordPress, vai su Utenti<\/strong> > Profilo<\/strong> e scorri verso il basso fino alla sezione “Password dell\u2019applicazione”. Inserisci un nome per la tua password e clicca su “Aggiungi nuova password dell\u2019applicazione<\/strong>“.<\/p>\n In questo modo verr\u00e0 generata una password da utilizzare nell’applicazione. Assicurati di copiare e incollare la password in un posto sicuro, perch\u00e9 questa \u00e8 l\u2019unica occasione in cui potrai vederla. Se la perdi, dovrai crearne una nuova.<\/p>\n WordPress richiede una connessione HTTPS per generare una password dell\u2019applicazione. Se non vedi questa sezione nel tuo profilo utente, verifica che il tuo sito sia accessibile tramite HTTPS. Per ulteriori informazioni, consulta la documentazione ufficiale<\/a>.<\/p>\n Prima di configurare Claude Desktop, ti consiglio di testare l\u2019intera catena in Postman, poich\u00e9 ci\u00f2 rende la risoluzione dei problemi molto pi\u00f9 semplice e veloce.<\/p>\n Per prima cosa, prova l\u2019handshake iniziale inviando la seguente richiesta POST:<\/p>\n La richiesta deve essere autenticata. Quando crei una nuova richiesta HTTP in Postman, seleziona Authorization<\/strong> > Basic Auth<\/strong> e inserisci il tuo nome utente WordPress e la password dell’applicazione.<\/p>\n Poi, aggiungi le seguenti intestazioni:<\/p>\n Passa alla scheda Body<\/strong>, seleziona raw<\/strong> > JSON<\/strong>\u00a0e imposta il seguente corpo della richiesta:<\/p>\n![\"Diagramma](\"https:\/\/kinsta.com\/wp-content\/uploads\/2026\/07\/mcp-diagram.png\")
Cosa si pu\u00f2 fare con WordPress e MCP<\/h2>\n
Come collegare un agente AI al tuo sito WordPress tramite MCP<\/h2>\n
\n
Configurare WordPress<\/h3>\n
Passo 1: Installare il plugin WordPress MCP Adapter<\/h4>\n
https:\/\/yoursite.com\/wp-json\/mcp\/mcp-adapter-default-server<\/code><\/pre>\n{\"code\":\"rest_forbidden\",\"message\":\"Sorry, you are not allowed to do that.\",\"data\":{\"status\":401}}<\/code><\/pre>\nmcp<\/code> sia registrato correttamente. Per farlo, invia la seguente richiesta nel tuo browser o in Postman:<\/p>\nhttps:\/\/yoursite.com\/wp-json\/<\/code><\/pre>\nmcp<\/code>:<\/p>\n{\n \"name\": \"WordPress 7.0\",\n \"description\": \"\",\n \"url\": \"http:\/\/yoursite.com\",\n \"home\": \"https:\/\/yoursite.com\",\n \"gmt_offset\": \"0\",\n \"timezone_string\": \"\",\n \"page_for_posts\": 0,\n \"page_on_front\": 345,\n \"show_on_front\": \"page\",\n \"namespaces\": [\n \"oembed\/1.0\",\n \"mcp\",\n \"wp\/v2\",\n \"wp-site-health\/v1\",\n \"wp-block-editor\/v1\",\n \"wp-abilities\/v1\"\n ],\n ...\n}<\/code><\/pre>\nPasso 2: Registrare le Ability con un plugin<\/h4>\n
<?php\n\/**\n * Plugin Name: My MCP Test Plugin\n * Description: Demonstration plugin for creating posts via MCP.\n * Version: 1.0.0\n *\/\n\nif ( ! defined( 'ABSPATH' ) ) {\n exit;\n}\n\nadd_action( 'wp_abilities_api_init', 'kinsta_mcp_register_simple_draft_ability' );\n\n\/**\n * Registers a minimal ability to create post drafts.\n * This acts as a formal contract between the underlying PHP logic and the AI client.\n *\n * @return void\n *\/\nfunction kinsta_mcp_register_simple_draft_ability(): void {\n\n if ( ! function_exists( 'wp_register_ability' ) ) {\n return;\n }\n\n wp_register_ability(\n 'kinsta-plugin\/create-draft',\n array(\n 'category' => 'post',\n 'label' => __( 'Create Post Draft', 'kinsta-mcp-draft' ),\n 'description' => __( 'Creates a new post draft with a title and content provided by the AI agent.', 'kinsta-mcp-draft' ),\n 'input_schema' => array(\n 'type' => 'object',\n 'properties' => array(\n 'title' => array(\n 'type' => 'string',\n 'description' => __( 'The headline or title of the post draft.', 'kinsta-mcp-draft' ),\n ),\n 'content' => array(\n 'type' => 'string',\n 'description' => __( 'The body text or content generated for the draft.', 'kinsta-mcp-draft' ),\n ),\n ),\n 'required' => array( 'title', 'content' ), \/\/ Mandatory fields for the AI payload\n ),\n 'permission_callback' => function(): bool {\n return current_user_can( 'edit_posts' );\n },\n 'execute_callback' => function( array $args ): array {\n $post_id = wp_insert_post( array(\n 'post_title' => sanitize_text_field( $args['title'] ),\n 'post_content' => wp_kses_post( $args['content'] ),\n 'post_status' => 'draft',\n 'post_type' => 'post',\n ) );\n\n if ( is_wp_error( $post_id ) ) {\n return array( \n 'success' => false, \n 'error' => $post_id->get_error_message() \n );\n }\n\n return array( \n 'success' => true, \n 'message' => __( 'Draft saved successfully!', 'kinsta-mcp-draft' ),\n 'post_id' => $post_id \n );\n },\n\n \/\/ Explicitly flag this ability as public to expose it through the default MCP Server\n 'meta' => array(\n 'mcp' => array(\n 'public' => true, \n ),\n \/\/ Also expose within the native WordPress REST API\n 'show_in_rest' => true,\n ),\n )\n );\n}<\/code><\/pre>\n\n
wp_register_ability()<\/code> all\u2019azione wp_abilities_api_init<\/code>.<\/li>\nkinsta-plugin\/create-draft<\/code>).<\/li>\ninput_schema<\/code> \u00e8 un array che definisce il contratto di input per l\u2019abilit\u00e0. In questo caso, l\u2019abilit\u00e0 si aspetta di ricevere un oggetto con due stringhe di testo obbligatorie: title<\/code> e content<\/code>.<\/li>\npermission_callback<\/code> \u00e8 una funzione che verifica se l\u2019agente ha i permessi necessari per eseguire l\u2019abilit\u00e0 (edit_posts<\/code>).<\/li>\nexecute_callback<\/code> \u00e8 la funzione di callback che viene eseguita quando l\u2019abilit\u00e0 viene attivata. In questo esempio, wp_insert_post<\/code> viene utilizzata per creare una nuova bozza di post.<\/li>\nmeta.mcp.public<\/code> rende l\u2019abilit\u00e0 disponibile tramite il server predefinito dell\u2019adattatore MCP (per saperne di pi\u00f9, leggi qui<\/a>).<\/li>\n<\/ul>\nPasso 3: Generare una password dell\u2019applicazione<\/h4>\n
Testare l\u2019interare catena in Postman<\/h3>\n
Passo 1: Provare l\u2019handshake iniziale<\/h4>\n
https:\/\/yoursite.com\/wp-json\/mcp\/mcp-adapter-default-server<\/code><\/pre>\n![\"Impostare](\"https:\/\/kinsta.com\/wp-content\/uploads\/2026\/07\/postman-authorization.png\")
Content-Type: application\/json\nAccept: application\/json, text\/event-stream<\/code><\/pre>\n![\"Impostare](\"https:\/\/kinsta.com\/wp-content\/uploads\/2026\/07\/postman-headers.png\")
{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"initialize\",\"params\":{\"protocolVersion\":\"2025-03-26\",\"capabilities\":{},\"clientInfo\":{\"name\":\"postman\",\"version\":\"1.0\"}}}<\/code><\/pre>\n![\"Impostare](\"https:\/\/kinsta.com\/wp-content\/uploads\/2026\/07\/postman-body-settings.png\")