Estroni Storefront

Estroni Storefront — MCP サーバー

Estroni のストアフロント向け、読み取り専用のModel Context Protocolサーバーです。オーストラリア産メリノウールと低毒性素材を使用した、女性向けアクティブウェアを扱います。

AI エージェント（Claude、ChatGPT、Cursor、Copilot など）が商品カタログを検索し、商品詳細を取得し、コレクションを一覧表示して、配送・返品ポリシーを確認できます。エージェント主導の商品発見と調査を目的として構築されており、チェックアウトには対応していません。ポリシーにより、Estroni のチェックアウトは人間のみが行うフローとして維持されています。

• レジストリ名： io.github.estroni/storefront
• トランスポート： Streamable HTTP（MCP プロトコル 2025-06-18）
• エンドポイント： https://mcp.estroni.com.au/mcp
• ランタイム： Cloudflare Workers
• ソース： github.com/estroni/storefront-mcp

---

ツール

ツール	返される内容
search_products	キーワード検索に一致する最大10件の商品概要（タイトル、価格（AUD）、画像、在庫状況、URL）
get_product	URL ハンドルで指定した商品の詳細情報（バリエーション、価格、SKU、説明の HTML、画像）
list_collections	公開中のすべてのコレクション（タイトル、ハンドル、URL、商品数）
get_policies	配送／返金／プライバシー／利用規約の URL と、ボット／エージェント向けポリシーの文面

4つのツールはすべて読み取り専用です。Shopify の公開ストアフロント JSON エンドポイントをラップしており、呼び出し元のエージェントによる認証は不要です。

---

インストール

Claude Desktop / Cursor / Claude Code

MCP 設定に追加します（macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json、Cursor の場合は mcp.json）。

{
  "mcpServers": {
    "estroni-storefront": {
      "url": "https://mcp.estroni.com.au/mcp"
    }
  }
}

クライアントを再起動します。4つのツールが estroni-storefront サーバーの下に表示されます。

ChatGPT / Anthropic Claude.ai（カスタムコネクター）

設定 → コネクター → カスタムコネクターを追加 → https://mcp.estroni.com.au/mcp を貼り付けます。

ターミナルからテスト

# initialize
curl -sS https://mcp.estroni.com.au/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

# list tools
curl -sS https://mcp.estroni.com.au/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# call search_products
curl -sS https://mcp.estroni.com.au/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search_products","arguments":{"query":"merino"}}}'

---

エージェントのプロンプト例

「Estroni で150 AUD 未満の長袖メリノウールベースレイヤーを探してください。」 → search_products({query: "merino long sleeve base layer"}) を呼び出し、絞り込み、要約します。

「Estroni の返品期間はどのくらいですか？」 → get_policies() を呼び出し、返金ポリシーの URL と1行の要約を提示します。

「『Merino activewear』コレクションのうち、在庫がある商品をすべて表示してください。」 → list_collections() → ハンドルごとに get_product() → variants[].available で絞り込みます。

---

ボットおよびエージェント向けポリシー

Estroni は、商品カタログの検索、商品調査、ポリシーの取得を目的とした読み取り専用のエージェントアクセスを歓迎します。

最終的な人間による確認手順を経ずに支払いを完了する、エンドツーエンドの「代わりに購入する」エージェントは、Estroni.com.au では許可されていません。

購入を勧めるエージェントは、チェックアウトに進む前に、人間が確認できるよう配送ポリシーと返金ポリシーの URL（get_policies が返すもの）を提示する必要があります。

関連項目：estroni.com.au/robots.txt — Content-Signal: search=yes, ai-input=no, ai-train=no。

---

開発

git clone https://github.com/estroni/storefront-mcp.git
cd storefront-mcp
npm install
npm run dev          # wrangler dev — local Worker on http://localhost:8787
npm run typecheck    # tsc --noEmit
npm run deploy       # wrangler deploy → estroni-mcp.workers.dev

MCP ワイヤープロトコルは手作業で実装しています（公式の @modelcontextprotocol/sdk が提供するトランスポートは Node 専用のため、Workers では独自の実装が必要です）。実装は意図的に最小限に抑えており、src/index.ts の約300行で構成されています。

---

ライセンス

MIT — LICENSE を参照してください。

Estroni が開発 · お問い合わせ：[email protected]