MediaMarkt MCP 连接 Gemini CLI

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

MediaMarkt Marketplace + Gemini

通过 AI 代理在 MediaMarkt 市场上运行你的商店：订单、接受、跟踪和运输、事件、带有价格和库存的报价、导入、消息、退货、发票和交易。该市场在德国、奥地利、西班牙、荷兰、意大利、比利时、瑞士、波兰和匈牙利销售；使用来自 MediaMarkt 卖家后台的商店 API 密钥登录。

前提条件

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

MEDIAMARKT_API_KEY

第一步 — 获取凭据

国家：德国、奥地利、西班牙、荷兰、意大利、比利时、瑞士、波兰和匈牙利。在意大利，市场以 MediaWorld 的名义交易。所有国家共享一个卖家平台。

谁可以销售：MediaMarkt 通过每个国家的表单接受申请，随后进行商业验证（KYC）。该连接器需要一个 MediaMarkt 已经开设的卖家账户。

设置大约需要 5 分钟。

1. 登录 MediaMarkt 卖家后台：https://mediamarktsaturn.mirakl.net/login。
2. 在后台打开你的登录名（右上角）> 我的用户设置 > API 密钥，然后点击 生成新密钥（或复制现有密钥）。将其粘贴到 MEDIAMARKT_API_KEY 中。密钥以原样形式发送在 Authorization 头中，不带 Bearer。生成新密钥会使旧密钥失效，因此使用旧密钥的任何其他工具将停止工作。
3. MediaMarkt 通常在每个国家开设一个商店，因此大多数卖家在一个用户下有多个商店。如果你的用户有多个商店，请将 MEDIAMARKT_SHOP_ID 设置为此连接器应在其上工作的商店的数字 ID（在后台仪表板上显示在 标识符 或 商店 ID 旁边，并由 mediamarkt_get_account 返回为 shop_id）；要在多个商店上工作，请为每个商店安装一次连接器。没有它将使用你的默认商店。
4. 安装并运行 mediamarkt_get_account：它返回密钥所属的商店。

从哪里开始：mediamarkt_get_account 显示密钥背后的商店（id、名称、状态、货币和渠道）。日常工作中使用 mediamarkt_list_orders，参数为 order_state_codes=WAITING_ACCEPTANCE，使用 mediamarkt_list_offers 获取价格和库存，使用 mediamarkt_list_threads 获取等待回复的消息。

产品和竞争报价：mediamarkt_get_products 通过 EAN 或其他参考在 MediaMarkt 目录中查找产品，并返回市场产品 SKU；mediamarkt_list_product_offers 列出给定产品的每个商店的报价，按最佳价格排序，每分钟大约 5 次调用。

订单工作流程：新订单在 WAITING_ACCEPTANCE 中等待。mediamarkt_accept_order 接受（或拒绝）每一行；在客户被扣款后，订单转移到 SHIPPING。然后 mediamarkt_update_tracking 存储承运人和跟踪号码（承运人代码来自 mediamarkt_list_carriers），mediamarkt_ship_order 确认发货（SHIPPED）。后续状态为 TO_COLLECT、RECEIVED、CLOSED、REFUSED 和 CANCELED。使用 mediamarkt_list_orders，参数为 order_state_codes=WAITING_ACCEPTANCE，获取日常待办事项，并使用 has_incident=true 获取未解决的事件；mediamarkt_resolve_incident 在问题解决后关闭一个订单行上的事件。附加到订单的文档（交货单、标签、客户发票）由 mediamarkt_list_order_documents 列出。

写入：先确认。 mediamarkt_accept_order、mediamarkt_update_tracking、mediamarkt_ship_order、mediamarkt_resolve_incident、mediamarkt_accept_return、mediamarkt_receive_return、mediamarkt_update_offers、mediamarkt_reply_thread、mediamarkt_create_order_thread 和 mediamarkt_import_products 在实时市场上操作。在每次调用之前，向用户展示将要更改的内容（订单 ID 和行、跟踪号码、报价 SKU 及其旧价格和新价格或库存、消息文本和收件人），并等待确认。拒绝订单行将永久取消。此处没有工具可以退款、取消订单或转移资金；请在后台处理。mediamarkt_import_offers 可以删除报价（REPLACE 模式会删除文件中缺失的每个报价），因此它的安装是关闭的。

更新报价（价格和库存）：mediamarkt_update_offers（OF24）替换整个报价。你遗漏的每个字段都会被重置：缺失的 quantity 变为 0，缺失的 discount 或 description 被删除。始终先读取报价（mediamarkt_get_offer 或 mediamarkt_list_offers，参数为 sku），并将其完整发送回去，仅包含预期的更改：shop_sku、product_id 和 product_id_type（来自 product_references）、state_code、price、quantity、leadtime_to_ship、logistic_class（其代码）、min_quantity_alert、description、discount、all_prices、available_started / available_ended（读取为 available_start_date / available_end_date）以及任何 offer_additional_fields。将 update_delete 留空或设置为 update。调用返回一个 import_id；更改是异步应用的，因此在再次读取报价之前，请使用 mediamarkt_get_offer_import 检查它。state_code 的条件代码来自 mediamarkt_list_offer_conditions，物流类别代码来自 mediamarkt_list_logistic_classes。

