MCP Capabilities
Server eccube
Tools 11
get_customer_orders
Description: EC-CUBE の指定会員の購入履歴 (注文一覧) を取得する。 読み取り専用。 必要 scope: mcp:customer:read。
Handler: Eccube\Service\Mcp\Tool\GetCustomerOrdersTool::get()
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
customerId |
integer | Yes | - | 会員 ID |
limit |
integer | No |
10
|
取得件数 1〜200 (既定 10) |
offset |
integer | No |
0
|
スキップ件数 (既定 0) |
Full Schema
array:3 [ "type" => "object" "properties" => array:3 [ "customerId" => array:2 [ "type" => "integer" "description" => "会員 ID" ] "limit" => array:3 [ "type" => "integer" "description" => "取得件数 1〜200 (既定 10)" "default" => 10 ] "offset" => array:3 [ "type" => "integer" "description" => "スキップ件数 (既定 0)" "default" => 0 ] ] "required" => array:1 [ 0 => "customerId" ] ] |
get_customer
Description: EC-CUBE の会員 ID から会員詳細 (氏名・連絡先・住所など) を取得する。 読み取り専用。 必要 scope: mcp:customer:read。 allow_list に PII が含まれる。
Handler: Eccube\Service\Mcp\Tool\GetCustomerTool::get()
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
id |
integer | Yes | - | 会員 ID |
Full Schema
array:3 [ "type" => "object" "properties" => array:1 [ "id" => array:2 [ "type" => "integer" "description" => "会員 ID" ] ] "required" => array:1 [ 0 => "id" ] ] |
get_order
Description: EC-CUBE の注文 ID または注文番号から注文詳細 (明細 / 配送状況 / 支払状況等) を取得する。 読み取り専用。 必要 scope: mcp:order:read。 allow_list に氏名・住所等の PII が含まれ得る。
Handler: Eccube\Service\Mcp\Tool\GetOrderTool::get()
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
id |
null|integer | No |
|
注文 ID (id, orderNo いずれか必須) |
orderNo |
null|string | No |
|
注文番号 (id, orderNo いずれか必須) |
Full Schema
array:2 [ "type" => "object" "properties" => array:2 [ "id" => array:3 [ "type" => array:2 [ 0 => "null" 1 => "integer" ] "description" => "注文 ID (id, orderNo いずれか必須)" "default" => null ] "orderNo" => array:3 [ "type" => array:2 [ 0 => "null" 1 => "string" ] "description" => "注文番号 (id, orderNo いずれか必須)" "default" => null ] ] ] |
get_plugin
Description: EC-CUBE のプラグイン ID または code から詳細 (Plugin entity + composer.json の description / require 依存関係) を取得する。 読み取り専用。 必要 scope: mcp:plugin:read。 プラグイン設定値は含まれない。
Handler: Eccube\Service\Mcp\Tool\GetPluginTool::get()
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
id |
null|integer | No |
|
プラグイン ID (id, code いずれか必須) |
code |
null|string | No |
|
プラグインコード (id, code いずれか必須) |
Full Schema
array:2 [ "type" => "object" "properties" => array:2 [ "id" => array:3 [ "type" => array:2 [ 0 => "null" 1 => "integer" ] "description" => "プラグイン ID (id, code いずれか必須)" "default" => null ] "code" => array:3 [ "type" => array:2 [ 0 => "null" 1 => "string" ] "description" => "プラグインコード (id, code いずれか必須)" "default" => null ] ] ] |
get_product_stock
Description: EC-CUBE の商品 (および商品規格) 単位の在庫数を取得する。 規格の在庫数は ProductStock.stock、 在庫の有無は in_stock。 stock_unlimited フラグの規格は ProductStock.stock が null になる場合がある。 読み取り専用。 必要 scope: mcp:product:read。
Handler: Eccube\Service\Mcp\Tool\GetProductStockTool::get()
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
productId |
integer | Yes | - | 商品 ID |
Full Schema
array:3 [ "type" => "object" "properties" => array:1 [ "productId" => array:2 [ "type" => "integer" "description" => "商品 ID" ] ] "required" => array:1 [ 0 => "productId" ] ] |
get_product
Description: EC-CUBE の商品 ID または商品コードから商品詳細 (規格 / 画像 / カテゴリ等を含む) を取得する。 読み取り専用。 必要 scope: mcp:product:read。
Handler: Eccube\Service\Mcp\Tool\GetProductTool::get()
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
id |
null|integer | No |
|
商品 ID (id, code いずれか必須) |
code |
null|string | No |
|
商品コード (ProductClass.code、 id, code いずれか必須) |
Full Schema
array:2 [ "type" => "object" "properties" => array:2 [ "id" => array:3 [ "type" => array:2 [ 0 => "null" 1 => "integer" ] "description" => "商品 ID (id, code いずれか必須)" "default" => null ] "code" => array:3 [ "type" => array:2 [ 0 => "null" 1 => "string" ] "description" => "商品コード (ProductClass.code、 id, code いずれか必須)" "default" => null ] ] ] |
get_shipping
Description: EC-CUBE の注文 ID に紐づく配送情報 (出荷ステータス / 配送日 / 追跡番号 / 配送先) の一覧を取得する。 読み取り専用。 必要 scope: mcp:order:read。 配送先住所等の PII が含まれ得る。
Handler: Eccube\Service\Mcp\Tool\GetShippingTool::get()
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
orderId |
integer | Yes | - | 注文 ID |
Full Schema
array:3 [ "type" => "object" "properties" => array:1 [ "orderId" => array:2 [ "type" => "integer" "description" => "注文 ID" ] ] "required" => array:1 [ 0 => "orderId" ] ] |
list_plugins
Description: EC-CUBE にインストール済みのプラグイン一覧 (code / name / version / enabled / initialized 等) を取得する。 読み取り専用。 必要 scope: mcp:plugin:read。 個別プラグインの設定値は含まれない。
Handler: Eccube\Service\Mcp\Tool\ListPluginsTool::list()
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
enabledOnly |
null|boolean | No |
|
true で enabled のみ、 false で disabled のみ、 null (既定) で全件 |
Full Schema
array:2 [ "type" => "object" "properties" => array:1 [ "enabledOnly" => array:3 [ "type" => array:2 [ 0 => "null" 1 => "boolean" ] "description" => "true で enabled のみ、 false で disabled のみ、 null (既定) で全件" "default" => null ] ] ] |
search_customers
Description: EC-CUBE の会員を キーワード / 電話 / ステータス / 登録期間 / 購入合計 / 購入回数 で検索する。 読み取り専用。 必要 scope: mcp:customer:read。 氏名・メール・電話等の PII を含み得る。
Handler: Eccube\Service\Mcp\Tool\SearchCustomersTool::search()
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
keyword |
null|string | No |
|
氏名 / メール / 顧客 ID 等の汎用検索 (任意) |
phoneNumber |
null|string | No |
|
電話番号部分一致 (任意) |
statusIds |
array|null | No |
|
CustomerStatus ID 配列 (1=仮会員、 2=本会員、 3=退会、 任意) |
createDateFrom |
null|string | No |
|
登録日 (ISO 8601) 開始 (任意) |
createDateTo |
null|string | No |
|
登録日 (ISO 8601) 終了 (任意) |
buyTotalMin |
null|integer | No |
|
購入合計の下限 (任意) |
buyTotalMax |
null|integer | No |
|
購入合計の上限 (任意) |
buyTimesMin |
null|integer | No |
|
購入回数の下限 (任意) |
buyTimesMax |
null|integer | No |
|
購入回数の上限 (任意) |
limit |
integer | No |
10
|
取得件数 1〜200 (既定 10) |
offset |
integer | No |
0
|
スキップ件数 (既定 0) |
Full Schema
array:2 [ "type" => "object" "properties" => array:11 [ "keyword" => array:3 [ "type" => array:2 [ 0 => "null" 1 => "string" ] "description" => "氏名 / メール / 顧客 ID 等の汎用検索 (任意)" "default" => null ] "phoneNumber" => array:3 [ "type" => array:2 [ 0 => "null" 1 => "string" ] "description" => "電話番号部分一致 (任意)" "default" => null ] "statusIds" => array:4 [ "type" => array:2 [ 0 => "array" 1 => "null" ] "description" => "CustomerStatus ID 配列 (1=仮会員、 2=本会員、 3=退会、 任意)" "default" => null "items" => array:1 [ "type" => "integer" ] ] "createDateFrom" => array:3 [ "type" => array:2 [ 0 => "null" 1 => "string" ] "description" => "登録日 (ISO 8601) 開始 (任意)" "default" => null ] "createDateTo" => array:3 [ "type" => array:2 [ 0 => "null" 1 => "string" ] "description" => "登録日 (ISO 8601) 終了 (任意)" "default" => null ] "buyTotalMin" => array:3 [ "type" => array:2 [ 0 => "null" 1 => "integer" ] "description" => "購入合計の下限 (任意)" "default" => null ] "buyTotalMax" => array:3 [ "type" => array:2 [ 0 => "null" 1 => "integer" ] "description" => "購入合計の上限 (任意)" "default" => null ] "buyTimesMin" => array:3 [ "type" => array:2 [ 0 => "null" 1 => "integer" ] "description" => "購入回数の下限 (任意)" "default" => null ] "buyTimesMax" => array:3 [ "type" => array:2 [ 0 => "null" 1 => "integer" ] "description" => "購入回数の上限 (任意)" "default" => null ] "limit" => array:3 [ "type" => "integer" "description" => "取得件数 1〜200 (既定 10)" "default" => 10 ] "offset" => array:3 [ "type" => "integer" "description" => "スキップ件数 (既定 0)" "default" => 0 ] ] ] |
search_orders
Description: EC-CUBE の注文を キーワード / 注文番号 / ステータス / 期間 / 金額レンジ / 顧客 ID で検索する。 読み取り専用。 必要 scope: mcp:order:read。 PII を含み得る。
Handler: Eccube\Service\Mcp\Tool\SearchOrdersTool::search()
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
keyword |
null|string | No |
|
注文者名 / 注文番号 / メール等の汎用検索 (任意) |
orderNo |
null|string | No |
|
注文番号の完全一致 (任意。 部分一致で探すなら keyword を使う) |
statusIds |
array|null | No |
|
OrderStatus ID の配列 (任意。 例: 1=新規受付、 5=対応中) |
email |
null|string | No |
|
注文者メール部分一致 (任意) |
totalMin |
null|integer | No |
|
支払合計の下限 (任意) |
totalMax |
null|integer | No |
|
支払合計の上限 (任意) |
orderDateFrom |
null|string | No |
|
注文日 (ISO 8601) の開始 (任意) |
orderDateTo |
null|string | No |
|
注文日 (ISO 8601) の終了 (任意) |
customerId |
null|integer | No |
|
Customer ID で絞り込み (任意) |
limit |
integer | No |
10
|
取得件数 1〜200 (既定 10) |
offset |
integer | No |
0
|
スキップ件数 (既定 0) |
Full Schema
array:2 [ "type" => "object" "properties" => array:11 [ "keyword" => array:3 [ "type" => array:2 [ 0 => "null" 1 => "string" ] "description" => "注文者名 / 注文番号 / メール等の汎用検索 (任意)" "default" => null ] "orderNo" => array:3 [ "type" => array:2 [ 0 => "null" 1 => "string" ] "description" => "注文番号の完全一致 (任意。 部分一致で探すなら keyword を使う)" "default" => null ] "statusIds" => array:4 [ "type" => array:2 [ 0 => "array" 1 => "null" ] "description" => "OrderStatus ID の配列 (任意。 例: 1=新規受付、 5=対応中)" "default" => null "items" => array:1 [ "type" => "integer" ] ] "email" => array:3 [ "type" => array:2 [ 0 => "null" 1 => "string" ] "description" => "注文者メール部分一致 (任意)" "default" => null ] "totalMin" => array:3 [ "type" => array:2 [ 0 => "null" 1 => "integer" ] "description" => "支払合計の下限 (任意)" "default" => null ] "totalMax" => array:3 [ "type" => array:2 [ 0 => "null" 1 => "integer" ] "description" => "支払合計の上限 (任意)" "default" => null ] "orderDateFrom" => array:3 [ "type" => array:2 [ 0 => "null" 1 => "string" ] "description" => "注文日 (ISO 8601) の開始 (任意)" "default" => null ] "orderDateTo" => array:3 [ "type" => array:2 [ 0 => "null" 1 => "string" ] "description" => "注文日 (ISO 8601) の終了 (任意)" "default" => null ] "customerId" => array:3 [ "type" => array:2 [ 0 => "null" 1 => "integer" ] "description" => "Customer ID で絞り込み (任意)" "default" => null ] "limit" => array:3 [ "type" => "integer" "description" => "取得件数 1〜200 (既定 10)" "default" => 10 ] "offset" => array:3 [ "type" => "integer" "description" => "スキップ件数 (既定 0)" "default" => 0 ] ] ] |
search_products
Description: EC-CUBE の商品をキーワード / カテゴリ / 公開ステータス / 在庫数で検索し、商品一覧を返す。 読み取り専用。 必要 scope: mcp:product:read。
Handler: Eccube\Service\Mcp\Tool\SearchProductsTool::search()
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
keyword |
null|string | No |
|
ID または商品名 / 商品コードの部分一致 (任意) |
categoryId |
null|integer | No |
|
カテゴリ ID。 子カテゴリも対象 (任意) |
statusIds |
array|null | No |
|
商品ステータス ID の配列。 1=公開、 2=非公開、 3=廃止 (任意、 既定 [1]) |
stockMin |
null|integer | No |
|
在庫がこの値以上の表示規格を持つ商品のみ (任意)。 stockMax と併用時は同一規格が [stockMin, stockMax] に入る商品に限る |
stockMax |
null|integer | No |
|
在庫がこの値以下の表示規格を持つ商品のみ (任意)。 stockMin と併用時は同一規格が [stockMin, stockMax] に入る商品に限る |
limit |
integer | No |
10
|
取得件数。 1〜200 (既定 10) |
offset |
integer | No |
0
|
スキップ件数 (既定 0) |
Full Schema
array:2 [ "type" => "object" "properties" => array:7 [ "keyword" => array:3 [ "type" => array:2 [ 0 => "null" 1 => "string" ] "description" => "ID または商品名 / 商品コードの部分一致 (任意)" "default" => null ] "categoryId" => array:3 [ "type" => array:2 [ 0 => "null" 1 => "integer" ] "description" => "カテゴリ ID。 子カテゴリも対象 (任意)" "default" => null ] "statusIds" => array:4 [ "type" => array:2 [ 0 => "array" 1 => "null" ] "description" => "商品ステータス ID の配列。 1=公開、 2=非公開、 3=廃止 (任意、 既定 [1])" "default" => null "items" => array:1 [ "type" => "integer" ] ] "stockMin" => array:3 [ "type" => array:2 [ 0 => "null" 1 => "integer" ] "description" => "在庫がこの値以上の表示規格を持つ商品のみ (任意)。 stockMax と併用時は同一規格が [stockMin, stockMax] に入る商品に限る" "default" => null ] "stockMax" => array:3 [ "type" => array:2 [ 0 => "null" 1 => "integer" ] "description" => "在庫がこの値以下の表示規格を持つ商品のみ (任意)。 stockMin と併用時は同一規格が [stockMin, stockMax] に入る商品に限る" "default" => null ] "limit" => array:3 [ "type" => "integer" "description" => "取得件数。 1〜200 (既定 10)" "default" => 10 ] "offset" => array:3 [ "type" => "integer" "description" => "スキップ件数 (既定 0)" "default" => 0 ] ] ] |
Prompts 0
No prompts were registered.
Resources 0
No resources were registered.
Resource Templates 0
No resource templates were registered.