KiotViet MCP by usefulapi

usefulapi 提供的 KiotViet MCP

在线端点： https://kiotviet.usefulapi.io/mcp

连接

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

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

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

分步设置指南、凭据查找位置及常见问题解答：https://usefulapi.io/kiotviet/

首次连接时，你需要粘贴 KiotViet Client ID、secret 和店铺名称。这些信息会经过验证，按用户存储，并仅限你本人使用。配置文件中不会存储密钥。

工具

工具	类型	功能
kiotviet_list_products	读取	列出商品
kiotviet_get_product	读取	获取商品
kiotviet_get_product_by_code	读取	按商品编码获取商品
kiotviet_list_categories	读取	列出类别
kiotviet_get_category	读取	获取类别
kiotviet_list_customers	读取	列出客户
kiotviet_get_customer	读取	获取客户
kiotviet_get_customer_by_code	读取	按客户编码获取客户
kiotviet_create_customer	写入	创建客户
kiotviet_list_invoices	读取	列出发票
kiotviet_get_invoice	读取	获取发票
kiotviet_get_invoice_by_code	读取	按发票编码获取发票
kiotviet_list_orders	读取	列出销售订单
kiotviet_get_order	读取	获取销售订单
kiotviet_get_order_by_code	读取	按订单编码获取销售订单
kiotviet_create_order	写入	创建销售订单
kiotviet_list_branches	读取	列出分店
kiotviet_list_stock	读取	列出库存
kiotviet_list_suppliers	读取	列出供应商
kiotviet_get_supplier	读取	获取供应商
kiotviet_list_purchase_orders	读取	列出收货单
kiotviet_get_purchase_order	读取	获取收货单
kiotviet_list_supplier_orders	读取	列出供应商订单
kiotviet_list_returns	读取	列出退货单
kiotviet_get_return	读取	获取退货单
kiotviet_list_cashflow	读取	列出现金流
kiotviet_list_users	读取	列出用户
kiotviet_list_price_books	读取	列出价格表
kiotviet_get_price_book	读取	获取价格表价格
kiotviet_usage_status	元数据	使用情况（免费套餐用量计数）
kiotviet_request_feature	元数据	申请添加缺失功能
kiotviet_upgrade	元数据	升级到 Pro（无限制*）
kiotviet_cancel_subscription	元数据	取消 Pro 订阅

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

定价

套餐	价格	限额
Free	$0	每月 50 次工具调用
Pro（按店铺账号计费）	$9/mo 或 $90/yr（免费 2 个月）	无限*

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

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

许可证

MIT