Merchant Web MCP
Merchant Web MCP — 에이전트 분석 및 운용성 프로토타입
모든 전자상거래 스토어프론트를 AI 쇼핑 에이전트를 위한 관찰 가능하고, 측정 가능하며, 거래 가능한 플랫폼으로 전환하세요.
[!NOTE] 프로토타입 및 시뮬레이션 고지: 이 저장소는 제안된 BigCommerce / Merchant Web MCP 플러그인 아키텍처의 대화형 시뮬레이션 콕핏 및 프로토타입을 포함합니다. 시뮬레이션 엔진은 클라이언트 측에서 실행되며, 시뮬레이션된 지연 시간, 실제 Web Crypto HMAC-SHA256 서명, 실제 15분 TTL 재고 예약 타이머, 그리고 경영진용 에이전트 의도 분석 대시보드를 제공합니다.
🎯 핵심 문제 및 가치 제안
단기적 현실: 에이전트 트래픽에 대한 맹점
오늘날 판매자들은 AI 쇼핑 에이전트(ChatGPT Agent, Claude, Perplexity, Apple Intelligence)에 대해 알지 못합니다. 봇이 제품 페이지를 스크레이핑할 때:
트래픽은 단순 웹 스크레이퍼와 구분할 수 없습니다.
시각적 스크레이핑은 페이지당 6,000–10,000 토큰을 소비하며 React hydration 또는 DOM 재설계 시 자주 실패합니다.
판매자들은 에이전트가 어떤 제품을 검색하는지, 어떤 쿼리가 실패하는지, 어떤 상업적 수요가 포착되지 않은 채 지나가는지에 대해 전혀 가시성이 없습니다.
해결책: BigCommerce Merchant Web MCP
에이전트 의도 분석(즉각적인 SaaS 가치): 유입되는 에이전트 세션, 도구 실행, 발견된 의도 가치(£124k+ 파이프라인), 공급자별 분석, 카탈로그 수요 격차를 포착합니다.
결정적 MCP 인터페이스: 구조화된 JSON-RPC 도구(
search_products,get_product_details,check_variant_stock,apply_promotions,add_to_cart_session,create_checkout_session)를 노출합니다.검증된 암호화 핸드오프: 15분 임시 재고 소프트락과 함께 실제 Web Crypto HMAC-SHA256 토큰을 사용하여 서명된 체크아웃 URL을 생성합니다.
Related MCP server: Shopify Agentic MCP Gateway
🏗️ 아키텍처 개요
┌────────────────────────────────────────────────────────┐
│ AI Shopping Agent │
│ (Claude / ChatGPT / Perplexity) │
└───────────────────────────┬────────────────────────────┘
│ (1) Discover: /.well-known/mcp.json
│ (2) Transport: HTTP / SSE Stream
▼
┌────────────────────────────────────────────────────────┐
│ Merchant Web MCP Plugin Engine │
│ ┌──────────────────────────────────────────────────┐ │
│ │ Layered Security Guard (Unicode Filter & Regex) │ │
│ └────────────────────────┬─────────────────────────┘ │
│ │ │
│ ┌────────────────────────▼─────────────────────────┐ │
│ │ Standardized MCP Tools: │ │
│ │ • search_products(query, max_price, waterproof) │ │
│ │ • check_variant_stock(variant_id, postal_code) │ │
│ │ • apply_promotions(promo_code, subtotal) │ │
│ │ • add_to_cart_session(variant_id, qty) [15m TTL]│ │
│ │ • create_checkout_session (WebCrypto HMAC SHA256│ │
│ │ • get_store_policies() │ │
│ └────────────────────────┬─────────────────────────┘ │
└───────────────────────────┼────────────────────────────┘
│
┌───────────────┴───────────────┐
▼ ▼
┌───────────────────────┐ ┌───────────────────────┐
│ Merchant Catalog / DB │ │ Storefront Cart & DOM │
│ (BigCommerce / D1) │ │ (Live State Sync) │
└───────────────────────┘ └───────────────────────┘🚀 콕핏 및 테스트 실행
빠른 시작
# 1. Install dependencies
bun install
# 2. Run test suite (7 tests, 27 assertions)
bun test
# 3. Start development server
bun run dev실시간 배포
대화형 시뮬레이션 콕핏: https://merchant-web-mcp.web.app
독립형 프로젝터 데모(단일 파일 HTML): https://merchant-web-mcp.web.app/demos/merchant-web-mcp-demo-v2.html
🛡️ 이 저장소의 보안 및 무결성 주요 사항
실제 Web Crypto HMAC-SHA256: 표준
crypto.subtle를 사용하여src/mcp/cryptoAuth.ts에 구현되었습니다. 서명은 체크아웃 세션 생성 시 암호화 방식으로 검증됩니다.활성 TTL 재고 만료:
src/mcp/merchantMcpEngine.ts에 구현되었습니다. 임시 예약은 900초(15분) 후 만료되어 재고를 자동으로 사용 가능한 재고로 반환하고 클라이언트 와이어 HUD에 알립니다.계층형 심층 방어:
src/mcp/securityGuard.ts에 구현되었습니다. 유니코드/제로 폭 난독화를 정규화하고 고객 리뷰, 검색 쿼리, 프로모션 인수를 검사합니다.다중 카트 격리: 엔진은
cart_id로 카트를 명시적으로 매핑하여 잘못되거나 외부 카트 세션에 대한 체크아웃 시도를 거부합니다.
🗺️ 로드맵 및 프로덕션 사양
대상 Cloudflare Worker + BigCommerce 엣지 서버 사양은 ROADMAP.md를 참조하세요.
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to perform e-commerce operations through a standardized interface implementing the x402 and Agentic Commerce Protocol (ACP). Supports merchant sessions, product search, and payment orchestration with production-ready security features.
- AlicenseAqualityFmaintenanceEnables AI agents to autonomously browse inventory, negotiate terms, manage carts, and execute secure payments on Shopify stores using standardized protocols. It provides a bridge for LLMs to handle the entire commerce lifecycle from discovery to order tracking through a verifiable mandate chain.52MIT
- FlicenseNot gradedqualityBmaintenanceEnables AI agents to discover products, build carts, and complete purchases across multiple downstream commerce services through a secure, contract-driven API.
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to browse product catalogs, search products with filters, and initiate checkouts, generating order summaries and checkout URLs.
Related MCP Connectors
Commission infrastructure for AI commerce — program discovery, attribution, and settlement.
Agent-native commerce with trusted catalog, durable carts, and Stripe Checkout via MCP and UCP.
Agent-native product catalog for AI shopping agents. 296M+ products, 28 countries.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Redser06/merchant-web-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server