MCPツールリファレンス

公式およびコミュニティサーバーのShopify MCPツールの完全リファレンスです。必要な操作をすぐに見つけられるよう、ドメイン別に整理しています。

ツールの利用可否

すべてのMCPサーバーですべてのツールが利用できるわけではありません。サーバー列は各ツールを提供するサーバーを示しています。サーバー固有の詳細についてはコミュニティMCPサーバーをご覧ください。

Dev = 公式Shopify Dev MCP
GeLi = shopify-mcp (GeLi2001)
Ajackus = @ajackus/shopify-mcp-server
Composio = Composio Shopify MCP

商品

`get_products`

オプションのフィルターを使用して商品一覧を取得します。

パラメータ	型	必須	説明
`limit`	number	いいえ	返す商品数（デフォルト：50、最大：250）
`title`	string	いいえ	商品タイトルでフィルター（部分一致）
`product_type`	string	いいえ	商品タイプでフィルター
`vendor`	string	いいえ	ベンダー名でフィルター
`status`	string	いいえ	ステータスでフィルター：`active`、`draft`、`archived`
`collection_id`	string	いいえ	コレクション所属でフィルター
`created_at_min`	string	いいえ	ISO 8601日付 -- この日付以降に作成された商品
`updated_at_min`	string	いいえ	ISO 8601日付 -- この日付以降に更新された商品
`cursor`	string	いいえ	次のページのページネーションカーソル

サーバー： GeLi、Ajackus、Composio

例：

ベンダー"Nike"の、過去7日間に更新されたすべてのアクティブな商品を取得

`get_product`

IDで単一の商品の詳細情報を取得します。

パラメータ	型	必須	説明
`product_id`	string	はい	Shopify商品GID（例：`gid://shopify/Product/123456`）
`fields`	string[]	いいえ	返す特定のフィールド

サーバー： GeLi、Ajackus、Composio

例：

商品 gid://shopify/Product/8234567890 の詳細情報を取得

`create_product`

オプションのバリアントとメディア付きで新しい商品を作成します。

パラメータ	型	必須	説明
`title`	string	はい	商品タイトル
`description`	string	いいえ	商品説明（HTMLサポート）
`product_type`	string	いいえ	カテゴリ分けのための商品タイプ
`vendor`	string	いいえ	ベンダー名
`tags`	string[]	いいえ	タグの配列
`status`	string	いいえ	`active`、`draft`、または`archived`（デフォルト：`draft`）
`variants`	object[]	いいえ	バリアントオブジェクトの配列
`variants[].title`	string	いいえ	バリアントタイトル
`variants[].price`	string	いいえ	バリアント価格
`variants[].sku`	string	いいえ	SKUコード
`variants[].inventory_quantity`	number	いいえ	初期在庫数
`variants[].option1`	string	いいえ	最初のオプション値（例："Small"）
`variants[].option2`	string	いいえ	2番目のオプション値（例："Red"）
`variants[].option3`	string	いいえ	3番目のオプション値
`options`	object[]	いいえ	商品オプション（例：Size、Color）
`metafields`	object[]	いいえ	商品メタフィールド
`images`	object[]	いいえ	添付する画像URL

サーバー： GeLi、Ajackus、Composio

例：

新しい下書き商品を作成：
- タイトル: "Organic Cotton T-Shirt"
- タイプ: "Apparel"
- ベンダー: "EcoWear"
- タグ: ["organic", "cotton", "sustainable"]
- オプション: Size (S, M, L, XL)、Color (White, Black, Navy)
- 基本価格: $29.99

`update_product`

既存の商品のフィールドを更新します。

パラメータ	型	必須	説明
`product_id`	string	はい	Shopify商品GID
`title`	string	いいえ	更新後のタイトル
`description`	string	いいえ	更新後の説明
`product_type`	string	いいえ	更新後の商品タイプ
`vendor`	string	いいえ	更新後のベンダー
`tags`	string[]	いいえ	更新後のタグ（既存のものを置換）
`status`	string	いいえ	更新後のステータス
`metafields`	object[]	いいえ	設定または更新するメタフィールド

