Shopify Storefront MCP Server

🚀 Shopify店舗ガイド

このガイドでは、MCP（マルチチャネルプラットフォーム）サーバーを利用してShopify店舗とやり取りする方法を詳細に説明します。主な内容は、機能の概要、設定の説明、環境変数の設定、Storefront APIトークンの生成手順、使用例、顧客リソース管理、およびデータのプライバシーと保存策略です。

✨ 主な機能

• 商品情報の照会：すべての商品とその詳細情報を取得します。
• ショッピングカートの管理：ショッピングカート内の商品を追加、変更、削除します。
• 注文操作：新しい注文を作成するか、既存の注文の状態を確認します。
• 在庫同期：ローカルの在庫をShopify店舗の在庫と一致させます。
• 価格ルールの適用：セールイベントや価格設定戦略を適用します。

📦 インストール

依存関係のインストール

必要なパッケージをインストールするには、以下のコマンドを使用します。

npm install shopify-api

環境変数の設定

.envファイルを編集し、以下の設定を追加します。

SHOPIFY_STORE_NAME=your-store.myshopify.com
SHOPIFY_API_KEY=your_api_key
SHOPIFY_API_SECRET=your_api_secret

データベースの初期化

以下のコマンドを実行して、ローカルのデータベーステーブルを作成します。

npx knex migrate:latest

💻 使用例

商品情報の照会

以下のGraphQLクエリを使用して、すべての商品を取得します。

query {
  products(first: 10) {
    edges {
      node {
        id
        title
        description
        price
      }
    }
  }
}

ショッピングカートの作成

以下のREST APIを呼び出して、新しいショッピングカートを作成します。

POST /api/2025-04/graphql.json
{
  "query": "mutation createCart($lines: [CartLineInput!]!) {
    cartCreate(input: { lines: $lines }) {
      cart {
        id
        checkoutUrl
      }
      userErrors {
        field
        message
      }
    }
  }",
  "variables": {
    "lines": [
      {
        "merchandiseId": "gid://shopify/ProductVariant/12345678901234",
        "quantity": 1
      }
    ]
  }
}

クーポンの適用

以下のミューテーションを使用して、指定されたクーポンを適用します。

mutation applyCoupon($cartId: ID!, $couponCode: String!) {
  cartUpdate(id: $cartId, updates: { couponCode: $couponCode }) {
    cart {
      id
      totalAmount
    }
    userErrors {
      field
      message
    }
  }
}

📚 顧客リソース管理

データ構造

顧客データはdb/customers.jsonファイルに保存され、以下のフィールドを含みます。

• id: 一意の識別子
• firstName: 名
• lastName: 姓
• email: メールアドレス
• address: 配送先住所

データ操作

新しい顧客の追加

const newCustomer = {
  id: generateUUID(),
  firstName: "John",
  lastName: "Doe",
  email: "john.doe@example.com",
  address: "123 Main St, City"
};
db.customers.push(newCustomer);

既存の顧客の更新

const customer = db.customers.find(c => c.id === customerId);
if (customer) {
  customer.firstName = "Jane";
  customer.lastName = "Smith";
}

📚 データのプライバシーと保存

ファイル管理

• データファイル：db/customers.json
• サンプルファイル：db/customers.json.exampleは、架空の顧客データを含むテンプレートを提供します。

セキュリティ対策

1. .envやdb/customers.jsonなどの機密ファイルをバージョン管理システムにコミットしないでください。
2. 顧客の個人情報を保護するために、暗号化技術を使用します。
3. データの損失を防ぐために、定期的にデータベースをバックアップします。

📚 トラブルシューティング

問題：Shopify店舗に接続できない

解決策：

1. ネットワーク接続が正常であることを確認します。
2. APIキーとシークレットが正しいことを確認します。
3. 詳細なヘルプを得るには、Shopifyの開発者ドキュメントを参照します。

問題：ショッピングカートの作成に失敗しました

解決策：

1. 渡されたパラメータが要件を満たしていることを検証します。
2. 商品が存在し、在庫が十分であることを確認します。
3. 詳細なエラー情報を取得するには、ログファイルを確認します。

📚 まとめ

このガイドでは、Shopify店舗とのやり取りの基本的な方法を提供し、データの照会から顧客管理までのさまざまな側面をカバーしています。これらの手順とベストプラクティスに従うことで、Shopify店舗を効果的に統合および管理することができます。