Come Funziona Mia con Drupal — Guida all'Installazione (Server MCP)

Come Funziona Mia con Drupal: Una Guida Pratica all'Installazione

Drupal è una delle piattaforme CMS più flessibili sul web — e grazie al Model Context Protocol (MCP), ora può lavorare a stretto contatto con Mia, il tuo segretario personale AI. In questa guida, ti accompagneremo attraverso l'intera configurazione: dall'installazione del modulo server MCP per Drupal alla sua connessione con la tua chat Mia.

Alla fine, Mia sarà in grado di leggere, creare, aggiornare e gestire contenuti Drupal direttamente dalla tua conversazione Telegram — niente dashboard, niente cambi di contesto.

Cos'è MCP e perché dovrebbe interessarti?

Il Model Context Protocol è uno standard aperto (introdotto originariamente da Anthropic e ora supportato da OpenAI e Google) che consente agli agenti AI di comunicare con servizi esterni tramite un'interfaccia strutturata e sicura.

Un server MCP espone strumenti e dati da un sistema (Drupal, nel nostro caso). Un client MCP (Mia) si connette a quel server e utilizza quegli strumenti per tuo conto.

Per i proprietari di siti Drupal, questo significa che puoi fare cose come:

Chiedere a Mia di creare o aggiornare un post del blog
Cercare bozze di contenuti non pubblicate
Elencare termini di tassonomia, utenti o viste
Attivare flussi di lavoro (moderazione, pubblicazione, pianificazione)
Ottenere report sullo stato di salute del sito

Tutto da una singola chat Telegram.

Prerequisiti

Prima di iniziare, assicurati di avere:

Un sito Drupal 10.x o 11 (PHP 8.1+, configurazione Composer standard)
Accesso amministrativo per installare moduli
Un account Mia Handles con almeno un piano Standard (le connessioni MCP richiedono accesso API)
L'SDK PHP MCP ufficiale installato globalmente o disponibile tramite Composer

Passaggio 1 — Installa il modulo server MCP per Drupal

Il modulo consigliato è mcp_server da Drupal.org — è costruito sopra l'SDK ufficiale modelcontextprotocol/php-sdk (collaborazione PHP Foundation + Symfony).

Dalla root del tuo sito, esegui:

composer require drupal/mcp_server

Quindi abilitalo tramite Drush o l'interfaccia utente:

drush en mcp_server -y
drush cr

In alternativa, vai su Estendi → Installa nuovo modulo, carica l'archivio e abilita.

Dopo averlo abilitato, naviga su Configurazione → Servizi web → Server MCP (/admin/config/services/mcp_server). Lì troverai:

URL endpoint — l'URL pubblico per l'endpoint MCP (di solito https://iltuosito.com/mcp)
Autenticazione — autenticazione Basic, token o OAuth (consigliato: token)
Strumenti e risorse — attiva quali funzionalità di Drupal sono esposte (nodi, utenti, tassonomia, Viste, ecc.)

Genera un token API sicuro e salvalo — ti servirà in Mia.

Passaggio 2 — Esponi l'endpoint in modo sicuro

L'endpoint MCP dovrebbe essere raggiungibile solo da servizi di cui ti fidi. Opzioni tipiche:

Whitelist IP — limita l'accesso all'IP del backend di Mia
Autenticazione basata su token — ogni richiesta deve portare il token nell'header
Rete privata / VPC — per configurazioni enterprise

Se il tuo sito Drupal è dietro Cloudflare o un altro WAF, assicurati che il percorso /mcp sia consentito con i metodi POST e GET, più SSE se usi lo streaming.

Passaggio 3 — Connetti il server Drupal in Mia Handles

Ora la parte divertente. Nella tua chat Mia:

Apri la miniapp Mia (tocca la tua immagine del profilo o usa il menu)
Vai su Impostazioni → Integrazioni → Aggiungi server MCP
Compila il modulo di connessione:

Nome server:   Il mio sito Drupal
URL endpoint:  https://iltuosito.com/mcp
Trasporto:     HTTP Streamable
Auth:          Token Bearer
Token:         (incolla il tuo token MCP Drupal)

Tocca Connetti. Mia verificherà l'endpoint, elencherà gli strumenti disponibili e aggiungerà il server alla tua chat.

Puoi anche connetterti utilizzando un trasporto SSE o JSON POST — Mia supporta tutti e tre.

Passaggio 4 — Testa la connessione

Una volta connesso, prova un semplice comando nella tua chat Mia:

"Elenca gli ultimi 5 articoli non pubblicati sul mio sito Drupal"

Mia dovrebbe restituire un riassunto estratto direttamente dal tuo sito Drupal. Se ottieni un errore, controlla:

La validità del token nelle impostazioni MCP di Drupal
Che l'URL dell'endpoint sia raggiungibile dal backend di Mia (firewall, certificato SSL)
Che gli strumenti richiesti siano abilitati sul lato Drupal

Cosa puoi fare dopo l'installazione

Ecco alcune cose che Mia può gestire per te una volta connessa:

Operazioni sui contenuti — crea bozze, pubblica/rimuovi pubblicazione, modifica campi in blocco
Tassonomia e riferimenti — aggiungi termini, riorganizza vocabolari
Gestione utenti — crea account, resetta password, assegna ruoli
Query di Viste — ottieni report strutturati in Markdown o JSON
Attivazione flussi di lavoro — sposta contenuti attraverso stati di moderazione
Pubblicazione programmata — metti in coda articoli per date future tramite le attività o il calendario di Mia

E poiché Mia conosce già il tuo calendario, le tue attività e i tuoi file, può orchestrare il lavoro su Drupal insieme al resto della tua giornata — ad esempio:

"Pubblica l'intervista che ho finito di registrare stamattina come articolo sul mio sito Drupal, e ricorda all'editor di revisionarla domani alle 10:00."

Mia gestirà entrambe le cose in un'unica operazione.

Risoluzione dei problemi

Sintomo	Causa probabile	Soluzione
"Connessione fallita"	Endpoint bloccato o URL errato	Controlla le regole del firewall e il certificato SSL
"Nessuno strumento disponibile"	Modulo MCP disabilitato o nessuno strumento selezionato	Riabilita e seleziona almeno uno strumento
"Non autorizzato"	Token non valido	Rigenera il token nell'amministrazione di Drupal e aggiorna in Mia
Risposte lente	Esportazioni di entità di grandi dimensioni	Disabilita strumenti non utilizzati, abilita la paginazione

Letture correlate

Lo stesso schema MCP funziona con altre piattaforme CMS. Dai un'occhiata alle nostre guide complementari:

Come Funziona Mia con WordPress: Una Guida Pratica all'Installazione — copre il plugin mcp-adapter, le Password Applicative e i casi d'uso specifici di WordPress (media, commenti, azioni dei plugin, query API REST).
Il Miglior Compagno AI per Bitrix CMS: Connetti Mia via MCP — copre il modulo hiweb.site_mcp, l'autenticazione token bearer, il trasporto JSON POST e i casi d'uso specifici di Bitrix (iblok, ordini, CRM).

Puoi connettere tutte e tre le piattaforme alla stessa chat Mia, e lei si rivolgerà a ciascuna per nome.

Conclusione

Connettere Drupal a Mia tramite MCP trasforma il tuo CMS da una dashboard autonoma a un'estensione conversazionale del tuo flusso di lavoro quotidiano. Una volta configurato, funziona e basta — silenziosamente, in background, ogni volta che ne hai bisogno.

Se hai domande o desideri aiuto per l'installazione, chiedi direttamente a Mia in chat. Lei conosce già il protocollo.