Shopify MCP

🚀 Shopify MCP サーバー

Shopify API の MCP サーバーで、GraphQL API を通じてショップデータのやり取りを実現します。このサーバーは商品、顧客、注文などの管理機能を提供します。

(もし気に入ったらスターをつけてください！)

🚀 クイックスタート

Shopify API の MCP サーバーで、GraphQL API を通じてショップデータのやり取りを実現します。このサーバーは商品、顧客、注文などの管理機能を提供します。

✨ 主な機能

• 商品管理：商品情報の検索と取得
• 顧客管理：顧客データの読み込みと顧客タグの管理
• 注文管理：高度なクエリとフィルタリング機能
• GraphQL 統合：Shopify の GraphQL 管理 API を直接統合
• 完全なエラー処理：API と認証問題に対する明確なエラーメッセージ

📦 インストール

前提条件

1. Node.js (バージョン 16 以上)
2. Shopify カスタムアプリのアクセストークン（下記の設定を参照）

設定

カスタムアプリを作成してアクセストークンを取得する

この MCP サーバーを使用するには、Shopify 管理画面でカスタムアプリを作成し、アクセストークンを取得する必要があります。

手順は以下の通りです：

1. Shopify 管理者パネルにログインします。
2. アプリケーション > カスタムアプリに移動します。
3. 新しいアプリをクリックします。
4. アプリ情報を入力します。名前とコールバック URL（例：http://localhost:8080）を含みます。
5. アプリを保存した後、アプリ詳細ページにアクセスしてアクセストークンを取得します。

このアクセストークンは、MCP サーバーを構成する際に必要な資格情報として使用します。

Claude Desktop を使用した構成

Claude Desktop では、以下の JSON 構成を使用します：

{
  "name": "Shopify MCP Server",
  "type": "process",
  "command": "npx",
  "args": [
    "shopify-mcp-server",
    "--apiKey",
    "<あなたの API キー>",
    "--apiSecretKey",
    "<あなたの API シークレットキー>",
    "--host",
    "localhost",
    "--port",
    "8080"
  ],
  "stdout": {
    "filePath": "/var/log/claude/shopify-mcp-server.stdout.log",
    "maxSize": 1024,
    "numFiles": 3
  },
  "stderr": {
    "filePath": "/var/log/claude/shopify-mcp-server.stderr.log",
    "maxSize": 1024,
    "numFiles": 3
  }
}

<あなたの API キー> と <あなたの API シークレットキー> を、実際の Shopify アプリの資格情報に置き換えてください。

環境変数を使用する

以下の環境変数を設定することで、MCP サーバーを構成することもできます：

• SHOPFY_API_KEY：API アクセストークン
• SHOPFY_API_SECRET_KEY：API キー
• MCP_HOST：デフォルトは localhost
• MCP_PORT：デフォルトは 8080

直接インストール

必要に応じて、このサーバーを直接インストールすることができます：

npm install -g shopify-mcp-server

その後、以下のコマンドで実行します：

shopify-mcp-server --apiKey=<あなたの API キー> --apiSecretKey=<あなたの API シークレットキー>

💻 使用例

基本的な使用法

商品管理

1. get-products：商品リストを取得

{
  "status": "active" // オプション：ステータスでフィルタリング、デフォルトではすべての商品を返す
}

2. get-product-by-id：ID で単一の商品を取得
3. update-product：商品情報を更新

顧客管理

1. get-customers：顧客リストを取得
2. get-customer-by-id：ID で顧客の詳細情報を取得
3. create-customer：新しい顧客を作成

{
  "email": "test@example.com",
  "first_name": "John",
  "last_name": "Doe"
}

4. update-customer：顧客情報を更新
5. delete-customer：顧客を削除

注文管理

1. get-orders：注文リストを取得
2. get-order-by-id：ID で注文の詳細情報を取得
3. create-order：新しい注文を作成
4. update-order：注文情報を更新

🔧 デバッグ

デバッグが必要な場合は、Claude Desktop の MCP ログを確認してください：

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

📄 ライセンス

MIT