如何通过 MCP 将 Mirakl 连接到 Gemini

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

Mirakl + Gemini

用 AI 智能体运营你在任何基于 Mirakl 的电商平台上的店铺（Leroy Merlin、Conforama、BUT、home24、Maisons du Monde、Vente-unique、ePrice、Decathlon、Carrefour 等众多平台）：订单、接单、物流跟踪与发货、异常、含价格和库存的报价、报价与商品导入、与客户和运营方的消息、退货、订单文档、发票和交易。每个平台安装一次。

前提条件

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

MIRAKL_URL, MIRAKL_API_KEY

步骤 1 — 获取凭证

1. 登录电商平台的卖家后台（运营方提供给你的 Mirakl 门户）。每个运营方都有自己的 Mirakl 实例，因此每个平台都要单独安装一次连接器（例如 Leroy Merlin 和 Conforama），并按平台名称为每个安装命名。
2. 将门户地址（不带任何路径）复制到 MIRAKL_URL（常见平台的地址见下方）。不要加 /api：连接器会自动添加。
3. 点击右上角你的用户名，打开 My user settings 和 API Key 标签页，生成密钥（或复制现有密钥），不带 Bearer 粘贴到 MIRAKL_API_KEY。生成新密钥会使旧密钥失效，仍在使用旧密钥的其他工具都会停止工作。
4. 仅当你的用户在该平台上管理多个店铺时（在 home24 和 Vente-unique 上很常见）：将要使用的店铺的数字 ID 填入 MIRAKL_SHOP_ID。留空则使用你的默认店铺。
5. 安装连接器并运行 mirakl_get_account。它会显示该密钥所属的店铺。

基于 Mirakl 的平台：在所有平台上连接器都相同，只有地址和密钥不同。

• Leroy Merlin (ADEO): https://adeo-marketplace.mirakl.net
• Conforama: https://conforama-prod.mirakl.net
• BUT: https://but-prod.mirakl.net
• home24: https://home24.mirakl.net
• Maisons du Monde: https://maisonsdumonde-prod.mirakl.net
• Vente-unique: https://venteunique-prod.mirakl.net
• ePrice: https://marketplace.eprice.it

其他运营方的用法相同，包括使用自有域名的运营方：填写你登录的卖家后台地址即可。

订单和异常：AI 会列出等待接单的订单，逐行接受或拒绝，登记承运商和跟踪号并确认发货。它还能找出有未解决异常的订单，并在客户的问题解决后用 mirakl_resolve_incident 关闭该订单行上的异常。订单附带的文档（送货单、物流面单、客户发票）会列出名称、类型和上传日期；文件本身需在卖家后台打开。

退货：AI 会列出退货申请及其原因、RMA、物流跟踪和关联订单。在使用 Mirakl 退货并由店铺自行决定的平台上，它可以接受或拒绝申请，并确认货物已到达你的仓库。退款仍在卖家后台处理。

先确认：接单、物流跟踪、发货、关闭异常、退货决定、报价更新、消息和商品导入都会直接作用于线上平台。AI 会先展示将要改变的内容（订单行、跟踪号、新旧价格或库存、消息内容），等你同意后再执行。拒绝的订单行会被永久取消，已发送的消息无法撤回。

价格和库存：mirakl_update_offers 会替换整个报价，未填写的字段都会被重置（缺少数量即变为 0），所以 AI 会先读取报价，再只带着你的修改完整地发回。mirakl_import_offers 在安装时处于关闭状态，因为它的 REPLACE 模式会删除文件中没有的所有报价。

可读取的内容：包含客户、地址和异常的订单，你的报价以及其他店铺对相同商品的报价，消息，退货，订单文档，运营方的发票，交易明细（销售、佣金、退款、打款），以及平台的销售渠道（各国站点）、承运商、配送区域、配送方式和物流等级。在启用 Enhanced Seller Invoicing 的平台上，发票列表不会显示新单据，此时 AI 会改为读取会计单据请求和交易明细。

限制：Mirakl 对每个 API 分别限流，运营方还可以收紧限制。商品和报价导入最多每 15 分钟一次，与竞争对手的报价比较约每分钟 5 次。429 响应会说明需要等待的秒数。

常见错误：401：密钥错误、已被更新的密钥替换，或属于另一个平台。403：你的用户没有执行此操作的权限。404：该订单、报价或会话在此店铺中不存在，或 MIRAKL_URL 不是卖家后台的地址。400：参数错误，或订单处于不允许此操作的状态。

该连接器不会退款、取消订单或转移资金，并且每个安装只对应一个平台和一个店铺。

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

可用工具

示例提示

• “现在有哪些订单在等待接单，哪些订单有未解决的异常？”
• “把我们 EAN 3700123456789 的价格和这个平台上其他店铺的报价比较一下。”
• “把 SKU LAMP-042 的库存改为 25，但修改前先给我看当前报价和新的数值。”
• “为订单 20481937-A 的客户消息起草一条回复，发送前先给我看。”
• “Leroy Merlin 上有哪些退货申请在等我们处理？每位客户给出的退货原因是什么？”
• “订单 20481937-A 的客户已经收到替换商品。请关闭该订单行上的异常，但先给我看原因代码。”

FAQ

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

下一步

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