跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用,一键添加 Printify,然后将你的 AI 客户端(Claude、ChatGPT、Copilot 或 Cursor)指向生成的 MCP 端点。无需 Docker,无需 git clone,无需任何工程经验。
摘要
Printify 按需印刷:店铺、商品、包含印刷服务商、变体和配送的底版(blueprint)目录、图片库、订单和 Webhook。通过个人访问令牌使用 Printify REST API v1。
试试这样问
Printify 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Printify、粘贴凭证、生成 MCP API key — 完成。无 Docker、无
git clone、无本地服务器。
Printify + Gemini
Printify 按需印刷:店铺、商品、包含印刷服务商、变体和配送的底版(blueprint)目录、图片库、订单和 Webhook。通过个人访问令牌使用 Printify REST API v1。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
PRINTIFY_API_TOKEN
步骤 1 — 获取凭证
该连接器通过个人访问令牌(personal access token)使用 Printify REST API v1。一个令牌即可覆盖 Printify 账户中的所有店铺。
- 在 Printify 中打开 My Profile → Connections,在 Personal Access Tokens 下点击 Generate。
- 选择访问范围(scopes)。使用全部工具需要:
shops.read、catalog.read、print_providers.read、products.read、products.write、orders.read、orders.write、uploads.read、uploads.write、webhooks.read。只读配置只需勾选*.read范围。 - 将令牌复制到
PRINTIFY_API_TOKEN。Printify 只显示一次令牌,有效期为一年,到期后请重新生成。 - 先调用
printify_list_shops。每个店铺都有一个数字id(即所有商品、订单和 Webhook 工具使用的shop_id)和一个sales_channel(etsy、shopify、custom_integration或disconnected)。
配合 Etsy 店铺使用
先在 Printify 中连接 Etsy 店铺:打开店铺菜单,选择 Manage my stores → Connect → Etsy,登录 Etsy 并授权访问。Printify 帮助中心还要求在 Etsy 的 Shop Manager → Settings → Production partners 中把 Printify 添加为生产合作伙伴。之后该店铺会以 sales_channel etsy 出现在 printify_list_shops 中。
- 商品以 Printify 为准。在 Printify 中创建或修改商品(
printify_create_product、printify_update_product),再用printify_publish_product把标题、描述、图片、变体、标签和运费模板推送到 Etsy 商品页。之后不要直接在 Etsy 中编辑商品页,否则两边会不一致:请在 Printify 中修改商品后重新发布。 - Printify 商品的 Etsy 订单会自动导入,并出现在
printify_list_orders中,无需再用printify_create_order创建。订单是自动进入生产还是等待处理,取决于 Printify 中的订单审批设置。 - 可与同一 AnythingMCP 服务器上的 Etsy 连接器 搭配使用:Etsy 负责商品页统计、评价和买家消息,Printify 负责生产成本、配送和履约状态。
限制与费用:每个账户每分钟 600 次请求,目录接口每分钟 100 次,发布操作每 30 分钟 200 次。价格和成本均为以分为单位的整数(2499 = 24.99)。printify_send_order_to_production 会从 Printify 余额或银行卡扣款;printify_cancel_order 仅在订单状态为 on-hold 或 payment-not-received 时可用。
步骤 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 — 在 Gemini 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Gemini CLI 从 ~/.gemini/settings.json(Windows 上为 %USERPROFILE%\.gemini\settings.json)读取 MCP 服务器。添加:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥,并用它替换
YOUR_MCP_API_KEY。 - 保存文件并重启
gemini。 - 在 Gemini CLI 中运行
/mcp(或在终端运行gemini mcp list)—anythingmcp应显示为已连接。 - 开始输入提示 — Gemini CLI 现在可以调用
Printify的工具。
可用工具
| Tool | What it does |
|---|---|
printify_list_shops | List the shops in the Printify account with their id, title and sales channel (etsy, shopify, custom_integration, disconnected) |
printify_list_blueprints | List every blueprint in the Printify catalog: the base products (t-shirts, mugs, posters...) with id, title, brand, model and images |
printify_get_blueprint | Get one catalog blueprint by id: title, description, brand, model and product images |
printify_list_blueprint_print_providers | List the print providers that can produce a blueprint, with their id, name and decoration methods (dtg, embroidery...) |
printify_list_variants | List the variants (size, colour) of a blueprint at one print provider, with variant ids and the print area placeholders and their dimensions |
printify_get_shipping | Get the shipping profiles of a blueprint at one print provider: handling time and first-item and additional-item costs in cents per variant… |
printify_list_print_providers | List all Printify print providers with their id, title and location |
printify_get_print_provider | Get one print provider by id: name, location and the blueprints it produces |
printify_list_products | List the products of a shop, newest first, with title, variants and prices, images, print areas, visibility and the sales channel listing… |
printify_get_product | Get one product of a shop with all details: variants with price, cost and SKU, print areas and images, mockups, tags, publishing state and… |
printify_create_product | Create a product in a shop from a blueprint and print provider: title, description, variants with prices in cents and print areas placing… |
printify_update_product | Update a product: title, description, tags, variant prices and enabled flags, or print areas |
printify_delete_product | Delete a product from a Printify shop |
printify_publish_product | Publish a product to the shop's sales channel (for example the Etsy listing) |
printify_list_uploads | List the images in the account's media library with id, file name, size, dimensions and preview URL |
printify_get_upload | Get one uploaded image by id: file name, dimensions, size, MIME type, preview URL and upload time |
printify_upload_image | Upload an image to the media library from a public URL (preferred) or base64 contents |
printify_list_orders | List the orders of a shop, newest first, with status, line items and costs, shipping address, shipments and tracking |
printify_get_order | Get one order with status, line items with production cost and shipping cost in cents, the address, shipments with carrier and tracking… |
printify_calculate_shipping | Calculate the shipping cost of a would-be order for an address without creating it |
printify_create_order | Create an order in a shop for existing products (product_id + variant_id), SKUs, or catalog items with print areas |
printify_send_order_to_production | Send an on-hold order to production |
printify_cancel_order | Cancel an order |
printify_list_webhooks | List the webhooks installed on a shop with id, topic (order:created, product:publish:started...) and target URL |
FAQ
Gemini CLI 从哪里读取 MCP 服务器? 用户级配置位于 ~/.gemini/settings.json,项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。
下一步
这份指南对你有帮助吗?