Merchant Web MCP
Merchant Web MCP — エージェント分析・運用性プロトタイプ
あらゆるeコマースストアを、AIショッピングエージェントにとって観測可能・測定可能・取引可能なプラットフォームへと変えます。
[!NOTE] プロトタイプ&シミュレーションに関するお知らせ: このリポジトリには、提案中のBigCommerce / Merchant Web MCPプラグインアーキテクチャのインタラクティブなシミュレーションコックピットとプロトタイプが含まれています。シミュレーションエンジンはクライアントサイドで動作し、シミュレートされたレイテンシ、本物のWeb Crypto HMAC-SHA256署名、実際の15分TTL在庫予約タイマー、そしてエグゼクティブ向けのエージェント意図分析ダッシュボードを備えています。
🎯 中核となる課題と価値提案
短期的な現実:エージェントトラフィックへの盲点
現在、マーチャントはAIショッピングエージェント(ChatGPT Agent、Claude、Perplexity、Apple Intelligence)に対して盲目です。ボットが商品ページをスクレイピングするとき:
トラフィックは単純なWebスクレイパーと区別がつきません。
ビジュアルスクレイピングは1ページあたり6,000〜10,000トークンを消費し、Reactのハイドレーションや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)を公開します。暗号学的に検証されたハンドオフ: 本物のWeb Crypto HMAC-SHA256トークンを使用して、15分間の一時的在庫ソフトロックを伴う署名済みチェックアウト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に通知します。多層防御(Defense-in-Depth):
src/mcp/securityGuard.tsに実装されています。Unicode/ゼロ幅文字による難読化を正規化し、カスタマーレビュー、検索クエリ、プロモーション引数を横断してスキャンします。マルチカート分離: エンジンはカートを
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