如何通过 MCP 将 Ozon Seller 连接到 Gemini

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Ozon Seller、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Ozon Seller + Gemini

通过 AI 智能体管理 Ozon 卖家账户：商品、库存和价格，FBS 和 FBO 发货单，退货，财务入账明细和余额报表，销售分析，仓库，促销活动，评价和买家提问，还能更新价格和库存。只需一个 Client ID 和 API 密钥。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

OZON_CLIENT_ID, OZON_API_KEY

步骤 1 — 获取凭证

在 Ozon 卖家账户中配置大约需要 3 分钟。该连接器已用真实的 Ozon 数据测试过：它的读取工具在一个正在运营的卖家账户上验证过。

1. 在卖家后台打开 Settings → Seller API（seller.ozon.ru/app/settings/api-keys），点击 Generate key。
2. 给密钥命名并选择角色：Admin 可以使用所有工具，范围更小的角色只能使用其覆盖的工具。如果 Ozon 询问密钥用途，请选择外部服务并填写 AnythingMCP。
3. Ozon 只显示一次密钥，所以请立即把它复制到 OZON_API_KEY，再把同一页面上的 Client ID（一串数字）复制到 OZON_CLIENT_ID。然后安装连接器。
4. 运行 ozon_get_api_key_info：它会显示密钥的角色和到期日期。Ozon 密钥有效期为 3 个月，请在到期前创建新密钥。

可以读取的内容：按卖家货号（offer_id）、Ozon 商品 ID 或 SKU 查询的商品，包括名称、条码、价格、增值税、状态和审核错误；FBO、FBS 和 rFBS 各模式下的库存，以及你自有每个仓库的库存；价格，包括最低价、参加你的促销后的价格、价格指数，以及 FBO 和 FBS 的销售佣金；某段时间内的 FBS、rFBS 和 FBO 发货单，以及单个 FBS 发货单的完整信息，含配送、物流单号、取消情况和每件商品的结算金额；带原因和状态的退货；与 Finance → Balance 相同的余额报表、某一天的全部入账明细，以及最多 200 个发货单的入账明细；销售分析；你的仓库；你可以参加的 Ozon 促销活动；评价和买家提问。连接器从不返回买家的联系方式。

财务：Ozon 已于 2026 年 9 月停用旧的交易列表。连接器已经改用取代它的方法：最长 30 天的余额报表、按天的入账明细列表和按发货单的入账明细。

发货单需要指定时间段：查询 FBS 和 FBO 列表时，AI 总会给出开始和结束日期（最长一年）。查看今天的 FBS 订单时，它会按“等待打包”状态筛选。

订阅：评价需要 Review management 或 Premium Pro 订阅，买家提问需要 Premium Plus；没有这些订阅时 Ozon 会拒绝相应请求。没有 Premium Plus 时，销售分析只返回收入和下单件数，仅限最近 3 个月，每天最多 50 次请求。无论哪种情况，销售分析每分钟只能调用一次。

每次修改前都会询问：ozon_update_prices 和 ozon_update_stocks 会修改正在运营的店铺。AI 会列出每件商品修改前后的价格或库存并等你同意，然后检查 Ozon 的返回结果并重新读取数值。库存值会替换当前库存，而且不能包含已预留的数量，所以 AI 会先读取预留量。每件商品的价格每小时最多修改 10 次。对评价的回复（ozon_reply_to_review）和对提问的回答（ozon_answer_question）会公开显示在商品页面上，因此 AI 在发布前会给你看确切的文字。

安装时默认关闭：ozon_ship_fbs_posting（把 FBS 订单打包成包裹）和 ozon_cancel_fbs_posting（取消 FBS 订单，无法撤销，并可能影响你的卖家评分）。只有管理员有意开启后才能使用，而且 AI 每次都会请你明确确认。

速率限制：每个 Client ID 每秒最多 50 次请求，各方法另有单独限制。遇到 429 时，AI 会按 Ozon 在 Retry-After 中给出的时间等待。发送大量重复或失败请求的密钥可能会被 Ozon 封禁。

常见错误：401 Invalid Api-Key 表示密钥有误、已过期或属于另一个 Client ID。403 "missing a required role" 表示密钥本身有效，但其角色不包含该工具；请用 ozon_get_api_key_info 查看角色。403 "restricted to specific IP addresses"：请为该密钥允许所有网络访问。

该连接器不会创建或编辑商品卡片，不会创建 FBO 供货申请，不会打印标签或交接单，不会与买家聊天，不会参加或管理促销活动，也不使用 Performance（广告）API。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Gemini 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Gemini CLI 从 ~/.gemini/settings.json（Windows 上为 %USERPROFILE%\.gemini\settings.json）读取 MCP 服务器。添加：

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 gemini。
3. 在 Gemini CLI 中运行 /mcp（或在终端运行 gemini mcp list），anythingmcp 应显示为已连接。
4. 开始输入提示，Gemini CLI 现在可以调用 Ozon Seller 的工具。

可用工具

示例提示

• “现在有哪些 FBS 订单在等待打包？分别从哪个仓库发货？”
• “给我看 10 月上半月的 Ozon 余额：入账、已结算、销售、退货和佣金。”
• “哪些商品在我自己的仓库里已经缺货？在 Ozon 仓库里还剩多少件？”
• “发货单 89491381-0072-1 Ozon 收了哪些费用、付了多少钱？请把入账明细拆开说明。”
• “把货号 ART-123 的价格从 1,990 卢布提高到 2,190 卢布。修改前先给我看新旧价格。”
• “给我看本周新的 1 星和 2 星评价，并起草回复，我先审核。”

FAQ

Gemini CLI 从哪里读取 MCP 服务器？ 用户级配置位于 ~/.gemini/settings.json，项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT