Puoi collegare un assistente IA come Claude, Claude Code o ChatGPT al tuo spazio di lavoro Composerie. Mentre chatti, l’assistente può così consultare i tuoi prodotti e ordini, creare design, completare bozze di prodotti e seguire gli ordini che richiedono attenzione. Questa guida spiega come collegare ciascuno, cosa può fare l’assistente e cosa no, e come scollegarlo.
Il collegamento passa dal server MCP di Composerie. MCP (Model Context Protocol) è uno standard aperto che gli assistenti IA usano per lavorare con altre app. Aggiungi un indirizzo web al tuo assistente, accedi a Composerie e scegli uno spazio di lavoro. Non devi copiare nessuna chiave API, ID client o secret: Composerie riconosce Claude e ChatGPT da solo.
Non è la stessa cosa che collegare un fornitore di IA, che aggiunge effetti alle immagini dei tuoi prodotti. Qui un assistente lavora nel tuo spazio di lavoro per conto tuo.
Prima di iniziare
L’indirizzo del server è:
https://app.composerie.com/api/mcpComposerie lo mostra anche come URL del server MCP nell’elenco Collegamenti alle app IA, con un pulsante Copia URL. L’ultima sezione di questa guida spiega dove trovare quell’elenco.
I collegamenti alle app IA vengono attivati per singolo spazio di lavoro. Se uno spazio di lavoro non compare quando colleghi l’assistente, o se la schermata dice che non hai uno spazio di lavoro disponibile da collegare, contatta il supporto.
Collegare Claude
Funziona in Claude sul web e nell’app desktop di Claude.
Aggiungi un connettore personalizzato
In Claude, apri le impostazioni dei connettori e scegli di aggiungere un connettore personalizzato. Chiamalo Composerie e incolla l’indirizzo del server. Se Claude propone campi per un ID client o un secret OAuth, lasciali vuoti.
Collega e accedi a Composerie
Scegli di collegare. Claude apre Composerie nel browser. Accedi se richiesto, poi approva il collegamento come descritto nella sezione qui sotto.
Chiedi a Claude qualcosa sul tuo spazio di lavoro
Di nuovo in Claude, chiedi per esempio “Trova i miei prodotti tazza” o “Mostrami gli ultimi ordini”. Claude interroga Composerie e risponde con i tuoi dati.
Collegare Claude Code
Esegui questo comando nel terminale:
claude mcp add --transport http composerie https://app.composerie.com/api/mcpCosì aggiungi Composerie alla cartella del progetto in cui ti trovi. Per usarlo in tutti i progetti, aggiungi --scope user dopo add.
Poi avvia Claude Code, digita /mcp, scegli composerie e scegli di autenticarti. Il browser apre Composerie. Approva il collegamento come descritto nella sezione qui sotto e il browser ti riporta a Claude Code.
Collegare ChatGPT
ChatGPT ti permette di aggiungere una tua app solo con i piani che consentono le app personalizzate, e può chiederti di attivare prima la modalità sviluppatore nelle impostazioni. I nomi esatti dei menu di ChatGPT possono cambiare, quindi cerca il punto in cui gestisci app o connettori.
Crea un’app personalizzata
Nelle impostazioni di ChatGPT, crea una nuova app o un nuovo connettore.
Chiamalo Composerie e incolla l’indirizzo del server. Se ChatGPT chiede come
accedere, scegli OAuth. Poi apri le impostazioni OAuth avanzate e aggiungi
offline_access agli scope di base. Senza, ChatGPT si disconnette dopo 15
minuti.
Conferma l’avviso
ChatGPT ti avvisa dei rischi di un’app personalizzata e ti chiede di confermare. Verifica che l’indirizzo sia esattamente quello indicato sopra, poi conferma.
Accedi a Composerie
ChatGPT apre Composerie. Accedi e approva il collegamento come descritto nella sezione qui sotto. Poi aggiungi Composerie a una chat e fai la tua domanda.
Approvare il collegamento in Composerie
Ogni assistente arriva alla stessa schermata di Composerie: Collega un’app IA.
Accedi di nuovo se richiesto
Un collegamento resta attivo anche dopo la fine della sessione del browser, quindi Composerie chiede un accesso recente prima che tu ne approvi uno. Se l’ultimo accesso risale a un po’ di tempo fa, scegli prima Accedi per continuare.
Controlla chi lo chiede
La schermata indica l’app che chiede l’accesso e dove torni dopo averlo consentito. Per Claude Code è il tuo computer (localhost). Se non hai avviato tu questo collegamento, scegli Rifiuta.
Scegli uno spazio di lavoro
In Spazio di lavoro, scegli lo spazio in cui l’assistente può lavorare. L’elenco mostra ogni spazio di lavoro di cui fai parte e in cui i collegamenti alle app IA sono attivi. Il collegamento resta associato a quello spazio, anche se più avanti cambi spazio di lavoro in Composerie.
Controlla i permessi e consenti l’accesso
Permessi elenca cosa può fare l’app in quello spazio, per esempio leggere i prodotti o modificare bozze di design. Se il tuo ruolo consente meno di quanto chiede l’app, l’elenco mostra solo ciò che il tuo ruolo consente, con l’avviso “Il tuo ruolo in questo workspace consente meno permessi, quindi l’app riceve solo questi.” Poi scegli Consenti accesso.
Cosa consente il tuo ruolo
L’assistente lavora come te, quindi il tuo ruolo nello spazio di lavoro continua a valere. Composerie dà all’app solo i permessi che il tuo ruolo può concedere. Nei ruoli del team trovi cosa può fare ciascun ruolo.
- Con il ruolo Proprietario o Amministratore, un assistente può fare tutto ciò che descrive questa guida.
- Con il ruolo Editor, può leggere e lavorare su prodotti, design e immagini, ma non intervenire sugli ordini.
- Con il ruolo Fulfillment, può leggere, aggiungere note agli ordini e ritentare i render non riusciti, ma non modificare prodotti o design.
- Con il ruolo Visualizzatore, può solo leggere, senza modificare nulla.
Composerie ricontrolla il tuo ruolo a ogni azione, quindi un ruolo inferiore limita subito l’assistente. Un ruolo superiore non amplia un collegamento già esistente: scollega l’assistente e ricollegalo per dare all’app i nuovi permessi. Se lasci uno spazio di lavoro, il collegamento a quello spazio smette di funzionare.
Cosa può fare l’assistente
Quali di queste cose offre il tuo assistente dipende dai permessi che hai approvato.
Leggere il tuo spazio di lavoro
- Trovare prodotti, design, modelli e file nella tua libreria media.
- Leggere i riepiloghi degli ordini con lo stato di pagamento ed evasione, e vedere perché un ordine richiede attenzione. I recapiti e gli indirizzi dei clienti non vengono condivisi.
- Vedere le voci di Richiede attenzione nella Home, ognuna con un link alla soluzione.
- Leggere statistiche, notifiche, mockup, impostazioni del customizer e lo stato delle tue integrazioni.
Creare design
- Creare il design di un prodotto, vuoto o a partire da un modello, oppure duplicare un design.
- Partire da una ricetta di design per il tipo di prodotto, come un poster, un biglietto, una tazza o una maglietta: dove vanno le parti principali, una scala di dimensioni del testo, abbinamenti di font e palette di colori con contrasto sufficiente.
- Modificare un design con testo, forme, linee, icone, foto e spazi foto vuoti.
- Aggiungere questi smart element: Mappa stellare, Fase lunare, Calendario, Mappa di viaggio, Codice QR, Codice a barre e Avatar, più una raccolta di clipart.
- Definire lo stile dei livelli con font, colori, sfumature, ombre, effetti di testo, ritagli delle foto e filtri.
- Rendere parti di un design modificabili dai tuoi clienti con i campi di personalizzazione.
- Vedere l’anteprima di una modifica prima di salvarla, anche con testo del cliente corto, lungo e vuoto, per controllare che tutto ci stia ancora.
- Controllare il layout per trovare testo troppo piccolo, elementi quasi ma non del tutto allineati, spaziature irregolari, un layout sbilanciato e testo nascosto sotto una foto o appoggiato sopra. Il testo viene misurato con i font usati per la stampa.
- Importare un’immagine da un indirizzo web nella tua libreria media. Funziona solo con immagini su siti accettati da Composerie. Gli altri indirizzi vengono rifiutati.
Completare i prodotti
- Creare una bozza di prodotto e cambiarne nome, descrizione e campi SEO.
- Leggere le aree di stampa e le varianti di un prodotto del catalogo.
- Impostare i prezzi di vendita, i prezzi di confronto e quali varianti sono disponibili.
- Rinominare le opzioni, scegliere come vengono mostrate nel tuo negozio e impostare la modalità di visualizzazione.
- Aggiungere, modificare e rimuovere componenti aggiuntivi, come la confezione regalo.
- Avviare i render dei mockup, scegliere la foto principale e la foto di ogni variante, e ordinare la galleria dei mockup.
- Controllare cosa blocca ancora la pubblicazione, con gli stessi controlli che Composerie esegue quando pubblichi. Non viene pubblicato nulla.
- Cambiare l’aspetto del customizer e le regole di caricamento delle foto. Possono farlo solo Proprietari e Amministratori, e i tuoi clienti vedono la modifica appena viene salvata.
Seguire gli ordini
- Aggiungere una nota interna a un ordine. Il tuo team la vede nella pagina dell’ordine, il cliente mai.
- Ritentare i render di stampa non riusciti di un ordine, come faresti dalla pagina dell’ordine. L’ordine prosegue poi nel suo normale flusso di produzione. Vedi risolvere un errore di rendering o di evasione del fornitore.
L’invio di un ordine al fornitore di stampa, la spedizione e i rimborsi restano nella dashboard. Li gestisce una persona, non l’assistente.
Modificare immagini (a pagamento)
L’assistente può rimuovere lo sfondo di un’immagine della tua libreria media o aumentarne la risoluzione. Ogni modifica passa dal tuo fornitore di IA, che la addebita sul tuo account, e conta nel limite mensile di quel fornitore. Vedi quanto costa la generazione IA. L’assistente deve chiederti il permesso prima di ogni modifica. Il risultato viene salvato come nuova immagine e l’originale resta com’era.
Le modifiche a prodotti e design vengono salvate come bozze. L’assistente non pubblica mai da solo: mettere un prodotto nel tuo negozio richiede sempre la tua conferma in Composerie. Leggi cosa fa davvero la pubblicazione prima di pubblicare una bozza preparata da un assistente.
Limiti
- Ogni spazio di lavoro consente fino a 60 azioni dell’assistente al minuto, condivise tra tutti gli assistenti collegati. Ogni ricerca o modifica conta come un’azione. Quando il limite viene raggiunto, l’assistente deve aspettare un momento prima di riprovare.
- Un assistente non può aggiungere una Mappa della città, un Percorso sportivo o un Profilo altimetrico. Aggiungili nel Design Studio.
- Costi dei prodotti, tasse, inventario, regole di visibilità dei componenti aggiuntivi e CSS personalizzato del customizer restano nella dashboard.
- Ogni collegamento funziona in un solo spazio di lavoro. Per lavorare in un altro, scollega l’assistente, ricollegalo e scegli l’altro spazio di lavoro.
Gestire o scollegare un assistente
L’elenco Collegamenti alle app IA mostra ogni assistente che hai collegato, con il suo spazio di lavoro e i suoi permessi.
- Proprietari e amministratori lo trovano in Impostazioni, poi Sicurezza. Quando apri Composerie dentro Shopify, la pagina Sicurezza non mostra questo elenco.
- Chiunque abbia effettuato l’accesso a Composerie può aprire lo stesso elenco all’indirizzo
app.composerie.com/mcp/connections. La schermata di consenso lo collega con Gestisci i miei collegamenti IA.
Per scollegare, scegli Scollega accanto al collegamento. L’assistente perde subito l’accesso. Il tuo assistente potrebbe ancora mostrare Composerie nelle sue impostazioni: rimuovilo anche lì se non vuoi più usarlo.
L’elenco mostra solo i collegamenti che hai creato tu. Ogni membro del team gestisce i propri.
Prossimo passo
Se qualcosa non funziona come descritto qui, contatta il supporto. Per decidere chi nel tuo team può lasciare che un assistente apporti modifiche, leggi gestire il team e i ruoli.