shopify-mcp

Shopify MCPサーバー

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

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

特徴

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

前提条件

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

設定

Shopify���クセストークン

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

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

Claude Desktopでの使用

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

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

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

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

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

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

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

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

次にそれを実行します:

利用可能なツール

製品管理

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

顧客管理

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

注文管理

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

デバッグ

問題が発生した場合は、Claude Desktop の MCP ログを確認してください。

ライセンス

マサチューセッツ工科大学