领星MCP-领星ERP-专业亚马逊ERP系统

一、什么是MCP

领星MCP（Model Context Protocol） 是一项基于 MCP 标准协议的官方服务，旨在让AI助手能够安全、标准化地连接外部数据源和工具。通过领星MCP，你可以将领星ERP中的业务数据（库存、Listing、销售、利润、关键词排名、竞品、跟卖等）接入任何支持MCP的AI工具，用自然语言即可查询和操作，无需编写代码。

对比维度	传统API	MCP
接入方式	需要写代码对接，处理鉴权、参数、异常	配置URL即可，AI自动理解并调用
使用门槛	需要开发能力	自然语言提问即可
标准化程度	每个API格式不同，需逐一适配	统一协议，一次配置多平台通用
交互方式	构造HTTP请求，解析JSON响应	用自然语言描述需求，AI自动选择Tool并返回结果

二、怎么启用

2.1 在领星AI助手中启用

管理员需要在【业务配置】-【开放接口】-【MCP】中启用MCP功能（仅限付费用户）
打开领星ERP系统，进入AI助手模块
勾选MCP即可调用领星数据
在对话框提问，AI自动识别并查询数据，返回结果

2.2 获取领星MCP配置地址

如需把领星数据提供给第三方应用使用，可获取当前帐号权限的MCP请求地址：

直接在ERP中打开AI助手
点击【MCP】
根据你需要配置的服务器点击【复制JSON】或者【复制密钥】

注意：该链接仅有当前领星帐号的数据权限，即通过该URL查询到的数据范围与当前登录帐号在ERP中的权限一致。

2.3 获取鉴权密钥（X-Mcp-Key）

MCP服务需要鉴权才能调用，除了服务器URL外，还需要一个鉴权密钥：

在【MCP】页面，点击 复制密钥
该密钥与当前领星帐号绑定，用于验证调用者身份

重要：

服务器URL和鉴权密钥是两个独立的值，缺一不可。

鉴权密钥请妥善保管，请勿分享给他人，以免数据泄露。

如果密钥泄露，可在【管理MCP】页面重新生成。

三、如何在第三方应用中使用

领星ERP MCP现在已多项国内常用Agent平台，你可以直接复制Token方式在第三方平台添加，亦可自行添加至其他第三方平台，目前支持接入任何支持自定义MCP工具的AI平台（如Cursor、ChatGPT、Claude、Gemini、Trae、通义千问等），配置方法通用。

1、已上架国内办公平台：WorkBuddy、豆包工作伙伴、千问办公
配置方法参考
打开【连接器】或【插件】功能，搜索领星ERP，点击安装，在弹出窗口中将【MCP】页面中【 复制密钥】获取的密钥贴入即可

2、Codex等常用Agent工具接入领星MCP
进入设置页面添加MCP服务器

选择【流式HTTP】
URL填入https://openmcp.lingxing.com/mcp-servers/lingxing-mcp
标头的键填入X-Mcp-Key（填入此名称非具体的key），值填入具体的密钥，保存即可

3、让Agent添加
复制JSON，发送给AGENT，让其添加即可
示例

{
"mcpServers": {
"LingXing-MCP": {
"type": "streamableHttp",
"url": "",
"headers": {
"": "xxxxx"
}
}
}
}

提示：此方法存在密钥泄露风险

四、工具能力

领星 MCP Server 提供了300种工具，涵盖供应链，多平台，利润等板块。与 Open API 相同，每用户将可以在1分钟调用100次MCP TOOL。

工具清单：

产品

工具ID	中文名称	描述
`product_create_tcode`	申请商品透明计划 TCode	用于为商品透明计划申请 Tcode。
`product_paging_log_lists`	查询产品操作日志	用于查询操作日志。
`product_tcode_list_list`	查询透明计划 TCode 列表	查询透明计划(Transparency)TCode列表
`product_transparency_product_list`	查询透明计划商品列表	查询产品管理中的透明计划商品列表，支持按产品状态、是否关联MSKU及搜索字段筛选，并支持分页查询。

销售

1、商品管理

工具ID	中文名称	描述
`erp_listing`	查询 Listing 列表	查询Listing列表，支持按MSKU/ASIN/SKU搜索，支持按店铺、状态、配送方式、分类、品牌、国家等筛选
`product_sale_time_remark`	批量编辑在线商品本地信息	用于批量编辑在线商品的本地信息、销售时间和备注。
`sales_adjust_price_manual`	查询调价队列	用于查询调价队列。
`sales_batch_link_product_relation`	批量配对 VC 商品关系	用于批量建立 VC 商品关系配对。
`sales_bind_listing_tag`	添加 Listing 商品标签	用于Listing新增商品标签。
`sales_link_listing_tag`	解除 Listing 配对	用于解除Listing配对。
`sales_listing_page_list`	查询 VC Listing 列表	查询VC Listing列表。
`sales_merchant_shipping_group`	刊登管理-获取商船集团列表	刊登管理-获取商船集团列表
`sales_operate_log_list`	查询 Listing 操作日志	用于查询Listing操作日志列表。
`sales_price_modify_price`	修改 Amazon B2B 价格	用于修改 Amazon B2B 价格。
`sales_product_type_new`	查询刊登表单	用于刊登管理-获取刊登表单。
`sales_publish_category_children`	查询刊登子分类	用于刊登管理-子分类。
`sales_publish_category_root`	查询刊登根分类	用于刊登管理-根分类。
`sales_relation_tag_list`	查询 Listing 标记标签列表	查询Listing标记标签列表。
`sales_remove_listing_tag`	删除 Listing 商品标签	用于删除 Listing 已标记的商品标签。
`sales_un_link_product_relation`	批量解除 VC 商品配对	用于批量解除 VC 商品关系配对。
`settings_tag_add_tag`	添加 Listing 标签	用于添加 Listing 标签。
`settings_tag_page_list`	查询 Listing 标签列表	用于查询Listing标签列表。
`settings_tag_remove_tag`	删除 Listing 标签	用于删除 Listing 标签。

