星拓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和密钥

MCP功能目前灰度中，如果配置权限后看不到入口，请联系您的专属客服开通权限。

2.3 在第三方AI工具配置

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

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 并默认启用。

三、工具能力

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

落地页	工具	使用场景	提问示例
店铺授权	get_my_stores	查询当前用户授权的亚马逊站点、店铺、店铺类型和 Profile 信息	我有哪些授权店铺？
店铺列表	query_store_list	按站点和店铺聚合查询销售和广告表现	上周各店铺销售额排名
店铺列表	query_store_list_summary	查询 SC 店铺列表筛选结果的汇总指标	美国站店铺上周总销售额和整体 ACOS是多少？
品牌列表	query_brand_list	查询指定店铺拥有的品牌名称列表	美国站所有店铺有哪些品牌？
品牌列表	query_brand_report	按品牌聚合查询销售和广告表现	美国站上周销售额最高的 5 个品牌
品牌列表	query_brand_report_summary	查询品牌报表筛选结果的汇总指标	各品牌上周合计广告花费是多少？
产品列表	query_product_category_list	查询产品大类目或小类目名称列表	美国站所有店铺有哪些产品大类目？
产品列表	query_product_tag_list	查询产品（ASIN）标签列表	美国站所有店铺 ASIN 有哪些产品标签？
产品列表	query_operation_principal_list	查询指定店铺可选的运营负责人列表	美国站XX店铺的运营负责人有哪些？
产品列表	query_parent_asin_report	按父 ASIN 维度查询SC店铺产品的销售和广告表现	按父 ASIN 看广告花费前10的产品
产品列表	query_parent_asin_report_summary	查询SC店铺父 ASIN 报表筛选结果的汇总指标	广告花费前10的父 ASIN 的整体 ACOS 是多少？
产品列表	query_asin_report	按ASIN 维度SC店铺查询产品的销售和广告表现	最近30天销量前10的ASIN是哪些？
产品列表	query_asin_report_summary	查询SC店铺 ASIN 报表筛选结果的汇总指标	美国站上周销量前10的ASIN 总销量和广告销售额是多少？
产品列表	query_sku_report	按SKU 维度查询SC店铺产品的销售和广告表现	美国站这周销量最好的 10 个 SKU
产品列表	query_sku_report_summary	查询SC店铺 SKU 报表筛选结果的汇总指标	美国站销量前10的 SKU 上个月总广告花费是多少？
产品列表	query_vc_parent_asin_report	按父 ASIN 维度查询 VC 店铺产品的销售和广告表现	VC 店铺这周销量最好的 10 个父 ASIN
产品列表	query_vc_parent_asin_report_summary	查询VC店铺父 ASIN 报表筛选结果的汇总指标	VC 店铺父 ASIN 整体 ACOS 是多少？
产品列表	query_vc_asin_report	按 ASIN 维度查询 VC 店铺产品的销售和广告表现	德国站 VC 店铺 ASIN 销售额排名
产品列表	query_vc_asin_report_summary	查询VC店铺 ASIN 报表筛选结果的汇总指标	VC 店铺本周 ASIN 总销售额是多少？
广告组合	query_portfolio	查询广告组合的基础信息和广告效果数据	美国站所有店铺的广告组合里花费最高的前 10 个
广告组合	query_portfolio_summary	查询广告组合筛选结果的汇总指标	美国站本月广告组合总花费是多少？
广告活动	query_campaign	查询广告活动的基础信息与广告效果数据	美国站上个月哪个广告活动 ACOS 最高？
广告活动	query_campaign_summary	查询广告活动筛选结果的汇总指标	SP 广告活动本周总销售额是多少？
广告位	query_placement	查询广告位（顶部、商品页、其余位置）的效果数据	近7天搜索结果顶部的广告位 ACOS 是多少？
广告位	query_placement_summary	查询广告位筛选结果的汇总指标	近7天SP所有广告位的广告花费及其ACOS？
广告位	query_business_placement	查询企业购广告位的基础信息与广告效果数据	近7天企业购的各个广告位位置的花费对比
广告位	query_business_placement_summary	查询企业购广告位筛选结果的汇总指标	近7天企业购广告位整体转化率是多少？
广告组	query_adgroup	查询广告组的基础信息与广告效果数据	XX广告活动下有哪些广告组，各自花费多少？
广告组	query_adgroup_summary	查询广告组筛选结果的汇总指标	XX广告活动下当前开启的广告组近14天整体ACOS 是多少？
广告	query_ad	查询广告商品的基础信息与广告效果数据	我的 SP 广告商品里花费最高的 ASIN有哪些？
广告	query_ad_summary	查询广告商品筛选结果的汇总指标	美国站广告商品本月总花费和总订单是多少？
关键词	query_keyword	查询关键词的基础信息与广告效果数据	有点击没有成交的关键词列表
关键词	query_keyword_summary	查询关键词筛选结果的汇总指标	精确匹配关键词整体 ACOS 是多少？
商品投放	query_target	查询商品或类目投放的基础信息与广告效果数据	商品投放里花费最高的 ASIN 目标有哪些？
商品投放	query_target_summary	查询商品投放筛选结果的汇总指标	类目投放的整体 ACOS 是多少？
搜索词	query_search_word	查询搜索词或 ASIN 搜索词的广告效果数据	来自自动投放的搜索词，按照 ACOS 排序
搜索词	query_search_word_summary	查询搜索词筛选结果的汇总指标	本周搜索词总花费是多少？

* 广告创意/自动投放/受众投放/匹配的目标/否定投放”暂未开放，敬请期待~

四、常用问题

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

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

Q2：数据是实时的吗？

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

Q3：查询有次数限制吗？

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

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和鉴权密钥分享给他人使用，以免数据泄露。