Shopify MCP Server for Claude Desktop

Claude Desktop 向け Shopify MCP サーバー

これは、Shopify ストアのデータを Claude Desktop に接続し、Claude がストア情報にアクセスできるようにするシンプルな Model Context Protocol（MCP）サーバーです。

セットアップ

1. 依存関係をインストールします：

   npm install
   

2. Shopify の認証情報を含む .env ファイルを作成します：

   SHOPIFY_STORE_NAME=your-store-name
   SHOPIFY_API_ACCESS_TOKEN=your-access-token
   

3. TypeScript コードをビルドします：

   npm run build
   

4. MCP サーバーを実行します：

   npm start
   

5. Claude Desktop で、このサーバーを指すように MCP サーバーを設定します。これで Shopify のデータにアクセスできるようになります。

機能

このサーバーでは、MCP ツールを通じて以下の Shopify 機能を利用できます。

商品ツール

• create_product：このツールは、オプション（例：色、サイズ）を含む商品構造を下書き（DRAFT）ステータスで作成します。商品名、説明、販売元、商品タイプ、タグ、オプションの設定を処理しますが、価格を設定したバリエーションは作成しません。商品作成の最初のステップとして使用します。

• browse_products：このツールは、在庫情報を任意で含めて商品一覧を取得します。ページネーションに対応しており、商品名、説明、画像、バリエーション、在庫レベルなど、主要な商品情報を提供します。特定の product_id を指定すると、その商品の詳細情報を返します。

• update_variant_price：このツールは、特定の商品バリエーションの価格や比較価格を更新します。通常価格の設定、比較価格の追加・更新、または null もしくは空文字列を渡して比較価格を削除できます。

在庫ツール

• list_inventory_items：このツールは、SKU による任意の絞り込みに対応した在庫アイテム一覧を取得します。ページネーションに対応しており、在庫数、原価、商品を保管しているロケーションなどの在庫情報を提供します。

• get_inventory_item：このツールは、ID または SKU を指定して、特定の在庫アイテムの詳細情報を取得します。追跡状態、すべてのロケーションの在庫数、関連するバリエーション情報など、包括的な在庫データを返します。

• update_inventory_quantity：このツールは、特定のロケーションにおける在庫アイテムの在庫数を更新します。在庫アイテム ID、ロケーション ID、新しい在庫数を指定すると、調整後の在庫レベルを返します。

注文ツール

• browse_orders：このツールは、強力な絞り込みオプションを使用して Shopify の注文を取得します。ステータス、日付範囲、顧客のメールアドレス、決済ステータス、フルフィルメントステータスによる絞り込みに対応しており、注文番号や顧客情報による検索も可能です。特定の order_id を指定すると、その注文の詳細情報を返します。

顧客ツール

• browse_customers：このツールは、購入金額データと高度な絞り込みオプションを含む顧客情報を取得します。複数のフィールドによる並べ替え、最低・最高購入金額による絞り込みに対応しており、詳細な顧客プロフィールを返します。特定の customer_id を指定すると、その顧客の包括的な情報を返します。

メディアツール

• upload_image_from_url：このツールは、公開 URL から Shopify CDN の Files セクションに画像をアップロードします。画像データを Shopify のサーバーに転送し、アップロードする画像の代替テキストと任意のファイル名を指定できます。

放棄ツール

• get_abandonment：このツールは、ID を指定してカートまたはチェックアウトの放棄に関する詳細情報を取得します。放棄されたカートの商品、価格、顧客情報（利用可能な場合）、放棄されたタイミングなどのデータを返します。レスポンスに含めるフィールドをカスタマイズできます。

GraphQL ツール

• query_shopify：このツールは、Shopify Admin API に対してカスタム GraphQL クエリまたはミューテーションを実行します。専用ツールでは対応していない Shopify Admin API のエンドポイントにも柔軟にアクセスでき、変数の受け渡しやミューテーション操作の有効化が可能です。

• introspect_admin_schema：このツールは、ユーザーのプロンプトに関連する Shopify Admin API GraphQL スキーマの一部をイントロスペクションして返します。Shopify Admin API にのみ使用し、Shopify Storefront API や Shopify Functions API など、ほかの API には使用しないでください。名前でスキーマ要素を絞り込む検索語を指定でき、型、クエリ、ミューテーションなど、特定のセクションに焦点を当てるオプションも用意されています。

ライセンス

MIT