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の3つの柱
この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。
- 利用者の声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月6日にチェック
- ✓ 合格
作者とリポジトリが一致
レジストリ名はドメイン usefulapi.io で確認済みです(レジストリがドメインの所有を確認しています)
- … 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
- … 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
- ✓ 合格
エンドポイントが応答する
36ミリ秒で応答(HTTP 200)
- – 対象外
OAuthでサインイン
サインイン不要
- ✓ 合格
ツールの説明に隠れた指示がない
29件のツールの説明を読み、AIへの隠れた指示は見つかりませんでした
ネットショップ・決済のほかのサーバーとの比較i
- このカテゴリのほかの1745件のうち0%よりスターが多い
- このカテゴリのほかの1745件のうち96%より最近レジストリに公開
- 基本チェックの結果が、このカテゴリのほかの1745件のうち100%と同じかそれ以上
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
よくある質問
KiotViet MCP by usefulapiは安全ですか?
当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
どんなキーやコードが必要ですか?
レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。
パソコンで動きますか、それともクラウドですか?
作者のクラウドで動きます。インストール不要でインターネット経由でつながりますが、送った内容は作者のサーバーを通ります。
今もメンテナンスされていますか?
GitHubリポジトリの最終更新は–、最新バージョン(1.11.4)がレジストリに届いたのは今日です。
どのアプリで使えますか?
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URLでつながるので、リモートMCPサーバーに対応したアプリ(開発者モードのChatGPTなど)でも使えます。
代わりに使えるものは?
同じカテゴリには:Spree Commerce: open-source B2B and marketplace ecommerce, Stripe MCP, MCP Cn Commerce
代わりの候補
同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。
カードの見方:★ GitHubスターi3つの柱:レビュー · チェック · 利用状況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