도구 목록
큐넥터 MCP 도구는 search / count / list / get / summary 패턴입니다. 읽기 도구와 쓰기(예정) 도구를 안내합니다.
네이밍·패턴
접두사 qnector_ + 리소스 + 동작입니다. inputSchema는 JSON Schema이며 필수 필드를 최소화합니다. 스코프가 부족하면 403 oauth_insufficient_scope를 반환합니다.
- search: 키워드·필터 매칭 (기본 limit 작음)
- count: 동일 필터의 건수
- list: page/limit 페이지네이션
- get: 단건 상세
- summary: 집계·한 줄 요약 (내부 다건 호출도 MCP 1회로 카운트)
연결·진단
qnector_login
Device Flow 시작 — URL·user_code를 채팅에 표시
qnector_logout
로컬 credentials 삭제 + /revoke
qnector_check_connection
access 유효·만료·scopes·seller_id·플랜
qnector_runtime_status
레이트 리밋 잔량·API 버전
품목·창고·재고
qnector_product_search
품목코드·품목명 검색 (q, category_ids, product_status, limit)
qnector_product_count
search와 동일 필터의 건수
qnector_product_list
page/limit 목록 (필터는 search와 동일)
qnector_product_get
prod_code 단건
qnector_warehouse_list / _get
창고 목록·상세 (이카운트 연동 시 ecount_managed 안내)
qnector_inventory_search
q, low_stock_only, limit
qnector_inventory_list
전 품목 스냅샷 — page/limit 필수 (대용량 테넌트)
qnector_inventory_summary
total_skus, in_stock, out_of_stock, total_units
주문·정산 (read)
OAuth consent에서 mcp:orders:read / mcp:settlements:read를 추가로 동의해야 합니다.
qnector_order_search / _list / _get / _summary
주문번호·상태·기간 필터
qnector_settlement_search / _list / _summary
정산 상태·미수 요약
견적·문의·공지·구매자
qnector_quote_list / _get
quote_number 기준 (mcp:quotes:read)
qnector_inquiry_list
status, inquiry_type (mcp:inquiries:read)
qnector_notice_list
공지 목록 (mcp:notices:read)
qnector_buyer_list / _search
사업자번호·상호 (mcp:buyers:read)
등급·단가·카탈로그·링크열람
링크 열람(qnector_link_lead_*)은 유료 고객사만 사용 가능합니다. 무료 플랜은 plan_required(403)를 반환합니다.
qnector_buyer_tier_list
등급 코드·할인율 (mcp:buyer-tiers:read)
qnector_price_search / _list
업체별·적용 단가 (mcp:prices:read)
qnector_catalog_list / _get
catalog_token 기준 (mcp:catalogs:read)
qnector_link_lead_list / _summary
공유 링크 열람·리드 (mcp:link-leads:read, 유료)
쓰기 (예정)
아래 도구는 이후 제공 예정입니다.
qnector_inventory_update
mcp:inventory:write + confirm: true (없으면 dry-run)
qnector_product_update
mcp:products:write + confirm: true (없으면 dry-run)
주요 파라미터 (품목 검색)
| 필드 | 필수여부 | 자릿수/형식 | 설명 |
|---|---|---|---|
| q | 선택 | string, ≤100자 | 품목코드·품목명 검색 |
| category_ids | 선택 | string[] | 카테고리 UUID 필터 |
| product_status | 선택 | enum | out_of_stock | discontinued | made_to_order |
| limit | 선택 | int, 기본 20, 최대 50 | search 결과 상한 |
| page / limit | list 시 | page≥1, limit 1–100 | 목록 페이지네이션 |
| confirm | 쓰기 시 | boolean true | 없으면 dry-run 미리보기만 반환 |