文档MCP 接入

MCP 接入

Revenuealot MCP 可以让已授权的 AI 客户端通过远程 MCP 服务调用 Revenuealot 工具。当前 MVP 版本重点支持受管 Bearer 密钥、只读市场数据访问,以及跟随套餐和组织权限的访问控制。

MCP 接入对 Starter 及以上套餐开放。MCP 客户端只能调用当前套餐和组织权限允许的工具。

MCP 可以做什么

当前 MCP 服务开放只读工具,适合回答日常运营问题:

  • 查询已连接平台店铺
  • Takealot 关键词研究、关键词反查、商品研究、店铺分析和退货风险
  • Amazon 店铺指标、产品分析、商品、订单、关键词反查和广告表现
  • Makro 店铺指标和产品分析
  • Shopify 商品数据
  • 供应商商品数据

创建 MCP 密钥

打开 MCP 密钥页面

进入 仪表板 → 设置 → MCP 密钥

创建密钥

点击 创建密钥,填写清晰的名称,例如 Claude Desktop运营 Agent,也可以选择过期时间。

立即复制密钥

创建后,Revenuealot 只会显示一次完整密钥。请立即复制,并保存到 MCP 客户端使用的环境变量中。

管理有效密钥

你可以在同一页面编辑名称或过期时间,临时禁用密钥,或永久删除密钥。

连接 MCP 客户端

请选择支持远程 MCP Streamable HTTP 和手动 Bearer Token 的客户端。

下面的 <MCP_KEY> 指的是你在上一步创建并复制的 Revenuealot MCP 密钥。实际填写时请用完整密钥替换 <MCP_KEY>,不要保留尖括号。

打开 Codex App,进入 设置 → MCP 服务器 → 添加服务器,添加 Revenuealot MCP。类型选择 流式 HTTP,URL 填写 https://api.revenuealot.com/mcp,并在 标头 中添加 Authorization,值填写 Bearer <MCP_KEY>

Codex MCP 服务器配置

⚠️

不要把 MCP 密钥粘贴到共享 prompt、文档、代码仓库或截图里。请像 API Secret 一样保管。

安全建议

  • 为不同客户端或团队工作流创建不同密钥。
  • 临时 Agent 或试用场景建议设置过期时间。
  • 如果只是暂停访问,可以先禁用密钥。
  • 如果密钥可能泄露,请直接删除。删除后的密钥无法恢复。
  • 在权限允许时,组织管理员可以查看组织维度的 MCP 密钥。

常见问题

客户端无法连接
确认 URL 是 https://api.revenuealot.com/mcp,transport 是 Streamable HTTP,并且请求头包含 Authorization: Bearer <MCP_KEY>

工具列表为空或不完整
检查当前套餐和团队工具权限。MCP 工具可用范围与 Revenuealot 后台权限一致。

密钥突然不可用
检查该密钥是否已被禁用、删除、过期,或当前套餐不再包含 MCP 权限。

下一步