Shopify

🚀 Shopify MCP サーバー

Shopify MCP サーバーは、Model Context Protocol (MCP) に基づくツールで、Shopify ストアとのインタラクションに使用されます。一連の GraphQL API インターフェースを提供し、開発者が商品、顧客、注文などのデータを簡単に管理できるようにします。

🚀 クイックスタート

Shopify アクセストークン

このサーバーを使用するには、以下の手順でカスタムアプリを作成し、アクセストークンを取得してください。

1. Shopify 管理画面にログインします。
2. 設定 > アプリと販売チャネルに移動します。
3. 開発アプリをクリックします（開発者プレビューを有効にする必要がある場合があります）。
4. 新しいアプリを作成し、「Shopify MCP サーバー」または覚えやすい名前を付けます。
5. Admin API の権限範囲を設定します。
   • 商品の読み取りと書き込み (read_products, write_products)
   • 顧客の読み取りと書き込み (read_customers, write_customers)
   • 注文の読み取りと書き込み (read_orders, write_orders)
6. アプリをインストールし、Admin API アクセストークンを取得します。

⚠️ 重要提示

アクセストークンは適切に保管し、漏洩やバージョン管理システムへの誤送信を避けてください。

✨ 主な機能

• 強力な GraphQL サポート：GraphQL リクエストを通じて直接 Shopify データを操作できます。
• 柔軟な MCP プロトコル：MCP のコンテキストモデルプロトコルを利用して、効率的なデータ交換を実現します。
• 多様なシナリオ対応：商品管理、顧客関係維持、注文処理など、さまざまなビジネスシナリオに対応しています。

📦 インストール

プロジェクト構造

1. リポジトリをクローンします。

git clone https://github.com/your-username/shopify-mcp-server.git
cd shopify-mcp-server

2. 依存関係をインストールします。

npm install

3. .env ファイルを作成します。

SHOPIFY_ACCESS_TOKEN=<あなたのアクセストークン>
MYSHOPIFY_DOMAIN=<your-store>.myshopify.com

4. 開発サーバーを起動します。

npm start

依存関係

• graphql：GraphQL クライアントライブラリ。
• axios：HTTP リクエストライブラリ。
• dotenv：環境変数の読み込みツール。

💻 使用例

基本的な使用法

Claude Desktop でこのサーバーを使用するには、以下の手順に従ってください。

1. claude_desktop_config.json ファイルを作成または編集します。
2. 以下の設定を追加します。

{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": ["-y", "shopify-mcp-server"],
      "env": {
        "SHOPIFY_ACCESS_TOKEN": "<あなたのアクセストークン>",
        "MYSHOPIFY_DOMAIN": "<your-store>.myshopify.com"
      }
    }
  }
}

3. サーバーを起動し、関連ツールの使用を開始します。

📚 ドキュメント

ツールリスト

以下は、サーバーが提供する主なツールです。

商品管理

1. get-products：指定された条件の商品情報を取得します。
2. create-product：新しい商品を作成します。
3. update-product：既存の商品の詳細情報を更新します。
4. delete-product：指定された商品を削除します。

顧客管理

5. get-customers：すべての顧客情報をリストします。
6. create-customer：新しい顧客を追加します。
7. update-customer：顧客のプロファイルを変更します。
8. delete-customer：指定された顧客を削除します。

注文処理

9. get-orders：注文リストを取得します。
10. create-order：新しい注文を生成します。
11. update-order：注文の状態または情報を更新します。
12. cancel-order：未処理の注文をキャンセルします。

その他の機能

13. get-collections：商品コレクションの情報を取得します。
14. manage-webhook：webhook イベントの購読、検索、またはキャンセルを行います。
15. get-shop：ストアの基本情報を取得します。
16. get-shop-details：ストアの詳細設定（利用可能な配送国など）を取得します。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。詳細は LICENSE ファイルを参照してください。

コミュニティとサポート

• GitHub リポジトリ：https://github.com/your-username/shopify-mcp-server
• 問題フィードバック：Issues でバグを報告したり、機能要求を提出したりすることができます。
• ドキュメント貢献：プロジェクトのドキュメントに貢献することを歓迎します。

リンク

• Shopify 開発ドキュメント
• Model Context Protocol (MCP)