2、平台订单

工具ID	中文名称	描述
`sales_df_confirm_shipment`	确认 VC DF 订单发货	用于确认 DF 类型 VC 订单发货。
`sales_get_shipping_label`	获取 VC DF 订单标签	用于VC订单-打印标签【DF】。
`sales_order_df_detail`	查询 VC DF 订单详情	用于查询VC订单详情【DF】。
`sales_order_page_list`	查询 VC 订单列表	用于查询VC订单列表。
`sales_order_po_detail`	查询 VC PO 订单详情	用于查询VC订单详情【PO】。
`sales_submit_shipping_label`	请求 VC DF 订单标签	用于为 DF 类型 VC 订单请求发货标签。

3、运营管理

工具ID	中文名称	描述
`analytics_log_list_v2`	查询运营日志	用于查询运营日志(新)。

4、促销管理

工具ID	中文名称	描述
`sales_detail_prime_discount`	查询商品折扣详情-列表-优惠券	查询商品折扣详情-列表-优惠券
`sales_detail_sec_kill`	查询商品秒杀详情	查询商品折扣详情-列表-秒杀。
`sales_promotional_listing_detail`	查询商品管理促销详情	查询商品折扣详情-列表-管理促销。

FBA

1、补货

工具ID	中文名称	描述
`query_fba_valid_list`	查询 FBA 补货建议	查询FBA补货建议列表

2、货件

工具ID	中文名称	描述
`fba_delete_shipment_list`	删除 FBA 发货单	用于删除状态为待配货、待审批或待发货的 FBA 发货单。
`fba_invalid_shipment_sn`	作废 FBA 发货单	用于作废指定 FBA 发货单。
`fba_plan_storage_allocate`	锁定 FBA 发货计划库存	用于按发货计划单号批量锁定库存。
`fba_plan_storage_release`	释放 FBA 发货计划库存	用于按发货计划单号批量释放已锁定库存。
`fba_shipment_shopping_address`	查询 FBA 货件配送地址	FBA-fba货件详情-货件的配送地址

3、VC

工具ID	中文名称	描述
`fba_batch_send_goods`	确认 VC 发货单发货	用于VC发货单-确认发货。
`fba_fba_invoice_detail`	查询 VC 发货单详情	用于查询VC发货单详情。
`fba_invoice_page_list`	查询 VC 发货单列表	用于查询VC发货单列表。

采购

采购单据

工具ID	中文名称	描述
`purchase_cancel_shipment_list`	作废采购或委外退货单	用于作废采购/委外退货单。
`purchase_order_modify_remark`	编辑采购单备注	用于快速编辑采购单备注。
`purchase_order_plan_cancel`	作废采购计划	用于作废待审批或待采购状态的采购计划。
`purchase_plan_modify_remark`	批量编辑采购计划备注	用于按采购计划批次号或采购计划单号批量修改备注。
`purchase_set_order_finish`	结束采购单到货	用于将采购单标记为整单结束到货。
`warehouse_order_plan_list`	查询加工单计划列表	查询待完成的加工单计划列表

仓库

1、库存

工具ID	中文名称	描述
`get_fba_stock_list`	查询 FBA 仓库库存	查询FBA仓库库存列表，支持按SKU/品名/SPU/FNSKU搜索，支持按仓库、店铺、配送方式筛选

2、收货

工具ID	中文名称	描述
`fba_fast_storage_in`	办理待收货退货单快捷入库	用于将待收货退货单快速办理入库。
`warehouse_inspection_order_detail`	查询质检单详情	用于查询质检单详情。
`warehouse_update_order_info`	编辑收货单备注	用于编辑指定收货单的备注信息。

3、海外仓

工具ID	中文名称	描述
`warehouse_allocate_stock_order`	分配海外仓备货单库存	用于为海外仓备货单分配库存。
`warehouse_delete_stock_order`	删除海外仓备货单	用于删除待审批、待配货、待发货或已驳回的海外仓备货单。

4、出入库

工具ID	中文名称	描述
`warehouse_cancel_shipment_list`	撤销调拨单	撤销调拨单。
`warehouse_confirm_inbound_order`	确认入库单入库	用于确认入库单入库。
`warehouse_confirm_outbound_order`	确认出库单出库	用于确认出库单出库。
`warehouse_delete_shipment_list`	删除调拨单	用于删除调拨单。
`warehouse_inbound_order_revoke`	撤销入库单	用于撤销入库单。
`warehouse_orders_order_numbers`	查询销售出库单详情	支持查询ERP中【仓库】>【销售出库单】数据，即自发货订单销售出库单。
`warehouse_outbound_order_delete`	删除出库单	用于删除出库单。
`warehouse_outbound_order_revoke`	撤销出库单	用于撤销出库单。
`warehouse_packing_task_add`	生成装箱任务	用于生成装箱任务。
`warehouse_packing_task_detail`	查询装箱任务详情	装箱任务-任务详情
`warehouse_packing_task_finish`	完成装箱任务	用于将装箱任务标记为已完成。
`warehouse_packing_task_list`	查询装箱任务列表	查询装箱任务列表
`warehouse_relate_sn_list`	查询装箱任务关联单号	查询可创建装箱任务的关联单据列表，支持按单据类型、日期范围以及关联单号、MSKU、SKU或FNSKU搜索。

物流

1、头程物流

工具ID	中文名称	描述
`logistics_logistics_provider_list`	查询头程物流商列表	支持查询物流-头程物流商，默认返回已启用现结api对接的物流商。
`logistics_logistics_reconciliation_list`	查询头程物流对账列表	用于头程对账列表。

2、自发货物流

工具ID	中文名称	描述
`logistics_logistics_bill_confirm`	确认 FBM 物流账单	用于确认或批量确认 FBM 物流账单。

1、报告