サーバー： GeLi、Ajackus、Composio

`delete_product`

商品を完全に削除します。

パラメータ	型	必須	説明
`product_id`	string	はい	Shopify商品GID

サーバー： GeLi、Composio

破壊的操作

商品の削除は永久的で元に戻せません。AIアシスタントは実行前に必ず確認する必要があります。

`search_products`

商品カタログ全体をフルテキスト検索します。

パラメータ	型	必須	説明
`query`	string	はい	検索クエリ（タイトル、説明、SKU、タグを検索）
`limit`	number	いいえ	最大結果数（デフォルト：25）

サーバー： GeLi、Composio

`manage_product_media`

商品の画像や動画を追加、削除、並び替えします。

パラメータ	型	必須	説明
`product_id`	string	はい	Shopify商品GID
`action`	string	はい	`add`、`remove`、`reorder`
`media_urls`	string[]	いいえ	追加するメディアのURL
`media_ids`	string[]	いいえ	削除または並び替えるメディアGID

サーバー： GeLi

`manage_product_metafields`

商品メタフィールドを作成、更新、または削除します。

パラメータ	型	必須	説明
`product_id`	string	はい	Shopify商品GID
`metafields`	object[]	はい	メタフィールド操作の配列
`metafields[].namespace`	string	はい	メタフィールドの名前空間
`metafields[].key`	string	はい	メタフィールドのキー
`metafields[].value`	string	はい	メタフィールドの値
`metafields[].type`	string	はい	メタフィールドの型（`single_line_text_field`、`number_integer`、`json`など）

サーバー： GeLi、Composio

バリアント

`get_variants`

商品のバリアント一覧を取得します。

パラメータ	型	必須	説明
`product_id`	string	はい	Shopify商品GID

サーバー： GeLi、Ajackus、Composio

`update_variant`

バリアントの詳細（価格、SKU、重量など）を更新します。

パラメータ	型	必須	説明
`variant_id`	string	はい	ShopifyバリアントGID
`price`	string	いいえ	新しい価格
`compare_at_price`	string	いいえ	比較価格
`sku`	string	いいえ	SKUコード
`barcode`	string	いいえ	バーコード
`weight`	number	いいえ	重量値
`weight_unit`	string	いいえ	`kg`、`g`、`lb`、`oz`
`requires_shipping`	boolean	いいえ	バリアントが配送を必要とするかどうか
`taxable`	boolean	いいえ	バリアントが課税対象かどうか

サーバー： GeLi、Ajackus、Composio

注文

`get_orders`

フィルターオプション付きで注文を取得します。

パラメータ	型	必須	説明
`limit`	number	いいえ	注文数（デフォルト：50）
`status`	string	いいえ	`open`、`closed`、`cancelled`、`any`
`financial_status`	string	いいえ	`authorized`、`pending`、`paid`、`partially_paid`、`refunded`、`voided`
`fulfillment_status`	string	いいえ	`shipped`、`partial`、`unshipped`、`unfulfilled`
`created_at_min`	string	いいえ	ISO 8601日付
`created_at_max`	string	いいえ	ISO 8601日付
`customer_id`	string	いいえ	顧客でフィルター
`cursor`	string	いいえ	ページネーションカーソル

サーバー： GeLi、Ajackus、Composio

例：

過去24時間の未フルフィルメント・支払い済み注文をすべて取得

`get_order`

ラインアイテム、配送、決済を含む単一注文の詳細を取得します。

パラメータ	型	必須	説明
`order_id`	string	はい	Shopify注文GID

サーバー： GeLi、Ajackus、Composio

`create_draft_order`

手動処理用のドラフト注文を作成します。

