摘要
让你的 AI 处理 Printful：浏览按需印刷产品目录，查看生产价格和运费，估算订单费用，创建订单草稿并跟踪到送达，以及查看你的店铺商品，包括 Shopify、Etsy 和 WooCommerce 店铺。使用 Printful Developer Portal 中创建的私有令牌。
引导式设置
2 分钟将 Printful 连接到 Microsoft Copilot
开始 AnythingMCP Cloud 免费试用，在引导式设置中连接 Printful，再把你的 MCP URL 添加到 Microsoft Copilot。无需代码，也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Printful 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Printful、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无
git clone、无本地服务器。
Printful + Microsoft Copilot
让你的 AI 处理 Printful：浏览按需印刷产品目录，查看生产价格和运费，估算订单费用，创建订单草稿并跟踪到送达，以及查看你的店铺商品，包括 Shopify、Etsy 和 WooCommerce 店铺。使用 Printful Developer Portal 中创建的私有令牌。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
PRINTFUL_API_TOKEN
步骤 1 — 获取凭证
- 用你的 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。
步骤 2 — 安装 adapter
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 通过在 Copilot Studio 中构建的智能体使用 MCP 服务器：把 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，粘贴 AnythingMCP 的 MCP API 密钥（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 中输入 @ 并选择该智能体。
希望每个用户各自登录？请选择 OAuth 2.0 → Dynamic discovery 代替 API 密钥：每个用户会在智能体首次调用时登录 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 码、正面印花的 T 恤生产成本是多少？发往慕尼黑有哪些配送方式？”
- “我的哪些订单处于暂停或失败状态？已发货订单的跟踪链接是什么？”
- “为 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，密钥是否属于与 URL 相同的 MCP 服务器，并把 Server description 写得具体：Copilot Studio 根据它决定何时调用服务器。每次修改后重新发布智能体；在已打开的对话中输入 "start over" 即可使用新版本。
下一步
这份指南对你有帮助吗?