Questo tutorial spiega come usare il plugin WP Novamira in modo pratico, partendo dalla documentazione ufficiale e mantenendo un principio fondamentale: Novamira è uno strumento potente, pensato per sviluppo e staging, non per fare esperimenti direttamente su un sito in produzione.

Se lavori già con WordPress, AI e progettazione di temi, puoi collegare questo workflow anche ad altri approfondimenti pubblicati su MrTux, come la guida su AI per migliorare SEO, UX e design su WordPress, il metodo per creare articoli WordPress ottimizzati SEO con AI e l'analisi sugli strumenti per il web design di temi WordPress.

Cos'è Novamira.ai e perché interessa ai designer WordPress

Novamira è un plugin WordPress che consente a client AI compatibili con MCP, come Claude, Cursor, VS Code Copilot o altri strumenti che supportano il protocollo, di interagire con WordPress in modo programmatico. Secondo la documentazione ufficiale Getting started, il plugin permette all'AI assistant di eseguire codice PHP, leggere e scrivere file, gestire database, installare plugin e costruire funzionalità personalizzate.

Per il web design WordPress, questo significa poter lavorare con un agente AI che non si limita a suggerire codice in astratto, ma può leggere la struttura reale del sito, controllare il tema, verificare plugin attivi, creare file nella sandbox e iterare sulle modifiche con maggiore contesto.

Novamira non va interpretato come un page builder automatico, ma come un ponte operativo tra WordPress e un assistente AI tecnico.

Prima di iniziare: requisiti tecnici

Prima di installare Novamira, conviene verificare che l'ambiente sia adeguato. La pagina ufficiale sui requisiti Novamira indica alcune condizioni minime da rispettare.

Per installazioni locali senza HTTPS, la documentazione spiega che è possibile impostare WP_ENVIRONMENT_TYPE su local nel file wp-config.php. Questa eccezione va usata solo in locale, non su server remoti.

Installare Novamira su WordPress

La procedura di installazione è simile a quella di molti plugin premium o distribuiti via ZIP. La guida ufficiale Installation indica un flusso diretto: scaricare il file ZIP, caricarlo da WordPress e attivarlo.

1. Scarica l'ultima versione ZIP di Novamira dalla pagina di download ufficiale.
2. Entra nel pannello WordPress del sito di sviluppo o staging.
3. Vai in Plugin > Aggiungi nuovo plugin > Carica plugin.
4. Seleziona il file ZIP di Novamira e clicca su Installa ora.
5. Attiva il plugin.

All'attivazione, Novamira registra il MCP Adapter incluso, espone un menu dedicato nella sidebar admin e prepara le otto abilità principali. Le abilità AI, però, restano disattivate di default: nessun tool MCP viene esposto finché non viene abilitato esplicitamente.

Configurare le AI Abilities

Dopo l'installazione, il passaggio più importante è la configurazione. La pagina ufficiale Configuration spiega che bisogna abilitare manualmente le AI Abilities da Novamira > Settings.

1. Apri il pannello WordPress.
2. Vai in Novamira > Settings.
3. Attiva la checkbox Enable AI Abilities.
4. Leggi con attenzione il messaggio di conferma.
5. Conferma e salva le impostazioni.

Quando le abilità sono attive, compare un indicatore rosso Novamira ON nella barra di amministrazione. È un promemoria utile: in quel momento l'AI agent può accedere agli strumenti MCP collegati al sito.

Le otto abilità disponibili

Novamira registra otto abilità principali. Per un web designer o sviluppatore WordPress, è importante capire cosa fanno prima di usarle in un flusso reale.

Collegare il client AI tramite MCP

Una volta abilitate le AI Abilities, bisogna collegare il client AI. La guida Connecting Your AI Client descrive il processo basato su Application Password e configurazione MCP.

1. Crea una Application Password

Da Novamira > Connect, crea una nuova Application Password. WordPress mostrerà la password una sola volta: copiala subito e conservala in modo sicuro. È consigliabile usare un nome descrittivo, ad esempio il nome del client o della workstation.

2. Configura il client MCP

Novamira fornisce snippet per client come Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Zed e OpenCode. Il modello generale usa npx per avviare il proxy remoto @automattic/mcp-wordpress-remote.

{
  "mcpServers": {
    "novamira": {
      "command": "npx",
      "args": ["-y", "@automattic/mcp-wordpress-remote@latest"],
      "env": {
        "WP_API_URL": "https://your-site.com/wp-json/mcp/mcp-adapter-default-server",
        "WP_API_USERNAME": "your-wordpress-username",
        "WP_API_PASSWORD": "your-application-password"
      }
    }
  }
}

Nel tuo caso reale dovrai sostituire URL, username e Application Password con quelli del sito di staging. Dopo aver salvato la configurazione, riavvia il client AI: molti strumenti caricano i server MCP solo all'avvio.

3. Verifica la connessione

Per verificare che tutto funzioni, chiedi all'agente AI un'operazione semplice e non distruttiva, ad esempio elencare i plugin installati. Se la connessione è corretta, il client dovrebbe mostrare gli strumenti Novamira e usare Execute PHP o le altre abilità disponibili.

