Come collegare Printful a ChatGPT via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Printful, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Printful + ChatGPT

Fai lavorare la tua AI con Printful: sfoglia il catalogo print-on-demand, controlla prezzi di produzione e tariffe di spedizione, stima i costi degli ordini, crea bozze di ordine e seguile fino alla consegna e consulta i prodotti dei tuoi negozi, anche su Shopify, Etsy e WooCommerce. Con un token privato Printful.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

PRINTFUL_API_TOKEN

Step 1 — Ottieni le credenziali

1. Accedi a developers.printful.com con il tuo login Printful e apri Your tokens (developers.printful.com/tokens).
2. Crea un token privato e scegli il livello di accesso. Un token Store raggiunge un solo negozio, che scegli adesso, e gli strumenti del negozio non hanno bisogno di store_id. Un token Account raggiunge tutti i negozi dell'account; in quel caso l'AI passa agli strumenti del negozio uno store_id preso da printful_list_stores (viene inviato come header X-PF-Store-Id).
3. Scegli gli scope: orders per leggere e scrivere ordini (oppure orders/read per una configurazione in sola lettura) e sync_products/read per i prodotti del negozio. printful_list_stores richiede anche lo scope dei negozi (stores_list), dove il modulo lo propone. Catalogo, prezzi e tariffe di spedizione non richiedono scope.
4. Imposta una data di scadenza, crea il token e copialo subito: Printful lo mostra una volta sola. Incollalo da solo, senza Bearer davanti, in PRINTFUL_API_TOKEN, poi installa il connettore.
5. Comincia con printful_get_token_scopes per vedere cosa può fare il token, poi con printful_list_stores per i tuoi negozi e i loro id.

Scadenza del token: un token privato funziona fino alla data di scadenza che hai scelto e non si può rinnovare. Creane uno nuovo prima di quella data e incollalo in PRINTFUL_API_TOKEN. Non c'è nessun passaggio Authorize with Provider.

Serve un negozio: tariffe di spedizione, stime dei costi e ordini appartengono sempre a un negozio. Un account senza negozi risponde This endpoint requires store_id, quindi creane prima uno nella dashboard di Printful (Stores → Add store → Manual order platform / API).

Le bozze sono gratis, la conferma costa: printful_create_draft_order crea una bozza, che Printful non manda in produzione e non addebita. Puoi controllarla e modificarla nella dashboard, sotto Orders. Prima ancora, printful_calculate_shipping_rates elenca le opzioni di spedizione e printful_estimate_order_costs mostra il costo completo (articoli, stampe, spedizione, imposte, IVA) senza creare nulla. Ogni articolo è una variante del catalogo con gli URL dei file di stampa che Printful riesce a scaricare, oppure la variante di un prodotto già configurato nel tuo negozio, che porta con sé i propri file. Se dai a un ordine un tuo external_id, ogni strumento sugli ordini lo trova come @ seguito da quell'id, per esempio @SHOP-1001. Gli ordini di un negozio collegato a Shopify, Etsy o WooCommerce arrivano su Printful da soli, quindi l'AI non li crea di nuovo.

Disattivati all'installazione: printful_confirm_order, che invia una bozza alla produzione. Printful addebita allora il metodo di pagamento del negozio e avvia la produzione, e l'ordine si può annullare solo finché è ancora in stato pending. Attivalo solo se l'AI deve mandare ordini in produzione; altrimenti conferma tu le bozze nella dashboard. Se è attivo, l'AI ti mostra prima ordine, articoli, indirizzo e totale e aspetta il tuo sì.

Due tipi di prodotti del negozio: per i negozi Manual order / API l'AI usa printful_list_store_products e printful_get_store_product; per i negozi collegati a Shopify, WooCommerce, Etsy e altre piattaforme usa printful_list_sync_products e printful_get_sync_product, che mostrano quali varianti della piattaforma sono sincronizzate con un prodotto Printful. Il campo type restituito da printful_list_stores dice di che tipo è un negozio.

Permessi e sola lettura: il token raggiunge solo i suoi scope e, a livello Store, solo il suo negozio. Per una configurazione in sola lettura crea il token con orders/read al posto di orders, disattiva printful_create_draft_order nella pagina del connettore e lascia spento printful_confirm_order.

Limiti di richieste: Printful consente 120 richieste al minuto per negozio. Oltre il limite risponde 429 con un header Retry-After e non elabora la richiesta: aspetta un minuto e riprova.

Errori comuni: 401 significa che il token è sbagliato, scaduto o eliminato: creane uno nuovo sotto Your tokens. 403 significa che al token manca lo scope per quella chiamata, oppure che un token Account è stato usato senza store_id. 400 indica il campo non valido, per esempio un state_code mancante (obbligatorio per Stati Uniti, Canada e Australia), una variante sconosciuta o l'URL di un file che Printful non riesce a scaricare. 404 indica un id sconosciuto: gli id reali li forniscono gli strumenti di elenco.

Il connettore non annulla, modifica né elimina ordini, non crea né modifica prodotti del negozio, non carica file nella libreria file e non gestisce webhook.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in ChatGPT

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

ChatGPT si collega ai server MCP come app personalizzate in modalità sviluppatore (Developer mode), disponibile nei piani a pagamento, non in quello gratuito. Nei workspace Business ed Enterprise potrebbe doverla abilitare prima un amministratore.

1. In ChatGPT apri Settings → Security and login e attiva Developer mode.
2. Vai su chatgpt.com/plugins e clicca +.
3. Inserisci un nome e una breve descrizione, ad esempio Name: Printful.
4. In Connection inserisci l'URL del server MCP https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID e crea la connessione.
5. Quando ChatGPT lo chiede, accedi ad AnythingMCP (OAuth) e consenti l'accesso.

Tool disponibili

Esempi di prompt

• "Quanto costa produrre una t-shirt unisex nera taglia M con stampa frontale, e quali sono le opzioni di spedizione verso Milano?"
• "Quali dei miei ordini sono in attesa o non riusciti, e quali sono i link di tracciamento degli ordini già spediti?"
• "Crea una bozza di ordine per Anna Rossi, Via Roma 5, 20121 Milano: 2 pezzi del nostro Logo Hoodie in taglia L con spedizione standard, e mostrami il costo totale prima che venga confermato qualsiasi cosa."
• "Quali prodotti del mio negozio Shopify non sono ancora sincronizzati con un prodotto Printful?"

FAQ

Il piano free di ChatGPT funziona con i connettori MCP personalizzati? No. Le connessioni MCP personalizzate richiedono la modalità sviluppatore, disponibile solo nei piani a pagamento.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse