跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用，一键添加 Printful，然后将你的 AI 客户端（Claude、ChatGPT、Copilot 或 Cursor）指向生成的 MCP 端点。无需 Docker，无需 git clone，无需任何工程经验。
摘要
让你的 AI 处理 Printful：浏览按需印刷产品目录，查看生产价格和运费，估算订单费用，创建订单草稿并跟踪到送达，以及查看你的店铺商品，包括 Shopify、Etsy 和 WooCommerce 店铺。使用 Printful Developer Portal 中创建的私有令牌。
试试这样问
Printful 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Printful、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无
git clone、无本地服务器。
Printful
让你的 AI 处理 Printful：浏览按需印刷产品目录，查看生产价格和运费，估算订单费用，创建订单草稿并跟踪到送达，以及查看你的店铺商品，包括 Shopify、Etsy 和 WooCommerce 店铺。使用 Printful Developer Portal 中创建的私有令牌。
设置
- 用你的 Printful 账户登录 developers.printful.com，打开 Your tokens（developers.printful.com/tokens）。
- 创建一个私有令牌并选择访问级别。Store 级令牌只能访问一个店铺（现在就选定），店铺类工具不需要
store_id。Account 级令牌可以访问账户下的所有店铺，这时 AI 会把从printful_list_stores得到的store_id传给店铺类工具（通过X-PF-Store-Id请求头发送）。 - 选择 scope：
orders用于读写订单（只读设置请用orders/read），sync_products/read用于店铺商品。如果表单中提供店铺 scope（stores_list），printful_list_stores也需要它。产品目录、价格和运费不需要 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 能下载的印刷文件 URL 的目录变体，要么是你店铺中已设置好、自带文件的商品变体。给订单设置你自己的 external_id 后，任何订单工具都可以用 @ 加该 ID 找到它，例如 @SHOP-1001。来自已关联 Shopify、Etsy 或 WooCommerce 店铺的订单会自动进入 Printful，因此 AI 不会重复创建。
安装时默认关闭：printful_confirm_order，它会把草稿提交生产。之后 Printful 会从店铺的付款方式扣款并开始生产，订单只有在仍处于 pending 状态时才能取消。只有在需要 AI 把订单送去生产时才开启；否则请自己在后台确认草稿。开启后，AI 会先展示订单、商品、地址和总金额，等你确认后再执行。
两类店铺商品：对于 Manual order / API 店铺，AI 使用 printful_list_store_products 和 printful_get_store_product；对于关联了 Shopify、WooCommerce、Etsy 等平台的店铺，使用 printful_list_sync_products 和 printful_get_sync_product，可以看到哪些平台变体已同步到 Printful 商品。店铺属于哪一类，可以看 printful_list_stores 返回的 type。
权限和只读设置：令牌只能使用它的 scope，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 无法下载的文件 URL。404 表示 ID 不存在：请用列表类工具获取真实的 ID。
该连接器不会取消、修改或删除订单，不会创建或编辑店铺商品，不会向文件库上传文件，也不管理 webhook。
前提条件: 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 码、正面印花的 T 恤生产成本是多少？发往慕尼黑有哪些配送方式？”
- “我的哪些订单处于暂停或失败状态？已发货订单的跟踪链接是什么？”
- “为 Anna Schmidt（Hauptstraße 5, 10115 Berlin）创建一个订单草稿：2 件我们的 Logo Hoodie，L 码，标准配送。在确认任何东西之前先把总费用给我看。”
- “我的 Shopify 店铺中哪些商品还没有同步到 Printful 商品？”
下一步
这份指南对你有帮助吗?
