프로토타입 · 미리 보기: 공식 레지스트리의 모든 서버를 담고 있으며 30분마다 동기화해요. 리뷰와 계정 기능은 다음 단계에서 열려요.
PopNx MCPAI를 쓰는 사람을 위한 MCP 서버 · 쉬운 말로 설명해요

KiotViet MCP by usefulapi

제작자: m190버전 1.11.3i★ –i클라우드에서 실행
레지스트리 이름io.usefulapi/kiotviet

설치

개요

제작자가 쓴 설명(영어 원문)

Read KiotViet products, customers, invoices, orders and stock; create customers and orders.

PopNx MCP의 세 기둥

이 세 가지는 절대 하나의 점수로 합치지 않아요. 의견, 측정, 인기는 서로 다른 것이니까요.

할 수 있는 일

이 서버는 아직 쉬운 말로 된 요약을 쓰지 못했어요. 아래는 레지스트리에서 읽어 온 사실이에요.

  • 연결 방식: 클라우드에서 실행
  • 전송 방식: Streamable HTTP
  • 카테고리: 온라인 쇼핑몰 및 결제

설치

쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.

설치하기 전에

필요한 것

어떤 앱을 쓰세요?

위에서 앱을 고르세요. 기억해 두었다가 다음부터는 버튼에 “…에 설치”라고 표시해요.

웹, 데스크톱, 모바일의 Claude에서 쓸 수 있어요:

  1. Settings → Connectors 열기
  2. Add custom connector 누르기
  3. 아래 주소를 붙여 넣고 Add 누르기
  4. 로그인하라고 하면 제작자의 서비스에 로그인하기
SettingsConnectors1+ Add2https://…3
https://kiotviet.usefulapi.io/mcp

터미널에서 이 명령어를 실행하세요

claude mcp add --transport http kiotviet https://kiotviet.usefulapi.io/mcp

Cursor에서 열기

또는 설정을 직접 복사하기

프로젝트의 .cursor/mcp.json 또는 ~/.cursor/mcp.json에 붙여 넣으세요

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

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

VS Code에서 열기

또는 설정을 직접 복사하기

프로젝트의 .vscode/mcp.json에 붙여 넣으세요

{
  "servers": {
    "kiotviet": {
      "type": "http",
      "url": "https://kiotviet.usefulapi.io/mcp"
    }
  }
}

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

ChatGPT는 인터넷에 있는 서버에만 연결할 수 있어요:

  1. 웹에서 ChatGPT 열기 → Settings → Connectors (Apps)
  2. Create 또는 Add 누르기(일부 요금제는 먼저 Advanced에서 Developer mode를 켜야 해요)
  3. 아래 주소를 붙여 넣고 이름을 정한 뒤 저장하기
  4. 로그인하라고 하면 제작자의 서비스에 로그인하기
SettingsConnectors1+ Create2https://…3
https://kiotviet.usefulapi.io/mcp

메뉴 이름은 요금제나 시기에 따라 조금 다를 수 있어요.

선택한 앱은 이 기기의 쿠키에만 저장돼요. 계정은 필요 없어요.

이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.

할 수 있는 일

도구 이름과 설명은 서버가 2026년 11월 6일에 알려 준 그대로예요. 우리가 아니라 제작자가 쓴 글이고, 일반 텍스트로만 보여 드려요.

  • kiotviet_list_products

    List 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_product

    One 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_code

    One product by its product code (SKU). GET /products/code/{code}.

  • kiotviet_list_categories

    List product categories (id, name, parent, whether it has children). Set hierarchical to get the category tree. GET /categories.

  • kiotviet_get_category

    One product category by id (name, parent, children). GET /categories/{id}.

  • kiotviet_list_customers

    List 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_customer

    One customer by id: contact data, debt, total invoiced, reward points, groups. GET /customers/{id}.

  • kiotviet_get_customer_by_code

    One customer by customer code. GET /customers/code/{code}.

  • kiotviet_create_customer

    WRITE: 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_invoices

    List 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_invoice

    One invoice by id with its lines, payments and delivery. GET /invoices/{id}.

  • kiotviet_get_invoice_by_code

    One invoice by invoice code (for example HD000123). GET /invoices/code/{code}.

  • kiotviet_list_orders

    List 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_order

    One sales order by id with its lines, payments and delivery. GET /orders/{id}.

  • kiotviet_get_order_by_code

    One sales order by order code (for example DH000123). GET /orders/code/{code}.

  • kiotviet_create_order

    WRITE: 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_branches

    List the shop's branches (id, name, code, phone, address). Use the ids to filter other tools. GET /branches.

  • kiotviet_list_stock

    Stock on hand and reserved quantity per product and branch. Filter by branch or last change. GET /productOnHands.

  • kiotviet_list_suppliers

    List suppliers (code, name, phone, email, address, debt, total invoiced). Filter by code, name, phone or last change. GET /suppliers.

  • kiotviet_get_supplier

    One supplier by id. GET /suppliers/{id}.

  • kiotviet_list_purchase_orders

    List 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_order

    One goods receipt (nhap hang) by id with its lines. GET /purchaseorders/{id}.

  • kiotviet_list_supplier_orders

    List 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_returns

    List customer returns (code, date, branch, customer, invoice, return total, lines). GET /returns.

  • kiotviet_get_return

    One customer return by id with its lines. GET /returns/{id}.

  • kiotviet_list_cashflow

    List cash-book entries (receipts and payments: code, branch, method, partner, amount, date, status). Filter by branch, direction or date range. GET /cashflow.

  • kiotviet_list_users

    List the shop's staff users (id, username, name, phone, email). GET /users.

  • kiotviet_list_price_books

    List price books (bang gia: name, active flag, validity dates, branches, customer groups). GET /pricebooks.

  • kiotviet_get_price_book

    The product prices of one price book (product id, code, price), paged. GET /pricebooks/{id}.