パラメータ	型	必須	説明
`line_items`	object[]	はい	ラインアイテムの配列
`line_items[].variant_id`	string	はい	バリアントGID
`line_items[].quantity`	number	はい	数量
`customer`	object	いいえ	顧客情報
`shipping_address`	object	いいえ	配送先住所
`billing_address`	object	いいえ	請求先住所
`note`	string	いいえ	注文メモ
`tags`	string[]	いいえ	注文タグ
`discount`	object	いいえ	注文レベルのディスカウント

サーバー： GeLi、Composio

`fulfill_order`

注文のフルフィルメントを作成します。

パラメータ	型	必須	説明
`order_id`	string	はい	Shopify注文GID
`tracking_number`	string	いいえ	配送業者の追跡番号
`tracking_company`	string	いいえ	配送業者名
`tracking_url`	string	いいえ	追跡URL
`notify_customer`	boolean	いいえ	通知メールを送信（デフォルト：true）
`line_items`	object[]	いいえ	フルフィルメントする特定のラインアイテム（部分フルフィルメント）

サーバー： GeLi、Ajackus、Composio

`cancel_order`

未処理の注文をキャンセルします。

パラメータ	型	必須	説明
`order_id`	string	はい	Shopify注文GID
`reason`	string	いいえ	`customer`、`fraud`、`inventory`、`declined`、`other`
`refund`	boolean	いいえ	返金を行うかどうか
`restock`	boolean	いいえ	商品を在庫に戻すかどうか
`notify_customer`	boolean	いいえ	キャンセルメールを送信

サーバー： GeLi、Composio

`refund_order`

注文の返金を作成します。

パラメータ	型	必須	説明
`order_id`	string	はい	Shopify注文GID
`refund_line_items`	object[]	いいえ	返金する特定の商品
`shipping_refund`	object	いいえ	返金する配送金額
`note`	string	いいえ	返金理由
`notify_customer`	boolean	いいえ	返金通知を送信

サーバー： GeLi、Composio

顧客

`get_customers`

フィルター付きで顧客を取得します。

パラメータ	型	必須	説明
`limit`	number	いいえ	顧客数（デフォルト：50）
`query`	string	いいえ	検索クエリ（名前、メール、電話）
`created_at_min`	string	いいえ	ISO 8601日付
`tags`	string	いいえ	タグでフィルター
`cursor`	string	いいえ	ページネーションカーソル

サーバー： GeLi、Ajackus、Composio

`get_customer`

注文履歴付きで単一の顧客を取得します。

パラメータ	型	必須	説明
`customer_id`	string	はい	Shopify顧客GID

サーバー： GeLi、Ajackus、Composio

`create_customer`

新しい顧客レコードを作成します。

パラメータ	型	必須	説明
`first_name`	string	いいえ	名
`last_name`	string	いいえ	姓
`email`	string	いいえ	メールアドレス
`phone`	string	いいえ	電話番号
`tags`	string[]	いいえ	顧客タグ
`note`	string	いいえ	内部メモ
`addresses`	object[]	いいえ	顧客の住所
`metafields`	object[]	いいえ	顧客メタフィールド
`email_marketing_consent`	boolean	いいえ	メールマーケティングのオプトイン
`sms_marketing_consent`	boolean	いいえ	SMSマーケティングのオプトイン

サーバー： GeLi、Ajackus、Composio

`update_customer`

顧客情報を更新します。

パラメータ	型	必須	説明
`customer_id`	string	はい	Shopify顧客GID
`first_name`	string	いいえ	更新後の名
`last_name`	string	いいえ	更新後の姓
`email`	string	いいえ	更新後のメール
`phone`	string	いいえ	更新後の電話番号
`tags`	string[]	いいえ	更新後のタグ
`note`	string	いいえ	更新後のメモ

サーバー： GeLi、Ajackus、Composio

`search_customers`

さまざまな条件で顧客を検索します。

パラメータ	型	必須	説明
`query`	string	はい	検索語句
`limit`	number	いいえ	最大結果数

