如何通过 MCP 将 Trendyol 连接到 Gemini

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

Trendyol + Gemini

通过 AI 代理运营 Trendyol 卖家账户：商品（Product v2 列表、创建、内容、归档）、库存和价格、Buybox、批处理结果、带状态、物流追踪、承运商和发票链接的发货包裹、退货、客户问答、类目、属性和品牌、地址以及财务结算。使用 API 密钥和 secret 进行 Basic 认证。

前提条件

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

TRENDYOL_API_HOST, TRENDYOL_SELLER_ID, TRENDYOL_API_KEY, TRENDYOL_API_SECRET

步骤 1 — 获取凭证

1. 用 master user（管理员角色）登录 Trendyol 卖家后台（partner.trendyol.com）。只有 master user 能看到 API 密钥和 secret。
2. 打开右上角的店铺名称 → Hesap Bilgilerim → Entegrasyon Bilgileri。把 Satıcı ID（一个数字）复制到 TRENDYOL_SELLER_ID，把 API Key 复制到 TRENDYOL_API_KEY，把 API Secret Key 复制到 TRENDYOL_API_SECRET。
3. 对正式店铺，把 TRENDYOL_API_HOST 设为 https://apigw.trendyol.com。Stage（测试）主机 https://stageapigw.trendyol.com 需要单独的 stage 凭据，并且只响应已被 Trendyol 加入白名单的 IP 地址（其他地址会收到 503），因此适合自托管的测试安装，而不是你的正式店铺。
4. 仅当你在 Trendyol 的国际站点销售时，才把 TRENDYOL_STOREFRONT_CODE 设为该站点的两位国家代码。Trendyol 土耳其站请留空。
5. 安装连接器并运行 trendyol_list_stock_and_prices。

订单使用 v2 接口：trendyol_list_orders 通过 Trendyol 的 v2 订单接口（/v2/orders）读取发货包裹。Trendyol 已规定自 2026 年 10 月 15 日起必须使用该接口，届时旧的订单列表将停止工作。它最多只能查到最近一个月，日期范围最长 2 周（不指定日期时为最近一周），且每个筛选条件只能取到前 10,000 个包裹，因此要查看更多时，AI 会缩小时间范围或按状态筛选。

先确认：价格和库存更新、内容修改、包裹状态、追踪单号、更换承运商、发票链接、批准退货、回答提问、归档和创建商品，都会直接作用于你的正式店铺。AI 会先给你看将要改变的内容（带新旧数值的条码、包裹及其明细行、回答文本），并等待你确认。商品写入是异步的：返回成功只表示请求已进入队列，因此 AI 会用 trendyol_get_batch_request 检查结果（结果保留 4 小时）。

安装时默认关闭：trendyol_delete_products（无法撤销）、trendyol_report_unsupplied（为客户取消订单明细行，无法撤销）和 trendyol_reject_claim_items（请求 Trendyol 拒绝退回的商品）。

限制：每个接口每 10 秒最多 50 次请求，另外还有按服务组计算的每分钟限制，具体取决于你店铺的商品刊登等级。一次价格和库存更新最多包含 1,000 个条码（每个商品最多 20,000 件，售价不高于标价），Trendyol 会拒绝 15 分钟内重复提交的相同请求，以及同一条码每分钟超过 30 次的价格更新。财务列表需要指定交易类型，时间范围最长 15 天。

常见错误：带 ClientApiAuthenticationException 或 basic.authorization.failed 的 401：凭据错误（stage 和正式环境的凭据不同）。403：请检查 TRENDYOL_SELLER_ID，因为 Trendyol 要求使用由它生成的 User-Agent。429 too.many.requests：稍等片刻再试。

该连接器不使用旧主机 api.trendyol.com/sapigw、旧的订单列表或旧的商品筛选。

步骤 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 现在可以调用 Trendyol 的工具。

可用工具

示例提示

• “过去 3 天的发货包裹中，哪些仍处于 Created 状态？每个包裹包含哪些明细行？”
• “检查条码 8680001234567 和 8680001234574 的 Buybox，告诉我是否有其他卖家拿到了 Buybox，价格是多少。”
• “列出等待回答的客户提问，并为每个问题起草回复，但在发送任何回复之前先给我看。”
• “根据 10 月 1 日至 15 日的结算，汇总我们的销售额、退货和佣金。”

FAQ

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

下一步

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