MCP 개요
큐넥터 MCP로 Cursor·Claude 등 AI 클라이언트에서 품목·창고·재고를 자연어로 조회·요약합니다. OAuth Device Flow가 기본 인증입니다.
MCP란
Model Context Protocol(MCP)은 AI 에이전트가 외부 도구(tool)를 호출할 수 있게 하는 표준입니다. 큐넥터 MCP 서버는 판매자 데이터를 LLM tool calling에 맞게 검색·건수·목록·요약 패턴으로 제공합니다.
ERP/WMS용 REST API(v1)와 달리, 브라우저에 API 키를 붙여 넣을 필요 없이 OAuth로 스코프를 승인한 뒤 IDE 채팅에서 바로 조회할 수 있습니다.
사용 흐름
1. Connect
mcp.json에 @qnector/mcp-server를 등록하고 Device Flow로 로그인·스코프를 승인합니다.
2. Tools
qnector_product_search, qnector_order_summary, qnector_inventory_summary 등 도구를 AI가 호출합니다.
3. Summarize
응답의 summary 한 줄과 구조화 data로 재고·품목을 채팅에 바로 보여 줍니다.
제공 범위
읽기 중심(판매자: 품목·창고·재고·주문 등 / 구매자: 연결 판매자·품목·주문·견적·정산·공지·문의)과 Hosted MCP를 제공합니다.
판매자 도구
qnector_product_* / order_* / inventory_* 등
구매자 도구
qnector_buyer_* (role=buyer, 조회 전용)
품목·창고·재고
qnector_product_* / warehouse_* / inventory_*
주문·정산
qnector_order_* / settlement_*
견적·문의·공지
qnector_quote_* / inquiry_list / notice_list
구매자·등급·단가
qnector_buyer_* / buyer_tier_list / price_*
카탈로그·링크열람
qnector_catalog_* / link_lead_* (열람은 유료 플랜)
연결·Hosted
login/logout/check · https://qnector.kr/mcp
쓰기
product_create/update, warehouse_create/update, inventory_update, order_update_status — confirm: true
REST와의 차이
소비자
MCP: AI·IDE / REST: ERP·WMS·배치 서버
인증
MCP: OAuth Bearer (Device Flow 기본) / REST: qnx_live_* API 키
응답
MCP: summary + data JSON / REST: { data, meta, errors }
쓰기
MCP: confirm 필수 / REST: 즉시 반영 (품목·창고·재고·주문상태)
플랜·제한
- 무료 플랜: OAuth 동의·MCP 툴 호출 불가 (api_access 단계에서 차단).
- 유료 플랜(레귤러 이상): Device Flow로 연결 — API 키 복사 불필요.
- 링크 열람(qnector_link_lead_*): 유료 구독(price>0)만 — 그 외는 plan_required.
- 레이트 리밋·플랜 게이트는 REST v1과 동일 seller 버킷을 공유합니다.
다음 단계
- 연결하기에서 클라이언트를 선택하고 mcp.json을 등록합니다.
- 인증 및 권한에서 OAuth 스코프를 확인합니다.
- 도구 목록·응답 형식에서 호출 규약을 확인합니다.