Как подключить Printful к Cursor через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Printful, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Printful + Cursor

Дайте ИИ работать с Printful: просматривать каталог печати по требованию, проверять цены производства и тарифы доставки, оценивать стоимость заказов, создавать черновики и отслеживать заказы до доставки, а также смотреть товары ваших магазинов, в том числе на Shopify, Etsy и WooCommerce. С приватным токеном Printful.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

PRINTFUL_API_TOKEN

Шаг 1 — Получите учётные данные

1. Войдите на developers.printful.com со своим логином Printful и откройте Your tokens (developers.printful.com/tokens).
2. Создайте приватный токен и выберите уровень доступа. Токен уровня Store открывает один магазин, который вы выбираете сейчас, и инструментам магазина не нужен store_id. Токен уровня Account открывает все магазины аккаунта; тогда ИИ передаёт инструментам магазина store_id из printful_list_stores (он отправляется в заголовке X-PF-Store-Id).
3. Выберите scopes: orders для чтения и записи заказов (или orders/read для режима только чтения) и sync_products/read для товаров магазина. Для printful_list_stores нужен ещё scope магазинов (stores_list), если форма его предлагает. Каталогу, ценам и тарифам доставки scope не нужен.
4. Укажите срок действия, создайте токен и сразу скопируйте его: Printful показывает его только один раз. Вставьте его в PRINTFUL_API_TOKEN как есть, без Bearer впереди, и установите коннектор.
5. Начните с 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 — Добавьте коннектор в Cursor

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Cursor читает MCP-серверы из ~/.cursor/mcp.json. Добавь эту запись:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти Cursor.
3. Открой Cursor → Settings → MCP и проверь, что anythingmcp есть в списке и подключён.
4. Начинай общаться: агент теперь может вызывать инструменты Printful.

Доступные инструменты

Примеры запросов

• «Сколько стоит производство чёрной футболки унисекс размера M с печатью спереди и какие есть варианты доставки в Мюнхен?»
• «Какие из моих заказов приостановлены или завершились ошибкой и какие ссылки для отслеживания у уже отправленных заказов?»
• «Создай черновик заказа для Anna Schmidt, Hauptstraße 5, 10115 Berlin: 2 штуки нашего Logo Hoodie размера L со стандартной доставкой, и покажи мне общую стоимость, прежде чем что-либо подтверждать.»
• «Какие товары в моём магазине Shopify ещё не синхронизированы с товаром Printful?»

FAQ

Поддерживает ли Cursor собственные MCP-серверы на бесплатном тарифе? Да, MCP доступен на тарифах Hobby, Pro и Business.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Gemini
• Подключить к Meta Muse