Server MCP e API per il print on demand: guida pratica con Hoplix, Claude e ChatGPT

Cos’è un server MCP per il print on demand?

In questa guida vediamo cos’è MCP, cosa puoi fare con il server Hoplix, come collegarlo a Claude e ChatGPT in due minuti e, per chi sviluppa, come fare le prime chiamate alle API di print on demand.

Cos’è il Model Context Protocol (MCP)

Il Model Context Protocol è uno standard aperto che permette agli assistenti AI di usare strumenti esterni in modo sicuro e controllato. Un server MCP mette a disposizione una serie di strumenti (per esempio “elenca i prodotti” o “crea un ordine”): l’assistente decide quando usarli, ti mostra cosa sta facendo e ti chiede conferma prima di modificare qualcosa.

Claude, ChatGPT, Cursor, VS Code e molte altre app supportano MCP. Colleghi il server una volta, accedi con il tuo account e da quel momento chiedi in italiano, invece di passare da una schermata all’altra.

Perché un server MCP è utile nel print on demand

Gestire un negozio di print on demand significa saltare tra catalogo, editor dei design, listini, tabelle di spedizione e pagina degli ordini. Molte di queste attività sono domande: su quali felpe posso stampare? quanto costa spedire in Germania? dov’è l’ordine 1042? Con un server MCP ognuna diventa una frase.

Cosa puoi fare con il server MCP di Hoplix

L’integrazione MCP di Hoplix dà all’assistente 14 strumenti, divisi in cinque aree:

Ecco una conversazione reale in Claude: con una sola domanda arrivano le felpe stampabili con costi base, taglie e colori.

Tutorial: collegare Hoplix a Claude

Ti servono un account seller Hoplix (gratuito) e un piano di Claude che supporta i connettori.

1. Apri la scheda Hoplix Print on Demand nella directory dei connettori di Claude e collegala. In alternativa vai in Impostazioni → Connettori → Aggiungi connettore personalizzato e incolla https://api.hoplix.com/mcp.
2. Accedi con il tuo account Hoplix e premi Consenti. L’accesso usa OAuth e puoi revocarlo quando vuoi.
3. Apri una nuova chat e fai la prima domanda, per esempio “Su quali t-shirt posso stampare con Hoplix?”

Chi sviluppa può aggiungerlo a Claude Code con un solo comando:

claude mcp add --transport http hoplix https://api.hoplix.com/mcp

Tutorial: collegare Hoplix a ChatGPT

Hoplix Print on Demand è un plugin pubblicato nella directory ufficiale di ChatGPT, quindi non serve la modalità sviluppatore.

1. Apri la scheda Hoplix Print on Demand nella directory dei plugin di ChatGPT e premi Installa plugin.
2. Accedi con il tuo account Hoplix e premi Consenti.
3. In chat chiedi, per esempio, “Mostrami le mie campagne Hoplix”.

Cursor, VS Code, Windsurf e gli altri client MCP funzionano allo stesso modo: aggiungi un server HTTP con lo stesso indirizzo e al primo utilizzo si apre la pagina di accesso di Hoplix.

Esempi di richieste da provare

• “Quali felpe con cappuccio posso stampare e quanto costano stampate fronte e retro?”
• “Crea una campagna privata con il mio logo su una t-shirt unisex nera a 24 €.”
• “Quanto costa spedire 3 t-shirt della campagna 00612345 in Germania con corriere express?”
• “Crea un ordine di prova di 2 pezzi in taglia L con consegna a Milano.”
• “A che punto è l’ordine con riferimento SHOP-1042? Dammi il link di tracking.”
• “Annulla l’ordine 12345678 se non è ancora in produzione.”

Ecco un preventivo seguito da un ordine di prova: l’assistente sceglie la campagna, calcola prodotti e spedizione, poi crea un ordine controllato e prezzato ma mai prodotto.

Server MCP ufficiali e non ufficiali