工具ID	中文名称	描述
`ad_campaign_group_report`	查询广告活动下的广告组报告	查询指定广告活动下的广告组报告,支持按日期、店铺、广告类型、广告活动等筛选
`ad_campaign_keyword_report`	查询广告活动下的关键词报告	查找指定广告活动下的投放报告(关键词),支持按关键词搜索、匹配方式、聚合方式筛选
`ad_campaign_product_report`	查询广告活动下的广告商品报告	查找指定广告活动下的广告商品报告,支持按状态、创意类型、搜索文本筛选
`ad_campaign_report`	查询广告活动报告	查询广告活动的报告,支持按日期、店铺、状态、竞价策略等多维度筛选和排序
`ad_campaign_search_term_report`	查询广告活动下的搜索词报告	查找指定广告活动下的搜索词报告,支持按搜索词、投放类型、广告对象等筛选
`ad_campaign_targeting_report`	查询广告活动下的投放报告	查找指定广告活动下的投放报告(自动投放或商品投放),支持按状态、策略、搜索文本筛选
`ad_portfolio_report_shop`	查询店铺维度广告组合报告	查询广告组合的报告-店铺维度,支持按日期范围、店铺、国家、服务状态筛选
`advertising_ad_analyze_keyword`	查询广告关键词分析	广告分析-搜索词分析
`advertising_order_analysis_list`	查询产品出单时段分析	用于出单时段分析（产品）。

2、基础数据

工具ID	中文名称	描述
`ad_auth_shops`	查询广告授权店铺列表	查询广告授权店铺列表,返回所有已授权的广告店铺信息(店铺名称、国家、Profile ID等)
`ad_campaign_tag_list`	查询广告活动标签列表	查询广告活动标签列表
`advertising_add_negative_keywords`	添加 SP 否定关键词	用于在广告活动或广告组层级批量添加 SP 广告否定关键词。
`advertising_add_negative_targets`	添加 SP 否定投放 ASIN	用于在广告活动或广告组层级批量添加 SP 广告否定投放 ASIN。
`advertising_sp_add_keywords`	添加 SP 关键词	用于批量添加 SP 广告关键词。
`advertising_sp_archive_negatives`	归档 SP 否定投放	用于批量归档 SP 广告否定关键词和否定投放 ASIN。
`post_keywords`	创建 SP 关键词	创建 Sponsored Products 关键词，并将 V3 关键词请求转换为 AdsV1 KEYWORD Target。
`post_productAds`	创建 SP 商品广告	创建 Sponsored Products 商品广告，为广告组添加实际推广商品。
`post_productAds_sd`	创建 SD 商品广告	创建 Sponsored Display 响应式电商商品广告，为广告组添加实际推广商品。
`post_targets`	创建 SB 投放	创建 SB 关键词、主题、商品或类目投放，单次 1 至 1000 条；仅支持广告组层级。
`post_targets_sd`	创建 SD 投放	创建 Sponsored Display 广告组级投放，支持受众、关键词、商品和类目等投放类型。
`post_targets_sp`	创建 SP 投放	创建 SP 投放
`put_adGroups`	修改 SB 广告组	修改 Sponsored Brands 广告组名称或状态；每个广告组至少修改名称或状态之一。
`put_adGroups_sd`	修改 SD 广告组	修改 Sponsored Display 广告组状态、名称或默认竞价，并可同步分时策略基准值。
`put_adGroups_sp`	修改 SP 广告组	修改 Sponsored Products 广告组状态、名称或默认竞价，并可同步分时策略基准值。
`put_campaigns`	修改 SB 广告活动	修改 Sponsored Brands 广告活动状态、预算、名称或已支持广告位竞价，并可在 Amazon 更新成功后同步分时策略基准值。
`put_campaigns_sd`	修改 SD 广告活动	修改 Sponsored Display 广告活动状态、名称或预算。
`put_campaigns_sp`	修改 SP 广告活动	修改 SP 广告活动，单次 1 至 1000 条
`put_targets`	修改 SB 投放	修改 Sponsored Brands 关键词、主题关键词或投放 Target 的状态或竞价，并可在 Amazon 更新成功后同步分时策略基准值。
`put_targets_sd`	修改 SD 投放	修改 Sponsored Display 投放状态或独立竞价，支持显式继承广告组默认竞价。
`put_targets_sp`	修改 SP 投放	修改 Sponsored Products 关键词、关键词组或投放的状态和独立竞价。

客服

1、绩效管理

工具ID	中文名称	描述
`customer_performance_notice_list`	查询业绩通知列表	业绩通知
`customer_store_performance_list`	查询店铺绩效列表	用于查询店铺绩效列表。
`customer_store_target_detail`	查询店铺绩效详情	查询店铺绩效详情
`customer_voice_buyer_list`	查询买家之声列表	用于查询买家之声列表。

2、客户管理

工具ID	中文名称	描述
`customer_service_customer_index`	查询客户列表	用于查询客户列表（新）。

3、售后管理

工具ID	中文名称	描述
`customer_service_rma_list`	查询 RMA 管理列表	用于查询RMA管理。

财务

1、往来管理

工具ID	中文名称	描述
`finance_custom_fee_list`	查询请款池其他应付款	用于查询请款池-其他应付款。
`finance_funds_order_list`	查询请款单列表	用于查询请款单列表。
`finance_other_fee_list`	查询请款池其他费用	查询请款池中的其他费用列表。
`finance_pool_logistics_list`	查询请款池物流请款	查询请款池-物流请款
`finance_pool_prepay_list`	查询请款池货款预付款	用于查询请款池 - 货款预付款。
`finance_receipt_funds_detail`	查询收款单详情	支持财务-收款单详情
`finance_receipt_funds_list`	查询收款单列表	支持查询收款单列表

2、财务结算

工具ID	中文名称	描述
`finance_compare_trade_reconcile`	查询交易对账详情	用于获取对账详情。
`finance_list_trade_reconcile`	查询交易对账列表	用于获取交易对账列表。

3、财务报告

工具ID	中文名称	描述
`finance_order_transcation_list`	查询订单维度利润交易明细	用于查询利润报表 - 订单维度transaction视图。
`get_profit_report_msku`	查询 MSKU 利润报表	查询MSKU利润报表

统计

1、销售分析

