领星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】
点击复制服务器URL——链接会自动复制到剪切板，直接粘贴到三方应用即可

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

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

领星MCP支持接入任何支持自定义MCP工具的AI平台（如Cursor、ChatGPT、Claude、Gemini、Trae、通义千问等），配置方法通用。

3.1 获取MCP Server URL

按照上方"获取领星MCP配置地址"步骤，复制MCP Server URL。

URL格式如下：

{

"mcpServers": {

"LingXing-MCP": {

"type": "streamableHttp",

"url": "http://openmcp.lingxing.com/mcp-servers/lingxing-mcp",

"headers": {

"X-Mcp-Key": "<token>"

}

}

}

}

说明：如果你的日常使用是以某个固定用户身份进行操作，可以将用户身份参数拼接到URL中，这样在构建或调用AI Agent时无需重复传入，简化调用过程。

3.2 在各AI工具中配置

在Cursor中配置

打开Cursor，进入 Settings > MCP
点击 + Add new global MCP server
配置如下：

{ "mcpServers": { "lingxing-mcp": { "url": "<YOUR_MCP_URL>", "transport": "streamable_http" } } }

保存后，在AI对话中即可调用领星数据

在Trae中配置

在Trae中，进入 设置 > MCP，单击 + 添加 MCP > 手动添加
在手动配置中填入以下信息，将MCP Server URL替换为步骤一获取的地址：

{ "mcpServers": { "lingxing-mcp": { "url": "<YOUR_MCP_URL>" } } }

将该MCP添加到智能体，在AI对话中@智能体即可使用

在ChatGPT中配置

进入ChatGPT的 Developer Mode
在MCP connectors配置中添加领星MCP Server URL
传输方式选择 HTTP Streaming

在其他AI工具中配置

领星MCP可与任何支持自定义工具的AI平台集成，通用配置步骤：

获取MCP Server URL
在AI工具的MCP/工具管理中，选择"添加自定义MCP工具"
将URL贴入，传输方式选择 HTTP Streaming / Streamable HTTP
保存后即可在对话中使用

提示：若需为团队分享使用该服务，建议将URL中的用户身份参数设置为变量，通过Header传入，以实现不同人使用AI服务时能正确鉴权。

四、工具能力

领星 MCP Server 提供了多种 Tool。与 Open API 相同，每个 Tool 的调用频率限制（QPS）为 1。当您构建 AI Agent 时，可以在输入信息中提供 Tool 所需参数，来提升 AI 的调用成功率并减少幻觉。

