po-pilot-mcp

PO Pilot MCP（po-pilot-mcp）

Solo Pro Kit＋n8nワークフロー3種（$49）→   |   代理店／3PL向け10ストアスイート（$249）→   |   ホスト型クラウド（$0／月額$29）→   |   Glama（Grade A）→

Shopifyのマーチャントと米国の卸売業者向けに、Stocky終了後の補充計算、Open-to-Buy、米国関税を含む着地原価の発注書、Shopify POSバーコード付き移動CSV、Stocky CSVからの仕入先データ復旧、および買掛金の3点請求書照合（QuickBooks OnlineとXeroの請求書CSVエクスポート付き）を提供します。

ShopifyはStockyを2026年8月31日に終了しました。Shopify Adminは在庫数と下書きの発注書レコードを保存しますが、マーチャントが頼りにしていた購買ロジック、つまり再発注点の計算、カートン／ケース単位への切り上げ、仕入先の最低注文数のしきい値、仕入先向けエクスポート、請求書の差異チェックは備えていません。一方、Shopify公式のStorefrontおよびUCP MCPエンドポイント（catalog、cart、checkout、policies）は、フロントオフィスの買い物客のみを対象としています。

po-pilot-mcpは、Claude Desktop、Claude Code、Cursor、またはn8nを、決定論的なバックオフィス購買ツール4種に接続します。各ツールはローカル、またはStreamable HTTP経由で動作し、demo_modeまたはCSVモードでは認証情報が不要です。読み取り専用のストア認証情報を指定すると、オプションでライブの**Shopify Admin GraphQL（2026-04）**にも接続できます。

---

60秒以内でセットアップ

オプションA：キー不要のクイックスタート（Claude Desktop／Cursor）

claude_desktop_config.jsonまたは.cursor/mcp.jsonに次のブロックを追加します（デプロイを再現可能にするため、バージョンを正確に固定することを推奨します）。

{
  "mcpServers": {
    "po-pilot": {
      "command": "npx",
      "args": ["-y", "[email protected]"]
    }
  }
}

オプションB：Claude Code CLI（コマンド1つ）

claude mcp add po-pilot -- npx -y [email protected]

オプションC：ライブShopifyストアモード（オプションの読み取り専用Adminトークン）

Shopify Admin -> Settings -> Apps and sales channels -> Develop appsでカスタムアプリを作成し、読み取り専用スコープを3つ設定します：read_products、read_inventory、read_orders。

{
  "mcpServers": {
    "po-pilot": {
      "command": "npx",
      "args": ["-y", "[email protected]"],
      "env": {
        "PO_PILOT_LICENSE_KEY": "your_polar_or_pop1_license_key",
        "SHOPIFY_STORE_DOMAIN": "your-store.myshopify.com",
        "SHOPIFY_ACCESS_TOKEN": "shpat_your_read_only_token"
      }
    }
  }
}

オプションD：リモートStreamable HTTP（n8n／クラウドゲートウェイ／MCPize）

npx -y [email protected] --http
# Listening on http://0.0.0.0:8080/mcp (Health check: GET /health)

---

コピーしてすぐ試せるプロンプト3つ

プロンプト1：月曜朝の仕入先向け発注書作成＋着地原価＋POSバーコードCSV（APIキー不要）

Use po-pilot to run `build_supplier_purchase_orders` with `demo_mode: true`, `service_level: "95%"`, and `max_cash_budget_usd: 3800`. Show me:
1. Which SKUs are at CRITICAL stockout risk after adjusting for past stockout days,
2. True landed unit costs after US import tariffs + freight (and any margin-erosion warnings) plus how Open-to-Buy rationed cartons under my $3,800 cash cap,
3. Both the Shopify Admin Draft PO CSV (`SKU,Supplier SKU,Quantity,Cost,Tax %`) and the Shopify POS Inventory Transfer CSV (`SKU,Barcode,Quantity`), and
4. The ready-to-send PO emails for each vendor.

プロンプト2：Stocky CSVからエクスポートできない仕入先データを復旧

