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_* / warehouse_* / inventory_*

주문·정산

qnector_order_* / settlement_*

견적·문의·공지

qnector_quote_* / inquiry_list / notice_list

구매자·등급·단가

qnector_buyer_* / buyer_tier_list / price_*

카탈로그·링크열람

qnector_catalog_* / link_lead_* (열람은 유료 플랜)

연결·Hosted

쓰기 (예정)

qnector_inventory_update, qnector_product_update — confirm: true

구분설명

소비자

MCP: AI·IDE / REST: ERP·WMS·배치 서버

인증

MCP: OAuth Bearer (Device Flow 기본) / REST: qnx_live_* API 키

응답

MCP: summary + data JSON / REST: { data, meta, errors }

쓰기

MCP: 2차·confirm 필수 / REST: 품목·창고·재고 1차 제공