サーバー： GeLi、Composio

在庫

`get_inventory_levels`

ロケーション全体の在庫レベルを取得します。

パラメータ	型	必須	説明
`inventory_item_id`	string	いいえ	特定の在庫アイテムGID
`location_id`	string	いいえ	特定のロケーションGID
`product_id`	string	いいえ	商品のすべての在庫を取得

サーバー： GeLi、Ajackus、Composio

例：

商品 gid://shopify/Product/123 のすべてのバリアントの在庫レベルを
すべての倉庫ロケーションで表示

`adjust_inventory`

ロケーションでの在庫数量を調整します。

パラメータ	型	必須	説明
`inventory_item_id`	string	はい	在庫アイテムGID
`location_id`	string	はい	ロケーションGID
`adjustment`	number	はい	数量変更（正または負の値）
`reason`	string	いいえ	理由：`correction`、`received`、`damaged`、`shrinkage`、`promotion`

サーバー： GeLi、Ajackus、Composio

在庫調整

在庫調整は絶対値ではなく相対値です。-5の調整は現在の数量から5単位を削除します。大きな調整を行う前に現在のレベルを確認してください。

`set_inventory`

在庫を特定の数量に設定します（絶対値）。

パラメータ	型	必須	説明
`inventory_item_id`	string	はい	在庫アイテムGID
`location_id`	string	はい	ロケーションGID
`quantity`	number	はい	新しい数量
`reason`	string	いいえ	変更理由

サーバー： GeLi、Composio

`get_locations`

すべての在庫ロケーションを一覧表示します。

パラメータ	型	必須	説明
`active`	boolean	いいえ	アクティブ/非アクティブなロケーションをフィルター

サーバー： GeLi、Ajackus、Composio

`transfer_inventory`

ロケーション間で在庫を移動します。

パラメータ	型	必須	説明
`inventory_item_id`	string	はい	在庫アイテムGID
`from_location_id`	string	はい	移動元ロケーションGID
`to_location_id`	string	はい	移動先ロケーションGID
`quantity`	number	はい	移動する数量

サーバー： GeLi

コレクション

`get_collections`

コレクション（スマートおよびカスタム）を取得します。

パラメータ	型	必須	説明
`limit`	number	いいえ	コレクション数
`type`	string	いいえ	`smart`、`custom`、または`all`
`title`	string	いいえ	タイトルでフィルター

サーバー： GeLi、Composio

`create_collection`

新しいコレクションを作成します。

パラメータ	型	必須	説明
`title`	string	はい	コレクションタイトル
`description`	string	いいえ	コレクション説明（HTML）
`type`	string	はい	`smart`または`custom`
`rules`	object[]	いいえ	スマートコレクションルール（smartタイプの場合必須）
`rules[].column`	string	はい	ルール列：`title`、`type`、`vendor`、`tag`、`price`、`weight`、`variant_title`
`rules[].relation`	string	はい	`equals`、`not_equals`、`greater_than`、`less_than`、`starts_with`、`ends_with`、`contains`
`rules[].condition`	string	はい	ルール値
`disjunctive`	boolean	いいえ	`true` = いずれかのルールに一致、`false` = すべてのルールに一致
`sort_order`	string	いいえ	`alpha-asc`、`alpha-desc`、`best-selling`、`created`、`created-desc`、`manual`、`price-asc`、`price-desc`
`image`	string	いいえ	コレクション画像URL

サーバー： GeLi、Composio

例：

"Summer Sale"というスマートコレクションを作成。"summer"タグが付いた
価格$50未満のすべての商品を含み、ベストセラー順にソート

`add_products_to_collection`

カスタムコレクションに商品を追加します。

パラメータ	型	必須	説明
`collection_id`	string	はい	コレクションGID
`product_ids`	string[]	はい	追加する商品GIDの配列

サーバー： GeLi、Composio

`remove_products_from_collection`