工具ID	中文名称	描述
`add_custom_indicator`	新增自定义指标	新增自定义指标，需指定指标名称、计算规则、字段类型等信息
`analytics_order_analysis_lists`	查询退货分析	支持统计-查询退货分析
`analytics_trend_hour_info`	查询 ASIN 360 小时趋势	查询asin360小时数据（查询产品每小时表现趋势数据）
`get_custom_indicator_field`	查询自定义指标计算字段	获取自定义指标计算规则枚举值。
`get_custom_indicator_list`	查询自定义指标列表	查询自定义指标列表，支持按指标名称搜索，支持按字段类型、维度、启用状态筛选
`get_custom_report_by_id`	查询自定义报表详情	获取指定自定义报表详情，通过报表ID或名称查询
`get_custom_report_list`	查询自定义报表列表	获取自定义报表列表，支持按报表名称搜索，支持按收藏状态、报表归属筛选
`query_product_performance_asin_lists`	查询 ASIN 维度产品表现	查询产品表现ASIN列表，支持按SPU/ASIN/MSKU/SKU搜索，支持按国家、店铺、日期筛选，支持多维度汇总和筛选（品牌、分类、负责人、配送方式、促销、标签等）
`update_custom_indicator`	编辑自定义指标	编辑自定义指标，更新指标名称、计算规则、字段类型等信息

2、利润统计

工具ID	中文名称	描述
`finance_page_list_msku`	查询 MSKU 维度订单利润	查询MSKU维度订单利润。
`query_order_profit_list`	查询订单利润报表	查询订单利润报表，返回订单利润全部字段（含订单利润自定义费用字段），支持按MSKU/ASIN/SKU等维度汇总，支持按日期、币种筛选。需要完整利润数据或自定义费用字段时使用本工具。
`query_order_profit_list_gross_profit`	查询订单毛利报表	查询订单利润毛利报表，支持按MSKU/ASIN/SKU等维度汇总，支持按日期、币种筛选
`settings_get_statistics_refund_config`	查询订单利润退款配置	用于查询订单利润-MSKU前获取退款计算配置。
`settings_get_statistics_storage_fee_config`	查询订单利润仓储费配置	用于查询订单利润-MSKU前获取仓储费配置。

3、进销存报表

工具ID	中文名称	描述
`analytics_cg_member_list`	查询采购员维度采购报表	用于查询采购报表列表 - 采购员。
`analytics_show_product_list`	查询产品维度采购报表	用于查询采购报表列表 - 产品。
`analytics_show_supplier_list`	查询供应商维度采购报表	用于查询采购报表列表 - 供应商。

4、亚马逊源报告

工具ID	中文名称	描述
`analytics_report_adjustment_list`	查询 FBA 调整报告	查询亚马逊源报表中的盘存记录，支持按店铺及日期范围筛选，按ASIN、MSKU、FNSKU、标题或交易编号搜索，并支持分页查询。

5、亚马逊报告

工具ID	中文名称	描述
`analytics_report_reimbursement_list`	查询亚马逊赔偿报告	亚马逊赔偿记录

6、VC

工具ID	中文名称	描述
`analytics_realtime_sales_list`	查询 VC 实时销量报表	VC报表-实时销量报表
`analytics_vc_inventory_list`	查询 VC 库存报表	VC报表-库存报表
`analytics_vc_nppm_list`	查询 VC 产品利润率报表	VC报表-产品利润率报表
`analytics_vc_sales_list`	查询 VC 销量报表	VC报表-销量报表
`analytics_vc_traffic_list`	查询 VC 流量报表	VC报表-流量报表

工具

1、工具

工具ID	中文名称	描述
`create_erp_competitive_monitor`	新增竞品监控	新增竞品监控，需指定ASIN、国家和竞品等级
`create_erp_follow_sale_monitor`	新增 ASIN 跟卖监控	添加ASIN跟卖监控，需指定国家和ASIN
`create_erp_keyword`	新增关键词排名监控	手动添加关键词排名监控（支持批量），需指定国家、关键词和ASIN
`create_erp_new_monitor`	新增店铺监控	添加店铺监控，需指定国家和店铺信息
`query_erp_competitive_monitor`	查询竞品监控列表	查询竞品监控列表，支持按ASIN搜索，支持按更新时间筛选、国家、竞品等级、监控人等多维度筛选和排序
`query_erp_follow_sale_monitor`	查询 ASIN 跟卖监控列表	查询ASIN跟卖监控列表，支持按ASIN/父ASIN/标题搜索，支持按国家、关注状态、商品状态、卖家数量筛选
`query_erp_keyword_ranking_asin`	查询 ASIN 维度关键词排名	查询关键词排名ASIN维度列表，支持按ASIN搜索，支持按关注状态筛选
`query_erp_keyword_ranking_keyword`	查询关键词维度排名	查询关键词排名关键词维度列表，支持按关键词搜索
`query_erp_new_monitor`	查询店铺监控列表	查询店铺监控列表，支持按店铺名搜索，支持按国家、创建人、监控人筛选
`tools_get_postcode_list`	查询邮编列表	查询邮编列表

2、预警

工具ID	中文名称	描述
`settings_message_inventory_list`	查询库存预警消息	用于查询预警消息列表-库存。
`settings_message_seller_list`	查询卖家预警消息	查询预警消息列表(卖家维度)

设置

1、基础配置

工具ID	中文名称	描述
`settings_transport_method_list`	查询运输方式列表	支持查询自定义运输方式，对应系统【设置】>【业务配置】>【物流】当中的运输方式。

2、基础数据

工具ID	中文名称	描述
`get_my_sids`	查询我的店铺列表	查询当前用户的店铺列表,返回店铺ID(sid)、店铺名称、亚马逊卖家ID(seller_id)、国家等信息。返回的id即为其他接口中的sid(系统店铺ID)
`platform_report_state_list`	查询国家州省编码	获取国家下的州、省编码。
`settings_auth_page_list`	查询 VC 店铺列表	查询VC店铺列表。
`settings_exchange_rate_update`	修改我的汇率	用于修改我的汇率。