Tutorial pratico: usare Novamira per migliorare un layout WordPress

Un caso d'uso realistico per il web design è l'ottimizzazione di una pagina WordPress esistente. L'obiettivo non è chiedere all'AI di "rifare tutto", ma guidarla con richieste progressive e verificabili.

1. Mappa il sito: chiedi all'agente di identificare tema attivo, plugin principali e struttura dei template.
2. Analizza la pagina: fai leggere template, CSS e blocchi coinvolti nella pagina da migliorare.
3. Definisci il problema: per esempio hero troppo pesante, CTA poco visibile, spaziature incoerenti o layout mobile debole.
4. Chiedi una proposta: prima solo piano di intervento, poi modifica mirata.
5. Applica in staging: usa Edit File o file sandbox, mai direttamente su produzione.
6. Verifica risultato: controlla frontend, editor WordPress, mobile e performance.
7. Disabilita o raffina: se una modifica non convince, disabilita il file sandbox o chiedi una correzione puntuale.

Un prompt pratico potrebbe essere: "Analizza il tema attivo e proponi un miglioramento del layout della pagina servizi. Non modificare file finché non approvo il piano. Concentrati su leggibilità, CTA, mobile e compatibilità con Gutenberg".

Sicurezza: cosa fare e cosa evitare

La parte più importante della documentazione Novamira è quella sulla sicurezza. La pagina Security & Best Practices chiarisce che Novamira offre accesso programmatico reale al sito WordPress. Questo è il suo valore, ma anche il motivo per cui va usato con disciplina.

La documentazione su uso live/production è molto esplicita: le AI abilities dovrebbero essere attivate solo su ambienti di sviluppo e staging, mai direttamente in produzione. Il plugin può rimanere installato sul sito live, ma le abilità AI devono restare disattivate.

• Usa sempre backup prima di lavorare con AI agents.
• Configura Novamira su staging o sviluppo, non sul sito live.
• Approva ogni tool call prima dell'esecuzione.
• Crea Application Password separate per client o workstation.
• Revoca le password non più usate.
• Evita richieste vaghe come "sistema il sito".
• Preferisci interventi piccoli, verificabili e reversibili.

Capire la sandbox

La sandbox Novamira si trova in wp-content/novamira-sandbox/. Secondo la pagina ufficiale The Sandbox, i file PHP scritti dagli AI agent vengono confinati in questa directory e caricati automaticamente a ogni richiesta WordPress tramite un loader must-use.

Questo rende la sandbox utile per organizzare codice generato dall'AI: shortcode, endpoint REST, custom post type, funzioni di supporto o piccoli esperimenti. Ma la documentazione precisa anche un punto essenziale: la sandbox non è una vera barriera di sicurezza. Il codice che gira lì ha comunque privilegi simili a quelli di un plugin WordPress.

Quando Novamira è utile nel web design WordPress

Novamira diventa interessante quando il progetto richiede lavoro tecnico su un sito reale: analisi del tema, creazione di funzionalità, debug, verifica plugin, generazione di CSS mirato, integrazioni PHP o miglioramenti di workflow. Non sostituisce Figma, Gutenberg o un buon processo di design; li affianca nella fase di implementazione e revisione tecnica.

• Utile: staging, prototipi, debug, sviluppo custom, analisi plugin, refactoring controllato.
• Da evitare: test diretti su produzione, modifiche non approvate, prompt troppo generici, assenza di backup.
• Da valutare: team con più sviluppatori, processi di deploy, policy interne e gestione credenziali.

FAQ su Novamira e WordPress

Novamira è un page builder AI?

No. Novamira non è un page builder visuale. È un plugin che collega AI agents a WordPress tramite MCP, dando accesso a strumenti tecnici per leggere, modificare e testare il sito.

Posso usarlo su un sito in produzione?

La documentazione consiglia di usare le AI abilities solo su sviluppo o staging. Su produzione il plugin può restare installato, ma le abilità AI dovrebbero rimanere disattivate.

Serve Node.js?

Per connessioni remote tramite MCP proxy serve Node.js 18 o superiore lato client. Per installazioni locali con WP-CLI è possibile usare il trasporto STDIO, che non richiede Node.js.

La sandbox rende sicuro il codice generato dall'AI?

No. La sandbox aiuta a organizzare e gestire i file PHP generati, ma non va considerata una barriera di sicurezza. Il codice va sempre revisionato prima di portarlo in produzione.

Conclusione

Novamira.ai è uno strumento potente per chi lavora con WordPress in modo tecnico. Permette a un AI agent di operare con molto più contesto rispetto al classico copia e incolla di codice, aprendo scenari interessanti per sviluppo, debug, prototipazione e miglioramento del web design.

Il modo migliore per iniziare è prudente: installa Novamira su staging, abilita le AI Abilities solo quando servono, collega un client MCP, prova operazioni non distruttive e lavora sempre per passaggi piccoli. Se il risultato è valido, potrai poi portarlo nel normale flusso di deploy. L'AI diventa davvero utile quando accelera il lavoro senza togliere controllo al professionista.