Bsale MCP by usefulapi

Name: Bsale MCP by usefulapi
Author: usefulapi.io

远程服务

usefulapi.io商业与营销1今天更新

代码仓库访问官网

关于 Bsale MCP by usefulapi

Bsale MCP by usefulapi 将 Bsale 的销售、商品和库存数据接入 AI 客户端，支持查询并执行客户、价格、收货和付款相关操作。适用于使用 Bsale 管理销售与库存的团队。

主要功能

01查询销售单据与销售汇总
02查看客户及未付款单据
03查询商品、SKU 与库存
04管理价格清单与收款记录
05创建或更新客户及库存收货

适用场景

01查看销售额和退货记录
02核对客户欠款与付款
03检查商品库存和价格
04登记收货或付款并维护客户

MCP 相关

该 MCP 服务通过远程端点向 MCP 客户端提供 Bsale 数据查询和写入工具。连接时由服务器通过 OAuth 处理登录。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://bsale.usefulapi.io/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http io-usefulapi-bsale https://bsale.usefulapi.io/mcp

Cursor.cursor/mcp.json{"mcpServers":{"io-usefulapi-bsale":{"type":"http","url":"https://bsale.usefulapi.io/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"io-usefulapi-bsale":{"type":"http","url":"https://bsale.usefulapi.io/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"io-usefulapi-bsale":{"type":"http","url":"https://bsale.usefulapi.io/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"io-usefulapi-bsale":{"serverUrl":"https://bsale.usefulapi.io/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

usefulapi 推出的 Bsale MCP

读取 Bsale 产品、单据和库存；管理客户、价格、收据和付款。

连接

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

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

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

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

工具

工具	类型	功能
`bsale_list_documents`	read	列出单据（销售）
`bsale_get_document`	read	获取单据
`bsale_sales_summary`	read	销售汇总
`bsale_list_returns`	read	列出退货
`bsale_list_document_types`	read	列出单据类型
`bsale_list_clients`	read	列出客户
`bsale_get_client`	read	获取客户
`bsale_client_unpaid_documents`	read	客户未付款单据
`bsale_list_products`	read	列出产品
`bsale_get_product`	read	获取产品
`bsale_list_variants`	read	列出变体（SKU）
`bsale_get_variant`	read	获取变体
`bsale_list_stocks`	read	列出库存水平
`bsale_list_price_lists`	read	列出价格表
`bsale_list_price_list_details`	read	列出价格表价格
`bsale_list_payments`	read	列出付款
`bsale_list_payment_types`	read	列出付款类型
`bsale_list_offices`	read	列出办公室（分支机构）
`bsale_list_users`	read	列出用户（销售人员）
`bsale_user_sales_summary`	read	按销售人员统计销售额
`bsale_create_client`	write	创建客户
`bsale_update_client`	write	更新客户
`bsale_update_price`	write	更新价格表价格
`bsale_create_stock_reception`	write	接收库存
`bsale_create_payment`	write	记录付款
`bsale_usage_status`	meta	使用状态（免费套餐用量计数）
`bsale_request_feature`	meta	申请添加缺失功能
`bsale_upgrade`	meta	升级到 Pro 或 Pro+
`bsale_cancel_subscription`	meta	取消 Pro 订阅

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

定价

套餐	价格	限额
Free	$0	每月 50 次工具调用
Pro（每个 Bsale 公司和 API 主机）	$9/月或 $90/年（免费 2 个月）	无限制*

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

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