文件导入：mediamarkt_import_products（P41）和 mediamarkt_import_offers（OF01）接受 MediaMarkt 要求的 CSV、XLSX 或 XML 文件的 URL；连接器下载并将其上传到 MediaMarkt。使用 mediamarkt_list_product_imports / mediamarkt_get_product_import 和 mediamarkt_list_offer_imports / mediamarkt_get_offer_import 跟踪它们。

退货：mediamarkt_list_returns（RT11）列出退货请求。在 MediaMarkt 允许商店决定的地方，mediamarkt_accept_return 接受或拒绝一个处于 WAITING_ACCEPTANCE 状态的请求，mediamarkt_receive_return 确认货物已到达。退款留在后台处理。

消息：mediamarkt_list_threads 列出与客户和 MediaMarkt 的对话（通过 entity_type=MMP_ORDER 和 entity_id=<order id> 过滤特定订单；没有 entity_type 的 entity_id 将被拒绝），mediamarkt_get_thread 读取一个对话及其消息，mediamarkt_reply_thread 回复（收件人 CUSTOMER 或 OPERATOR，即 MediaMarkt），mediamarkt_create_order_thread 在订单上开启新的对话。主题的原因代码来自 mediamarkt_list_reasons；除非你知道市场有该语言，否则将其 locale 留空（非活动语言返回 400）。

资金：mediamarkt_list_invoices（IV01）列出 MediaMarkt 向商店发出的会计文件，mediamarkt_list_transactions（TL02）列出交易行（销售、佣金、退款、付款）。如果 MediaMarkt 使用增强卖家开票，IV01 不会返回新文件；然后使用 mediamarkt_list_document_requests（DR11）和交易。

参考列表：mediamarkt_list_channels（国家网站）、mediamarkt_list_carriers、mediamarkt_list_shipping_zones、mediamarkt_list_shipping_methods 和 mediamarkt_list_logistic_classes 变化很少；每次对话时读取一次。

分页：订单、报价、发票和产品导入使用 max（最多 100）和 offset 进行分页。对话、退货、交易、文档请求和报价导入返回 next_page_token；将其作为 page_token 传递以获取下一页（所有其他过滤器将被忽略），直到它缺失。

日期为 ISO 8601，例如 2026-10-01T00:00:00Z；答案为 UTC。

速率限制：每个 API 有自己的限制，MediaMarkt 可能会收紧它们。列出报价和订单是为了交互使用，产品和报价导入最多每 15 分钟一次，mediamarkt_get_account 和参考列表大约每天一次。429 会携带 Retry-After 头，指示等待的秒数；请勿循环重试。

错误：401 表示密钥错误或已被新密钥替换，403 表示你的用户没有此操作的权限，404 表示该订单、报价或对话在此商店中不存在，400 表示参数错误或订单处于错误状态（消息会命名，例如 ORDER_INVALID_STATE）。

第二步 — 安装适配器

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 现在可以调用 MediaMarkt Marketplace 的工具。

可用工具

示例提示

• "列出我在 SHIPPING 状态且尚未有跟踪号码的 MediaMarkt 订单。"
• "在 MediaMarkt 上，EAN 为 4548736132610 的耳机谁的价格最好，我的价格排名如何？"
• "我在 MediaMarkt 上的报价中，哪些库存少于 3 个？"
• "显示我在 MediaMarkt 订单上的未解决事件以及客户写了什么。"
• "在订单 4501234-A 的对话中回复客户，告知替换品明天发货。"

常见问题

我在哪里可以获得 MediaMarkt API 密钥？ 在 MediaMarkt 卖家后台：你的登录名（右上角）、我的用户设置、API 密钥，然后 生成新密钥（或复制现有密钥）。生成新密钥会使旧密钥失效。MediaMarkt 通常在每个国家开设一个商店，因此大多数卖家在一个用户下有多个商店。如果有多个商店，请将 MEDIAMARKT_SHOP_ID 设置为此连接器应在其上工作的商店。

谁可以在 MediaMarkt 上销售，覆盖哪些国家？ MediaMarkt 通过每个国家的表单接受申请，随后进行商业验证（KYC）。该连接器覆盖德国、奥地利、西班牙、荷兰、意大利、比利时、瑞士、波兰和匈牙利。在意大利，市场以 MediaWorld 的名义交易。所有国家共享一个卖家平台。

它可以取消订单、退款或删除报价吗？ 没有工具可以退款或取消订单；请在 MediaMarkt 后台处理。接受订单时拒绝一行将永久取消，因此 AI 会向你展示每个写入并等待确认。mediamarkt_import_offers 安装时关闭，因为其 REPLACE 模式会删除文件中缺失的每个报价；仅在 AI 应该使用时在连接器页面上打开。

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

下一步

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