Freshly Inventory MCP by usefulapi

usefulapi 提供的 Freshly Inventory MCP

通过 Claude、Cursor 或任何 MCP 客户端使用你的 Freshly 账户。读取和管理库存批次及其订单行分配；只有启用同步后才会更改 Shopify 库存。托管服务，无需本地安装：使用你自己的凭据连接。

在线端点： https://freshly-inventory.usefulapi.io/mcp · 主页： https://usefulapi.io

连接

• Claude（claude.ai、桌面版）：打开 自定义 → 连接器，点击 + 添加 → 添加自定义连接器，然后粘贴 https://freshly-inventory.usefulapi.io/mcp。
• Claude Code： claude mcp add --transport http freshly-inventory https://freshly-inventory.usefulapi.io/mcp，然后运行 /mcp 登录。
• VS Code： 添加到 VS Code。
• Cursor 和其他客户端： 将 URL 添加为远程 MCP 服务：

{
  "mcpServers": {
    "freshly-inventory": {
      "url": "https://freshly-inventory.usefulapi.io/mcp"
    }
  }
}

只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥：服务会通过 OAuth 为你登录，登录页面会要求你提供 Freshly Inventory 凭据。

分步设置说明、凭据查找方式和常见问题解答：https://usefulapi.io/freshly-inventory/

首次连接时，你需要提供 Freshly API 密钥（在 Freshly 的 Preferences → API keys 中；Freshly 只会显示一次）。服务会验证密钥，并按用户存储。无需将密钥写入配置文件。

工具

工具	类型	功能
freshly_get_shop	读取	获取 Freshly 商店信息
freshly_list_inventory_batches	读取	列出库存批次
freshly_get_inventory_batch	读取	获取库存批次
freshly_list_batch_assignments	读取	列出订单行对应的批次分配
freshly_create_inventory_batch	写入	创建库存批次
freshly_update_inventory_batch	写入	更新库存批次
freshly_assign_batch_to_line_item	写入	将批次分配给订单行
freshly_remove_batch_assignment	写入	移除订单行的批次分配
freshly_usage_status	元信息	使用情况（免费套餐用量计数）
freshly_request_feature	元信息	请求添加缺失的功能
freshly_upgrade	元信息	升级到 Pro（无限*）
freshly_cancel_subscription	元信息	取消 Pro 订阅

read 工具为只读；write 工具会修改数据（客户端应先征求确认）；meta 工具用于报告使用情况、管理订阅或发送功能请求。

定价

套餐	价格	限额
免费	$0	每月 50 次工具调用
Pro（每位用户）	$9/mo 或 $90/yr（免费 2 个月）	无限*

*Pro 在此服务上的公平使用限额为每月 10,000 次工具调用。如需更多，请发送邮件至 [email protected]。

Pro 仅适用于此服务。使用 freshly_upgrade 订阅（该工具会返回 Stripe Checkout 链接）。你可以随时使用 freshly_cancel_subscription 取消：Pro 权限会持续到付费周期结束，当前周期不退款；在此之前运行 freshly_upgrade 可撤销取消操作。也可以发送邮件至 [email protected]。

许可证

MIT — 参见 LICENSE。仅提供文档；服务由托管方提供。