Shopify MCPサーバー

（よろしければ星を付けてください！）

Shopify API用のMCPサーバー。GraphQL APIを介してストアデータとのやり取りを可能にします。このサーバーは、商品、顧客、注文などを管理するためのツールを提供します。

特徴

製品管理: 製品情報の検索と取得
顧客管理: 顧客データを読み込み、顧客タグを管理する
注文管理：高度な注文照会とフィルタリング
GraphQL 統合: Shopify の GraphQL 管理 API との直接統合
包括的なエラー処理: APIおよび認証の問題に関する明確なエラーメッセージ

Related MCP server: Shopify MCP Server

前提条件

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

設定

Shopifyアクセストークン

この MCP サーバーを使用するには、Shopify ストアでカスタムアプリを作成する必要があります。

Shopify管理画面から、 「設定」 > **「アプリと販売チャネル」**に移動します。
**「アプリを開発」**をクリックします（最初に開発者プレビューを有効にする必要がある場合があります）
「アプリを作成」をクリック
アプリの名前を設定します（例：「Shopify MCP Server」）
管理APIスコープの設定をクリックします
次のスコープを選択します。
- read_products 、 write_products
- read_customers 、 write_customers
- read_orders 、 write_orders
保存をクリック
アプリをインストールをクリック
インストールをクリックすると、アプリがストアデータにアクセスできるようになります
インストール後、管理APIアクセストークンが表示されます。
このトークンをコピーしてください - 設定に必要になります

Claude Desktopでの使用

これをclaude_desktop_config.jsonに追加します:

{ "mcpServers": { "shopify": { "command": "npx", "args": [ "shopify-mcp", "--accessToken", "<YOUR_ACCESS_TOKEN>", "--domain", "<YOUR_SHOP>.myshopify.com" ] } } }

Claude Desktop 構成ファイルの場所:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

代替案: 環境変数を使ってローカルで実行する

コマンドライン引数の代わりに環境変数を使用する場合:

Shopify の資格情報を使用して.envファイルを作成します。
SHOPIFY_ACCESS_TOKEN=your_access_token MYSHOPIFY_DOMAIN=your-store.myshopify.com
npx を使用してサーバーを実行します。
npx shopify-mcp-server

直接インストール（オプション）

パッケージをグローバルにインストールする場合:

npm install -g shopify-mcp-server

次にそれを実行します:

shopify-mcp-server --accessToken=<YOUR_ACCESS_TOKEN> --domain=<YOUR_SHOP>.myshopify.com

利用可能なツール

製品管理

get-products
- すべての製品を取得するか、タイトルで検索してください
- 入力:
  - searchTitle (オプションの文字列): タイトルで製品をフィルタリングします
  - limit (数値): 返される商品の最大数
get-product-by-id
- IDで特定の商品を取得する
- 入力:
  - productId (文字列): 取得する製品のID

顧客管理

get-customers
- 顧客を獲得するか、名前/メールアドレスで検索する
- 入力:
  - searchQuery （オプションの文字列）：名前またはメールアドレスで顧客をフィルタリングします
  - limit （オプションの数値、デフォルト：10）：返される顧客の最大数
update-customer
- 顧客情報を更新する
- 入力:
  - id (文字列、必須): Shopify顧客ID（数値IDのみ、例: "6276879810626")
  - firstName (文字列、オプション): 顧客の名
  - lastName (文字列、オプション): 顧客の姓
  - email (文字列、オプション): 顧客のメールアドレス
  - phone （文字列、オプション）: 顧客の電話番号
  - tags (文字列の配列、オプション): 顧客に適用するタグ
  - note （文字列、オプション）: 顧客に関するメモ
  - taxExempt （ブール値、オプション）：顧客が税金を免除されているかどうか
  - metafields （オブジェクトの配列、オプション）：追加データを保存するための顧客メタフィールド
get-customer-orders
- 特定の顧客の注文を取得する
- 入力:
  - customerId (文字列、必須): Shopify 顧客 ID (数値 ID のみ、例: "6276879810626")
  - limit （オプションの数値、デフォルト：10）：返される注文の最大数

注文管理

get-orders
- オプションのフィルタリングで注文を取得する
- 入力:
  - status （オプションの文字列）: 注文ステータスでフィルタリング
  - limit （オプションの数値、デフォルト：10）：返される注文の最大数
get-order-by-id
- IDで特定の注文を取得する
- 入力:
  - orderId （文字列、必須）: Shopifyの完全な注文ID（例："gid://shopify/Order/6090960994370"）
update-order
- 既存の注文を新しい情報で更新する
- 入力:
  - id (文字列、必須): Shopify注文ID
  - tags (文字列の配列、オプション): 注文の新しいタグ
  - email (文字列、オプション): 顧客のメールアドレスを更新する
  - note (文字列、オプション): 注文メモ
  - customAttributes （オブジェクトの配列、オプション）: 注文のカスタム属性
  - metafields （オブジェクトの配列、オプション）：メタフィールドの順序
  - shippingAddress (オブジェクト、オプション): 配送先住所情報