关于 Lightspeed Retail (X-Series) MCP by usefulapi
面向零售门店的托管 MCP 服务,可通过 MCP 客户端访问 Lightspeed Retail (X-Series) 的商品、库存、销售和客户数据。它还支持按期间汇总销售,以及更新客户、价格和库存。
主要功能
- 01查询商品、门店库存和销售
- 02查看客户、供应商及库存订单
- 03一次调用生成期间销售汇总
- 04创建或更新客户
- 05修改商品价格和库存
适用场景
- 01检查不同门店的库存水平
- 02按时间段查看销售汇总
- 03查找销售记录或客户资料
- 04调整商品价格或库存
MCP 相关
该托管 MCP 服务向 MCP 客户端提供 Lightspeed Retail (X-Series) 的查询与写入工具。通过 OAuth 授权连接门店账户;写入操作需由客户端确认。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://lightspeed-x-series.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-lightspeed-x-series https://lightspeed-x-series.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-lightspeed-x-series":{"type":"http","url":"https://lightspeed-x-series.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-lightspeed-x-series":{"type":"http","url":"https://lightspeed-x-series.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-lightspeed-x-series":{"type":"http","url":"https://lightspeed-x-series.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-lightspeed-x-series":{"serverUrl":"https://lightspeed-x-series.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
usefulapi 提供的 Lightspeed Retail(X-Series)MCP
通过 Claude、Cursor 或任何 MCP 客户端使用你的 Lightspeed Retail(X-Series)门店(原 Vend)——查询商品、各门店的库存、销售、客户、供应商、库存订单、收银机和员工;一次调用即可获取某个时段的销售报告;创建和更新客户、设置价格和库存水平。托管服务,无需本地安装:通过 OAuth 连接你的 Lightspeed Retail 账户。
在线端点: https://lightspeed-x-series.usefulapi.io/mcp · 主页: https://usefulapi.io/lightspeed-x-series
连接
- Claude(claude.ai、桌面版):打开 自定义 → 连接器,点击 + 添加 → 添加自定义连接器,然后粘贴
https://lightspeed-x-series.usefulapi.io/mcp。 - Claude Code:
claude mcp add --transport http lightspeed-x-series https://lightspeed-x-series.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code: 添加到 VS Code。
- Cursor 和其他客户端: 将该 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"lightspeed-x-series": {
"url": "https://lightspeed-x-series.usefulapi.io/mcp"
}
}
}
只添加 URL。请勿在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,你只需使用 Lightspeed Retail(X-Series)账户登录。
分步设置指南、凭据查找位置和常见问题解答:https://usefulapi.io/lightspeed-x-series/
首次连接时,系统会将你重定向到 Lightspeed 登录并批准访问你的门店;无需粘贴 API 密钥。 你可以随时在 Lightspeed Retail 后台撤销访问权限。一个订阅适用于一个门店账户。
工具
| 工具 | 类型 | 功能 |
|---|---|---|
lightspeedxseries_get_retailer | read | 获取零售商 |
lightspeedxseries_list_outlets | read | 列出门店 |
lightspeedxseries_get_outlet | read | 获取门店 |
lightspeedxseries_list_registers | read | 列出收银机 |
lightspeedxseries_get_register_payments_summary | read | 获取收银机付款摘要 |
lightspeedxseries_list_taxes | read | 列出税费 |
lightspeedxseries_list_users | read | 列出用户 |
lightspeedxseries_get_user_sale_totals | read | 获取用户销售总额 |
lightspeedxseries_list_products | read | 列出商品 |
lightspeedxseries_get_product | read | 获取商品 |
lightspeedxseries_search_products | read | 搜索商品 |
lightspeedxseries_get_inventory_levels | read | 获取库存水平 |
lightspeedxseries_list_brands | read | 列出品牌 |
lightspeedxseries_list_tags | read | 列出标签 |
lightspeedxseries_list_suppliers | read | 列出供应商 |
lightspeedxseries_list_consignments | read | 列出库存订单(寄售单) |
lightspeedxseries_get_consignment | read | 获取寄售单 |
lightspeedxseries_list_consignment_products | read | 列出寄售商品 |
lightspeedxseries_list_sales | read | 列出销售记录(变更馈送) |
lightspeedxseries_get_sale | read | 获取销售记录 |
lightspeedxseries_search_sales | read | 搜索销售记录 |
lightspeedxseries_sales_summary | read | 销售摘要(某一时段的总额) |
lightspeedxseries_list_customers | read | 列出客户 |
lightspeedxseries_search_customers | read | 搜索客户 |
lightspeedxseries_get_customer | read | 获取客户 |
lightspeedxseries_list_customer_groups | read | 列出客户群组 |
lightspeedxseries_create_customer | write | 创建客户 |
lightspeedxseries_update_customer | write | 更新客户 |
lightspeedxseries_update_product_prices | write | 更新商品价格 |
lightspeedxseries_set_product_stock | write | 设置商品库存和补货水平 |
lightspeedxseries_usage_status | meta | 使用情况状态(免费套餐用量计量) |
lightspeedxseries_request_feature | meta | 申请缺少的功能 |
lightspeedxseries_upgrade | meta | 升级到 Pro(无限使用) |
lightspeedxseries_cancel_subscription | meta | 取消 Pro 订阅 |
read 工具为只读;write 工具会修改数据(客户端应先确认);meta 工具用于报告用量、管理订阅或提交功能请求。
定价
| 套餐 | 价格 | 限制 |
|---|---|---|
| Free | $0 | 每月 50 次工具调用 |
| Pro(每个门店账户) | $9/mo 或 $90/yr(免费 2 个月) | 无限使用 |
Pro 仅适用于此服务。使用 lightspeedxseries_upgrade 订阅(该工具会返回 Stripe Checkout 链接)。可随时使用 lightspeedxseries_cancel_subscription 取消:Pro 会持续到已付费周期结束,当前周期不予退款;在此之前运行 lightspeedxseries_upgrade 可撤销取消操作。也可以发送邮件至 [email protected]。
许可证
MIT — 参见 LICENSE。此仓库仅包含文档;服务托管于外部。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。