如何通过 MCP 将 idealo 连接到 Claude

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

idealo + Claude

通过 idealo 的 Partner Web Service，在 AI 智能体中维护你的店铺在 idealo 比价平台上的报价：按 SKU 读取报价，并在你批准后新建或替换报价、修改价格、配送时间和标题，或下架报价。适用于已在 idealo 上架的店铺。

前提条件

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

IDEALO_CLIENT_ID, IDEALO_CLIENT_SECRET, IDEALO_SHOP_ID

步骤 1 — 获取凭证

设置大约需要 3 分钟。你需要一家已在 idealo 上架的店铺 (与 idealo 签有商家合同)，并能访问 idealo Business。

1. 登录 idealo Business，打开 Shop settings → API clients (business.idealo.com/direct/shops/settings/api-clients)。
2. 创建一个可访问 Partner Web Service 的 API 客户端，复制它的 client ID 和 client secret。secret 只显示一次；如果已经找不到，请新建一个客户端。
3. 把 client ID (UUID 格式) 粘贴到 IDEALO_CLIENT_ID，secret 粘贴到 IDEALO_CLIENT_SECRET，把 idealo Business 中显示的数字 shop ID 填入 IDEALO_SHOP_ID。AnythingMCP 会用客户端凭证换取有效期一小时的访问令牌，并自动续期。
4. 安装连接器，用一个你确定已上线的报价的 SKU 运行 idealo_get_offer：你会看到 idealo 所存储的报价内容。

可读取的内容：按 SKU 一次读取一条报价，内容与 idealo 存储的一致：标题、价格和原价、URL、EAN 和制造商编号、品牌、运费和支付费用、配送时间、能效标签、商品状况以及其他报价字段。Partner Web Service 没有列表接口，所以 AI 会向你询问 SKU。

只有报价，没有订单：Partner Web Service 2.0 是 idealo 提供给上架店铺逐条维护报价的接口，可以替代商品数据源，也可以与之并用，适用于 idealo.de、.at、.fr、.it、.es 和 .co.uk。idealo 已在 2023 年关闭了结账服务 (Direktkauf) 及其订单 API，所以订单仍然通过你自己的店铺进来。

报价的写法：价格是保留两位小数的字符串，例如 "177.99"；原价是降价前的价格。新报价至少需要 SKU、标题、价格、URL、一项运费 (例如 "DHL": "4.90") 和一项支付费用 (例如 "PAYPAL": "0.00")；EAN、制造商编号和品牌能帮助 idealo 匹配商品。idealo_upsert_offer 会替换整条报价，未发送的字段都会被删除；idealo_update_offer 只修改发送的字段，但不能修改运费和支付费用、尺码、颜色、性别、材质和动态商品属性，而且 EAN、图片等列表字段必须完整发送。SKU 只能包含字母、数字、下划线、点和连字符。

每次修改前都会询问：安装时没有开启任何写入工具。管理员开启后，AI 会向你展示报价的旧值和新值，或告诉你将要下架的 SKU，等你同意后才会上线。

安装时关闭：idealo_upsert_offer、idealo_update_offer 和 idealo_delete_offer。idealo 没有测试环境，每次写入都会立即改变比价平台上正在展示的报价，下架的报价会从 idealo 上消失。只开启允许 AI 使用的工具。一次性删除全部报价的功能是有意不提供的。

限制：idealo 限制调用次数，当前上限显示在 X-RateLimit-Limit 请求头中。遇到 429 时，AI 会等待后再重试，并且一次只修改一条报价。

常见错误：401 表示 client ID 或 secret 有误，或令牌被拒绝，请在 Shop settings → API clients 中检查。403 表示该 API 客户端没有 Partner Web Service 权限，或 shop ID 不属于你。404 表示此店铺中不存在该报价 (SKU 或 shop ID 有误)。400 会列出 fieldErrors，包含字段和原因，例如价格不是两位小数。

该连接器不会读取或处理订单，不会列出你的全部报价，不会修改你的商品数据源，也不会一次性删除全部报价。

步骤 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 — 在 Claude 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

推荐路径：在 claude.ai web 上工作，无需触碰任何配置文件。

1. 在 Claude 中打开 Customize → Connectors。
2. 点击 +，然后点击 Add custom connector。
3. 输入名称（例如 idealo）和远程 MCP 服务器 URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID，然后点击 Add。
4. 点击 Connect，登录 AnythingMCP（OAuth）并允许访问。

下面所有工具都会出现在你的聊天中，开始输入提示。

可用工具

示例提示

• “我 SKU 为 KS-4711 的报价现在在 idealo 上是什么样的？价格、配送时间和运费各是多少？”
• “把 SKU TV-55-OLED 的价格降到 899.00 欧元，并把 999.00 欧元显示为原价。”
• “把 SKU BOSCH-GSR18 的配送时间改为 1-3 个工作日。”
• “为 SKU LAMP-200 (EAN 4006381333931) 在 idealo 上新建报价：售价 49.90 欧元，DHL 运费 4.90 欧元，PayPal 不加收费用。”
• “把 SKU KS-4711 的报价从 idealo 下架，这件商品已经卖完了。”

FAQ

Claude Code 和 Claude Desktop 一样工作吗? 是的，两者都指向 https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。

下一步

• 连接器主页
• 连接到 ChatGPT
• 连接到 Cursor
• 连接到 Gemini
• 连接到 Meta Muse