Open-source B2B and marketplace ecommerce; new stores include an MCP server for AI agents.
KiotViet MCP by usefulapi
概览
作者提供的说明(英文原文)
Read KiotViet products, customers, invoices, orders and stock; create customers and orders.
PopNx MCP 的三大支柱
这三项永远不会合并成一个分数:意见、测量和人气是不同的东西。
- 用户评价i暂无评价评价功能将在后续阶段与账户功能一起开放
- 我们的基础检查i3 项中通过 3 项依据公开信息检查;尚未扫描代码
- 使用情况i尚未统计★ –
它能帮你做什么
我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。
- 连接方式: 在云端运行
- 传输方式: Streamable HTTP
- 分类: 网店与支付
安装
选择你使用的 AI 应用,然后复制设置。
安装之前
- 基础检查:3 项中通过 3 项
- 在作者的服务器上运行:你向它提出的内容会经过他们的服务器。
- 可以做 29 件事(工具) kiotviet_list_products, kiotviet_get_product, kiotviet_get_product_by_code, kiotviet_list_categories …
- 注册中心没有列出需要填写的密钥。
你需要
- 在云端运行无需安装任何东西,通过互联网连接
你用的是哪个应用?
在上方选择你的应用。我们会记住它,下次按钮会显示“安装到 …”。
适用于网页版、桌面版和手机版 Claude:
- 打开 Settings → Connectors
- 点击 Add custom connector
- 粘贴下面的地址,然后点击 Add
- 如果要求登录,请登录作者的服务
https://kiotviet.usefulapi.io/mcp在终端中运行这条命令
claude mcp add --transport http kiotviet https://kiotviet.usefulapi.io/mcp或者自己复制设置
粘贴到项目中的 .cursor/mcp.json,或 ~/.cursor/mcp.json
{
"mcpServers": {
"kiotviet": {
"url": "https://kiotviet.usefulapi.io/mcp"
}
}
}浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。
或者自己复制设置
粘贴到项目中的 .vscode/mcp.json
{
"servers": {
"kiotviet": {
"type": "http",
"url": "https://kiotviet.usefulapi.io/mcp"
}
}
}浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。
ChatGPT 只能连接互联网上的服务器:
- 打开网页版 ChatGPT → Settings → Connectors (Apps)
- 点击 Create 或 Add(部分套餐需要先在 Advanced 中开启 Developer mode)
- 粘贴下面的地址,起个名字,然后保存
- 如果要求登录,请登录作者的服务
https://kiotviet.usefulapi.io/mcp菜单名称可能因套餐和版本不同而略有差异。
你的选择通过 Cookie 保存在这台设备上,无需账户。
这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。
它能做什么
工具名称和描述与服务器在 2026年11月6日 报告的完全一致。这些内容由作者撰写,不是我们写的;我们以纯文本形式显示。
kiotviet_list_productsList products (code, barcode, name, category, base price, units, attributes). Optionally include stock per branch (include_inventory) and price-book prices. Filter by name, category, branch, active flag or last change. GET /products.
kiotviet_get_productOne product by id: code, barcode, name, category, base price, units, attributes, images, stock per branch and price books. GET /products/{id}.
kiotviet_get_product_by_codeOne product by its product code (SKU). GET /products/code/{code}.
kiotviet_list_categoriesList product categories (id, name, parent, whether it has children). Set hierarchical to get the category tree. GET /categories.
kiotviet_get_categoryOne product category by id (name, parent, children). GET /categories/{id}.
kiotviet_list_customersList customers (code, name, phone, email, address, debt, total invoiced, reward points, groups). Contains personal data of the shop's customers. Filter by code, name, phone, group or last change. GET /customers.
kiotviet_get_customerOne customer by id: contact data, debt, total invoiced, reward points, groups. GET /customers/{id}.
kiotviet_get_customer_by_codeOne customer by customer code. GET /customers/code/{code}.
kiotviet_create_customerWRITE: create a new customer in the shop (name required; code is generated by KiotViet if omitted). Always check with the user first, and look the customer up by phone before creating a duplicate. POST /customers.
kiotviet_list_invoicesList sales invoices (code, date, branch, customer, total, amount paid, status, lines). Filter by branch, customer, status, order, purchase-date range or last change. GET /invoices.
kiotviet_get_invoiceOne invoice by id with its lines, payments and delivery. GET /invoices/{id}.
kiotviet_get_invoice_by_codeOne invoice by invoice code (for example HD000123). GET /invoices/code/{code}.
kiotviet_list_ordersList sales orders (code, date, branch, customer, total, status, lines, delivery). Filter by branch, customer, status, creation date (from) or last change (from/to). GET /orders.
kiotviet_get_orderOne sales order by id with its lines, payments and delivery. GET /orders/{id}.
kiotviet_get_order_by_codeOne sales order by order code (for example DH000123). GET /orders/code/{code}.
kiotviet_create_orderWRITE: create a sales order (an order, not an invoice: no invoice is made and no payment is recorded) with lines of existing products in a branch, for an existing customer or none. Always confirm the products, quantities and prices with the user first. POST /orders.
kiotviet_list_branchesList the shop's branches (id, name, code, phone, address). Use the ids to filter other tools. GET /branches.
kiotviet_list_stockStock on hand and reserved quantity per product and branch. Filter by branch or last change. GET /productOnHands.
kiotviet_list_suppliersList suppliers (code, name, phone, email, address, debt, total invoiced). Filter by code, name, phone or last change. GET /suppliers.
kiotviet_get_supplierOne supplier by id. GET /suppliers/{id}.
kiotviet_list_purchase_ordersList goods receipts from suppliers (nhap hang: code, date, branch, supplier, total, lines). Filter by branch, status or purchase-date range. GET /purchaseorders.
kiotviet_get_purchase_orderOne goods receipt (nhap hang) by id with its lines. GET /purchaseorders/{id}.
kiotviet_list_supplier_ordersList orders placed with suppliers (dat hang nhap: code, date, branch, supplier, status, lines, amount paid). Filter by branch, status, supplier or product text. GET /ordersuppliers.
kiotviet_list_returnsList customer returns (code, date, branch, customer, invoice, return total, lines). GET /returns.
kiotviet_get_returnOne customer return by id with its lines. GET /returns/{id}.
kiotviet_list_cashflowList cash-book entries (receipts and payments: code, branch, method, partner, amount, date, status). Filter by branch, direction or date range. GET /cashflow.
kiotviet_list_usersList the shop's staff users (id, username, name, phone, email). GET /users.
kiotviet_list_price_booksList price books (bang gia: name, active flag, validity dates, branches, customer groups). GET /pricebooks.
kiotviet_get_price_bookThe product prices of one price book (product id, code, price), paged. GET /pricebooks/{id}.
基础检查i
我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月7日
- ✓ 通过
作者与仓库一致
注册名称已通过域名 usefulapi.io 验证(注册中心会核实域名所有权)
- … 尚未检查
仍在维护
我们还没有从 GitHub 读取这个仓库
- … 尚未检查
有许可证
我们还没有从 GitHub 读取这个仓库
- ✓ 通过
端点有响应
在 36 毫秒内响应(HTTP 200)
- – 不适用
使用 OAuth 登录
无需登录
- ✓ 通过
工具描述中没有隐藏指令
已读取 29 个工具描述,未发现针对 AI 的隐藏指令
与“网店与支付”中的其他服务器比较i
- 星标数多于此分类中其他 1748 个服务器的 0%
- 发布到注册中心的时间比此分类中其他 1748 个服务器的 96% 更新
- 基础检查结果等于或优于此分类中其他 1748 个服务器的 100%
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。
常见问题
KiotViet MCP by usefulapi 安全吗?
它在 3 项适用的基础检查中通过了 3 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。
它需要哪些密钥或代码?
注册中心没有列出必需的密钥,不过有些服务器会在首次使用时要求你登录。
它在我的电脑上运行还是在云端?
它在作者的云端运行。通过互联网连接,无需安装,但你发送的内容会经过作者的服务器。
它还在维护吗?
GitHub 仓库最后更新于–,最新版本(1.12.1)于今天进入注册中心。
哪些应用可以使用它?
支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接,所以接受远程 MCP 服务器的应用也可以使用,例如开启开发者模式的 ChatGPT。
有什么可以替代它?
同一分类中有:Spree Commerce: open-source B2B and marketplace ecommerce, Stripe MCP, MCP Cn Commerce
替代选择
同一分类中其他作者的服务器,按星标数排序。
如何看卡片:★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i
Stripe MCP
MCP server integrating with Stripe - tools for customers, products, payments, and more.
MCP Cn Commerce
8 read-only MCP platform entries; support is operation-specific; merchant live acceptance pending
作者的 README
打开 README
按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。
KiotViet MCP by usefulapi
Live endpoint: https://kiotviet.usefulapi.io/mcp
Connect
- Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste
https://kiotviet.usefulapi.io/mcp. - Claude Code:
claude mcp add --transport http kiotviet https://kiotviet.usefulapi.io/mcp, then run/mcpto log in. - VS Code: Add to VS Code.
- Cursor and other clients: add the URL as a remote MCP server:
{
"mcpServers": { "kiotviet": { "url": "https://kiotviet.usefulapi.io/mcp" } } }
Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your KiotViet credentials.
Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/kiotviet/
On first connect you will paste your KiotViet Client ID, secret and shop name. They are validated, stored per-user, and scoped to you. No keys in config files.
Tools
| Tool | Type | What it does |
|---|---|---|
kiotviet_list_products | read | List products |
kiotviet_get_product | read | Get product |
kiotviet_get_product_by_code | read | Get product by code |
kiotviet_list_categories | read | List categories |
kiotviet_get_category | read | Get category |
kiotviet_list_customers | read | List customers |
kiotviet_get_customer | read | Get customer |
kiotviet_get_customer_by_code | read | Get customer by code |
kiotviet_create_customer | write | Create customer |
kiotviet_list_invoices | read | List invoices |
kiotviet_get_invoice | read | Get invoice |
kiotviet_get_invoice_by_code | read | Get invoice by code |
kiotviet_list_orders | read | List sales orders |
kiotviet_get_order | read | Get sales order |
kiotviet_get_order_by_code | read | Get sales order by code |
kiotviet_create_order | write | Create sales order |
kiotviet_list_branches | read | List branches |
kiotviet_list_stock | read | List stock on hand |
kiotviet_list_suppliers | read | List suppliers |
kiotviet_get_supplier | read | Get supplier |
kiotviet_list_purchase_orders | read | List goods receipts |
kiotviet_get_purchase_order | read | Get goods receipt |
kiotviet_list_supplier_orders | read | List supplier orders |
kiotviet_list_returns | read | List returns |
kiotviet_get_return | read | Get return |
kiotviet_list_cashflow | read | List cash flow |
kiotviet_list_users | read | List users |
kiotviet_list_price_books | read | List price books |
kiotviet_get_price_book | read | Get price book prices |
kiotviet_usage_status | meta | Usage status (free-tier meter) |
kiotviet_request_feature | meta | Request a missing feature |
kiotviet_upgrade | meta | Upgrade to Pro or Pro+ |
kiotviet_cancel_subscription | meta | Cancel the Pro subscription |
read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.
Pricing
| Plan | Price | Limit |
|---|---|---|
| Free | $0 | 50 tool calls / month |
| Pro (per store account) | $9/mo or $90/yr (2 months free) | Unlimited* |
\*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to support@usefulapi.io.
Pro covers this server only. Subscribe with kiotviet_upgrade (it returns a Stripe Checkout link). Cancel any time with kiotviet_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running kiotviet_upgrade before then undoes the cancel. Or write to support@usefulapi.io.
License
MIT