让你的 AI 查询广告,再确认具体调整。
把自己的授权店铺接入支持 MCP 的 AI 客户端。通过对话查看计划、查询报表、准备预算或启停变更;AI 连接后自动获取工具说明和参数,你不用逐个配置接口。
适用于支持远程 Streamable HTTP 和自定义 Authorization 请求头的客户端。各客户端的安装入口不同;仅支持 OAuth 登录、不能填写请求头的客户端,不能直接使用本配置。
接入前准备
- 在服务台确认万相台 API 套餐有效,并完成自己的淘宝店铺授权。
- 复制该账户的奇门云密钥,到下方生成连接配置。
- 在 AI 客户端添加远程 MCP,选择 HTTP 类型并填写端点和 Authorization 请求头。连接后刷新工具列表。
- 先让 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
- “列出我已授权的店铺,先不要修改任何计划。”
- “查询这家店的货品全站推广计划,先返回一页,并说明是否还有下一页。”
- “查这家店上周的广告消耗和成交,说明日期、归因口径和缺失数据。”
- “把这个计划的日预算调整为我指定的金额,先给我看店铺、计划和新旧预算,等我确认。”
- “刚才的调整结果不明确,先查变更记录和实际计划状态,不要重复提交。”
修改计划怎样确认
- 先查询目标店铺和计划,确认计划编号、推广场景与当前预算或状态。
- 生成有效期为 5 分钟的变更预览,AI 向你展示店铺、计划、旧值、新值及确认文字。
- 你确认这次具体变更后,AI 按工具返回的要求提交执行。预览过期或当前设置已变化时重新核对。
- 以执行记录及实际状态核验结果。超时或结果不明时先查记录和计划,不自动重试写入。
生成配置、连接 MCP、查询和生成预览均不启动广告。确认预算或启停变更后可能影响真实投放,请以你确认的具体计划和金额为准。
结果未知的操作会阻止该计划继续创建变更预览,需要保留原预览编号并由人工核对。即使当前值与目标一致,也不要自行认定本次修改已成功或绕过未决记录。
连接失败时检查这些信息
| 现象 | 处理方法 |
|---|---|
| 没有找到 MCP 工具 | 核对完整端点与 HTTP 传输方式;确认客户端支持自定义请求头,重新连接并刷新工具列表。 |
| 401 或密钥无效 | 重新从服务台复制完整密钥;确认 Bearer 后只有一个空格。密钥重置后更新所有连接。 |
| 服务未开通或到期 | 查看万相台 API 套餐状态,网页工作台权益及其他平台套餐不能替代它。 |
| 店铺不属于账户或授权过期 | 重新列出授权店铺,使用返回的 shopKey;必要时回到服务台重新授权。 |
| 429 或调用过于频繁 | 降低并发并遵循返回的重试提示;一次查询一页,不循环全量拉取。 |
| 淘宝业务拒绝 | 保留错误码和请求编号,核对方法、参数、推广场景和应用订购。HTTP 成功不等于业务成功。 |
| 修改超时或结果不明 | 先查询变更记录和实际计划,不新建同一变更或自动重试。 |