如何通过 MCP 将 Fruugo 连接到 Gemini

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

Fruugo + Gemini

在 AI 智能体中经营 Fruugo 平台店铺：下载包含明细行、顾客价格、收货地址和发货信息的订单，并读取你各个 SKU 的可售状态和库存。也包含确认订单和标记发货，但安装时处于关闭状态。

前提条件

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

FRUUGO_USERNAME, FRUUGO_PASSWORD

步骤 1 — 获取凭证

设置大约需要 2 分钟。你需要一个 Fruugo 卖家账号和一个 Fruugo Retailer Portal 用户。

1. 在 retailer.fruugo.com 登录 Fruugo Retailer Portal。Fruugo 建议为集成单独设一个门户用户，所以如果可以，请为 AnythingMCP 新建一个。
2. 把该门户用户的用户名填入 FRUUGO_USERNAME，密码填入 FRUUGO_PASSWORD。Fruugo 每次调用都会通过 HTTP Basic 验证它们。
3. 安装连接器，用几天前的日期作为 from 运行 fruugo_download_orders。

可读取的内容：经 Fruugo 反欺诈审核后释放给你的订单，包括订单号和顾客订单号、日期、状态、顾客语言、收货地址和配送方式、运费、含 Fruugo 和你自己的商品 ID 与 SKU ID 的明细行、你的价格和顾客以本国货币看到的价格、增值税、件数计数（待处理、已确认、已发货、已取消、已申报退货、已退货）以及发货信息；还有你在售的 SKU，包括标题、可售状态（INSTOCK、OUTOFSTOCK、NOTAVAILABLE）以及你的商品源提供时的库存数量。如果税款由 Fruugo 代收，订单中还会包含 Fruugo 的税号和 EORI，用于报关。

每次最多 60 天：Fruugo 每次只列出最长 60 天时间窗口内的订单；更长的窗口会返回 400 Time range specified is too long。查询整个季度时，AI 会分两次查询再汇总。

订单状态：PENDING 表示新订单、等你处理，PROCESSED 表示至少部分已处理，EXCEPTION 表示 Fruugo 在 API 之外人工处理该订单。

库存来自你的商品源：库存列表每页 1,000 个 SKU，只有在你需要时 AI 才会读取后续页面。连接器不会修改库存或价格：它们来自你的商品数据源。

安装时关闭：fruugo_confirm_order 和 fruugo_ship_order。它们作用于真实的顾客订单：前者确认待处理的订单，可附预计发货日期；后者用物流单号和跟踪链接（或至少承运商名称）把订单标记为已发货，Fruugo 会把这些信息转给顾客。两者都可用于整笔订单或单个商品。需要管理员有意识地开启，即便开启后，AI 也会先展示订单和具体的变更内容，等你同意后再执行。

常见错误：401 表示门户用户名或密码错误；请登录 retailer.fruugo.com 核对。400 会用文字说明问题，例如时间窗口超过 60 天，或订单状态不对。

该连接器不会取消订单或登记退货，因为两者都会给顾客退款：请在 Retailer Portal 中处理。它也不会修改商品、价格或库存。

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

可用工具

示例提示

• “过去两周的 Fruugo 订单里，哪些还在待处理、需要发货？”
• “过去 30 天我们在 Fruugo 上收到了多少订单？都发往哪些国家？”
• “我的哪些 SKU 现在在 Fruugo 上显示缺货？”
• “给我看上周的订单：顾客用本国货币付了多少钱，以及每一行的增值税。”
• “9 月 1 日以来，哪些订单有商品被取消或退货？”

FAQ

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

下一步

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