Collegare un assistente AI (MCP)

Il canale MCP collega al sito un assistente AI esterno. L'assistente legge i contenuti del sito e propone nuovi contenuti o modifiche; ogni proposta arriva nel pannello e raggiunge il sito solo dopo l'approvazione.

• Lettura. Pagine, articoli, categorie, autori, prodotti, listini, preset e statistiche aggregate del sito. I dati personali dei clienti non sono accessibili.

• Proposte. Nuove pagine, articoli, eventi, prodotti e listini, aggiornamenti di pagine e prezzi. Le proposte compaiono in Proposte AI e restano in attesa di revisione.

• Un sito per connessione. Ogni sito ha un proprio indirizzo MCP e ogni connessione è limitata a quel sito. Per lavorare su più siti si aggiunge all'assistente un collegamento per ciascun sito. Ogni connessione può essere revocata in qualsiasi momento.

• Il piano del sito include l'MCP: senza questa condizione la scheda MCP delle impostazioni non compare.

• Il canale è attivato da un utente con ruolo ProjectAdmin o Sviluppatore.

• L'assistente AI supporta i server MCP remoti con autenticazione OAuth, per esempio tramite i connettori personalizzati.

Il collegamento usa l'indirizzo copiato dalla scheda MCP del sito e si svolge in due fasi: si aggiunge l'indirizzo come connettore nell'assistente, poi si autorizza il sito nella pagina di accesso di GajaCms.

GajaCms registra automaticamente l'assistente come client OAuth: non servono Client ID né Client Secret. La procedura seguente riguarda Claude; per altri assistenti che supportano i server MCP remoti con autenticazione OAuth i passaggi sono analoghi.

1. Nella pagina di accesso di GajaCms accedere con le credenziali del pannello.

2. La pagina Autorizza connessione MCP mostra i Permessi richiesti e, in Sito da autorizzare, il sito corrispondente all'indirizzo usato. Il sito non si può cambiare: per un altro sito serve il suo indirizzo.

3. Confermare con Autorizza il sito.

4. Alla conferma Sito autorizzato il collegamento si completa nell'assistente e la connessione compare in Connessioni autorizzate nella scheda MCP del sito.

Se la pagina riporta che il sito di questo indirizzo non è disponibile, l'account non ha accesso al progetto del sito, oppure il canale MCP non è attivo o non è incluso nel piano.

Una volta collegato, l'assistente riceve richieste in linguaggio naturale e usa gli strumenti di GajaCms per leggere il sito e preparare le proposte.

Ogni richiesta che modifica il sito produce una proposta. La proposta si esamina in Proposte AI, dove si confronta il valore attuale con quello proposto e si approva o si rifiuta. L'approvazione importa la proposta nella versione in lavorazione del contenuto; la pubblicazione resta un passaggio separato.

La qualità della proposta dipende dalla precisione della richiesta. Una richiesta efficace indica:

• Sito. Quando nella conversazione sono attivi più connettori, il sito su cui operare, con il nome del connettore.

• Tipo e destinazione. Pagina, articolo, evento, prodotto o listino; per un articolo anche categoria e autore.

• Contenuti di riferimento. Le pagine o gli articoli esistenti da riscrivere, citati con il loro titolo o indirizzo.

• Lingua. La lingua del contenuto, se il sito ne gestisce più di una.

• Pubblico, tono e lunghezza. A chi si rivolge il testo, con quale registro e in quante sezioni.

• Collegamenti. Le pagine del sito da collegare: l'assistente cerca i link interni tra i contenuti esistenti invece di scrivere indirizzi a mano.

• Un obiettivo per richiesta. Una proposta per volta si revisiona meglio di molte modifiche riunite insieme.

Prima di una proposta conviene chiedere all'assistente di consultare ciò che esiste già nel sito: categorie, autori, preset disponibili, pagine esistenti, link interni e immagini presenti negli archivi. In questo modo la proposta usa elementi reali invece di valori inventati.

1. Schema in chat. Per contenuti estesi, chiedere prima uno schema con titoli e punti principali e confermarlo nella conversazione.

2. Proposta. Dopo la conferma, chiedere di inviare la proposta.

3. Revisione. Esaminare la proposta in Proposte AI.

4. Correzione. Se la proposta non è corretta, rifiutarla indicando il motivo. L'assistente può leggere lo stato della proposta e la motivazione del rifiuto e preparare una nuova versione nella stessa conversazione.

• Connessioni autorizzate. Ogni connessione riporta lo stato (Attiva o Revocata) e l'ultimo utilizzo. Attività mostra le operazioni eseguite; Revoca chiude subito la connessione.

• Utilizzo di oggi. Livello MCP del piano, chiamate ai tool, proposte create e proposte in attesa di revisione, ciascuna con il proprio limite giornaliero. Lo storico degli ultimi 7 giorni si apre con Mostra gli ultimi 7 giorni.

• Disattivazione. Spegnendo Abilita canale MCP tutte le connessioni del sito smettono di funzionare.