Loyverse MCP by usefulapi

usefulapi 的 Loyverse MCP

通过 Claude、Cursor 或任何 MCP 客户端使用 Loyverse——查看收据、班次、商品、库存和客户，并更新客户、类别、供应商和库存水平。 托管服务，无需本地安装：使用你自己的 Loyverse 凭据连接。

在线端点： https://loyverse.usefulapi.io/mcp · 主页： https://usefulapi.io/loyverse

连接

• Claude（claude.ai、桌面版）：打开 Customize → Connectors，点击 + Add → Add custom connector，然后粘贴 https://loyverse.usefulapi.io/mcp。
• Claude Code： claude mcp add --transport http loyverse https://loyverse.usefulapi.io/mcp，然后运行 /mcp 登录。
• VS Code： 添加到 VS Code。
• Cursor 和其他客户端： 将此 URL 添加为远程 MCP 服务：

{
  "mcpServers": {
    "loyverse": {
      "url": "https://loyverse.usefulapi.io/mcp"
    }
  }
}

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

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

首次连接时，你需要提供 Loyverse 个人访问令牌（Back Office > Integrations > Access tokens）。 令牌会经过验证，按用户分别存储，并仅限你本人使用——配置文件中不会存放密钥。

工具

工具	类型	功能
loyverse_get_merchant	读取	获取商家信息
loyverse_list_stores	读取	列出门店
loyverse_list_employees	读取	列出员工
loyverse_list_receipts	读取	列出收据
loyverse_get_receipt	读取	获取单张收据
loyverse_list_shifts	读取	列出班次
loyverse_list_items	读取	列出商品
loyverse_get_item	读取	获取单个商品
loyverse_list_variants	读取	列出商品变体
loyverse_list_categories	读取	列出类别
loyverse_list_inventory	读取	列出库存水平
loyverse_list_customers	读取	列出客户
loyverse_get_customer	读取	获取单个客户
loyverse_list_payment_types	读取	列出付款类型
loyverse_list_discounts	读取	列出折扣
loyverse_list_taxes	读取	列出税项
loyverse_list_suppliers	读取	列出供应商
loyverse_upsert_customer	写入	创建或更新客户
loyverse_upsert_category	写入	创建或更新类别
loyverse_upsert_supplier	写入	创建或更新供应商
loyverse_set_inventory_levels	写入	设置库存水平
loyverse_usage_status	元数据	使用情况（免费额度计量）
loyverse_request_feature	元数据	申请添加缺失的功能
loyverse_upgrade	元数据	升级到 Pro（无限制*）
loyverse_cancel_subscription	元数据	取消 Pro 订阅

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

定价

方案	价格	限额
免费版	$0	每月 50 次工具调用
Pro（按用户计费）	$9/mo 或 $90/yr（免费 2 个月）	无限*

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

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

许可证

MIT © usefulapi。与 Loyverse 无关联，亦未获其认可。