カスタムコレクションから商品を削除します。

パラメータ	型	必須	説明
`collection_id`	string	はい	コレクションGID
`product_ids`	string[]	はい	削除する商品GIDの配列

サーバー： GeLi、Composio

ディスカウント

`get_discounts`

アクティブおよびスケジュール済みのディスカウントを一覧表示します。

パラメータ	型	必須	説明
`limit`	number	いいえ	ディスカウント数
`type`	string	いいえ	`code`、`automatic`、または`all`
`status`	string	いいえ	`active`、`expired`、`scheduled`

サーバー： GeLi、Composio

`create_discount_code`

コードベースのディスカウントを作成します。

パラメータ	型	必須	説明
`title`	string	はい	内部ディスカウントタイトル
`code`	string	はい	顧客が入力するディスカウントコード
`type`	string	はい	`percentage`、`fixed_amount`、`free_shipping`
`value`	number	はい	ディスカウント値（パーセンテージまたは金額）
`applies_to`	string	いいえ	`all_products`、`specific_collections`、`specific_products`
`collection_ids`	string[]	いいえ	コレクションGID（applies_toが`specific_collections`の場合）
`product_ids`	string[]	いいえ	商品GID（applies_toが`specific_products`の場合）
`minimum_requirement`	object	いいえ	最低購入金額または数量
`usage_limit`	number	いいえ	このディスカウントが使用できる合計回数
`once_per_customer`	boolean	いいえ	顧客あたり1回に制限
`starts_at`	string	いいえ	ISO 8601開始日
`ends_at`	string	いいえ	ISO 8601終了日

サーバー： GeLi、Composio

例：

ディスカウントコード"SPRING25"を作成。"Spring Collection"の全商品25%オフ、
最低購入額$50、500回使用に制限、2026年3月1日〜31日有効

`create_automatic_discount`

チェックアウト時に自動適用されるディスカウントを作成します。

パラメータ	型	必須	説明
`title`	string	はい	ディスカウントタイトル（顧客に表示）
`type`	string	はい	`percentage`、`fixed_amount`、`buy_x_get_y`、`free_shipping`
`value`	number	はい	ディスカウント値
`minimum_requirement`	object	いいえ	最低購入要件
`starts_at`	string	はい	ISO 8601開始日
`ends_at`	string	いいえ	ISO 8601終了日

サーバー： GeLi、Composio

`delete_discount`

ディスカウントを削除します。

パラメータ	型	必須	説明
`discount_id`	string	はい	ディスカウントGID

サーバー： GeLi、Composio

アナリティクス

`get_shop_info`

ストア情報と設定を取得します。

パラメータ	型	必須	説明
（なし）			完全なショップ詳細を返します

サーバー： GeLi、Ajackus、Composio

返される情報：ストア名、ドメイン、メール、通貨、タイムゾーン、プラン、機能など。

`get_order_count`

オプションの日付フィルター付きで注文数を取得します。

パラメータ	型	必須	説明
`status`	string	いいえ	`open`、`closed`、`cancelled`、`any`
`financial_status`	string	いいえ	支払いステータスフィルター
`fulfillment_status`	string	いいえ	フルフィルメントステータスフィルター
`created_at_min`	string	いいえ	ISO 8601日付
`created_at_max`	string	いいえ	ISO 8601日付

サーバー： GeLi、Composio

`get_sales_report`

日付範囲の売上アナリティクスを生成します。

パラメータ	型	必須	説明
`start_date`	string	はい	ISO 8601開始日
`end_date`	string	はい	ISO 8601終了日
`group_by`	string	いいえ	`day`、`week`、`month`

サーバー： Adzviser、ShopifyPy

`get_top_products`

収益または数量でベストセラー商品を取得します。

パラメータ	型	必須	説明
`start_date`	string	はい	ISO 8601開始日
`end_date`	string	はい	ISO 8601終了日
`limit`	number	いいえ	商品数（デフォルト：10）
`sort_by`	string	いいえ	`revenue`または`quantity`