기본 점검i

누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 6일 점검

  • ✓ 통과

    제작자와 저장소 일치

    레지스트리 이름이 도메인 usefulapi.io 기준으로 확인되었어요(레지스트리가 도메인 소유를 확인해요)

  • … 아직 점검 안 함

    계속 관리되고 있음

    아직 GitHub에서 이 저장소를 읽어 오지 않았어요

  • … 아직 점검 안 함

    라이선스 있음

    아직 GitHub에서 이 저장소를 읽어 오지 않았어요

  • ✓ 통과

    엔드포인트 응답

    36ms 만에 응답(HTTP 200)

  • – 해당 없음

    OAuth로 로그인

    로그인 필요 없음

  • ✓ 통과

    도구 설명에 숨겨진 지시 없음

    도구 설명 29개를 읽었고, AI에게 보내는 숨겨진 지시는 없었어요

온라인 쇼핑몰 및 결제 카테고리의 다른 서버와 비교i

  • 이 카테고리의 다른 서버 1743개 중 0%보다 스타가 많아요
  • 이 카테고리의 다른 서버 1743개 중 94%보다 최근에 레지스트리에 공개됐어요
  • 기본 점검 결과가 이 카테고리의 다른 서버 1743개 중 100%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

KiotViet MCP by usefulapi, 안전한가요?

해당하는 기본 점검 3개 중 3개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

제작자의 클라우드에서 실행돼요. 설치 없이 인터넷으로 연결하지만, 보내는 내용은 제작자의 서버를 거쳐요.

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 – 변경됐고, 최신 버전(1.11.3)은 어제 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

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 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i

Stripe MCP

제작자: stripe

MCP server integrating with Stripe - tools for customers, products, payments, and more.

클라우드에서 실행★ 2,043MIT12개월 전 업데이트
설치

MCP Cn Commerce

제작자: TonyWang-hub

8 read-only MCP platform entries; support is operation-specific; merchant live acceptance pending

내 컴퓨터에서 실행★ 96MIT27일 전 업데이트
설치

제작자의 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 /mcp to 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

ToolTypeWhat it does
kiotviet_list_productsreadList products
kiotviet_get_productreadGet product
kiotviet_get_product_by_codereadGet product by code
kiotviet_list_categoriesreadList categories
kiotviet_get_categoryreadGet category
kiotviet_list_customersreadList customers
kiotviet_get_customerreadGet customer
kiotviet_get_customer_by_codereadGet customer by code
kiotviet_create_customerwriteCreate customer
kiotviet_list_invoicesreadList invoices
kiotviet_get_invoicereadGet invoice
kiotviet_get_invoice_by_codereadGet invoice by code
kiotviet_list_ordersreadList sales orders
kiotviet_get_orderreadGet sales order
kiotviet_get_order_by_codereadGet sales order by code
kiotviet_create_orderwriteCreate sales order
kiotviet_list_branchesreadList branches
kiotviet_list_stockreadList stock on hand
kiotviet_list_suppliersreadList suppliers
kiotviet_get_supplierreadGet supplier
kiotviet_list_purchase_ordersreadList goods receipts
kiotviet_get_purchase_orderreadGet goods receipt
kiotviet_list_supplier_ordersreadList supplier orders
kiotviet_list_returnsreadList returns
kiotviet_get_returnreadGet return
kiotviet_list_cashflowreadList cash flow
kiotviet_list_usersreadList users
kiotviet_list_price_booksreadList price books
kiotviet_get_price_bookreadGet price book prices
kiotviet_usage_statusmetaUsage status (free-tier meter)
kiotviet_request_featuremetaRequest a missing feature
kiotviet_upgrademetaUpgrade to Pro or Pro+
kiotviet_cancel_subscriptionmetaCancel 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

PlanPriceLimit
Free$050 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

PopNx에게 묻기