MediaMarkt MCP 服务器：订单与发货

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

MediaMarkt 市场

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

设置

国家：德国、奥地利、西班牙、荷兰、意大利、比利时、瑞士、波兰和匈牙利。在意大利，市场以 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）。

先决条件：MEDIAMARKT_API_KEY

本地安装连接器

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

打开 http://localhost:3000/connectors/store，选择 MediaMarkt Marketplace 并粘贴在先决条件下列出的环境变量。

可用工具

示例提示

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

下一步

• 连接到 Claude
• 连接到 ChatGPT