落地页	工具	使用场景	提问示例
店铺管理	`get_my_sids`	查询当前用户的店铺列表，返回店铺ID（sid）、店铺名称、亚马逊卖家ID（seller_id）、国家等信息	"我有哪几个店铺？"、"帮我查一下我名下所有店铺的ID和国家"
FBA库存	`get_fba_stock_list`	查询FBA仓库库存列表，支持按SKU/品名/SPU/FNSKU搜索，支持按仓库、店铺、配送方式筛选	"A001还剩多少库存？"、"帮我查一下FBA仓库里SKU为XXX的库存情况"、"哪些SKU的FBA库存低于100？"
Listing管理	`erp_listing`	查询Listing列表，支持按MSKU/ASIN/SKU搜索，支持按店铺、状态、配送方式、分类、品牌、国家等筛选	"这个ASIN的评分是多少？"、"帮我查一下美国站FBA的Listing有哪些？"、"最近30天销量最高的Listing是哪些？"
产品表现	`query_product_performance_asin_lists`	查询产品表现ASIN列表，支持按SPU/ASIN/MSKU/SKU搜索，支持按国家、店铺、日期筛选，支持多维度汇总和筛选（品牌、分类、负责人、配送方式、促销、标签等）	"上周卖了多少钱？"、"帮我看看这个ASIN最近一个月的销售趋势"、"按ASIN汇总一下上个月各产品的销售额"
利润报表	`get_profit_report_msku`	查询MSKU利润报表，支持按日期范围查询，支持按月统计	"上个月各SKU利润如何？"、"帮我查一下这个MSKU的利润情况"
订单利润	`query_order_profit_list_gross_profit`	查询订单利润毛利报表，支持按MSKU/ASIN/SKU等维度汇总，支持按日期、币种筛选	"上个月各ASIN的毛利是多少？"、"按店铺汇总一下本月的订单利润"
关键词排名	`query_erp_keyword_ranking_keyword`	查询关键词排名关键词维度列表，支持按关键词搜索	"某关键词下排第几？"、"帮我查一下'power bank'这个关键词的排名情况"
关键词排名	`query_erp_keyword_ranking_asin`	查询关键词排名ASIN维度列表，支持按ASIN搜索，支持按关注状态筛选	"这个ASIN在哪些关键词下有排名？"、"帮我看看关注的ASIN关键词排名变化"
关键词排名	`create_erp_keyword`	手动添加关键词排名监控（支持批量），需指定国家、关键词和ASIN	"帮我给这个ASIN添加关键词排名监控"
竞品监控	`query_erp_competitive_monitor`	查询竞品监控列表，支持按ASIN搜索，支持按更新时间筛选和多种字段排序（价格、评分、评论数、大类排名、30天销量等）	"竞品最近价格有变化吗？"、"帮我看看竞品B0XXXXXX的评分和排名"
竞品监控	`create_erp_competitive_monitor`	新增竞品监控，需指定ASIN、国家和竞品等级（A/B/C/D）	"帮我添加一个竞品监控，ASIN是B0XXXXXX，等级设为A"
跟卖监控	`query_erp_follow_sale_monitor`	查询ASIN跟卖监控列表，支持按ASIN/父ASIN/标题搜索，支持按国家、关注状态、商品状态、卖家数量筛选	"有没有新跟卖？"、"帮我查一下这个ASIN的跟卖情况，卖家数量超过3个的"
跟卖监控	`create_erp_follow_sale_monitor`	添加ASIN跟卖监控，需指定国家和ASIN，支持批量添加	"帮我给ASIN B0XXXXXX添加跟卖监控，国家选美国"
店铺监控	`query_erp_new_monitor`	查询店铺监控列表，支持按店铺名搜索，支持按国家、创建人、监控人筛选	"帮我看看正在监控的店铺有哪些？"、"查一下美国站监控的店铺列表"
店铺监控	`create_erp_new_monitor`	添加店铺监控，需指定国家和店铺信息	"帮我添加一个店铺监控，店铺名是XXX，国家选美国"
广告管理	`ad_auth_shops`	查询广告授权店铺列表，返回所有已授权的广告店铺信息（店铺名称、国家、Profile ID等）	"我有哪些广告授权店铺？"、"帮我查一下美国站的广告Profile ID"
广告管理	`ad_campaign_report`	查询广告活动报告，支持按日期、店铺、状态、竞价策略、广告类型（SP/SB/SD）等多维度筛选和排序	"上个月哪个广告活动ACOS最高？"、"帮我查一下SP广告活动的花费和销售额"
广告管理	`ad_campaign_group_report`	查询广告组报告，支持按日期、店铺、广告类型、广告活动等筛选	"这个广告活动下各广告组表现怎么样？"、"按广告组查看点击和转化率"
广告管理	`ad_campaign_keyword_report`	查询广告关键词投放报告，支持按关键词搜索、匹配方式、聚合方式筛选	"哪些关键词的ACOS超过了30%？"、"帮我看看'power bank'这个关键词的投放效果"
广告管理	`ad_campaign_search_term_report`	查询广告搜索词报告，支持按搜索词、投放类型、广告对象等筛选，支持翻译为中文	"这个广告活动带来了哪些客户搜索词？"、"帮我分析最近一周的搜索词表现"
广告管理	`ad_campaign_targeting_report`	查询广告投放报告（自动投放或商品投放），支持按状态、策略、搜索文本筛选	"自动投放的效果如何？"、"帮我查一下商品投放的ACOS和订单数"
广告管理	`ad_campaign_product_report`	查询广告商品报告，支持按状态、创意类型（视频/商品）、搜索文本筛选	"这个广告活动下哪些ASIN表现最好？"、"帮我对比视频创意和商品创意的转化率"
广告管理	`ad_portfolio_report_shop`	查询广告组合报告（店铺维度），支持按日期范围、店铺、国家、服务状态筛选	"各店铺的广告花费和ROAS怎么样？"、"按店铺汇总上个月的广告表现"
自定义报表	`get_custom_report_list`	获取自定义报表列表，支持按报表名称搜索，支持按收藏状态、报表归属筛选	"帮我找一下收藏的自定义报表"、"搜索名称含'利润'的报表"
自定义报表	`get_custom_report_by_id`	获取指定自定义报表详情，通过报表ID或名称查询	"帮我打开'月度销售汇总'这个报表"、"查看这个报表的具体数据"
自定义指标	`get_custom_indicator_list`	查询自定义指标列表，支持按指标名称搜索，支持按字段类型（销售/库存/广告/财务）、维度、启用状态筛选	"我有哪些自定义指标？"、"帮我查一下所有启用的销售类自定义指标"
自定义指标	`get_custom_indicator_field`	获取自定义指标计算规则枚举值（调用 add/update 前需先调此工具）	"有哪些可用的计算字段？"、"帮我查一下产品表现和订单利润的计算字段"
自定义指标	`add_custom_indicator`	新增自定义指标，需指定指标名称、计算规则（如 ROAS + ACOS）、字段类型、维度、显示方式等信息	"帮我创建一个'综合得分'指标，公式是销售额/花费"
自定义指标	`update_custom_indicator`	编辑自定义指标，更新指标名称、计算规则、字段类型等信息	"帮我把'综合得分'指标改成销售额/（花费+广告费）"

五、常见问题

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

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

Q2：数据是实时的吗？

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

Q3：查询有次数限制吗？

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

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

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

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

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

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

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

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