Shopify Stocky never exported our supplier directory before shutting down. Run `migrate_stocky_csv_snapshot` with `demo_mode: true` (or use the Stocky Purchase Orders CSV I paste below) to reconstruct each vendor's real observed lead time in days, inferred carton pack sizes, latest unit costs, and a ready `supplier_rules` JSON configuration.

プロンプト3：財務業務の3点照合監査＋検証済みQuickBooks／Xero請求書CSV

Run `reconcile_po_three_way_match` with `demo_mode: true`. Cross-check our original Purchase Order against warehouse dock receiving counts and the supplier's billed invoice. List every unit-price overcharge, short-shipment billed in full, unapproved surcharge, and freight cap overage, then give me the verified USD amount to pay ($2,386.20), the ready-to-import QuickBooks Online & Xero Bill CSVs (excluding unapproved fees), and the Debit Memo email to send their AR team.

---

ツールリファレンス（4 つのワークフローツール）

ツール名	目的	入力	主な出力	アノテーション
calculate_replenishment_plan	粗利益率を加味した ABC 分類、欠品を考慮した日次販売速度、Z スコアによる安全在庫、再発注点を算出します	skus[]、inventory_csv、use_live_shopify、demo_mode、service_level、review_period_days	SKU ごとの abc_class、inventory_position、safety_stock_units、reorder_point_units、recommended_order_units、stockout_risk	readOnlyHint: true、idempotentHint: true
build_supplier_purchase_orders	SKU を仕入先ごとにまとめ、カートン単位に切り上げ、仕入先の最低発注数量を適用し、米国の関税と運賃込みの着地原価を算出し、Open-to-Buy（max_cash_budget_usd）の現金上限を適用して、Shopify の PO と POS Transfer の CSV を出力します	上記と同じ ＋ supplier_rules[]、po_prefix、max_cash_budget_usd、default_import_duty_pct、min_gross_margin_pct	仕入先ごとの shopify_draft_po_csv、shopify_transfer_import_csv、total_landed_cost_usd、otb_summary、vendor_email_markdown	readOnlyHint: true、idempotentHint: true
reconcile_po_three_way_match	PO、倉庫での入荷、仕入先請求書を照合する買掛金の 3 点照合を行い、会計用 CSV をエクスポートします	po_number、vendor、invoice_number、invoice_date、due_date、po_lines[]、receiving_lines[]、invoice_lines[]、agreed_freight_cap_usd、demo_mode	payment_recommendation、verified_payable_amount_usd、total_overcharge_recovered_usd、quickbooks_bill_csv、xero_bill_csv、debit_memo_email_markdown	readOnlyHint: true、idempotentHint: true
migrate_stocky_csv_snapshot	Stocky の PO CSV エクスポートから仕入先プロファイル、実際のリードタイム平均・標準偏差、カートン単位を再構築します	stocky_po_csv、demo_mode	profiles[]、ready_supplier_rules_json[]、suppliers_recovered、skus_recovered	readOnlyHint: true、idempotentHint: true

---

内部で使用する決定論的な計算

1. 在庫ポジション（輸送中の在庫がある間の二重発注を防止します）： $$\text{IP} = \text{OnHand} + \text{OnOrder} - \text{Committed} - \text{Backorders}$$
2. 欠品を考慮した日次販売速度（月の一部で人気商品が欠品していた場合に、販売速度が実際より低く算出されるのを防止します）： $$d = \frac{\text{UnitsSold}}{\max(1,; \text{WindowDays} - \text{StockoutDays})}$$
3. 需要とリードタイムの変動を考慮した安全在庫： $$\text{SS} = \left\lceil Z \cdot \sqrt{\text{LT} \cdot \sigma_d^2 + d^2 \cdot \sigma_{\text{LT}}^2} \right\rceil$$ ここで、$85%、90%、95%、97.5%、99%$ のサイクルサービスレベルに対して、$Z \in {1.04, 1.28, 1.65, 1.96, 2.33}$ です。
4. 定期見直しの発注数量とカートン単位への切り上げ： $$\text{ROP} = \lceil d \cdot \text{LT} + \text{SS} \rceil, \quad S = \lceil d \cdot (\text{LT} + R) + \text{SS} \rceil$$ $\text{IP} \le \text{ROP}$ の場合、必要発注数量の基準値 $Q_0 = \max(\text{SKU-MOQ}, S - \text{IP})$ をカートン単位に切り上げます（$\lceil Q_0 / \text{CasePack} \rceil \times \text{CasePack}$）。仕入先への PO が min_order_value_usd（たとえば、卸売の最低注文額 2,200 ドルや送料無料の適用基準額）に満たない場合、エンジンは販売速度が最も高い A クラスの SKU にカートン単位で追加し、販売速度の低い C クラスの商品で数量を水増ししません。

