Wonderkraftz Premium Gifting Studio

Wonderkraftz MCP サーバー

AI アシスタントを Wonderkraftz のプレミアムギフトスタジオに接続する MCP（Model Context Protocol）サーバーです。商品を閲覧したり、パーソナライズされたギフトをおすすめしてもらったり、カートを管理したり、購入手続きを完了したりできます。すべて、AI アシスタントとの自然言語でのやり取りを通じて行えます。

機能

• 商品検索 — キーワード、用途、ギフトの種類でカタログを検索します
• 商品詳細 — バリエーション、価格、画像を含む商品の詳細情報を取得します
• コレクション — 厳選されたギフトコレクション（法人向けギフト、ウェディングハンパーなど）を閲覧します
• おすすめ — 気に入った商品に基づいて、商品をおすすめします
• カート管理 — カートを作成し、商品を追加、更新、削除します
• 購入手続き — ブラウザーで購入を完了するためのチェックアウト URL を取得します
• ストアポリシー — 配送、返品、プライバシーポリシーを確認します

クイックスタート

オプション 1：npx（インストール不要）

SHOPIFY_STORE_DOMAIN=64cd5c-2.myshopify.com \
SHOPIFY_STOREFRONT_ACCESS_TOKEN=aeeec5ab77309d1c339d2971f56b6506 \
npx wonderkraftz-mcp

オプション 2：グローバルにインストール

npm install -g wonderkraftz-mcp

セットアップ

Cursor IDE

プロジェクトの .cursor/mcp.json に追加します。

{
  "mcpServers": {
    "wonderkraftz": {
      "command": "npx",
      "args": ["-y", "wonderkraftz-mcp"],
      "env": {
        "SHOPIFY_STORE_DOMAIN": "64cd5c-2.myshopify.com",
        "SHOPIFY_STOREFRONT_ACCESS_TOKEN": "aeeec5ab77309d1c339d2971f56b6506"
      }
    }
  }
}

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "wonderkraftz": {
      "command": "npx",
      "args": ["-y", "wonderkraftz-mcp"],
      "env": {
        "SHOPIFY_STORE_DOMAIN": "64cd5c-2.myshopify.com",
        "SHOPIFY_STOREFRONT_ACCESS_TOKEN": "aeeec5ab77309d1c339d2971f56b6506"
      }
    }
  }
}

ChatGPT / Grok / リモート AI ツール

ホスト型 HTTP エンドポイントを使用します。インストールは不要です。

https://wonderkraftz-mcp.onrender.com/mcp

MCP クライアントをこの URL に接続してください。Streamable HTTP トランスポートに対応しています。

セルフホスト型 HTTP（任意）

HTTP トランスポートを自分で実行するには、次のようにします。

SHOPIFY_STORE_DOMAIN=64cd5c-2.myshopify.com \
SHOPIFY_STOREFRONT_ACCESS_TOKEN=aeeec5ab77309d1c339d2971f56b6506 \
npx wonderkraftz-mcp-http

サーバーは http://localhost:3000/mcp で起動します（または PORT 環境変数を設定してください）。

トランスポート

トランスポート	エントリーポイント	用途
stdio	wonderkraftz-mcp	Cursor、Claude Desktop、ローカル AI ツール
Streamable HTTP	wonderkraftz-mcp-http	ChatGPT、Grok、リモート／クラウド AI ツール

環境変数

変数	説明	必須
SHOPIFY_STORE_DOMAIN	Shopify ストアのドメイン（例：your-store.myshopify.com）	はい
SHOPIFY_STOREFRONT_ACCESS_TOKEN	公開 Storefront API アクセストークン	はい
PORT	HTTP サーバーのポート（デフォルト：3000、HTTP トランスポートのみ）	いいえ

利用可能なツール

ツール	説明
search_products	キーワードで商品カタログを検索します
get_product_details	ハンドルまたは ID で商品の詳細情報を取得します
get_collections	すべての商品コレクションを一覧表示します
get_collection_products	特定のコレクションの商品を閲覧します
get_recommendations	商品に基づいておすすめの商品を取得します
create_cart	商品を含む新しいショッピングカートを作成します
add_to_cart	既存のカートに商品を追加します
update_cart	カート内の商品の数量を更新します
remove_from_cart	カートから商品を削除します
get_cart	カートの内容と合計金額を確認します
get_checkout_url	購入を完了するためのチェックアウト URL を取得します
get_store_policies	ストアの配送、返品、プライバシーポリシーを確認します

利用可能なリソース

URI	説明
wonderkraftz://store/info	ストア情報、ブランド、決済設定
wonderkraftz://collections	すべての商品コレクションの一覧

会話例

「2000 ルピー以下の法人向けギフトを見せてください」

「結婚祝いのギフトハンパーが必要です。おすすめはありますか？」

「高級ギフトボックスをカートに追加して、チェックアウトリンクを教えてください」

「返品ポリシーを教えてください」

開発

git clone https://github.com/rachit1987/wonderkraftz-mcp.git
cd wonderkraftz-mcp
npm install
cp .env.example .env  # Add your Shopify credentials
npm run build
npm start             # stdio transport
npm run start:http    # HTTP transport

ライセンス

MIT