Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi Printful con un clic, poi punta il tuo client AI (Claude, ChatGPT, Copilot o Cursor) all'endpoint MCP generato. Niente Docker, niente git clone, nessuna esperienza di sviluppo richiesta.
In breve
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.
Prova a chiedere
Prompt di esempio per Printful
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 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
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.
Setup
- Accedi a developers.printful.com con il tuo login Printful e apri Your tokens (developers.printful.com/tokens).
- 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 unostore_idpreso daprintful_list_stores(viene inviato come headerX-PF-Store-Id). - Scegli gli scope:
ordersper leggere e scrivere ordini (oppureorders/readper una configurazione in sola lettura) esync_products/readper i prodotti del negozio.printful_list_storesrichiede anche lo scope dei negozi (stores_list), dove il modulo lo propone. Catalogo, prezzi e tariffe di spedizione non richiedono scope. - Imposta una data di scadenza, crea il token e copialo subito: Printful lo mostra una volta sola. Incollalo da solo, senza
Bearerdavanti, inPRINTFUL_API_TOKEN, poi installa il connettore. - Comincia con
printful_get_token_scopesper vedere cosa può fare il token, poi conprintful_list_storesper 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.
Prerequisiti: PRINTFUL_API_TOKEN
Installazione locale del connettore
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
Apri http://localhost:3000/connectors/store, scegli Printful e inserisci le variabili elencate nei Prerequisiti.
Tool disponibili
| Tool | What it does |
|---|---|
printful_get_token_scopes | List the scopes of the configured private token (orders, sync_products, file_library, webhooks…), to check what the connector is allowed to… |
printful_list_stores | List the Printful stores the token can reach, with id, name and type (the platform the store is linked to) |
printful_list_categories | List the Printful catalog categories (men's clothing, wall art, mugs, hats…) with id, parent id, title and image |
printful_list_catalog_products | List the blank products in the Printful catalog (t-shirts, hoodies, posters, mugs…) with id, type, brand, model, title, image, variant… |
printful_get_catalog_product | Get one catalog product with its description, print file placements, techniques and options, and every variant (size, colour, price… |
printful_get_catalog_variant | Get one catalog variant (a size and colour of a product) with its price, stock status by region and its parent product |
printful_get_product_size_guide | Get the size guide of a catalog product: measurements per size for the product and how to measure, in inches or centimetres |
printful_get_product_prices | Get the production prices of a catalog product, including store discounts: price per placement and technique (front, back, sleeve… |
printful_calculate_shipping_rates | Get the shipping options for a set of catalog or store variants to an address, with rate id, name, price, currency and delivery-day range… |
printful_list_orders | List the orders of a store, optionally by status: draft, pending, inreview, failed, canceled, inprocess, onhold, partial, fulfilled or… |
printful_get_order | Get one order: status, shipping method, recipient, items with files, Printful costs (subtotal, shipping, tax, VAT, total), retail costs… |
printful_estimate_order_costs | Estimate what Printful would charge for an order without creating it: item and print costs (back prints, inside labels…), digitization… |
printful_create_draft_order | Create an order as a draft |
printful_confirm_order | Submit a draft order for fulfillment |
printful_list_store_products | List the products of a Manual order / API store (one created in the Printful dashboard rather than linked to a platform) with id, external… |
printful_get_store_product | Get one product of a Manual order / API store with its sync variants: catalog variant, retail price, currency, SKU, print files and options |
printful_list_sync_products | List the products of a store linked to an e-commerce platform (Shopify, WooCommerce, Etsy…), with their sync state toward Printful: how… |
printful_get_sync_product | Get one product of a platform-linked store with its sync variants: the platform variant, the Printful catalog variant it is synced to… |
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?"
Prossimi passi
Questa guida ti è stata utile?