多平台

多平台

工具ID	中文名称	描述
`advertising_audience_report_list`	查询 Lazada 广告受众报告	用于Lazada广告-受众报告。
`advertising_campaign_report_list`	查询 Lazada 广告活动报告	用于Lazada广告-广告活动报告。
`advertising_item_report_list`	查询 Lazada 广告商品报告	用于Lazada广告-广告商品报告。
`advertising_keyword_report_list`	查询 Lazada 关键词报告	用于Lazada广告-关键词报告。
`advertising_lazada_campaign_info`	查询 Lazada 广告活动信息	Lazada广告-获取广告活动信息
`advertising_lazada_item_info`	查询 Lazada 广告商品信息	Lazada广告-获取广告商品信息
`advertising_store_report_list`	查询 Lazada 广告店铺报告	用于Lazada广告-店铺报告。
`finance_finance_lazada_payout`	查询 Lazada 回款明细	用于回款明细-LazadaPayout。
`finance_finance_lazada_settlement`	查询 Lazada 账单结算明细	用于账单明细-LazadaSettlement。
`finance_finance_shopee_adjustment`	查询 Shopee 账单调整明细	用于账单明细-ShopeeAdjustment。
`finance_finance_shopee_payout`	查询 Shopee 回款明细	用于回款明细-ShopeePayout。
`finance_profit_report_config`	查询利润报表列表配置	用于利润报表-列表配置查询。
`finance_settlement_profit_list`	查询利润报表明细	用于利润报表-明细列表查询。
`finance_shopee_income_list`	查询 Shopee 账单收入明细	用于账单明细-ShopeeIncome。
`get_multi_platform_shop_list`	查询多平台店铺列表	获取用户所有有权限平台的店铺信息，返回店铺ID、店铺名称、平台、站点、国家、币种等。支持按平台、亚马逊店铺ID、店铺ID筛选
`get_walmart_sb_ad_group_report`	查询 Walmart SB 广告组报告	查询沃尔玛SB广告组报告。
`get_walmart_sb_ad_item_report`	查询 Walmart SB 广告项报表	查询沃尔玛SB广告的广告项报表
`get_walmart_sb_campaign_report`	查询 Walmart SB 广告活动报告	查询沃尔玛SB广告活动报告。
`get_walmart_sb_keyword_report`	查询 Walmart SB 关键词报告	查询沃尔玛SB关键词报告。
`get_walmart_sp_ad_group_report`	查询 Walmart SP 广告组报告	查询沃尔玛SP广告组报告。
`get_walmart_sp_ad_item_report`	查询 Walmart SP 广告项报表	查询沃尔玛SP广告的广告项报表
`get_walmart_sp_campaign_report`	查询 Walmart SP 广告活动报告	查询沃尔玛SP广告活动报告。
`get_walmart_sp_keyword_report`	查询 Walmart SP 关键词报告	查询沃尔玛SP关键词报告。
`get_walmart_sv_ad_group_report`	查询 Walmart SV 广告组报告	查询沃尔玛SV广告组报告。
`get_walmart_sv_ad_item_report`	查询 Walmart SV 广告项报表	查询沃尔玛SV广告的广告项报表
`get_walmart_sv_campaign_report`	查询 Walmart SV 广告活动报告	查询沃尔玛SV广告活动报告。
`get_walmart_sv_keyword_report`	查询 Walmart SV 关键词报告	查询沃尔玛SV关键词报告。
`platform_ad_group_list`	查询 TikTok 推广广告组	查询TikTok-推广广告-广告组。
`platform_adjustment_settlement_list`	查询 SHEIN 代运营补扣款明细	查询Shein代运营补扣款明细列表，对应系统【财务】>【SHEIN代运营】>【账单明细】>【补扣款明细】数据。
`platform_advertiser_report_list`	查询 TikTok GMV MAX 广告账号报告	查询TikTok-GMV MAX-广告帐号。唯一键：subjectId + reportDate。
`platform_ali_express_list`	查询 AliExpress 在线商品	查询AliExpress自运营模式下的子体在线商品列表，支持按店铺、负责人、商品状态及时间范围筛选，并支持商品搜索和分页查询。
`platform_alibaba_icbu_list`	查询阿里国际站在线商品	用于查询阿里国际站在线商品。
`platform_aliexpress_list_v2`	查询 AliExpress 托管商品	用于查询AliExpress在线商品 - 托管模式。
`platform_batch_revert_order`	撤销自发货订单发货	用于批量撤销自发货订单的发货操作。
`platform_bill_payment_list`	查询 TikTok 回款明细	用于TikTok回款明细。
`platform_bill_payout_list`	查询 Walmart 回款明细	用于Walmart-查询回款明细列表。
`platform_cargo_goods_list`	查询 WFS 货件可添加商品	用于查询WFS货件可添加商品列表。
`platform_common_advertiser_list`	查询 TikTok 推广广告账号	用于查询TikTok-推广广告-广告帐号。
`platform_delete_cargo_storage`	删除多平台暂存货件	用于删除多平台暂存货件。
`platform_delete_manual_order`	删除多平台手工订单	用于删除多平台手工创建的订单。
`platform_full_epr_list`	查询 Temu 全托管 EPR 费用	查询Temu全托EPR费用列表，对应系统【财务】>【Temu全托管-账单明细-EPR费用】数据。
`platform_full_fee_list`	查询 Temu 全托管支出详情	查询Temu全托支出费用列表，对应系统【财务】>【Temu全托管-账单明细-支出详情】数据。
`platform_full_finance_list`	查询 Temu 全托管账务明细	查询Temu全托财务明细列表，对应系统【财务】>【Temu全托管-账单明细-账务明细】数据。
`platform_full_transaction_list`	查询 Temu 全托管交易明细	Temu全托-支出费用
`platform_full_warehouse_list`	查询 Temu 全托管仓储明细	查询Temu全托管账单中的仓储综合服务费列表，支持按店铺、日期、费用类型及单号等条件筛选和分页查询。
`platform_gmv_campaign_report_list`	查询 TikTok GMV MAX 推广系列报告	查询TikTok-GMV MAX-推广系列。唯一键：subjectId + reportDate。
`platform_gmv_store_list`	查询 TikTok GMV MAX 店铺报告	查询TikTok-GMV MAX-店铺列表。唯一键：storeId + reportDate。
`platform_group_report_list`	查询 TikTok GMV MAX 广告商品报告	查询TikTok-GMV MAX-广告商品。唯一键：subjectId + reportDate。
`platform_half_fee_list`	查询 Temu 半托管费用明细	查询Temu半托管跨境店的支出详情列表，对应财务中的Temu半托管-跨境店账单明细，支持按店铺、日期及单号等条件筛选和分页查询。
`platform_half_finance_list`	查询 Temu 半托管账务明细	查询Temu半托管跨境店的账务明细列表，支持按店铺、日期、账务类型及对账差额等条件筛选和分页查询。
`platform_half_other_list`	查询 Temu 半托管支出明细	Temu半托-支出明细
`platform_half_po_list`	查询 Temu 半托管 PO 明细	查询Temu半托PO明细列表，对应系统【财务】>【Temu半托管-跨境店-账单明细-PO明细】数据。
`platform_listing_batch_pair`	批量配对在线商品	用于多平台-批量在线商品配对。
`platform_listing_cancel_pair`	取消在线商品配对	用于取消多平台在线商品配对关系。
`platform_listing_cdiscount_list`	查询 Cdiscount 在线商品	用于查询Cdiscount在线商品。
`platform_listing_coupang_list`	查询 Coupang 在线商品	用于查询Coupang在线商品。
`platform_listing_create_publish_queue`	修改 Temu 商品库存	用于通过发布队列修改 Temu 在线商品库存。
`platform_listing_ebay_list`	查询 eBay 在线商品	查询eBay在线商品列表，支持按店铺、站点、负责人、销售状态及时间范围筛选，并支持商品搜索和分页查询。
`platform_listing_kaufland_list`	查询 Kaufland 在线商品	用于查询Kaufland在线商品。
`platform_listing_lazada_list`	查询 Lazada 在线商品	用于查询Lazada在线商品。
`platform_listing_line_list`	查询 LINE 平台在线商品列表	查询LINE平台在线商品列表
`platform_listing_mercado_list`	查询 Mercado 在线商品	用于查询Mercado在线商品。
`platform_listing_otto_list`	查询 OTTO 在线商品	用于查询OTTO在线商品。
`platform_listing_ozon_list`	查询 Ozon 在线商品	用于查询Ozon在线商品。
`platform_listing_rakuten_list`	查询 Rakuten 在线商品	用于查询Rakuten在线商品。
`platform_listing_shein_list`	查询 Shein 在线商品	用于查询Shein在线商品。
`platform_listing_shopee_list`	查询 Shopee 在线商品	用于查询Shopee在线商品。
`platform_listing_temu_list`	查询 Temu 在线商品	用于查询Temu在线商品。
`platform_listing_tiktok_list`	查询 TikTok 在线商品	用于查询TikTok在线商品。
`platform_listing_walmart_list`	查询 Walmart 在线商品	查询Walmart在线商品。
`platform_local_bill_list`	查询 Temu 本土店账务明细	查询Temu本土账务明细列表，对应系统【财务】>【Temu半托管-本土店-账务明细】数据。
`platform_managed_payout_list`	查询 SHEIN 代运营回款明细	查询Shein代运营回款明细列表，对应系统【财务】>【SHEIN代运营】>【回款明细】数据。
`platform_mercado_bill_list`	查询美客多账单明细	查询美客多账单明细，对应系统【财务】>【MercadoLibre】>【账单明细】数据。
`platform_order_pre_shipment`	执行多平台订单预发货	用于对待审核发货的多平台订单执行预发货。
`platform_page_type_splist`	查询 Walmart SP 广告页面类型	用于查询沃尔玛-广告 - SP广告 - 页面类型。
`platform_platform_listing_qoo10list`	查询 Qoo10 在线商品	用于查询Qoo10在线商品。
`platform_platform_sb_list`	查询 Walmart SB 广告平台	用于查询沃尔玛-广告 - SB广告 - 平台。
`platform_platform_sp_list`	查询 Walmart SP 广告平台	用于查询沃尔玛-广告 - SP广告 - 平台。
`platform_platform_sv_list`	查询 Walmart SV 广告平台	用于查询沃尔玛-广告 - SV广告 - 平台。
`platform_query_ad_list`	查询 TikTok 推广广告	用于查询TikTok-推广广告-广告。
`platform_query_campaign_list`	查询 TikTok 推广广告系列	查询TikTok-推广广告-广告系列。
`platform_query_shipping_list`	查询平台仓发货单	用于查询平台仓发货单列表v2。
`platform_return_address_list`	查询退件地址列表	用于查询退件地址列表。
`platform_return_fee_list`	查询 Temu 半托管退货面单费	查询Temu半托退货面单费列表，对应系统【财务】>【Temu半托管-跨境店-账单明细-退货面单费】数据。
`platform_sales_settlement_list`	查询 SHEIN 代运营收支明细	用于查询Shein代运营收支明细列表。
`platform_search_trends_list`	查询 Walmart 搜索趋势报表	查询 Walmart 搜索趋势报表列表
`platform_shein_create_publish_queue`	修改 SHEIN 商品库存	用于通过发布队列修改 SHEIN 在线商品库存。
`platform_ship_fee_list`	查询 Temu 半托管发货面单费	查询Temu半托发货面单费列表，对应系统【财务】>【Temu半托管-跨境店-账单明细-发货面单费】数据。
`platform_shipping_allocate_stock`	分配平台仓发货单库存	用于为平台仓发货单分配库存。
`platform_shipping_delivery_batch`	确认平台仓发货单发货	用于批量确认平台仓发货单发货。
`platform_shipping_picking_batch`	为平台仓发货单拣货	用于平台仓发货单拣货。
`platform_shopify_bill_statement_list`	查询 Shopify 结算明细	用于Shopify-查询结算明细列表。
`platform_shopify_return_order_list`	查询 Shopify 退货订单列表	查询Shopify退货订单列表
`platform_shopify_variant_list`	查询 Shopify 在线商品	用于查询Shopify在线商品。
`platform_store_report_list`	查询 Shopee 店铺报告	用于分页查询店铺报告列表。
`platform_temu_return_order_list`	查询 Temu 售后订单	查询Temu售后订单列表。
`platform_tiktok_bill_list`	查询 TikTok 账单明细	用于TikTok账单明细。
`platform_tiktok_product_analysis_list`	查询 TikTok 产品表现	用于查询TikTok产品表现。
`platform_tiktok_return_order_list`	查询 TikTok 售后订单	查询TikTok售后订单列表。
`platform_type_sb_list`	查询 Walmart SB 广告页面类型	用于查询沃尔玛-广告 - SB广告 - 页面类型。
`platform_type_sv_list`	查询 Walmart SV 广告页面类型	用于查询沃尔玛-广告 - SV广告 - 页面类型。
`platform_v2_page_list`	查询销量统计列表	用于查询销量统计列表v2。
`platform_walmart_bill_statement_list`	查询 Walmart 结算账单	用于Walmart-查询结算账单列表。
`platform_walmart_comment_list`	查询 Walmart 评价列表	查询Walmart评价列表。
`platform_walmart_product_analysis_list`	查询 Walmart 产品表现	用于查询Walmart产品表现。
`platform_walmart_publish_queue`	修改 Walmart 商品库存	walmart修改库存
`platform_walmart_return_order_list`	查询 Walmart 售后订单	查询Walmart售后订单列表。
`platform_warehouse_cargo_storage`	暂存 WFS 货件	用于暂存 WFS 货件。
`platform_warehouse_coupang_stock`	查询 Coupang 库存	支持多平台-查询Coupang库存。
`platform_warehouse_fbs_stock`	查询 FBS 库存	支持多平台-查询FBS库存。
`platform_warehouse_fbt_stock`	查询 FBT 库存	用于多平台-查询FBT库存。
`platform_warehouse_full_stock`	查询 FULL 库存	用于查询FULL库存。
`platform_warehouse_wayfair_stock`	查询 Wayfair 库存	用于多平台-查询wayfair库存。
`sales_order_delivery_goods`	执行自发货订单发货	用于对订单执行发货，并标记出库及扣减库存。
`sales_temu_address_decrypt`	批量解密 Temu 地址	用于批量TEMU地址解密。
`warehouse_fbt_cargo_list`	查询 FBT 货件列表	用于查询FBT货件列表。
`warehouse_fbt_cargo_sync`	手动同步 FBT 货件	用于手动同步 FBT 货件。
`warehouse_stock_order_page`	查询 Temu 平台仓备货单	用于查询Temu平台仓备货单列表。

