星拓MCP
一、什么是MCP
星拓MCP(Model Context Protocol) 是一项基于 MCP 标准协议的官方服务,旨在让AI能够安全、标准化地连接外部数据源和工具。通过星拓MCP,你可以将星拓系统中的业务数据(店铺、产品、广告等)接入任何支持MCP的AI工具,用自然语言即可查询和操作,无需编写代码。
|
对比维度
|
传统API
|
MCP
|
|
接入方式
|
需要写代码对接,处理鉴权、参数、异常
|
配置URL即可,AI自动理解并调用
|
|
使用门槛
|
需要开发能力
|
自然语言提问即可
|
|
标准化程度
|
每个API格式不同,需逐一适配
|
统一协议,一次配置多平台通用
|
|
交互方式
|
构造HTTP请求,解析JSON响应
|
用自然语言描述需求,AI自动选择Tool并返回结果
|
二、怎么启用
当前星拓MCP仅支持安装到第三方AI工具使用,具体步骤如下:
2.1 权限分配
默认管理员有“MCP”的使用权限,其他账号需要主账号分配(注意:必须确保产品和广告模块拥有“查看”权限)。

2.2 获取星拓MCP配置地址和个人密钥
无论使用哪款 AI 工具,配置星拓 MCP 都需要先获取服务器URL和鉴权密钥(X-Mcp-Key)。
注意:
密钥和当前星拓帐号绑定,即通过该URL查询到的数据范围与当前登录帐号在星拓中的权限一致; 密钥请妥善保管,请勿分享给他人,以免数据泄露。如果密钥泄露,可在【星拓-MCP】页面更换密钥。
请访问 https://app.startop.com/home 获取MCP的服务器URL和密钥

2.3 在第三方AI工具配置
星拓MCP支持接入任何支持自定义MCP工具的AI平台(如 OpenClaw、WorkBuddy、Cursor、ChatGPT(Codex)、Claude、Gemini、Trae、通义千问等),配置方法通用。
注意:网页版的AI工具不能配置MCP
1、配置要素
接入星拓MCP需要两个值:
|
参数
|
说明
|
获取方式
|
|
服务器URL
|
MCP服务的请求地址
|
2.2节「复制服务器URL」
|
|
X-Mcp-Key
|
鉴权密钥,用于身份验证
|
2.2节「复制鉴权密钥」
|
完整配置格式:
{
"mcpServers": {
"StarTOP-MCP": {
"url": "https://openmcp.startop.com/mcp-servers/startop-mcp",
"headers": {
"X-Mcp-Key": "<你的鉴权密钥>"
}
}
}
}
2、在各AI工具中配置
注意:不管用哪种配置方式,务必替换为自己的密钥
方式1:AI执行安装(优先推荐)
你可以直接让你的AI工具帮你安装,即直接复制安装提示词,发给你的AI工具。(注意替换为您的专属配置密钥)
帮我安装MCP,下面是配置:
{
"mcpServers": {
"StarTOP-MCP": {
"url": "https://openmcp.startop.com/mcp-servers/startop-mcp",
"headers": {
"X-Mcp-Key": "<你的鉴权密钥>"
}
}
}
}
以下用Codex示例:

安装完成后,新开对话,即可调用星拓MCP。
也可以让AI列出StarTOP-MCP下的所有工具,若回复如下图,则表示配置成功。

方式2:手动安装
WorkBuddy配置
1)进入WorkBuddy主页,点击【专家-连接器】进入连接器设置页面,点击右上角【自定义连接器】

2)进入“MCP服务管理”页面,点击右上角【配置MCP】,进入MCP添加页面,设置并保存;

3)保存成功后,点击上图的【返回MCP列表】,查看并确认MCP状态。(注意首次链接MCP,需要信任确认)


ChatGPT(Codex)配置
1)打开并登录ChatGPT,点击左下角【设置 (Settings)】;

2)进入设置页面,点击【插件 (Plugins)】之后选择【MCP】,点击【添加服务器】;

3)进入MCP配置页面,依次填入以下参数,并点击【保存】;
名称:StarTOP-MCP- 类型:Streamable HTTP
- URL:https://openmcp.startop.com/mcp-servers/startop-mcp
标头:x-api-key | 复制粘贴你在星拓MCP中获取的密钥

