如何通过 MCP 将 ManoMano 连接到 Gemini

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

ManoMano + Gemini

通过 AI 代理在欧洲 DIY 与园艺电商平台 ManoMano 上销售：订单的接受、发货和退款，商品报价的价格与库存，与其他卖家的竞争力对比，按 EAN 查询商品目录，ManoFulfillment 库存以及客户发票。每个卖家合同安装一次。

前提条件

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

MANOMANO_API_KEY, MANOMANO_SELLER_CONTRACT_ID

步骤 1 — 获取凭证

1. 使用拥有 Admin 角色的用户登录 ManoMano Toolbox：https://toolbox.manomano.com。
2. 打开 Settings > API keys，点击 Create API key，起一个名字（例如 AnythingMCP），然后点击 Generate API key。请立即复制密钥：ManoMano 只显示一次。将其粘贴到 MANOMANO_API_KEY。
3. 在 MANOMANO_SELLER_CONTRACT_ID 中填写你的卖家合同 ID。它是 Toolbox 中显示的一个数字，例如 110841。
4. 安装连接器，先运行 manomano_list_orders。

每个合同安装一次：ManoMano 按平台（manomano.fr、.es、.it、.de 和 .co.uk）和配送方式分别创建卖家合同，因此在多个平台销售的卖家会有多个合同。请为每个合同各安装一次连接器，并按合同命名，例如 ManoMano FR。每次调用都会附带合同 ID，密钥只发送给 ManoMano。

订单流程：新订单的状态是 PENDING。接受后进入 PREPARATION；拒绝则会给客户退款（先 REFUNDING，再 REFUSED）。发货时登记承运商、运单号和追踪链接以及包裹中的商品，每个包裹登记一次，订单随后变为 SHIPPED。退款可以针对部分或全部商品（先 REFUNDING，再 REFUNDED）。作为每日待办清单，AI 会列出处于 PENDING 和 PREPARATION 的订单；在发货或退款之前，AI 会先读取订单，因为这两项操作都需要每个商品的 seller_sku 和数量。

先确认：接受、拒绝、发货和退款订单，修改、解冻和替换商品报价，以及上传发票，都会直接作用于线上平台。执行这些操作之前，AI 会向你展示将要更改的内容（订单、商品和数量、运单号、各 SKU 的新旧价格或库存、要上传的文件），并等待你确认。拒绝和退款无法撤销。

价格和库存：manomano_update_offers 修改现有 SKU 的价格、库存或两者。默认情况下新值会被冻结，之后的商品数据源（feed）导入不会再覆盖它们，直到 manomano_unfreeze_offers 把控制权交还给数据源。ManoMano 在后台处理更新：AI 会用返回的 request_id 通过 manomano_list_offers 查看结果（IN PROGRESS、带错误列表的 ERROR 或 COMPLETED）。用于新建或完整替换报价的 manomano_upsert_offers 安装时默认关闭。

竞争、目录和履约：将你选定的 SKU 与该商品的最佳报价对比，或列出在某个日期范围内竞争状况发生变化的所有报价。一次最多查询 200 个 EAN，了解商品是否已在 ManoMano 目录中、能否在其上发布报价。ManoFulfillment 仓库库存仅适用于 ManoFulfillment 合同。

客户发票：AI 会列出客户正在等待的发票，最早的请求排在最前。你需要在发货后 3 个工作日内提供发票。AI 会从一个 URL 上传 PDF；每份文件都会追加到已有文件旁，客户会收到通知。

限制：每个 API 密钥每小时大约可以向订单 API 发送 250 个请求、向报价 API 发送 200 个请求；超出后 ManoMano 返回 429。订单按每页最多 50 条返回。连接器使用正式 API，不使用 ManoMano 的沙盒环境。

常见错误：401 表示 ManoMano 拒绝了密钥：请检查密钥，或在 Toolbox 中新建一个（删除的密钥会立即失效）。403：密钥有效，但无权操作这个合同；请确认合同 ID 属于创建该密钥的卖家账户。400：请确认填写的是数字形式的卖家合同 ID。429：请求过多；请稍候再试。

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

可用工具

示例提示

• “哪些 ManoMano 订单还在等待处理？准备中的订单里有哪些已经超过两天？”
• “用 Colissimo 发货订单 M240915123，运单号 6A12345678901，所有商品在同一个包裹里。”
• “把 SKU DRILL-18V 的价格改成 89.90 欧元、库存改成 25，然后检查更新是否成功。”
• “这五个 SKU 我在 ManoMano 上是最佳报价吗？告诉我谁比我便宜、价格是多少。”

FAQ

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

下一步

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