A店铺、商品与经营结果

先确定店铺和业务对象，再看销量、利润，避免跨站点或跨口径混算。

细分场景	类型	公开工具 / 当前能力	适合提问
店铺与站点识别	查询	`get_my_sids`：返回有权限的店铺 ID、名称、站点等。	“列出我有权限的美国站店铺及店铺 ID。”
Listing 清单	查询	`erp_listing`：按 MSKU、ASIN、SKU、店铺、状态等筛选。	“查美国站在售的 FBA Listing，列出 ASIN 和 MSKU。”
产品表现	查询	`query_product_performance_asin_lists`：按 ASIN、店铺、日期等分析。	“按 ASIN 汇总上周销量、销售额并排序。”
MSKU 利润	查询	`get_profit_report_msku`：查看指定时间段的 MSKU 利润。	“上个月哪些 MSKU 毛利最低？”
订单毛利	查询	`query_order_profit_list_gross_profit`：按商品等维度汇总订单毛利。	“按 ASIN 汇总本月订单毛利，注明币种。”

B库存、补货与供应链

库存查询已有公开工具名；补货与更多供应链能力见领星后续版本更新，具体可调用工具以账号实际开放为准。

细分场景	类型	公开工具 / 当前能力	适合提问
FBA 库存	查询	`get_fba_stock_list`：按 SKU、FNSKU、仓库、店铺等检索。	“A001 在各 FBA 仓库还有多少库存？”
补货建议	新增方向		“按我有权限的店铺找出未来可能断货的商品及建议补货量。”
供应链业务	新增方向		“列出当前可用的采购或仓库相关领星工具，再按权限查询。”