---

セキュリティ、プライバシー、信頼性の保証

• 認証情報を一切保持しません：SHOPIFY_ACCESS_TOKEN 経由で渡されたトークンは、リクエストの処理中のみメモリに保持され、ログへの記録、ディスクへの書き込み、エラーペイロードへの出力は一切行われません。
• ストアへの読み取り専用アクセス：Shopify のライブ GraphQL 統合は、読み取り操作（productVariants と orders）のみを対象とする POST クエリを発行し、厳格な 15 秒の AbortSignal タイムアウトを適用します。
• クラッシュを防止するエラー応答：CSV ヘッダーの不正、パラメーターの不足、ネットワークタイムアウトが発生した場合、stdio プロセスを終了させることなく、対処手順を含む構造化された MCP isError: true 応答を返します。
• 既知の依存関係に関する勧告はありません：npm audit で問題がないことを確認済みです。

料金と利用権

• ローカル無料サンドボックス（npx -y [email protected]）：$0 — Stocky CSV の仕入先データ復元（migrate_stocky_csv_snapshot）は無制限で、demo_mode の全機能を利用でき、CSV または JSON 経由で 1回あたり最大25 SKU／一意の請求書 SKU 15件を処理できます。
• セルフホスト可能な永久ライセンス＋n8n 自動化ワークフロー3件（Solo $49 → | Agency $249 →）：
  • 早期購入者向けローンチ — $49 の買い切り（先着25名）：Solo Store Unlimited — Shopify ストア1件、SKU数と請求書明細数は無制限、Shopify Admin GraphQL のライブ接続、発注可能額に基づくキャッシュフロー最適化機能、および PO_PILOT_LICENSE_KEY を使ったすぐにインポートできるn8nワークフロー3件（#01、#02、#03）。
  • 通常のSolo Store：一括払いで$99（ローンチライセンスの先着25件販売後）。
  • 3PL／非常勤CFO／Agencyライセンス — 一括払いで$249：最大顧客のShopifyストア10件で利用可能。複数倉庫への対応、およびQuickBooks／Xeroの買掛金ワークフローの導入権を含みます。
• MCPize マネージドクラウド（MCPize で購読 →）：
  • 無料サンドボックス（$0/月） — 月15リクエスト（設定不要ですぐに評価できます）。
  • Cloud Pro（$29/月） — 月500リクエスト（SKU数無制限、Shopifyとのライブ同期、着地原価／OTB、QBO／Xeroの請求書CSV）。
  • Cloud Agency／3PL（$79/月） — 月3,000リクエスト（複数ブランドの運営事業者、3PL、n8nによる買掛金監視の自動化向け）。

メンテナー向け公開・デプロイコマンド

# 1. Verify build, automated test suite, and zero security advisories
npm test && npm audit

# 2. Publish to npm
npm login
npm publish --access public

# 3. Deploy & activate Free/Pro tiers on MCPize
npx mcpize login
npx mcpize deploy

3分間の製品デモ用スクリプトはdocs/LOOM-SCRIPT.mdを、このビルドの背景にある市場調査についてはdocs/RESEARCH-REPORT.mdをご覧ください。

ライセンス

MITライセンス — LICENSEをご覧ください。