关于 SmartBill MCP by usefulapi
SmartBill MCP by usefulapi 将 SmartBill 接入 MCP 客户端,供财务团队查询信息并处理单据。读取与写入工具分开,写入操作会更改数据。
主要功能
- 01查询客户、供应商、产品和库存
- 02查看发票状态及增值税率
- 03创建发票和形式发票
- 04取消、恢复或冲销单据
- 05登记付款并通过邮件发送单据
适用场景
- 01查询库存或发票付款状态
- 02准备发票或形式发票
- 03登记发票对应的付款
- 04通过邮件向客户发送单据
MCP 相关
通过托管端点向 MCP 客户端提供 SmartBill 数据查询和单据操作工具。读取工具仅供查询,写入工具会更改数据。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://smartbill.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-smartbill https://smartbill.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-smartbill":{"type":"http","url":"https://smartbill.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-smartbill":{"type":"http","url":"https://smartbill.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-smartbill":{"type":"http","url":"https://smartbill.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-smartbill":{"serverUrl":"https://smartbill.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
23| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| type | enum | 否 | f = 发票,p = 形式发票,c = 收据;省略表示全部。f | p | c |
详细介绍
usefulapi 的 SmartBill MCP
从 Claude、Cursor 或任意 MCP 客户端使用 SmartBill——文档系列、增值税税率、库存、付款状态、客户、供应商、产品和仓库,以及发票和估价单(默认创建为草稿)、红字冲销、取消/恢复、付款和通过电子邮件发送文档。 托管服务,无需本地安装:使用你自己的 SmartBill 凭据连接。
在线端点: https://smartbill.usefulapi.io/mcp · 主页: https://usefulapi.io/smartbill
连接
- Claude(claude.ai、Desktop):打开 Customize → Connectors,点击 + Add → Add custom connector,然后粘贴
https://smartbill.usefulapi.io/mcp。 - Claude Code:
claude mcp add --transport http smartbill https://smartbill.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code: 添加到 VS Code。
- Cursor 和其他客户端: 将该 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"smartbill": {
"url": "https://smartbill.usefulapi.io/mcp"
}
}
}
只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 SmartBill 凭据。
分步设置说明、凭据查找位置和常见问题解答:https://usefulapi.io/smartbill/
工具
| 工具 | 类型 | 功能 |
|---|---|---|
smartbill_list_series | 读取 | 列出文档系列 |
smartbill_list_taxes | 读取 | 列出增值税税率(V1) |
smartbill_get_stock | 读取 | 获取库存水平 |
smartbill_get_invoice_payment_status | 读取 | 获取发票付款状态 |
smartbill_get_estimate_invoices | 读取 | 获取估价单对应的发票 |
smartbill_list_clients | 读取 | 列出或搜索客户 |
smartbill_get_client | 读取 | 获取客户信息 |
smartbill_list_suppliers | 读取 | 列出或搜索供应商 |
smartbill_get_supplier | 读取 | 获取供应商信息 |
smartbill_list_products | 读取 | 列出或搜索产品和服务 |
smartbill_get_product | 读取 | 获取产品或服务信息 |
smartbill_list_warehouses | 读取 | 列出仓库 |
smartbill_list_vat_rates | 读取 | 列出增值税税率(V3) |
smartbill_create_invoice | 写入 | 创建发票 |
smartbill_create_invoice_from_estimate | 写入 | 根据估价单创建发票 |
smartbill_create_estimate | 写入 | 创建估价单 |
smartbill_reverse_invoice | 写入 | 冲销发票(红字冲销) |
smartbill_cancel_invoice | 写入 | 取消发票 |
smartbill_restore_invoice | 写入 | 恢复已取消的发票 |
smartbill_cancel_estimate | 写入 | 取消估价单 |
smartbill_restore_estimate | 写入 | 恢复已取消的估价单 |
smartbill_record_invoice_payment | 写入 | 登记发票付款 |
smartbill_send_document | 写入 | 通过电子邮件发送发票或估价单 |
smartbill_usage_status | 元数据 | 使用情况状态(免费套餐用量计量) |
smartbill_request_feature | 元数据 | 申请添加缺失的功能 |
smartbill_upgrade | 元数据 | 升级到 Pro(无限制*) |
smartbill_cancel_subscription | 元数据 | 取消 Pro 订阅 |
read 工具为只读;write 工具会修改数据(客户端应先确认);meta 工具用于报告用量、管理订阅或发送功能请求。
定价
| 套餐 | 价格 | 限额 |
|---|---|---|
| 免费版 | $0 | 每月 50 次工具调用 |
| 专业版(按公司计费) | $9/mo 或 $90/yr(免费 2 个月) | 无限* |
*专业版在此服务上的公平使用限额为每月 10,000 次工具调用。如需更多,请联系 [email protected]。
专业版仅适用于此服务。使用 smartbill_upgrade 订阅(它会返回一个 Stripe Checkout 链接)。可随时使用 smartbill_cancel_subscription 取消:专业版将持续到付费周期结束,当前周期不予退款;在此之前运行 smartbill_upgrade 可撤销取消操作。也可联系 [email protected]。
许可证
MIT © usefulapi。与 SmartBill 无关联,也未获其认可。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。