C广告：从授权店铺到投放结果

广告按分析层级拆开：店铺 → 活动 → 广告组 → 关键词/搜索词/投放 → 广告商品与组合。调整广告设置属于操作能力。

细分场景	类型	公开工具 / 当前能力	适合提问
广告授权店铺	查询	`ad_auth_shops`：核对广告店铺及 Profile ID。	“我有哪些已授权的美国站广告店铺？”
广告活动报告	查询	`ad_campaign_report`：活动层级花费、销售等表现。	“按花费排序上周 SP 广告活动。”
广告组报告	查询	`ad_campaign_group_report`：下钻到广告组。	“这个活动下哪些广告组的转化率偏低？”
广告关键词	查询	`ad_campaign_keyword_report`：关键词投放表现。	“列出 ACoS 超过 30% 的广告关键词。”
客户搜索词	查询	`ad_campaign_search_term_report`：查看实际搜索词表现。	“最近一周哪些搜索词有点击但没有订单？”
自动/商品投放	查询	`ad_campaign_targeting_report`：投放对象层级报告。	“对比自动投放和商品投放的 ACoS。”
广告商品	查询	`ad_campaign_product_report`：商品或创意层级表现。	“这个活动下哪些广告商品带来的订单最多？”
广告组合	查询	`ad_portfolio_report_shop`：组合在店铺维度的表现。	“按店铺汇总各广告组合的花费与 ROAS。”
广告设置调整	操作		“先列出拟调整的活动、原值和新值，再提交审批。”

D关键词与市场监控

