ChannelEngine MCP by usefulapi
Read orders, products, stock and returns; acknowledge orders and set stock in ChannelEngine.
使うべきか
品質と安全性
検出事項(5)
- LOWchannelengine_list_stock_locations 内
- LOWchannelengine_acknowledge_order 内
- LOWchannelengine_list_channel_listings 内
- LOWchannelengine_list_cancellations 内
- LOWchannelengine_list_notifications 内
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"channelengine": {
"url": "https://channelengine.usefulapi.io/mcp"
}
}
}リモートエンドポイント
https://channelengine.usefulapi.io/mcpstreamable-httpできること
ツール一覧
ツール(15)
🟢channelengine_list_channels
List the marketplaces and webshops (channels) connected to this merchant account, with their ids. Good first call: channel ids are used by the other filters. Merchant API: GET /api/v2/channels.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢channelengine_get_settings
Get the merchant account settings in ChannelEngine. Merchant API: GET /api/v2/settings.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢channelengine_list_stock_locations
List the stock locations (warehouses) of this merchant account, with their ids. Merchant API: GET /api/v2/stocklocations.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢channelengine_list_orders(statuses, merchant_order_nos, channel_order_nos, channel_ids, from_date, ...)
List orders with filters: status, order numbers, channel, order date range and acknowledgement state. Returns Content plus TotalCount. Merchant API: GET /api/v2/orders.
入力スキーマ
{
"type": "object",
"properties": {
"statuses": {
"description": "Filter on one or more order statuses (for example NEW, IN_PROGRESS or SHIPPED). AWAITING_PAYMENT orders are excluded unless listed.",
"type": "array",
"items": {
"type": "string"
}
},
"merchant_order_nos": {
"description": "Filter on one or more merchant order numbers.",
"type": "array",
"items": {
"type": "string"
}
},
"channel_order_nos": {
"description": "Filter on one or more channel order numbers.",
"type": "array",
"items": {
"type": "string"
}
},
"channel_ids": {
"description": "Filter on one or more channel ids (see channelengine_list_channels).",
"type": "array",
"items": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"from_date": {
"description": "Order date from (inclusive).",
"type": "string"
},
"to_date": {
"description": "Order date until (exclusive).",
"type": "string"
},
"is_acknowledged": {
"description": "Only acknowledged (true) or unacknowledged (false) orders.",
"type": "boolean"
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢channelengine_get_new_orders(stock_location_id)
Get the orders that are new and not yet processed by the merchant (the usual order-intake call). Merchant API: GET /api/v2/orders/new.
入力スキーマ
{
"type": "object",
"properties": {
"stock_location_id": {
"description": "Only orders for this stock location id.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡channelengine_acknowledge_order(order_id, merchant_order_no)
WRITE: acknowledge one order, which tells the channel the merchant accepted it. Needs the ChannelEngine OrderId (from channelengine_list_orders). Optionally sets your own MerchantOrderNo on it. Merchant API: POST /api/v2/orders/acknowledge.
入力スキーマ
{
"type": "object",
"properties": {
"order_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The ChannelEngine order id (the Id field of the order)."
},
"merchant_order_no": {
"description": "Your own order reference to store on the order.",
"type": "string"
}
},
"required": [
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢channelengine_list_products(search, eans, merchant_product_nos, page_size, page)
Search the merchant product catalogue by name, merchant product number, EAN or brand, or by explicit lists of product numbers or EANs. Merchant API: GET /api/v2/products.
入力スキーマ
{
"type": "object",
"properties": {
"search": {
"description": "Search by name, merchant product number, EAN or brand.",
"type": "string"
},
"eans": {
"description": "Filter on one or more EAN codes.",
"type": "array",
"items": {
"type": "string"
}
},
"merchant_product_nos": {
"description": "Filter on one or more merchant product numbers (SKUs).",
"type": "array",
"items": {
"type": "string"
}
},
"page_size": {
"description": "Products per page (default: all).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢channelengine_get_product(merchant_product_no)
Get one product by its merchant product number (SKU). Merchant API: GET /api/v2/products/{merchantProductNo}.
入力スキーマ
{
"type": "object",
"properties": {
"merchant_product_no": {
"type": "string",
"minLength": 1,
"description": "The merchant product number (SKU)."
}
},
"required": [
"merchant_product_no"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢channelengine_list_channel_listings(channel_id, merchant_product_nos, page)
List the products listed on one channel (marketplace or webshop), optionally for given merchant product numbers. Merchant API: GET /api/v2/channels/{channelId}/products.
入力スキーマ
{
"type": "object",
"properties": {
"channel_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The channel id (see channelengine_list_channels)."
},
"merchant_product_nos": {
"description": "Filter on one or more merchant product numbers (SKUs).",
"type": "array",
"items": {
"type": "string"
}
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"channel_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢channelengine_get_stock(skus, stock_location_ids, page_index, page_size)
Get the stock level per product across all stock locations. Pages start at index 0 here. Merchant API: GET /api/v2/offer/stock.
入力スキーマ
{
"type": "object",
"properties": {
"skus": {
"description": "Filter on one or more product SKUs (merchant product numbers).",
"type": "array",
"items": {
"type": "string"
}
},
"stock_location_ids": {
"description": "Filter on one or more stock location ids.",
"type": "array",
"items": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"page_index": {
"description": "Page index, starting at 0.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"page_size": {
"description": "Items per page (default 100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴channelengine_update_stock(updates)
WRITE: set the absolute stock for products at stock locations. This changes live stock on every connected channel. Send the full stock per location, not a change. Merchant API: PUT /api/v2/offer/stock.
入力スキーマ
{
"type": "object",
"properties": {
"updates": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"merchant_product_no": {
"type": "string",
"minLength": 1,
"description": "The product SKU."
},
"stock_locations": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"stock_location_id": {
"description": "The stock location id.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"stock": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "The new absolute stock quantity."
}
},
"required": [
"stock"
]
}
}
},
"required": [
"merchant_product_no",
"stock_locations"
]
},
"description": "Stock updates, one entry per product (max 100)."
}
},
"required": [
"updates"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢channelengine_list_shipments(merchant_order_nos, merchant_shipment_nos, channel_order_nos, channel_id, from_create_date, ...)
List shipments created for merchant orders, with filters on order, shipment, create date and channel. Merchant API: GET /api/v2/shipments/merchant.
入力スキーマ
{
"type": "object",
"properties": {
"merchant_order_nos": {
"description": "Filter on one or more merchant order numbers.",
"type": "array",
"items": {
"type": "string"
}
},
"merchant_shipment_nos": {
"description": "Filter on one or more merchant shipment numbers.",
"type": "array",
"items": {
"type": "string"
}
},
"channel_order_nos": {
"description": "Filter on one or more channel order numbers.",
"type": "array",
"items": {
"type": "string"
}
},
"channel_id": {
"description": "Only shipments for this channel id.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"from_create_date": {
"description": "Created from (inclusive).",
"type": "string"
},
"to_create_date": {
"description": "Created until (exclusive).",
"type": "string"
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢channelengine_list_returns(channel_ids, merchant_order_nos, channel_order_nos, statuses, from_date, ...)
List returns for merchant orders, with filters on channel, order, status, date and acknowledgement. Merchant API: GET /api/v2/returns/merchant.
入力スキーマ
{
"type": "object",
"properties": {
"channel_ids": {
"description": "Filter on one or more channel ids.",
"type": "array",
"items": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"merchant_order_nos": {
"description": "Filter on one or more merchant order numbers.",
"type": "array",
"items": {
"type": "string"
}
},
"channel_order_nos": {
"description": "Filter on one or more channel order numbers.",
"type": "array",
"items": {
"type": "string"
}
},
"statuses": {
"description": "Filter on one or more return statuses.",
"type": "array",
"items": {
"type": "string"
}
},
"from_date": {
"description": "Created from (inclusive).",
"type": "string"
},
"to_date": {
"description": "Created until (exclusive).",
"type": "string"
},
"is_acknowledged": {
"description": "Only acknowledged (true) or unacknowledged (false) returns.",
"type": "boolean"
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢channelengine_list_cancellations(created_since, created_to, merchant_order_nos, channel_order_nos, page)
List order cancellations for this merchant, with filters on creation date and order numbers. Merchant API: GET /api/v2/cancellations/merchant.
入力スキーマ
{
"type": "object",
"properties": {
"created_since": {
"description": "Created since this date-time.",
"type": "string"
},
"created_to": {
"description": "Created until this date-time.",
"type": "string"
},
"merchant_order_nos": {
"description": "Filter on one or more merchant order numbers.",
"type": "array",
"items": {
"type": "string"
}
},
"channel_order_nos": {
"description": "Filter on one or more channel order numbers.",
"type": "array",
"items": {
"type": "string"
}
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢channelengine_list_notifications(from_date, to_date, types, merchant_order_nos, channel_order_nos, ...)
List notifications ChannelEngine raised for this merchant (for example order or shipment problems), with date and order filters. Merchant API: GET /api/v2/notifications.
入力スキーマ
{
"type": "object",
"properties": {
"from_date": {
"description": "From this date-time.",
"type": "string"
},
"to_date": {
"description": "Until this date-time.",
"type": "string"
},
"types": {
"description": "Filter on one or more notification types.",
"type": "array",
"items": {
"type": "string"
}
},
"merchant_order_nos": {
"description": "Filter on one or more merchant order numbers.",
"type": "array",
"items": {
"type": "string"
}
},
"channel_order_nos": {
"description": "Filter on one or more channel order numbers.",
"type": "array",
"items": {
"type": "string"
}
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}コミュニティ
エビデンス