이커머스용 MCP: AI가 Store tools를 안전하게 쓰는 방법

Model Context Protocol은 호환 client에 이름 있는 tools 발견, 제한된 resources 읽기, structured arguments로 server 호출하기 위한 표준을 제공합니다. 그 자체로 Store를 안전하게 만들거나 payment를 승인하거나 checkout을 대체하지 않습니다. MCP server가 actor를 식별하고 input을 검증하며 product와 Store policy를 적용해 typed result를 반환합니다. model은 capability를 요청하는 client이지 commerce state의 owner가 아닙니다.

search_catalog, get_product, create_cart_draft, request_checkout, get_order_status, draft_catalog_update처럼 좁은 action을 공개합니다. raw query, 임의 HTTP, provider secret, 범용 execute는 노출하지 않습니다. 각 tool에 input/output schema, Store scope, risk, idempotency, timeout, 명확한 failure를 둡니다. resources는 policy와 catalog를 설명할 수 있지만 untrusted text가 tool을 부여하거나 validation을 약화할 수 없습니다.

buyer tools와 creator-management tools는 다른 authority surface입니다. shopper는 검색, 비교, 한 Store의 cart 준비, 허용된 checkout 시작, 자신의 order status 확인을 할 수 있습니다. owner는 정확한 grant가 있어야 catalog draft, inventory alert, discount, order, reconciliation을 다룹니다. 연결된 Agent는 선택된 Store capabilities만 받고 ownership, payment provider access, 다른 Store tools를 상속하지 않습니다.

product, price, sellable inventory, order, payment, refund, fulfillment, customer, consent는 authoritative commerce services에 둡니다. MCP layer는 typed request를 번역하고 committed result를 보고하며 대화에서 두 번째 진실을 만들지 않습니다. mutable draft에는 revision check, 재시도 effect에는 idempotency key를 씁니다. provider timeout이면 성공을 추측하지 말고 unknown 또는 pending으로 반환해 reconciliation합니다.

OAuth 같은 verified scoped identity, least privilege, 짧은 session, 중요한 write의 explicit confirmation, actor가 남는 immutable audit를 사용합니다. 실행 시 Store id, identity, amount, currency, price revision, state, capability를 검증합니다. grant는 회수 가능해야 하고 read와 write를 나누며 stale, missing, cross-Store, ambiguous tool은 fail closed로 처리합니다. confirmation은 server validation을 대체하지 않습니다.

Codex, ChatGPT, GitHub Copilot 등은 transport, authentication, discovery, approval, admin control이 다르므로 실제 client와 plan을 확인하세요. read-only catalog 또는 order status부터 시작해 reversible draft action 하나를 더하고 invalid, duplicate, stale, cross-account, timeout, revoked access를 test합니다. Prostir Store는 Preview이며 한 commerce root, 승인된 기존 Agent, https://{slug}.store.prostir.build/mcp 를 중심으로 설계됩니다. 안정적인 기존 path를 바꾸기 전에 fit을 검증하세요.