Riferimento agli strumenti MCP di WordPress.com
Questo testo è stato tradotto utilizzando l’IA. Se desideri visualizzare il testo originale in inglese, fai clic qui.
Questo documento fornisce una mappatura completa degli strumenti MCP disponibili per chi sviluppa su WordPress.com. Si tratta di un documento in continuo aggiornamento, che verrà modificato man mano che vengono aggiunti nuovi strumenti o quelli esistenti vengono modificati.
Per gli schemi esatti di input e output, richiama lo strumento stesso — ogni facade STRAP espone action: list (catalogo delle operazioni) e action: describe (JSON Schema completo per ogni operazione). Gli schemi si evolvono, quindi considera sempre la risposta live di describe come la fonte di verità.
Come sono organizzati gli strumenti MCP di WordPress.com
Il server MCP di WordPress.com espone due tipi di strumenti:
- Strumenti facade STRAP — Un singolo strumento MCP che racchiude una famiglia di operazioni correlate dietro un unico punto di accesso. Le facade utilizzano un’interfaccia uniforme basata sulle azioni (
action: list | describe | execute) in modo che gli agenti AI possano scoprire cosa è disponibile, recuperare gli schemi dei parametri ed eseguire operazioni attraverso un unico strumento. Questo mantiene il catalogo degli strumenti ridotto e prevedibile. - Strumenti standalone — Strumenti a scopo singolo che accettano parametri direttamente. Utilizzati per operazioni che non rientrano in una famiglia più ampia (ad es. elencare i siti dell’utente, generare un URL di checkout).
⚠️ Protocollo di sicurezza: Tutte le operazioni di scrittura, aggiornamento ed eliminazione richiedono la conferma dell’utente. L’agente deve (1) descrivere esattamente cosa intende fare, (2) chiedere all’utente una conferma esplicita e (3) includere la conferma dell’utente come user_confirmed: true nei params di execute. Le operazioni di scrittura non vengono mai eseguite automaticamente. Le eliminazioni permanenti (termini di tassonomia) richiedono inoltre confirm_permanent_delete: true.
Interfaccia basata sulle azioni (facade STRAP)
Ogni strumento facade STRAP accetta gli stessi tre input di primo livello:
action(enum:list/describe/execute): Cosa vuole fare l’agente.list— Scoprire le operazioni disponibili su questo strumento. Restituisce nomi delle operazioni, brevi descrizioni e motivi per cui alcune operazioni sono disabilitate.describe— Ottenere il JSON Schema completo (parametri, tipi, campi obbligatori) per una singola operazione.execute— Eseguire un’operazione.operation: Il nome dell’operazione nella formaresource.action(ad es.posts.create,theme.presets).params: Parametri specifici dell’operazione. Le operazioni di scrittura devono includereuser_confirmed: true.
La maggior parte delle facade richiede anche wpcom_site (un ID sito o URL). La facade wpcom-mcp-account è l’eccezione: opera sull’utente autenticato.
Tutte le operazioni supportano un parametro opzionale include_fields per limitare i campi restituiti. Utilizzalo per mantenere le risposte efficienti in termini di contesto.
Strumenti della facade STRAP
Creazione di contenuti ( wpcom-mcp-content-authoring )
Crea, leggi, aggiorna ed elimina contenuti su un sito WordPress.com: articoli, pagine, commenti, media, categorie, tag, pattern di blocchi e ricerca di contenuti.
💡 Sequenza consigliata: Chiama prima wpcom-mcp-site-editor-context (theme.active, theme.presets) in modo che i contenuti utilizzino gli slug dei preset allineati al tema (ad es. "primary", "large") invece di colori e dimensioni codificati manualmente.
Operazioni disponibili
| Operazione | Descrizione |
|---|---|
posts.list | Elenca gli articoli con filtri opzionali (stato, autore, ricerca, tassonomia, intervallo di date, ordinamento, paginazione). |
posts.get | Ottieni un articolo singolo per ID o slug. Se lo slug non corrisponde a un articolo, cerca tra le pagine. |
posts.create | Crea un nuovo articolo — creato come bozza per impostazione predefinita. Scrittura. |
posts.update | Aggiorna un articolo esistente. Vengono modificati solo i campi forniti. Se lo stato è publish, le modifiche diventano immediatamente visibili. Scrittura. |
posts.delete | Sposta un articolo nel cestino. Ripristinabile dall’amministrazione di WordPress entro 30 giorni. Scrittura. |
pages.list | Elenca le pagine con filtri opzionali (genitore, stato, ricerca, ordinamento, paginazione). |
pages.get | Ottieni una singola pagina per ID o slug. |
pages.create | Crea una nuova pagina — creata come bozza per impostazione predefinita. Supporta strutture gerarchiche e template di pagina. Scrittura. |
pages.update | Aggiorna una pagina esistente. Vengono modificati solo i campi forniti. Se lo stato è publish, le modifiche diventano immediatamente visibili. Scrittura. |
pages.delete | Sposta una pagina nel cestino. Ripristinabile dall’amministrazione di WordPress entro 30 giorni. Scrittura. |
comments.list | Elenca i commenti con filtri opzionali (stato, articolo, autore, ricerca, intervallo di date, paginazione). |
comments.get | Ottieni un singolo commento per ID. |
comments.create | Crea un commento su un articolo. I commenti degli utenti autenticati compilano automaticamente i campi dell’autore. Scrittura. |
comments.update | Aggiorna un commento esistente. Se lo stato è approved, le modifiche sono immediatamente visibili. Scrittura. |
comments.delete | Sposta un commento nel cestino. Scrittura. |
media.list | Elenca gli elementi multimediali con filtri opzionali (tipo MIME, articolo, autore, ricerca, intervallo di date, paginazione). |
media.get | Ottieni un singolo elemento multimediale per ID. |
media.create | Carica un nuovo elemento multimediale (immagine, video, audio, documento). Scrittura. |
media.update | Aggiorna i metadati di un elemento multimediale (non il file). Le modifiche a alt_text e caption si aggiornano immediatamente ovunque l’elemento multimediale sia utilizzato. Scrittura. |
media.delete | Sposta un elemento multimediale nel cestino. Potrebbe compromettere i contenuti che vi fanno riferimento. Scrittura. |
categories.list | Elenca le categorie con filtri opzionali. |
categories.get | Ottieni una singola categoria per ID. |
categories.create | Crea una nuova categoria. Supporta relazioni gerarchiche genitore-figlio. Scrittura. |
categories.update | Aggiorna una categoria esistente. La modifica dello slug influisce sugli URL degli archivi immediatamente e potrebbe interrompere i link. Scrittura. |
categories.delete | Elimina permanentemente una categoria — i termini di tassonomia non hanno cestino. Gli articoli assegnati vengono spostati in Senza categoria; le categorie figlie diventano di primo livello. Richiede confirm_permanent_delete: true. |
tags.list | Elenca i tag con filtri opzionali. La ricerca dei tag non distingue tra maiuscole e minuscole. |
tags.get | Ottieni un singolo tag per ID. |
tags.create | Crea un nuovo tag. Scrittura. |
tags.update | Aggiorna un tag esistente. La modifica dello slug influisce immediatamente sugli URL degli archivi. Scrittura. |
tags.delete | Elimina permanentemente un tag — viene rimosso da tutti gli articoli associati. Richiede confirm_permanent_delete: true. |
patterns.list | Elenca i pattern di blocchi disponibili sul sito (tema, core, directory dei pattern). |
patterns.get | Ottieni un singolo pattern di blocchi per nome, incluso il relativo markup dei blocchi. |
synced-patterns.list | Elenca i pattern sincronizzati (riutilizzabili) del sito. |
synced-patterns.get | Ottieni un singolo pattern sincronizzato per ID, incluso il relativo markup dei blocchi. |
content-search | Ricerca a testo libero nei contenuti del sito (articoli, pagine, altri tipi di articolo). |
⚠️ Le operazioni distruttive (posts.delete, pages.delete, comments.delete, media.delete, categories.delete, tags.delete) richiedono che l’agente recuperi e presenti l’elemento da eliminare (titolo, autore, numero di articoli interessati) prima di richiedere la conferma.
💡 Suggerimento: Quando crei delle pagine, usa patterns.list → patterns.get per recuperare i pattern di blocchi e comporre pagine intere a partire da più pattern. Dopo ogni creazione o aggiornamento, controlla il campo _content_warnings nella risposta — WordPress potrebbe rimuovere blocchi o HTML durante il salvataggio.
Contesto dell’Editor del sito ( wpcom-mcp-site-editor-context )
Interroga il contesto di design del sito — preset del tema, stili applicati e tipi di blocco registrati. Complemento in sola lettura della Creazione contenuti. Usalo prima di creare o aggiornare contenuti, in modo che il markup utilizzi token allineati al tema anziché valori codificati manualmente.
Questa interfaccia usa action: list | describe | get (non execute, poiché non effettua mai scritture).
💡 Sequenza consigliata: theme.active → theme.presets → (opzionalmente) blocks.allowed → poi crea contenuti tramite wpcom-mcp-content-authoring.
Operazioni disponibili
| Operazione | Descrizione |
|---|---|
theme.active | Ottieni lo slug dello stylesheet e il nome del tema attivo. Usa il valore stylesheet quando recuperi theme.presets o theme.styles. |
theme.presets | Ottieni i token di design del sito — palette colori, dimensioni del font, famiglie di font, gradienti, scala di spaziatura. Risolve automaticamente lo stylesheet dal tema attivo se omesso. |
theme.styles | Ottieni gli stili applicati del sito da theme.json — override a livello di blocco e tipografia/colori a livello di elemento. Complementa theme.presets: i preset indicano quali token esistono; gli stili indicano come vengono applicati. |
blocks.allowed | Elenca i tipi di blocco registrati sul sito con nome, titolo, descrizione, categoria e variazioni di stile. Applica una variazione di stile come is-style-{name}. |
💡 Suggerimento: Fai riferimento agli slug dei preset nel markup dei blocchi — ad esempio, has-primary-color o has-large-font-size — anziché usare stili inline con valori esadecimali o in pixel, così il contenuto si adatta quando i token di design del sito cambiano.
⚠️ Importante: Il fatto che un blocco sia registrato non garantisce che il suo markup sopravviva invariato alla pipeline di salvataggio della REST API. Dopo ogni creazione o aggiornamento tramite wpcom-mcp-content-authoring, controlla il campo _content_warnings. Se il markup è stato rimosso, usa alternative di blocco più semplici oppure chiedi come procedere.
Account ( wpcom-mcp-account )
Gestisci l’account WordPress.com dell’utente autenticato: profilo, notifiche, traguardi, domini, connessioni, sicurezza e valuta. Opera sull’utente chiamante; non è richiesto il parametro wpcom_site.
Operazioni disponibili
| Operazione | Descrizione |
|---|---|
profile.get | Profilo di base (nome utente, email, nome visualizzato, avatar, lingua, fuso orario), opzionalmente con preferenze, statistiche, informazioni sull’account, dati social/attività. |
profile.update | Aggiorna i campi del profilo (nome visualizzato, biografia, lingua, ecc.). Scrittura. |
notifications.get | Preferenze di notifica su email, push, timeline e altri canali. Include l’elenco dei dispositivi e il test di consegna. |
notifications.update | Aggiorna le impostazioni di notifica. Scrittura. |
inbox.get | La casella di notifica dell’utente (messaggi, avvisi, menzioni, like, follower). Filtra per tipo, non letti, intervallo di tempo. |
achievements.get | Badge ottenuti, imprese, progressi di gamification e bacheca dei trofei. |
domains.list | Elenca i domini dell’utente autenticato su tutti i siti. |
domains.get | Dettagli del dominio: funzionalità di gestione, configurazione DNS, DNSSEC, stato SSL, stato di manutenzione. |
domains.dns_records | Record DNS (A, AAAA, ALIAS, CAA, CNAME, MX, NS, SRV, TXT) per un singolo dominio. |
domains.set_primary | Imposta un dominio personalizzato come dominio principale per un sito. Scrittura. |
connections.get | Connessioni a servizi social e di terze parti (elenco, dettagli, verifica dello stato). |
security.get | Stato della sicurezza: 2FA, password per applicazioni, sessioni attive, cronologia degli accessi, età dell’account. |
currency.preview | Anteprima dell’impatto del cambio di valuta dell’account (senza conferma). |
currency.change | Cambia la valuta dell’account. Scrittura. |
Site ( wpcom-mcp-site )
Gestisci un sito WordPress.com: impostazioni, statistiche, plugin, log attività, temi e configurazione dei moduli Jetpack. Richiede wpcom_site (ID del sito o URL).
Operazioni disponibili
| Operazione | Descrizione |
|---|---|
settings.get | Impostazioni generali, di scrittura, lettura, discussione, media, permalink e privacy. |
settings.update | Aggiorna le impostazioni del sito. Scrittura. |
statistics.get | Totali del sito — articoli pubblicati, pagine, iscritti — più visualizzazioni, visitatori, articoli pubblicati e pagine pubblicate opzionali per un intervallo di date. NON include top-posts, referrer, dati geografici o suddivisioni per URL. |
plugin.list | Plugin installati con stato, versione, disponibilità di aggiornamenti e permessi. |
activity.get | Voci del log attività (articoli, commenti, aggiornamenti plugin, backup, azioni utente). In ordine cronologico inverso. Predefinito agli ultimi 6 mesi. Filtra per activity_group e activity_action. |
theme.list | Temi installati sul sito. |
theme.set | Cambia il tema attivo. Scrittura. |
monitor.status / monitor.activate / monitor.deactivate | Controlli di uptime di Jetpack Monitor. Attivazione/disattivazione sono scritture. |
newsletter.status / newsletter.get_settings | Stato e impostazioni di Jetpack Newsletter. |
account-protection.status / account-protection.activate / account-protection.deactivate | Jetpack Account Protection. Attivazione/disattivazione sono scritture. |
manage-site.status / manage-site.launch / manage-site.set-visibility | Ciclo di vita del sito — stato “prossimamente”, lancio, visibilità. Scritture. |
💡 Suggerimento per activity.get: combina activity_group (es. ["plugin"]) e activity_action (es. ["activated", "deactivated"]) per restringere le indagini. Effettua prima una chiamata senza filtri per scoprire cosa è disponibile per un determinato sito.
Strumenti autonomi
Elenco dei siti utente ( wpcom-user-sites )
Elenca i siti accessibili dall’utente autenticato su WordPress.com e i siti self-hosted connessi tramite Jetpack. Utilizza questo strumento per individuare gli ID dei siti prima di chiamare strumenti con ambito specifico per sito. Supporta paginazione, ricerca, filtri per stato e privacy, ordinamento e metriche opzionali del sito.
Cerca disponibilità dominio ( wpcom-domain-purchase )
Cerca domini disponibili e genera link di checkout per la registrazione su WordPress.com. Restituisce i domini corrispondenti con prezzi e URL di checkout precompilati.
Aggiorna record DNS ( wpcom-domain-update-dns-records )
Aggiungi o rimuovi record DNS (A, AAAA, ALIAS, CAA, CNAME, MX, NS, SRV, TXT) per un singolo dominio personalizzato che gestisci.
⚠️ Operazione distruttiva. Una configurazione DNS errata può compromettere email e siti web. Recupera sempre i record attuali (tramite wpcom-mcp-account → domains.dns_records) e descrivi le differenze prima di richiedere la conferma.
Ripristina i record DNS predefiniti ( wpcom-domain-restore-default-dns-records )
Ripristina i record A predefiniti di WordPress.com (IP apex) o il CNAME www predefinito per un singolo dominio personalizzato. Subordinato all’impostazione «Aggiorna record DNS».
Aggiorna i nameserver ( wpcom-domain-update-nameservers )
Imposta i nameserver per un singolo dominio personalizzato. Richiede che il chiamante gestisca il sito a cui è collegato il dominio. Accetta da 2 a 13 hostname nameserver validi.
⚠️ La modifica dei nameserver trasferisce il controllo DNS al di fuori di WordPress.com. Email, siti web e altri servizi potrebbero smettere di funzionare se i nuovi nameserver non sono configurati per servire gli stessi record.
Impostare un servizio di posta esterno ( wpcom-domain-set-mail-service )
Configura i record DNS su un dominio per un servizio di posta esterno: Google Workspace, iCloud Mail, Office 365 o Zoho Mail.
⚠️ Sovrascrive i record MX e i record DNS correlati esistenti del dominio. Il flusso di posta esistente si interrompe non appena i nuovi record si propagano.
Generare un URL di checkout ( wpcom-checkout-url )
Genera un URL di checkout WordPress.com preconfigurato per uno o più prodotti (nuovo acquisto) o per il rinnovo di un abbonamento. L’URL porta l’utente al checkout di WordPress.com: il pagamento avviene nel browser, non tramite questo strumento.
Elencare i piani WordPress.com ( wpcom-plans-list )
Elenca i piani WordPress.com con prezzi e liste di funzionalità per ogni livello. Sola lettura; utile per mostrare le opzioni di piano prima di generare un URL di checkout.
Riepilogo del protocollo di sicurezza
Tutte le operazioni di scrittura/eliminazione applicano un flusso di conferma obbligatorio. L’agente deve descrivere l’azione, ottenere l’approvazione esplicita dell’utente e passare tale approvazione come user_confirmed: true nei params di esecuzione.
| Comportamento | Lettura | Creazione | Aggiornamento | Eliminazione (cestino) | Eliminazione (permanente) |
|---|---|---|---|---|---|
| Conferma richiesta | ❌ | ✅ | ✅ | ✅ | ✅ |
| Reversibile | N/D | N/D | Parzialmente (i valori precedenti vengono persi) | ✅ Entro 30 giorni | ❌ Permanente |
| Stato predefinito (contenuto) | N/D | bozza | Nessuna modifica | cestino | Rimosso completamente |
| Flag aggiuntivo | — | — | — | — | confirm_permanent_delete: true |
Le eliminazioni permanenti (termini di tassonomia come categorie e tag) richiedono inoltre confirm_permanent_delete: true nei params.
Forme accettate di user_confirmed: il booleano true (preferito), oppure una delle stringhe "true", "yes", "on", "1". Frasi di approvazione in forma libera come "yes do it" vengono rifiutate — l’agente deve tradurre l’approvazione dell’utente in una di queste forme accettate.
Ultimo aggiornamento: giugno 22, 2026
Risorse per gli sviluppatori di WordPress.com 