4)保存成功后,在「MCP服务器」板块显示 StarTOP-MCP 并默认启用。

Trae配置
1)进入Trae主页,点击左下角头像,选择【设置】,进入设置页面;

2)选择【MCP】,之后点击右侧【+ 添加】按钮,选择【手动配置】进入配置页面;


3)确认后,在MCP列表显示 StarTOP-MCP 并默认启用。

更多AI工具配置
星拓MCP可与任何支持MCP的AI工具集成,配置方法都差不多。可直接使用“方式1-AI执行安装”,或者按照下述通用配置步骤:
-
获取MCP Server URL 和 X-Mcp-Key 鉴权密钥
-
在AI工具的MCP/工具管理中,选择"添加自定义MCP工具"
-
填入服务器URL,传输方式选择 HTTP Streaming / Streamable HTTP
-
在请求头(Headers)中添加
X-Mcp-Key: <你的鉴权密钥> -
保存后即可在对话中使用
三、工具能力
星拓 MCP Server 提供了多种 Tool,涵盖店铺、产品、广告三大维度。分为查询和操作两大类:
- 查询类工具:读取星拓自己账号的数据,放心使用
- 操作类工具:会改变广告设置或投放状态,执行前请确认
每个 Tool 的调用频率限制为“每300ms一次(即平均每秒3.33次)”。当您构建 AI Agent 时,可以在输入信息中提供 Tool 所需参数,来提升 AI 的调用成功率并减少幻觉。
1. 店铺
| 工具 | 中文名称 | 工具描述 | 提问示例 |
| get_my_stores | 授权店铺 | 查询已授权站点、店铺、店铺类型和广告Profile。 | 列出我已授权的美国站店铺,包含店铺名称和SC/VC类型。 |
| query_store_list | 店铺经营列表 | 查询店铺维度的销售与广告效果明细。 | 对比美国站各店铺在 2026-10-01 至 2026-10-14 的销售额、广告花费和T-ACOS,按销售额排序。 |
| query_store_list_summary | 店铺经营合计 | 查询筛选范围内店铺的合计经营指标,不返回逐店铺明细。 | 汇总美国站全部店铺在 2026-10-01 至 2026-10-14 的销售额、广告花费和整体T-ACOS。 |
2. 产品
| 工具 | 中文名称 | 工具描述 | 提问示例 |
| query_brand_list | 品牌列表 | 查询店铺下可用的品牌名称。 | 列出美国站「{店铺名称}」店铺的所有品牌。 |
| query_brand_report | 品牌报表 | 查询品牌维度的销售与广告效果明细。 | 对比美国站「{店铺名称}」店铺各品牌在 2026-10-01 至 2026-10-14 的销售额、广告花费和T-ACOS。 |
| query_brand_report_summary | 品牌报表合计 | 查询筛选范围内品牌的合计指标。 | 汇总美国站「{店铺名称}」店铺品牌「{品牌名称}」在 2026-10-01 至 2026-10-14 的销售额、广告花费和ACOS。 |
| query_product_category_list | 产品类目列表 | 查询店铺下可用的产品大类和小类目。 | 查询美国站「{店铺名称}」店铺的一级和二级类目。 |
| query_product_tag_list | 产品标签列表 | 查询产品(asin)标签列表,用于按产品标签筛选。 | 列出美国站「{店铺名称}」店铺的产品标签,查找“清库存”标签。 |
| query_operation_principal_list | 运营负责人列表 | 查询店铺下可选的运营负责人,用于按负责人筛选。 | 查询美国站「{店铺名称}」店铺的运营负责人。 |
| query_parent_asin_report | 父ASIN报表 | 查询SC店铺父ASIN维度的销售与广告效果明细。 | 查询美国站「{店铺名称}」店铺在 2026-10-01 至 2026-10-14 销售额前 20 的父ASIN。 |
| query_parent_asin_report_summary | 父ASIN报表合计 | 查询SC店铺筛选范围内父ASIN的合计指标。 | 汇总美国站「{店铺名称}」店铺父ASIN「{父ASIN}」在 2026-10-01 至 2026-10-14 的销量、销售额和ACOS。 |
| query_asin_report | ASIN报表 | 查询SC店铺ASIN维度的销售与广告效果明细。 | 找出美国站「{店铺名称}」店铺在 2026-10-01 至 2026-10-14 花费超过 100 美元但无广告订单的ASIN。 |
| query_asin_report_summary | ASIN报表合计 | 查询SC店铺筛选范围内ASIN的合计指标。 | 汇总美国站「{店铺名称}」店铺ASIN「{ASIN}」在 2026-10-01 至 2026-10-14 的广告花费、销售额、ACOS和ROAS。 |
| query_sku_report | SKU报表 | 查询SC店铺SKU维度的销售、库存和广告效果明细。 | 查询美国站「{店铺名称}」店铺在 2026-10-01 至 2026-10-14 有销量但广告花费为 0 的SKU。 |
| query_sku_report_summary | SKU报表合计 | 查询SC店铺筛选范围内SKU的合计指标。 | 汇总美国站「{店铺名称}」店铺“清库存”SKU在 2026-10-01 至 2026-10-14 的销量、销售额、广告花费和T-ACOS。 |
| query_vc_parent_asin_report | VC 父ASIN报表 | 查询VC店铺父ASIN维度的销售与广告效果明细。 | 查询美国站「{店铺名称}」VC店铺在 2026-10-01 至 2026-10-14 ACOS高于 40% 的父ASIN。 |
| query_vc_parent_asin_report_summary | VC 父ASIN报表合计 | 查询VC店铺筛选范围内父ASIN的合计指标。 | 汇总美国站「{店铺名称}」VC店铺父ASIN「{父ASIN}」在 2026-10-01 至 2026-10-14 的销量、销售额和ACOS。 |
| query_vc_asin_report | VC ASIN 报表 | 查询VC店铺ASIN维度的销售与广告效果明细。 | 查询美国站「{店铺名称}」VC店铺在 2026-10-01 至 2026-10-14 销售额前 20 的ASIN。 |
| query_vc_asin_report_summary | VC ASIN 报表合计 | 查询VC店铺筛选范围内ASIN的合计指标。 | 汇总美国站「{店铺名称}」VC店铺ASIN在 2026-10-01 至 2026-10-14 的销售额、广告花费和ACOS。 |
3. 广告
- 广告查询:明细类工具同时返回基础信息和广告效果数据;合计类工具仅返回当前筛选结果的汇总指标。
| 工具 | 中文名称 | 工具描述 | 提问示例 |
| query_portfolio | 广告组合列表 | 查询广告组合的基础信息及广告效果明细。 | 查询美国站「{店铺名称}」店铺在 2026-10-01 至 2026-10-14 花费超过 500 美元、ACOS低于 25% 的广告组合。 |
| query_portfolio_summary | 广告组合合计 | 查询筛选范围内广告组合的合计指标。 | 汇总美国站「{店铺名称}」店铺全部广告组合在 2026-10-01 至 2026-10-14 的预算、花费、销售额和ACOS。 |
| query_campaign | 广告活动列表 | 查询广告活动的基础信息及广告效果明细。 | 找出美国站「{店铺名称}」店铺在 2026-10-01 至 2026-10-14 花费超过 200 美元但无订单的SP广告活动。 |
| query_campaign_summary | 广告活动合计 | 查询筛选范围内广告活动的合计指标。 | 汇总美国站「{店铺名称}」店铺在 2026-10-01 至 2026-10-14 的SP、SB、SD广告花费、销售额和ACOS。 |
| query_placement | 广告位列表 | 查询广告位的基础信息及效果明细。 | 查询美国站「{店铺名称}」店铺SP活动「{广告活动名称}」在 2026-10-01 至 2026-10-14 各广告位的花费、销售额和ACOS。 |
| query_placement_summary | 广告位合计 | 查询筛选范围内广告位的合计指标。 | 汇总美国站「{店铺名称}」店铺SP广告三个广告位在 2026-10-01 至 2026-10-14 的花费、销售额和ACOS。 |
| query_business_placement | 企业购广告位列表 | 查询企业购广告位基础信息及广告效果明细。 | 对比美国站「{店铺名称}」店铺企业购广告“搜索结果顶部”和“商品详情页”在 2026-10-01 至 2026-10-14 的花费、订单和ROAS。 |
| query_business_placement_summary | 企业购广告位合计 | 查询筛选范围内企业购广告位的合计指标。 | 汇总美国站「{店铺名称}」店铺企业购广告位在 2026-10-01 至 2026-10-14 的曝光、花费、订单和ACOS。 |
| query_adgroup | 广告组列表 | 查询广告组的基础信息及广告效果明细。 | 查询美国站「{店铺名称}」店铺活动「{广告活动名称}」下启用中的广告组及其花费、订单和ACOS。 |
| query_adgroup_summary | 广告组合计 | 查询筛选范围内广告组的合计指标。 | 汇总美国站「{店铺名称}」店铺活动「{广告活动名称}」下广告组在 2026-10-01 至 2026-10-14 的曝光、花费、订单和ACOS。 |
| query_ad | 广告商品列表 | 查询广告商品的基础信息及广告效果明细。 | 查询美国站「{店铺名称}」店铺在 2026-10-01 至 2026-10-14 花费超过 50 美元但无订单的广告商品ASIN。 |
| query_ad_summary | 广告商品合计 | 查询筛选范围内广告商品的合计指标。 | 汇总美国站「{店铺名称}」店铺ASIN「{ASIN}」在 2026-10-01 至 2026-10-14 的SP、SD广告花费、订单和销售额。 |
| query_ad_creative | 广告创意列表 | 查询SB广告创意的基础信息及广告效果明细。 | 对比美国站「{店铺名称}」店铺SB视频活动「{广告活动名称}」下各创意在 2026-10-01 至 2026-10-14 的CTR、CPC、销售额和ROAS。 |
| query_ad_creative_summary | 广告创意合计 | 查询筛选范围内SB广告创意的合计指标。 | 汇总美国站「{店铺名称}」店铺SB视频活动「{广告活动名称}」在 2026-10-01 至 2026-10-14 的曝光、点击、CTR和销售额。 |
| query_keyword | 关键词列表 | 查询关键词的基础信息及广告效果明细。 | 找出美国站「{店铺名称}」店铺活动「{广告活动名称}」中在 2026-10-01 至 2026-10-14 点击超过 20 次但无订单的精准关键词。 |
| query_keyword_summary | 关键词合计 | 查询筛选范围内关键词的合计指标。 | 汇总美国站「{店铺名称}」店铺活动「{广告活动名称}」下关键词在 2026-10-01 至 2026-10-14 的花费、销售额、订单和ACOS。 |
| query_target | 商品投放列表 | 查询商品投放的基础信息及广告效果明细。 | 找出美国站「{店铺名称}」店铺商品投放活动「{广告活动名称}」中在 2026-10-01 至 2026-10-14 ACOS超过 50%、花费超过 30 美元的竞品ASIN。 |
| query_target_summary | 商品投放合计 | 查询筛选范围内商品投放的合计指标。 | 汇总美国站「{店铺名称}」店铺商品投放活动「{广告活动名称}」在 2026-10-01 至 2026-10-14 的花费、订单、销售额和ROAS。 |
| query_auto_target | 自动投放列表 | 查询SP自动定向组的基础信息及广告效果明细。 | 查询美国站「{店铺名称}」店铺自动活动「{广告活动名称}」中“紧密匹配”在 2026-10-01 至 2026-10-14 的花费、订单、ACOS和ROAS。 |
| query_auto_target_summary | 自动投放合计 | 查询筛选范围内自动投放的合计指标。 | 汇总美国站「{店铺名称}」店铺自动活动四类投放目标在 2026-10-01 至 2026-10-14 的花费、订单、销售额和ACOS。 |
| query_audience | SD受众列表 | 查询SD受众投放的基础信息及广告效果明细。 | 查询美国站「{店铺名称}」店铺SD再营销活动「{广告活动名称}」下各受众在 2026-10-01 至 2026-10-14 的曝光、花费、销售额和ROAS。 |
| query_audience_summary | SD受众合计 | 查询筛选范围内 SD 受众的合计指标。 | 汇总美国站「{店铺名称}」店铺SD再营销受众在 2026-10-01 至 2026-10-14 的花费、销售额、ACOS和ROAS。 |
| query_negative_keyword | 否定关键词列表 | 查询已设置的否定关键词、匹配方式和否定层级。 | 列出美国站「{店铺名称}」店铺活动「{广告活动名称}」已添加的否定关键词及其匹配方式。 |
| query_negative_target | 否定商品列表 | 查询已设置的否定ASIN、否定品牌及其否定层级。 | 列出美国站「{店铺名称}」店铺活动「{广告活动名称}」已添加的否定ASIN、否定品牌和否定层级。 |
| query_search_word | 搜索词列表 | 查询客户实际搜索词及其广告效果明细。 | 查询美国站「{店铺名称}」店铺自动活动「{广告活动名称}」中在 2026-10-01 至 2026-10-14 销售额超过 100 美元、ACOS低于 25% 的搜索词。 |
| query_search_word_summary | 搜索词合计 | 查询筛选范围内搜索词的合计指标。 | 汇总美国站「{店铺名称}」店铺自动活动「{广告活动名称}」在 2026-10-01 至 2026-10-14 搜索词的花费、订单、销售额和转化率。 |
| query_search_word_frequency | 搜索词词频分析 | 分析搜索词中高频出现的词及其广告效果。 | 分析美国站「{店铺名称}」店铺自动活动「{广告活动名称}」在 2026-10-01 至 2026-10-14 高转化搜索词中出现频率最高的 20 个词。 |
| query_search_word_root | 搜索词词根分析 | 按词根聚合分析搜索词构成及广告效果。 | 分析美国站「{店铺名称}」店铺自动活动「{广告活动名称}」在 2026-10-01 至 2026-10-14 销售额最高的 20 个搜索词词根。 |
| query_match_target | SD匹配目标列表 | 查询SD投放实际匹配的商品/类目或受众目标及其效果明细。 | 查询美国站「{店铺名称}」店铺SD商品相似投放中,在 2026-10-01 至 2026-10-14 订单不少于 5 单且ROAS最高的 20 个匹配目标。 |
| query_match_target_summary | SD匹配目标合计 | 查询筛选范围内SD匹配目标的合计指标。 | 汇总美国站「{店铺名称}」店铺SD商品相似和互补商品投放在 2026-10-01 至 2026-10-14 的花费、销售额和ROAS。 |
- 细分数据:细分查询支持按小时 或 ASIN、SKU、广告位、关键词等业务维度细分。
| 工具 | 中文名称 | 工具描述 | 提问示例 |
| query_campaign_subdivision | 广告活动细分 | 查询单个广告活动按小时、ASIN、SKU、广告位或关键词的效果。 | 查询美国站「{店铺名称}」店铺活动「{广告活动名称}」在 2026-10-01 至 2026-10-14 按广告位的花费、销售额和ACOS。 |
| query_ad_subdivision | 广告商品细分 | 查询广告商品按小时、广告位或关键词的效果。 | 查询美国站「{店铺名称}」店铺广告商品ASIN「{ASIN}」在 2026-10-01 至 2026-10-14 按关键词的点击、花费、订单和ACOS。 |
| query_placement_subdivision | 广告位细分 | 查询活动内广告位按小时、ASIN、SKU或关键词的效果。 | 查询美国站「{店铺名称}」店铺活动「{广告活动名称}」的“搜索结果顶部”广告位在 2026-10-01 至 2026-10-14 按关键词的花费、订单和ACOS。 |
| query_adgroup_subdivision | 广告组细分 | 查询广告组按小时、ASIN、SKU、广告位或关键词的效果。 | 查询美国站「{店铺名称}」店铺广告组「{广告组名称}」在 2026-10-01 至 2026-10-14 按广告位的花费、销售额和ACOS。 |
| query_keyword_subdivision | 关键词细分 | 查询关键词按小时、ASIN、SKU或广告位的效果。 | 查询美国站「{店铺名称}」店铺关键词「{关键词}」在 2026-10-01 至 2026-10-14 按广告位的点击、花费、订单和ACOS。 |
| query_target_subdivision | 商品投放细分 | 查询商品或类目投放按小时、ASIN、SKU或广告位的效果。 | 查询美国站「{店铺名称}」店铺竞品ASIN「{竞品ASIN}」在 2026-10-01 至 2026-10-14 按广告位的花费、销售额和ACOS。 |
| query_auto_target_subdivision | 自动投放细分 | 查询自动投放定向组按小时、ASIN、SKU或广告位的效果。 | 查询美国站「{店铺名称}」店铺自动活动“同类商品”定向在 2026-10-01 至 2026-10-14 按ASIN的花费、订单和ACOS。 |
| query_audience_subdivision | SD受众细分 | 查询SD受众按小时、ASIN或SKU的效果。 | 查询美国站「{店铺名称}」店铺SD再营销受众「{受众名称}」在 2026-10-01 至 2026-10-14 按ASIN的销售额和ROAS。 |
- 广告操作
| 工具 | 中文名称 | 工具描述 | 提问示例 |
| write_campaign_status | 调整广告活动状态 | 启用或暂停SP、SB、SD广告活动。 | 暂停美国站「{店铺名称}」店铺活动「SP|{产品名称}|Broad」;它在 2026-10-01 至 2026-10-14 花费 250 美元但无订单。 |
| write_campaign_budget | 调整广告活动预算 | 设置或增减广告活动预算。 | 将美国站「{店铺名称}」店铺活动「SP|{产品名称}|Exact」日预算从 80 美元提高到 120 美元。 |
| write_campaign_bidding | 调整广告活动竞价策略 | 调整活动竞价策略和广告位加价设置。 | 将美国站「{店铺名称}」店铺活动「SP|{产品名称}|Exact」改为“动态竞价—提高和降低”。 |
| write_placement_bid | 调整广告位竞价 | 调整SP、SB广告位加价比例。 | 将美国站「{店铺名称}」店铺活动「SP|{产品名称}|Exact」的“搜索结果顶部”加价从 20% 调整为 40%。 |
| write_adgroup_status | 调整广告组状态 | 启用或暂停SP、SB、SD广告组。 | 暂停美国站「{店铺名称}」店铺活动「SP|{产品名称}|Auto」下已停售商品对应的广告组「{广告组名称}」。 |
| write_adgroup_default_bid | 调整广告组默认出价 | 设置或增减SP、SD广告组默认竞价。 | 将美国站「{店铺名称}」店铺广告组「{广告组名称}」默认竞价从 0.80 美元调整为 1.10 美元。 |
| write_keyword_status | 调整关键词/关键词组状态 | 调整关键词或关键词组状态。 | 暂停美国站「{店铺名称}」店铺广泛词「{关键词}」;它在 2026-10-01 至 2026-10-14 点击 35 次、花费 42 美元但无订单。 |
| write_keyword_bid | 调整关键词/关键词组竞价 | 设置或增减关键词、关键词组竞价。 | 将美国站「{店铺名称}」店铺精准词「{关键词}」竞价从 0.90 美元提高到 1.10 美元。 |
| write_target_status | 调整投放状态 | 启用或暂停商品、自动和受众投放。 | 暂停美国站「{店铺名称}」店铺竞品ASIN「{竞品ASIN}」投放;它在 2026-10-01 至 2026-10-14 花费 60 美元但无订单。 |
| write_target_bid | 调整投放竞价 | 设置或增减商品、自动和受众投放竞价。 | 将美国站「{店铺名称}」店铺竞品ASIN「{竞品ASIN}」投放竞价从 0.65 美元提高到 0.80 美元。 |
| create_keyword_target | 添加关键词投放 | 在SP、SB、SD广告组中新增关键词投放。 | 在美国站「{店铺名称}」店铺广告组「{广告组名称}」添加精准词「{关键词}」,竞价设为 1.00 美元。 |
| create_keyword_group_target | 添加关键词组投放 | 在SP广告组中新增关键词组投放。 | 在美国站「{店铺名称}」店铺SP广告组「{广告组名称}」创建关键词组「{关键词组名称}」,竞价设为 0.85 美元。 |
| create_negative_keyword | 添加否定关键词 | 在广告活动/组中新增否定关键词。 | 在美国站「{店铺名称}」店铺SP自动活动「SP|{产品名称}|Auto」添加否定精准词「{搜索词}」。 |
| create_product_target | 添加商品投放 | 在广告组中新增商品或类目投放。 | 在美国站「{店铺名称}」店铺广告组「{广告组名称}」添加竞品ASIN「{竞品ASIN}」投放,竞价设为 0.70 美元。 |
| create_negative_target | 添加否定商品投放 | 在广告活动/组中新增否定商品或否定类目投放。 | 在美国站「{店铺名称}」店铺活动「{广告活动名称}」中将ASIN「{竞品ASIN}」添加为否定商品投放。 |
| create_audience_target | 添加SD受众投放 | 在SD广告组中新增受众投放。 | 为美国站「{店铺名称}」店铺SD广告组「{广告组名称}」添加“浏览未购买 30 天”再营销受众,竞价设为 0.60 美元。 |
| create_ad_sku | 添加SP/SD广告商品 | 将ASIN或SKU添加至SP、SD广告组。 | 将SKU「{SKU}」添加到美国站「{店铺名称}」店铺SP广告组「{广告组名称}」。 |
- 操作日志
| 工具 | 中文名称 | 工具描述 | 提问示例 |
| query_operation_log_list | 广告操作日志列表 |
查询 StarTOP 和Amazon日志。
支持按店铺、日期、广告活动/组、操作类型、来源和操作人筛选,
返回操作时间、操作对象、来源、操作人及操作前后内容。
|
查询美国站「{店铺名称}」店铺,近1个月通过规则优化产生的操作日志。 |
四、常用问题
Q1:MCP和普通API有什么区别?
A:普通API需要写代码对接,MCP是标准化协议(Model Context Protocol),配置更简单,AI助手能直接理解并调用,无需手动写代码。你只需要用自然语言提问,AI会自动选择合适的Tool并返回结果。
Q2:数据是实时的吗?
A:是的,数据与星拓页面数据一致,实时同步。
Q3:查询有次数限制吗?
A:目前无查询次数限制。但是平均每秒钟只能查询3.33次(QPS=3~4)。
Q4:MCP配置后未生效怎么办?
A:此问题通常是由于以下原因导致:
-
配置的工具集过多:配置的工具集过多可能导致大模型无法正确选择工具。请尝试移除其他MCP工具,仅保留必要的工具。
-
提示词不够精确:当提示词不够精确时,模型可能无法正确调用工具。请使用更具体的查询,例如:"查一下ASIN B0XXXXXX的产品和广告数据表现"。
-
权限未开通:确保MCP Server已在对应空间中启用,且当前帐号拥有相关数据的查看权限。
Q5:鉴权失败怎么办?
A:请按以下步骤排查:
-
检查X-Mcp-Key是否配置:MCP服务需要鉴权密钥才能调用。请确认在AI工具的MCP配置中,headers里已添加
"X-Mcp-Key": "<你的鉴权密钥>"。仅配置URL而不配置鉴权头,会导致鉴权失败。 -
检查密钥是否正确:在星拓的【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可查询的数据范围不同,取决于该帐号在星拓中的权限配置。请勿将个人MCP URL和鉴权密钥分享给他人使用,以免数据泄露。
Q8:安装配置成功后,使用自然语言搜索时,显示服务器连接失败,要怎么处理呢?
A:先确认是通过什么方式配置的MCP,如果是网页版的AI工具,则会配置不成功,因为mcp是依赖本地环境的。
Q9:调用MCP出现:agent_id is missing on agent track,这是怎么回事呢
A:这个并非是我们星拓mcp的问题,可以尝试将具体情况反馈给AI工具进一步排查解决
Q10:如果在chatgpt引入星拓的【MCP】是否会造成亚马逊不同账号关联?
A:不会造成关联,mcp只是调用星拓数据库的数据,不会涉及到亚马逊店铺
Q11:支持豆包桌面版吗?
A:星拓MCP支持接入任何支持自定义MCP工具的AI平台,但是豆包不支持自定义MCP服务器,所以在豆包桌面版中无法使用星拓MCP。
未能解决你的问题?请联系在线客服
本文是否对您有帮助?
有帮助?
无帮助?
请问有什么疑问?
本文是否对您有帮助?
有帮助?
无帮助?
请问有什么疑问?