po-pilot-mcp

PO Pilot MCP (po-pilot-mcp)

Solo Pro Kit + 3 个 n8n 工作流（$49）→   |   Agency / 3PL 10 店套件（$249）→   |   托管云服务（$0 / $29/月）→   |   Glama（评级 A）→

为 Shopify 商家和美国批发商提供 Stocky 停用后的补货计算、开放采购预算（Open-to-Buy）和含美国关税的到岸成本采购订单、Shopify POS 条码调拨 CSV、Stocky CSV 供应商数据恢复，以及应付账款三方发票匹配（支持 QuickBooks Online 和 Xero 账单 CSV 导出）。

Shopify 已于 2026 年 8 月 31 日停用 Stocky。Shopify 原生管理后台会存储库存数量和草稿采购订单记录，却缺少商家赖以运作的采购逻辑：计算补货点、按箱规取整、供应商最低订购量门槛、供应商数据导出，以及发票差异检查。同时，Shopify 官方 Storefront 和 UCP MCP 端点（catalog、cart、checkout、policies）仅服务于前台购物者。

po-pilot-mcp 可将 Claude Desktop、Claude Code、Cursor 或 n8n 连接到四种确定性的后台采购工具。在 demo_mode 或 CSV 模式下，每种工具均可本地运行或通过 Streamable HTTP 运行，无需任何凭据；如果提供只读商店凭据，也可以选择连接实时 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（一条命令）

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

选项 C：实时 Shopify 商店模式（可选，只读 Admin 令牌）

在 Shopify Admin -> Settings -> Apps and sales channels -> Develop apps 中创建自定义应用，并授予三个只读权限范围：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：财务运营三方匹配审计 + 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	应付账款三方匹配：比对采购订单、仓库收货记录和供应商发票，并导出会计 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$ 值为 $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 集成仅通过 POST 查询执行读取操作（productVariants 和 orders），并强制设置严格的 15 秒 AbortSignal 超时。
• 崩溃防护错误封装：CSV 标头无效、缺少参数或网络超时时，系统会返回结构化 MCP isError: true 响应及补救步骤，而不会终止 stdio 进程。
• 无已知依赖项安全公告：经 npm audit 验证无问题。

---

定价与权益

• 本地免费沙盒（npx -y [email protected]）：$0 — 无限次 Stocky CSV 供应商恢复（migrate_stocky_csv_snapshot）、完整的 demo_mode，并且每次调用最多支持 25 个 SKU / 15 个唯一发票 SKU，可使用 CSV 或 JSON。
• 自托管终身许可证 + 3 个 n8n 自动化工作流（Solo $49 → | Agency $249 →）：
  • 早鸟发布价 — 一次性支付 $49（前 25 位买家）：Solo Store Unlimited — 1 个 Shopify 店铺、无限 SKU 和发票行、实时 Shopify Admin GraphQL、Open-to-Buy 现金流优化器，以及通过 PO_PILOT_LICENSE_KEY 使用全部 3 个可直接导入的 n8n 工作流（#01、#02、#03）。
  • 常规 Solo Store：一次性支付 $99（前 25 个发布许可证售出后）。
  • 3PL / Fractional CFO / Agency 许可证 — 一次性支付 $249：最多可用于 10 个客户 Shopify 店铺，并享有多仓库及 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。