自然关键词排名与广告关键词报告是两套业务口径；监控类还可分别查询竞品、跟卖和店铺。

细分场景	类型	公开工具 / 当前能力	适合提问
关键词自然排名	查询操作	`query_erp_keyword_ranking_keyword`、`query_erp_keyword_ranking_asin`；添加监控：`create_erp_keyword`。	“这个 ASIN 在指定关键词下排第几？再为关键词发起监控。”
竞品监控	查询操作	`query_erp_competitive_monitor`；添加：`create_erp_competitive_monitor`。	“查看竞品 B0XXXXXX 的价格、评分和排名；需要时添加监控。”
跟卖监控	查询操作	`query_erp_follow_sale_monitor`；添加：`create_erp_follow_sale_monitor`。	“哪些 ASIN 的跟卖卖家数超过 3？”
店铺监控	查询操作	`query_erp_new_monitor`；添加：`create_erp_new_monitor`。	“列出美国站正在监控的店铺；为指定店铺申请监控。”

E报表、指标与多平台

区分“读取已有报表”和“维护分析口径”。2026 年更新还扩展了多平台统计及沃尔玛广告报告。

细分场景	类型	公开工具 / 当前能力	适合提问
自定义报表查找	查询	`get_custom_report_list`：按名称或收藏状态定位报表。	“找出我收藏的利润类自定义报表。”
自定义报表详情	查询	`get_custom_report_by_id`：查看指定报表详情。2026 年 6 月更新确认报表编辑能力，具体工具名以实际清单为准。	“打开‘月度销售汇总’并解释关键指标。”
自定义指标查询	查询	`get_custom_indicator_list`：列出指标；`get_custom_indicator_field`：查询可用计算字段。	“列出已启用的销售类指标及可用计算字段。”
自定义指标维护	操作	`add_custom_indicator`、`update_custom_indicator`：创建和修改指标。	“先核对计算字段与公式，再申请新增指标。”
多平台经营统计	新增方向		“按平台和店铺分别汇总上周的经营数据。”
沃尔玛广告报告	新增方向		“查看我有权限的沃尔玛店铺上周广告表现。”

五、常见问题

Q1：MCP和普通API有什么区别？

A：普通API需要写代码对接，MCP是标准化协议（Model Context Protocol），配置更简单，AI助手能直接理解并调用，无需手动写代码。你只需要用自然语言提问，AI会自动选择合适的Tool并返回结果。

Q2：数据是实时的吗？

A：是的，数据与ERP页面数据一致，实时同步。

Q3：查询有次数限制吗？

A：目前无查询次数限制。但是每秒钟只能查询1次（QPS=1）。

Q4：MCP配置后未生效怎么办？

A：此问题通常是由于以下原因导致：

配置的工具集过多：配置的工具集过多可能导致大模型无法正确选择工具。请尝试移除其他MCP工具，仅保留必要的工具。
提示词不够精确：当提示词不够精确时，模型可能无法正确调用工具。请使用更具体的查询，例如："查一下ASIN B0XXXXXX的FBA库存情况"。
权限未开通：确保MCP Server已在对应空间中启用，且当前帐号拥有相关数据的查看权限。

Q5：鉴权失败怎么办？

A：请按以下步骤排查：

检查X-Mcp-Key是否配置：MCP服务需要鉴权密钥才能调用。请确认在AI工具的MCP配置中，headers里已添加 "X-Mcp-Key": "<你的鉴权密钥>"。仅配置URL而不配置鉴权头，会导致鉴权失败。
检查密钥是否正确：在ERP的【AI助手】-【管理MCP】页面重新复制鉴权密钥，确保复制完整、无多余空格。
检查MCP功能是否启用：需要超级管理员在【业务配置】-【开放接口】-【MCP】中启用MCP功能（仅限付费用户）。
检查帐号权限：MCP Server URL与当前领星帐号的数据权限绑定，请确认帐号是否拥有相关数据的查看权限。
检查URL协议：服务器URL应使用 https:// 协议，而非 http://。

Q6：领星MCP支持哪些AI工具？

A：领星MCP支持任何支持自定义MCP工具的AI平台，包括但不限于：OpenClaw、WorkBuddy、Cursor、ChatGPT、Claude、Gemini、Trae、通义千问、Manus、百度千帆等。传输方式为 Streamable HTTP（HTTP Streaming）。

Q7：不同帐号获取的MCP URL有什么区别？

A：MCP Server URL与当前领星帐号的数据权限绑定。不同帐号获取的URL可查询的数据范围不同，取决于该帐号在ERP中的权限配置。请勿将个人MCP URL和鉴权密钥分享给他人使用，以免数据泄露。

领星MCP

一、什么是MCP

二、怎么启用

2.1 在领星AI助手中启用

2.2 获取领星MCP配置地址

2.3 获取鉴权密钥（X-Mcp-Key）

三、如何在第三方应用中使用

四、工具能力

工具清单：

产品

销售

1、商品管理

2、平台订单

3、运营管理

4、促销管理

FBA

1、补货

2、货件

3、VC

采购

采购单据

仓库

1、库存

2、收货

3、海外仓

4、出入库

物流

1、头程物流

2、自发货物流

广告

1、报告

2、基础数据

客服

1、绩效管理

2、客户管理

3、售后管理

财务

1、往来管理

2、财务结算

3、财务报告

统计

1、销售分析

2、利润统计

3、进销存报表

4、亚马逊源报告

5、亚马逊报告

6、VC

工具

1、工具

2、预警

设置

1、基础配置

2、基础数据

多平台

多平台

A店铺、商品与经营结果

B库存、补货与供应链

C广告：从授权店铺到投放结果

D关键词与市场监控

E报表、指标与多平台

五、常见问题

Q1：MCP和普通API有什么区别？

Q2：数据是实时的吗？

Q3：查询有次数限制吗？

Q4：MCP配置后未生效怎么办？

Q5：鉴权失败怎么办？

Q6：领星MCP支持哪些AI工具？

Q7：不同帐号获取的MCP URL有什么区别？