文档MCP 接入

MCP 接入

Revenuealot MCP 可以让已授权的 AI 客户端通过远程 MCP 服务调用 Revenuealot 工具。ChatGPT 使用 OAuth 授权,其他通用 MCP 客户端仍可继续使用受管 Bearer 密钥。两种方式都会沿用同一套组织、套餐、店铺和工具权限。

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

MCP 可以做什么

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

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

管理 MCP 授权

打开 MCP 授权页面

进入 仪表板 → 设置 → MCP 授权

查看 ChatGPT 授权

用户在 ChatGPT 中安装或授权 Revenuealot App 后,对应授权会显示在这里。在权限允许时,组织管理员可以查看并断开组织维度的 ChatGPT 授权。

创建密钥

对于其他 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 填写 复制,并在 标头 中添加 复制,值填写 复制

Codex MCP 服务器配置

⚠️

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

安全建议

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

常见问题

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

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

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

下一步