Кратко
Дайте ИИ работать с Printful: просматривать каталог печати по требованию, проверять цены производства и тарифы доставки, оценивать стоимость заказов, создавать черновики и отслеживать заказы до доставки, а также смотреть товары ваших магазинов, в том числе на Shopify, Etsy и WooCommerce. С приватным токеном Printful.
Пошаговая настройка
Подключи Printful к Microsoft Copilot за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи Printful в пошаговой настройке и добавь свой MCP URL в Microsoft Copilot. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для Printful
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Printful, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без
git clone, без локального сервера.
Printful + Microsoft Copilot
Дайте ИИ работать с Printful: просматривать каталог печати по требованию, проверять цены производства и тарифы доставки, оценивать стоимость заказов, создавать черновики и отслеживать заказы до доставки, а также смотреть товары ваших магазинов, в том числе на Shopify, Etsy и WooCommerce. С приватным токеном Printful.
Предварительные требования
Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:
PRINTFUL_API_TOKEN
Шаг 1 — Получите учётные данные
- Войдите на 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 возвращают инструменты-списки.
Коннектор не отменяет, не меняет и не удаляет заказы, не создаёт и не редактирует товары магазина, не загружает файлы в библиотеку файлов и не управляет вебхуками.
Шаг 2 — Установите адаптер
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
Шаг 3 — Добавьте коннектор в Microsoft Copilot
URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (
https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указаноYOUR_SERVER_ID.
Microsoft Copilot использует MCP-серверы через агентов, созданных в Copilot Studio: ты добавляешь AnythingMCP в агента как инструмент, а затем публикуешь агента в Microsoft 365 Copilot и Teams. Copilot Studio подключается из облака Microsoft по Streamable HTTP, который AnythingMCP поддерживает.
- В Copilot Studio открой своего агента (или создай нового), перейди в Tools и выбери Add a tool → New tool → Model Context Protocol.
- Укажи Server name (например,
AnythingMCP), Server description, которое объясняет, что делает коннектор, и Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. По описанию Copilot Studio решает, когда вызывать сервер. - В аутентификации выбери API key, установи Type в Header, укажи имя заголовка
X-API-Keyи нажми Create. - В окне Add tool выбери Create a new connection, вставь MCP API-ключ из AnythingMCP (MCP Servers → твой сервер → API keys) и нажми Add to agent.
- Проверь в панели Test агента: попроси о том, для чего нужны инструменты
Printful. - Нажми Publish, затем Channels → Microsoft 365 and Microsoft Teams, оставь включённым Make agent available in Microsoft Copilot и нажми Add channel. See agent in Teams установит агента для тебя; в Microsoft 365 Copilot введи @ и выбери агента.
Хочешь, чтобы каждый входил под своей учётной записью? Вместо API-ключа выбери OAuth 2.0 → Dynamic discovery: каждый пользователь войдёт в AnythingMCP при первом вызове агентом.
Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Copilot Studio подключается из облака Microsoft, поэтому localhost не подойдёт.
Доступные инструменты
| 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… |
printful_get_printfiles | Get the print areas of a catalog product: per placement (front, back, sleeve...) the printfile size in pixels, DPI and fill mode, and which… |
printful_get_webhooks | Show the webhook set up for the store: the URL that receives Printful's notifications and the enabled event types (package_shipped… |
Примеры запросов
- «Сколько стоит производство чёрной футболки унисекс размера M с печатью спереди и какие есть варианты доставки в Мюнхен?»
- «Какие из моих заказов приостановлены или завершились ошибкой и какие ссылки для отслеживания у уже отправленных заказов?»
- «Создай черновик заказа для Anna Schmidt, Hauptstraße 5, 10115 Berlin: 2 штуки нашего Logo Hoodie размера L со стандартной доставкой, и покажи мне общую стоимость, прежде чем что-либо подтверждать.»
- «Какие товары в моём магазине Shopify ещё не синхронизированы с товаром Printful?»
FAQ
Для какого Copilot это руководство? Для Microsoft 365 Copilot на работе — через агентов Copilot Studio. В приложении Microsoft Copilot для личных аккаунтов добавить свой MCP-сервер нельзя.
Что нужно? Рабочий аккаунт с доступом к Copilot Studio (лицензия или пробная версия), чтобы создать агента. Тем, кто будет пользоваться им в Microsoft 365 Copilot или Teams, нужен доступ к агенту: поделись им или попроси администратора опубликовать его для организации. Если в организации действуют политики данных для коннекторов Power Platform, они распространяются и на MCP-серверы.
Агент не вызывает инструменты. Проверь, что имя заголовка — ровно X-API-Key, а ключ относится к тому же MCP-серверу, что и URL, и сделай Server description конкретным: по нему Copilot Studio решает, когда вызывать сервер. После каждого изменения опубликуй агента заново; в открытом чате введи «start over», чтобы перейти на новую версию.
Следующие шаги
- Страница коннектора
- Подключить к Claude
- Подключить к ChatGPT
- Подключить к Cursor
- Подключить к Gemini
- Подключить к Meta Muse
Это руководство помогло?