インストール不要。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 キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Printful + Cursor
AI に Printful で作業させます。プリントオンデマンドのカタログの閲覧、製造価格と送料の確認、注文にかかる費用の見積もり、注文の下書き作成と配達までの追跡、Shopify、Etsy、WooCommerce のストアを含む自分のストアの商品の参照ができます。Printful Developer Portal で作成するプライベートトークンを使います。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
PRINTFUL_API_TOKEN
ステップ 1 — 認証情報を取得
- Printful のアカウントで developers.printful.com にサインインし、Your tokens（developers.printful.com/tokens）を開きます。
- プライベートトークンを作成し、アクセスレベルを選びます。Store のトークンはここで選んだ 1 つのストアだけにアクセスでき、ストア向けのツールに
store_idは不要です。Account のトークンはアカウントのすべてのストアにアクセスでき、その場合 AI はストア向けのツールにprintful_list_storesで調べたstore_idを渡します（X-PF-Store-Idヘッダーとして送信されます）。 - スコープを選びます。注文の読み書きには
orders（読み取り専用にするならorders/read）、ストアの商品にはsync_products/readが必要です。printful_list_storesには、フォームに表示される場合はストアのスコープ（stores_list）も必要です。カタログ、価格、送料にはスコープは不要です。 - 有効期限を設定してトークンを作成し、すぐにコピーします。Printful が表示するのは一度だけです。トークンだけを、先頭に
Bearerを付けずにPRINTFUL_API_TOKENに貼り付け、コネクターをインストールします。 - まず
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 は下書きを作成します。下書きは製造に回されず、請求もされません。ダッシュボードの Orders で確認や編集ができます。その前に、printful_calculate_shipping_rates で配送方法を、printful_estimate_order_costs で総費用（商品、プリント、送料、税、VAT）を、何も作成せずに確認できます。注文の各アイテムは、Printful がダウンロードできるプリントファイルの URL を付けたカタログのバリエーションか、ストアですでに設定済みでファイルを持っている商品のバリエーションのどちらかです。注文に独自の external_id を付けておくと、どの注文ツールでも @ に続けてその ID を指定すれば見つかります（例: @SHOP-1001）。Shopify、Etsy、WooCommerce と連携したストアの注文は自動で Printful に届くため、AI が改めて作成することはありません。
インストール時はオフ: printful_confirm_order は下書きを製造に回します。Printful はストアの支払い方法に請求して製造を始め、その後は注文がまだ pending の間しかキャンセルできません。AI に注文を製造に回させたい場合だけオンにし、それ以外は下書きを自分でダッシュボードから確定してください。オンにした場合、AI は先に注文、アイテム、住所、合計金額を示し、あなたの承認を待ちます。
2 種類のストア商品: 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 でわかります。
権限と読み取り専用の設定: トークンが使えるのは付与したスコープだけで、Store レベルならそのストアだけです。読み取り専用にするには、orders の代わりに orders/read でトークンを作成し、コネクターのページで printful_create_draft_order を無効にして、printful_confirm_order はオフのままにします。
レート制限: Printful が受け付けるのはストアごとに 1 分あたり 120 リクエストまでです。上限を超えると Retry-After ヘッダー付きの 429 を返し、リクエストは処理されません。1 分待ってからやり直してください。
よくあるエラー: 401 はトークンが間違っている、期限切れ、または削除されていることを示します。Your tokens で新しいトークンを作成してください。403 はその呼び出しに必要なスコープがトークンにないか、Account レベルのトークンを store_id なしで使ったことを示します。400 は無効な項目を示します。たとえば state_code の不足（米国、カナダ、オーストラリアでは必須）、存在しないバリエーション、Printful がダウンロードできないファイル URL などです。404 は存在しない ID です。正しい ID は一覧ツールで取得できます。
このコネクターは、注文のキャンセル、編集、削除、ストア商品の作成や編集、ファイルライブラリへのアップロード、Webhook の管理は行いません。
ステップ 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 は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:
{
"mcpServers": {
"anythingmcp": {
"url": "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と置き換えます。 - ファイルを保存し、Cursor を再起動します。
- Cursor → Settings → MCP を開き、
anythingmcpが一覧にあり接続済みであることを確認します。 - チャットを始めましょう。エージェントが
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… |
プロンプトの例
- 「黒のユニセックス T シャツ、M サイズ、前面プリントの製造費はいくら？ミュンヘンへの配送方法も教えて。」
- 「保留中または失敗した注文はどれ？発送済みの注文の追跡リンクも教えて。」
- 「Anna Schmidt、Hauptstraße 5、10115 Berlin 宛ての注文の下書きを作成して。うちの Logo Hoodie の L サイズを 2 枚、標準配送で。何かを確定する前に合計金額を見せて。」
- 「Shopify ストアの商品のうち、まだ Printful の商品と同期していないものはどれ？」
FAQ
Cursor の無料プランでカスタム MCP サーバーは使えますか? はい。MCP は Hobby、Pro、Business の各プランで利用できます。
次のステップ
このガイドは役に立ちましたか?
