万相台 AI 助手 · MCP 接入

让你的 AI 查询广告,再确认具体调整。

把自己的授权店铺接入支持 MCP 的 AI 客户端。通过对话查看计划、查询报表、准备预算或启停变更;AI 连接后自动获取工具说明和参数,你不用逐个配置接口。

适用于支持远程 Streamable HTTP 和自定义 Authorization 请求头的客户端。各客户端的安装入口不同;仅支持 OAuth 登录、不能填写请求头的客户端,不能直接使用本配置。

接入前准备

  1. 在服务台确认万相台 API 套餐有效,并完成自己的淘宝店铺授权。
  2. 复制该账户的奇门云密钥,到下方生成连接配置。
  3. 在 AI 客户端添加远程 MCP,选择 HTTP 类型并填写端点和 Authorization 请求头。连接后刷新工具列表。
  4. 先让 AI 列出授权店铺,再查询一页计划,确认店铺与推广场景正确。

本接入沿用已有万相台 API 套餐和店铺权限。推广工作台网页权益、其他平台套餐不能替代万相台 API 权益;平台实际可用功能仍受店铺资格与淘宝应用授权约束。

生成你的 MCP 连接配置

使用服务台已有的奇门云密钥。此处只在本页生成配置,不上传密钥、不保存到浏览器存储,也不自动发起接口查询。

请输入客户密钥,不是淘宝 AppSecret、店铺 shopKey 或登录密码。格式校验通过不代表套餐或授权有效,连接时服务器会核验。

连接信息

设置填写内容
名称万相台 AI 助手
端点https://api.miandanni.com/api/wanxiang/mcp
传输方式Streamable HTTP
兼容协议版本2025-11-25、2025-06-18,由客户端初始化时协商。
请求头名称Authorization
请求头值Bearer、一个空格,再接完整客户密钥;下方文档中的占位文字不是有效密钥。
店铺范围仅当前账户已绑定且授权有效的店铺,每次业务调用重新校验。

客户端只连接本站端点。密钥不放在地址、工具参数或提示词中;工具参数里的 shopKey 从授权店铺列表取得。

本端点使用无状态 HTTP POST 返回 JSON,不提供旧版 SSE 专用地址、OAuth 登录或第三方网页的浏览器跨域直连。请使用能由本机程序或服务端连接的客户端。

本版可以做什么

工具用途
wanxiang_list_shops查看当前密钥所属账户的授权店铺,先确认要查询哪家店。
wanxiang_list_methods查看读写方法目录及 MCP 开放标记;目录中的写方法不代表可以任意执行。
wanxiang_describe_method读取指定方法的参数说明、示例和官方文档链接。
wanxiang_read调用目录中标记为查询的方法,包括已有支持的广告报表;不能通过此工具执行写入。
wanxiang_list_campaigns分页查询明确店铺和推广场景下的计划,核对名称、编号及当前设置。
wanxiang_preview_campaign_change准备预算或启停变更预览,展示店铺、计划、旧值和新值;预览不改变广告。
wanxiang_execute_campaign_change商家确认预览中的具体变更后提交;过期或条件变化时重新预览。
wanxiang_get_change查询变更记录及执行状态,结果不明时先核验,不自动再次提交。

实际工具和参数以连接后的 tools/list 为准。查询返回的数据带有原始业务口径,AI 应同时检查业务错误和数据覆盖;当天数据与历史数据、不同归因窗口不能直接混算。缺失数据不能补成零。

专用计划工具支持货品全站推广、关键词推广、人群推广。预算调整只支持普通日预算计划,填写整数元/日;不限预算及其他预算类型不在本版调整范围。写入围绕预算和启停,不通过通用查询工具开放任意修改。

库存、退款、经营净利润及其他广告平台不在本版范围。

可以这样问 AI

  • “列出我已授权的店铺,先不要修改任何计划。”
  • “查询这家店的货品全站推广计划,先返回一页,并说明是否还有下一页。”
  • “查这家店上周的广告消耗和成交,说明日期、归因口径和缺失数据。”
  • “把这个计划的日预算调整为我指定的金额,先给我看店铺、计划和新旧预算,等我确认。”
  • “刚才的调整结果不明确,先查变更记录和实际计划状态,不要重复提交。”

修改计划怎样确认

  1. 先查询目标店铺和计划,确认计划编号、推广场景与当前预算或状态。
  2. 生成有效期为 5 分钟的变更预览,AI 向你展示店铺、计划、旧值、新值及确认文字。
  3. 你确认这次具体变更后,AI 按工具返回的要求提交执行。预览过期或当前设置已变化时重新核对。
  4. 以执行记录及实际状态核验结果。超时或结果不明时先查记录和计划,不自动重试写入。

生成配置、连接 MCP、查询和生成预览均不启动广告。确认预算或启停变更后可能影响真实投放,请以你确认的具体计划和金额为准。

结果未知的操作会阻止该计划继续创建变更预览,需要保留原预览编号并由人工核对。即使当前值与目标一致,也不要自行认定本次修改已成功或绕过未决记录。

连接失败时检查这些信息

现象处理方法
没有找到 MCP 工具核对完整端点与 HTTP 传输方式;确认客户端支持自定义请求头,重新连接并刷新工具列表。
401 或密钥无效重新从服务台复制完整密钥;确认 Bearer 后只有一个空格。密钥重置后更新所有连接。
服务未开通或到期查看万相台 API 套餐状态,网页工作台权益及其他平台套餐不能替代它。
店铺不属于账户或授权过期重新列出授权店铺,使用返回的 shopKey;必要时回到服务台重新授权。
429 或调用过于频繁降低并发并遵循返回的重试提示;一次查询一页,不循环全量拉取。
淘宝业务拒绝保留错误码和请求编号,核对方法、参数、推广场景和应用订购。HTTP 成功不等于业务成功。
修改超时或结果不明先查询变更记录和实际计划,不新建同一变更或自动重试。
查看万相台方法目录与参数说明 →