Пропустите установку. Заработает меньше чем за 2 минуты.
Начните бесплатный период на cloud.anythingmcp.com, добавьте Printful одним кликом и направьте свой ИИ-клиент (Claude, ChatGPT, Copilot или Cursor) на сгенерированный MCP-эндпоинт. Без Docker, без git clone, без опыта разработки.
Кратко
Дайте ИИ работать с Printful: просматривать каталог печати по требованию, проверять цены производства и тарифы доставки, оценивать стоимость заказов, создавать черновики и отслеживать заказы до доставки, а также смотреть товары ваших магазинов, в том числе на Shopify, Etsy и WooCommerce. С приватным токеном Printful.
Попробуй спросить
Примеры промптов для Printful
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Printful, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без
git clone, без локального сервера.
Printful
Дайте ИИ работать с Printful: просматривать каталог печати по требованию, проверять цены производства и тарифы доставки, оценивать стоимость заказов, создавать черновики и отслеживать заказы до доставки, а также смотреть товары ваших магазинов, в том числе на Shopify, Etsy и WooCommerce. С приватным токеном Printful.
Настройка
- Войдите на developers.printful.com со своим логином Printful и откройте Your tokens (developers.printful.com/tokens).
- Создайте приватный токен и выберите уровень доступа. Токен уровня Store открывает один магазин, который вы выбираете сейчас, и инструментам магазина не нужен
store_id. Токен уровня Account открывает все магазины аккаунта; тогда ИИ передаёт инструментам магазинаstore_idизprintful_list_stores(он отправляется в заголовкеX-PF-Store-Id). - Выберите scopes:
ordersдля чтения и записи заказов (илиorders/readдля режима только чтения) иsync_products/readдля товаров магазина. Дляprintful_list_storesнужен ещё scope магазинов (stores_list), если форма его предлагает. Каталогу, ценам и тарифам доставки scope не нужен. - Укажите срок действия, создайте токен и сразу скопируйте его: Printful показывает его только один раз. Вставьте его в
PRINTFUL_API_TOKENкак есть, безBearerвпереди, и установите коннектор. - Начните с
printful_get_token_scopes, чтобы увидеть, что может токен, а затем вызовитеprintful_list_stores, чтобы получить список магазинов и их id.
Срок действия токена: приватный токен работает до выбранной вами даты и не продлевается. Создайте новый до этой даты и вставьте его в PRINTFUL_API_TOKEN. Шага Authorize with Provider нет.
Нужен магазин: тарифы доставки, оценки стоимости и заказы всегда относятся к магазину. Аккаунт без магазина отвечает This endpoint requires store_id, поэтому сначала создайте магазин в панели Printful (Stores → Add store → Manual order platform / API).
Черновики бесплатны, платить приходится за подтверждение: printful_create_draft_order создаёт черновик, который Printful не отправляет в производство и не оплачивает со счёта. Его можно проверить и изменить в панели в разделе Orders. До этого printful_calculate_shipping_rates показывает варианты доставки, а printful_estimate_order_costs полную стоимость (товары, печать, доставка, налоги, НДС), ничего не создавая. Позиция заказа это либо вариант из каталога со ссылками на файлы для печати, которые Printful может скачать, либо вариант товара, уже настроенного в вашем магазине, со своими файлами. Если дать заказу свой external_id, любой инструмент заказов найдёт его как @ плюс этот id, например @SHOP-1001. Заказы из магазина, связанного с Shopify, Etsy или WooCommerce, сами приходят в Printful, поэтому ИИ не создаёт их повторно.
Выключено при установке: printful_confirm_order, который передаёт черновик в производство. После этого Printful списывает деньги со способа оплаты магазина и запускает производство, а отменить заказ можно только пока он в статусе pending. Включайте его, только если ИИ должен отправлять заказы в производство; иначе подтверждайте черновики сами в панели. Если он включён, ИИ сначала показывает заказ, позиции, адрес и итоговую сумму и ждёт вашего «да».
Два вида товаров магазина: для магазинов Manual order / API ИИ использует printful_list_store_products и printful_get_store_product; для магазинов, связанных с Shopify, WooCommerce, Etsy и другими платформами, printful_list_sync_products и printful_get_sync_product, которые показывают, какие варианты платформы синхронизированы с товаром Printful. Вид магазина виден по полю type в ответе printful_list_stores.
Права и режим только чтения: токен получает доступ только к своим scopes, а на уровне Store только к своему магазину. Для режима только чтения создайте токен с orders/read вместо orders, отключите printful_create_draft_order на странице коннектора и оставьте printful_confirm_order выключенным.
Лимиты запросов: Printful разрешает 120 запросов в минуту на магазин. При превышении он отвечает 429 с заголовком Retry-After и не обрабатывает запрос: подождите минуту и попробуйте снова.
Частые ошибки: 401 значит, что токен неверный, просрочен или удалён: создайте новый в Your tokens. 403 значит, что у токена нет scope для этого вызова или токен уровня Account использован без store_id. 400 указывает на неверное поле, например отсутствующий state_code (обязателен для США, Канады и Австралии), неизвестный вариант или ссылку на файл, который Printful не может скачать. 404 значит неизвестный id: настоящие id возвращают инструменты-списки.
Коннектор не отменяет, не меняет и не удаляет заказы, не создаёт и не редактирует товары магазина, не загружает файлы в библиотеку файлов и не управляет вебхуками.
Предварительные требования: PRINTFUL_API_TOKEN
Локальная установка коннектора
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
Откройте http://localhost:3000/connectors/store, выберите Printful и введите переменные, перечисленные в Предварительных требованиях.
Доступные инструменты
| 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… |
Примеры запросов
- «Сколько стоит производство чёрной футболки унисекс размера M с печатью спереди и какие есть варианты доставки в Мюнхен?»
- «Какие из моих заказов приостановлены или завершились ошибкой и какие ссылки для отслеживания у уже отправленных заказов?»
- «Создай черновик заказа для Anna Schmidt, Hauptstraße 5, 10115 Berlin: 2 штуки нашего Logo Hoodie размера L со стандартной доставкой, и покажи мне общую стоимость, прежде чем что-либо подтверждать.»
- «Какие товары в моём магазине Shopify ещё не синхронизированы с товаром Printful?»
Следующие шаги
Это руководство помогло?
