将 bol.com MCP 连接到 Meta Muse

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

bol.com + Meta Muse

bol.com 零售商 API 适用于荷兰和比利时市场的卖家：订单、带追踪的发货、退货、FBB 库存、带价格和库存的报价、佣金、目录内容、竞争报价、评级、发票和绩效指标。客户端 ID 和密钥。

前提条件

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

BOL_CLIENT_ID, BOL_CLIENT_SECRET

第一步 — 获取凭据

设置大约需要 3 分钟。你需要一个 bol.com 卖家账户（Verkopen via bol）和访问 bol 卖家仪表板中的 API 设置。连接器需要零售商 API 的客户端 ID 和客户端密钥。

1. 在 bol 卖家仪表板中打开你的账户，然后 Instellingen → Diensten → API Instellingen（设置、服务、API 设置）。如果 bol 要求，请保存一个技术联系人。
2. 在 Client credentials voor de Retailer API 下点击 Aanmaken（创建），给密钥命名并点击 Toon secret（显示密钥）。
3. 将 client ID 复制到 BOL_CLIENT_ID，将 secret 复制到 BOL_CLIENT_SECRET。如果密钥丢失，请创建新的凭据。
4. 安装连接器。运行 bol_com_list_orders 检查连接：它返回你自己发货的未完成订单（FBR）。

云端和自托管的工作方式相同：凭据相同，无需注册重定向 URL 或 IP 地址。

身份验证：连接器在 https://login.bol.com/token（客户端凭据）处交换客户端 ID 和密钥以获取一个大约持续 5 分钟的 Bearer 令牌，并在令牌过期之前重复使用。它不会在每次调用时请求新的令牌，因为 bol 会阻止频繁请求其登录服务的地址。

从哪里开始：bol_com_list_orders 列出未完成的 FBR 订单，最新的在前；bol_com_get_order 添加客户的运输和账单详细信息及商品。bol_com_list_offers 列出你的报价，bol_com_list_inventory 显示 bol 为你在其仓库中持有的库存（FBB）。

读取内容：订单、带运输和追踪的发货、带原因和客户评论的退货、FBB 库存、带价格、库存和国家可用性的报价、为何某个报价不可售、某个价格的产品佣金、按 EAN 的 bol 目录内容、竞争报价及谁拥有购买框、每个报价的星级评分、访问量和购买框百分比、每周的卖家绩效指标，以及发票（只读）。

发货：bol_com_create_shipment 确认你自己发货的商品的发货，包含承运人和追踪代码。bol_com_add_track_and_trace 将缺失的代码添加到发货中；它无法更改现有代码。

报价：bol_com_create_offer 和 bol_com_update_offer 创建报价并更改价格、库存、履行、国家或暂停标志。更新仅更改给定的字段，但数组（捆绑价格、国家）会完全替换旧的。409 意味着有人同时更改了报价。价格以欧元计，包括增值税，库存为 0 到 999。

安装时关闭：bol_com_cancel_order_item（取消无法交付的订单项）和 bol_com_delete_offer（删除报价）。取消无法撤销，并会影响你的卖家评分，删除的报价会立即从 bol 消失，无法恢复。要暂停报价，请使用 bol_com_update_offer 将其设置为暂停。仅在 AI 应该使用它们时在连接器页面上启用；AI 会要求你确认每个更改。发货、追踪和创建及更新报价已启用。

异步写入：发货、运输和取消的响应为处理状态，而不是结果。bol_com_get_process_status（或按实体和事件类型的 bol_com_find_process_statuses）显示何时为 SUCCESS 或 FAILURE。bol 保留处理状态一天。报价为同步。

分页：订单、发货、退货和库存列表从 1 开始，页面上有 50 行；空响应意味着没有更多页面。报价使用游标：传递 page.nextCursor 直到缺失。

速率限制：bol 为每个端点设置速率限制。订单列表和发货列表允许每分钟 25 次调用，退货和库存每分钟 20 次，发票每分钟 24 次；订单详细信息每秒 25 次，报价每秒 25 到 50 次。429 会携带 Retry-After（以秒为单位）；实时值在 api.bol.com/retailer/public/ratelimits。

ID 和格式：订单 ID 可以包含字母（A4K8290LP0），EAN 是字符串，日期为 YYYY-MM-DD，时间为带偏移的 ISO 8601。未使用的字段将被省略，因为 bol 对空字符串返回 400。

常见错误：错误以 application/problem+json 格式返回，包含 title、detail 和命名字段的 violations。400 通常意味着缺少或为空字段。429 是速率限制：请等待 Retry-After 时间。

未涵盖：处理或登记退货（接受退货会使 bol 退款给客户）、购买运输标签和任何涉及资金流动的事务。

第二步 — 安装适配器

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

第三步 — 在 Muse 中添加连接器

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

Muse 以自定义连接器的形式添加远程 MCP 服务器，并通过 OAuth 登录。

1. 在 Muse 中打开 Settings → Connectors，选择 Add custom connector。
2. 粘贴 MCP 服务器 URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。
3. Muse 会打开 AnythingMCP 的登录页面：登录并批准访问。
4. 在聊天中，向 Muse 提出需要用到 bol.com 的工具的请求。

你也可以在聊天中完成设置，适用于网页版、iOS 和 Android 应用以及 WhatsApp。给 Muse 发送这条消息：

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

自托管？请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Muse 从 Meta 的云端连接，因此 localhost 无法使用。

可用工具

示例提示

• "今天还有哪些未发货的订单需要发货，是否有取消请求？"
• "显示订单 A4K8290LP0 的客户地址和商品。"
• "我的哪些报价不可售，原因是什么？"
• "谁在 EAN 8712345678901 上拥有购买框，价格是多少？"
• "将我对 EAN 8712345678901 的报价价格设置为 24.95，库存设置为 40。"

常见问题

它能处理退货或取消订单吗？ 它可以读取退货，但不处理或登记，因为接受退货会使 bol 退款给客户。使用 bol_com_cancel_order_item 可以取消订单项，但在安装时已关闭。

它适用于比利时和荷兰的销售吗？ 是的。一个卖家账户覆盖两个国家；报价携带其国家可用性，bol_com_get_offer_not_for_sale_reasons 按国家解释为何某个报价不可售。

Muse 在哪些地区可用？ Meta 目前在美国和加拿大提供 Muse，可在网页版、iOS 和 Android 应用以及 WhatsApp 中使用。

Meta 会审核这个连接器吗？ 不会。Meta 不审核自定义连接器。Muse 只能看到你在 AnythingMCP 中为此 MCP 服务器启用的工具，你也可以随时在 Settings → Connectors 中断开它。

下一步

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