サーバー： Adzviser、ShopifyPy

ドキュメントツール（公式Dev MCP）

以下のツールは公式Shopify Dev MCPサーバーでのみ利用可能です：

ツール	説明
`search_docs`	Shopify開発者ドキュメント全体のフルテキスト検索
`explore_api_schema`	Shopify GraphQL APIスキーマの閲覧と探索
`get_liquid_reference`	Liquidテンプレート言語リファレンスへのアクセス
`get_function_reference`	Shopify Functions APIリファレンスとスキャフォールディング
`validate_graphql`	Shopifyスキーマに対するGraphQLクエリのバリデーション

詳細なパラメータドキュメントは公式MCPサーバーページをご覧ください。

よくあるツールパターン

バルク操作

多くの操作をバルクワークフローに組み合わせることができます：

"clearance"タグのすべての商品を取得 → タグフィルター付きget_products
各商品の価格を50%削減 → update_variant（ループ）
商品を"Sale"コレクションに移動 → add_products_to_collection
"CLEARANCE50"ディスカウントコードを作成 → create_discount_code

監査ワークフロー

すべての商品を取得 → get_products（ページネーション付き）
説明が欠けているものをチェック → AIでフィルター
在庫レベルを確認 → get_inventory_levels
在庫ゼロの商品にフラグを立てる → adjust_inventoryまたはアーカイブ

カスタマーサービス

メールで顧客を検索 → search_customers
最近の注文を取得 → customer_id付きget_orders
注文のフルフィルメントステータスを確認 → get_order
必要に応じて返金処理 → refund_order

Dev MCP + Store MCPの組み合わせ

最も強力なパターンは、Dev MCP（ドキュメント用）とStore MCP（ライブデータ用）を組み合わせることです。Claudeにドキュメントで正しいAPIアプローチを調べさせ、それをストアに対して実行させることが、1つの会話内ですべて可能です。

商品​

get_products​

get_product​

create_product​

update_product​

delete_product​

search_products​

manage_product_media​

manage_product_metafields​

バリアント​

get_variants​

update_variant​

注文​

get_orders​

get_order​

create_draft_order​

fulfill_order​

cancel_order​

refund_order​

顧客​

get_customers​

get_customer​

create_customer​

update_customer​

search_customers​

在庫​

get_inventory_levels​

adjust_inventory​

set_inventory​

get_locations​

transfer_inventory​

コレクション​

get_collections​

create_collection​

add_products_to_collection​

remove_products_from_collection​

ディスカウント​

get_discounts​

create_discount_code​

create_automatic_discount​

delete_discount​

アナリティクス​

get_shop_info​

get_order_count​

get_sales_report​

get_top_products​

ドキュメントツール（公式Dev MCP）​

よくあるツールパターン​

バルク操作​

監査ワークフロー​

カスタマーサービス​

商品

`get_products`

`get_product`

`create_product`

`update_product`

`delete_product`

`search_products`

`manage_product_media`

`manage_product_metafields`

バリアント

`get_variants`

`update_variant`

注文

`get_orders`

`get_order`

`create_draft_order`

`fulfill_order`

`cancel_order`

`refund_order`

顧客

`get_customers`

`get_customer`

`create_customer`

`update_customer`

`search_customers`

在庫

`get_inventory_levels`

`adjust_inventory`

`set_inventory`

`get_locations`

`transfer_inventory`

コレクション

`get_collections`

`create_collection`

`add_products_to_collection`

`remove_products_from_collection`

ディスカウント

`get_discounts`

`create_discount_code`

`create_automatic_discount`

`delete_discount`

アナリティクス

`get_shop_info`

`get_order_count`

`get_sales_report`

`get_top_products`

ドキュメントツール（公式Dev MCP）

よくあるツールパターン

バルク操作

監査ワークフロー

カスタマーサービス