将 ABOUT YOU MCP 连接到 Gemini CLI

💡 没有安装？直接使用 cloud.anythingmcp.com。 登录，点击 Connectors → ABOUT YOU，粘贴你的凭证，生成一个 MCP API 密钥，完成。无需 Docker，无需 git clone，无需本地服务器。

ABOUT YOU + Gemini

ABOUT YOU 卖家中心 API 供市场合作伙伴使用：订单、带追踪的运输、发票和装箱单、具有审批状态的产品、库存、价格、类别和属性、品牌和报告。API 密钥。

前提条件

请查看连接器中的完整设置说明（在选择连接器时可在应用内商店中查看）。此连接器所需的环境变量为：

ABOUT_YOU_API_KEY

第一步 — 获取凭证

设置大约需要 2 分钟。

1. 以 Admin 用户身份登录 ABOUT YOU 卖家中心。成员用户无法创建 API 密钥。
2. 打开 设置，然后 API 密钥，点击 + 添加。
3. 输入标签，选择性地输入到期日期，然后点击 添加密钥。
4. 立即将密钥复制到 ABOUT_YOU_API_KEY：卖家中心仅在此时显示该密钥。

密钥通过 X-API-Key 头发送。要获取测试数据，请在 设置、沙盒、创建沙盒 下创建一个沙盒：它在同一地址上有自己的 API 密钥，产品在此处无需审批即可上线，测试订单来自订单页面上的 接收订单 按钮。

从哪里开始：about_you_list_orders 以 order_status 为 open 显示待发货的订单。about_you_list_products 显示你的目录，包括库存和价格。about_you_list_countries 是一个便宜的调用，证明密钥有效。

订单和运输：about_you_list_orders 返回每个订单的项目及其 id；发货、取消和退货工具使用这些项目 ID，而不是 SKU。使用 about_you_ship_order_items 发货（需要从 about_you_list_carriers 获取的承运人密钥、运输追踪密钥和退货追踪密钥）。about_you_get_delivery_document 返回一份直邮订单的装箱单，about_you_get_order_invoices 返回客户发票，均为文件格式。about_you_cancel_order_items 和 about_you_return_order_items 默认关闭：已取消的项目无法再发货，标记为退货的项目会使 ABOUT YOU 自动退款给客户。请在收到后 24 小时内检查退货；不要注册你拒绝的退货。

异步写入：每次写入都会立即返回 batchRequestId，并在后台处理。使用 about_you_get_batch_result 读取结果（选择匹配的 result_type），直到状态为完成或失败；每个项目都包含成功和错误信息。结果保留 7 天。短时间内发送相同的有效负载将返回相同的批处理 ID，并且不会再次处理。

产品：一行代表一个 SKU（某种颜色的某种款式的尺寸）。使用来自 about_you_list_categories、about_you_list_category_attribute_groups 和 about_you_list_brands 的 ID，通过 about_you_upsert_products 创建或更改它们，然后使用 about_you_publish_product 将样式发送至审批。状态包括：草稿、待审批（在 ABOUT YOU 审核期间锁定）、拒绝（原因在 about_you_list_rejected_products 中）、待激活、激活、非激活和问题（已激活的产品变为无效；修复后返回激活状态）。about_you_update_product_status（也包括草稿和非激活）和 about_you_delete_product 默认关闭。

库存和价格：about_you_update_stock 和 about_you_update_prices 每次调用最多可处理 1000 行，并始终生效，与通过产品更新发送的库存或价格不同。产品价格为该国货币的十进制数字（49.99），而订单金额为最小单位的整数（4999 = 49.99 欧元）。每个价格都需发送 currency。

报告和 Webhook：about_you_list_reports 和 about_you_download_report（ABOUT YOU 仓库中商品的库存和移动报告，DAC7），about_you_list_webhooks（只读）。

分页：列表返回 items 和 pagination。订单和产品应使用 cursor = pagination.next_cursor 进行分页；页面参数仍然有效，但已弃用。较小的列表使用 page 和 per_page（最大 100）。

履行类型：dropshipping 意味着你发货；fulfillment_by_marketplace 意味着 ABOUT YOU 从其自己的仓库发货（FbAY），因此没有需要发货的物品，也没有交付文件。

速率限制（每个端点和每个密钥）：订单每分钟 100 次，发货 200 次，取消和退货 50 次，库存 1000 次，价格 200 次，产品列表 1000 次，产品更新和状态 100 次，批处理结果 200 次，发票和报告 10 次。头部 X-RateLimit-Limit 和 X-RateLimit-Remaining 显示预算；429 表示等待下一个分钟。

错误：400 和 401 返回 JSON message。文档的 404 表示订单没有该文件。此 API 没有支付或付款调用；唯一导致退款的操作是注册退货，该操作默认关闭。

第二步 — 安装适配器

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

第三步 — 在 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 现在可以调用 ABOUT YOU 的工具。

可用工具

示例提示

• "哪些 ABOUT YOU 订单是开放的，等待发货？"
• "我的哪些产品被 ABOUT YOU 拒绝了，原因是什么？"
• "将 SKU AY-TSHIRT-WHT-M 的库存设置为 50。"
• "使用 DHL 发货订单 123456789 的物品，追踪 003404341612345678 和退货追踪 003404341698765432。"
• "下载上个月的销售报告。"

常见问题

我在哪里可以获得 API 密钥？ 在 ABOUT YOU 卖家中心，以 Admin 用户身份登录：设置、API 密钥、+ 添加。密钥仅显示一次。设置下的沙盒有自己的密钥用于测试订单。

它涵盖了什么？ 订单及其项目、带追踪的运输、客户发票和装箱单、具有审批状态的产品、库存、价格、类别、属性、品牌、批处理结果、报告和 webhook。

哪些工具默认关闭？ about_you_cancel_order_items、about_you_return_order_items、about_you_update_product_status 和 about_you_delete_product，因为已取消的项目无法再发货，标记为退货的项目会使 ABOUT YOU 自动退款给客户。仅在 AI 应该使用时在连接器页面上打开它们。

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

下一步

• 连接器着陆页
• 连接到 Claude