Cercando “Printify MCP” o “Printful MCP” trovi soprattutto progetti della community su GitHub. Possono essere utili, ma funzionano in modo diverso da un server ufficiale:

In ogni caso controlla chi gestisce il server e quali permessi chiede prima di collegarlo a un negozio con clienti veri.

Sicurezza: i pagamenti restano nelle tue mani

• Nessun addebito dalla chat. Gli ordini nascono da pagare e vanno in produzione solo dopo che li paghi dalla pagina Ordini del tuo account Hoplix.
• Prima la conferma: l’assistente chiede prima di creare campagne o ordini.
• Ordini di prova: non vengono mai prodotti, quindi puoi provare ogni passaggio senza rischi.
• Accesso revocabile: scolleghi l’assistente quando vuoi da Account → Integrazioni → Integrazione MCP.

Tutti i dettagli sono nell’informativa privacy dell’integrazione MCP.

Tutorial API print on demand: per chi sviluppa

Se vuoi che gli ordini arrivino a Hoplix in automatico dal tuo software (un gestionale, un e-commerce fatto su misura, un’app), usa le API di print on demand di Hoplix. Sono le stesse funzioni del server MCP, ma le chiami tu dal codice.

1. Genera le chiavi

Nel tuo account Hoplix apri Impostazioni → Api Key e premi Genera API Key: ottieni una chiave (api) e una chiave segreta (secret). Tienile riservate, come una password.

2. Fai la prima chiamata

Tutte le chiamate sono POST su https://api.hoplix.com/v1/, con un corpo JSON che contiene le due chiavi. Per esempio, l’elenco dei prodotti:

curl -X POST https://api.hoplix.com/v1/product-list \
  -H "Content-Type: application/json" \
  -d '{"api": "LA_TUA_API_KEY", "secret": "LA_TUA_SECRET_KEY"}'

3. Prova un ordine senza produrlo

Aggiungi "test": true alla richiesta di un ordine: Hoplix lo controlla e lo prezza come uno vero, ma non lo crea, non lo addebita e non lo spedisce. Gli ID degli ordini di prova iniziano con TEST- e restano disponibili per 30 giorni.

4. Gli endpoint principali

La documentazione completa ha esempi per ogni endpoint e la specifica OpenAPI; se preferisci non scrivere codice puoi anche importare gli ordini da un file CSV o XLS.

MCP, API o integrazioni: cosa ti serve?

Funzionano insieme: molti seller ricevono gli ordini da un’integrazione con il negozio e usano il server MCP per preventivi, controlli e assistenza clienti.

Domande frequenti

Il server MCP di Hoplix è gratuito?

Sì. Il collegamento è gratuito, come l’account seller Hoplix: paghi solo il costo base del prodotto e la spedizione quando ordini.

Che differenza c’è tra server MCP e API?

Con il server MCP parli con un assistente AI, che usa gli strumenti di Hoplix al posto tuo dopo averti chiesto conferma. Con le API scrivi tu il codice che fa le chiamate. Le funzioni sono le stesse.

Devo saper programmare?

Per il server MCP no: in Claude e ChatGPT lo aggiungi dalla directory e accedi. Solo Claude Code ed editor come Cursor usano un comando o un breve file di configurazione. Per le API invece serve un po’ di codice.

L’AI può fare ordini veri?

Può creare ordini veri dopo averti chiesto conferma, ma restano da pagare: nulla viene prodotto o spedito finché non li paghi dal tuo account Hoplix. Per provare, chiedi un ordine di prova.

Quali assistenti AI sono supportati?

Tutti i client che supportano i server MCP remoti con OAuth: Claude (web, desktop, mobile e Claude Code), ChatGPT, Cursor, VS Code e Windsurf.

Funziona con il mio negozio Shopify o WooCommerce?

Sì. Il server MCP lavora sul tuo account Hoplix, quindi vede gli stessi prodotti, campagne e ordini che arrivano dai negozi collegati.