将 bol.com MCP 连接到 Microsoft Copilot

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

bol.com + Microsoft Copilot

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

第三步 — 在 Microsoft Copilot 中添加连接器

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

Microsoft Copilot 通过在 Copilot Studio 中构建的智能体使用 MCP 服务器：把 AnythingMCP 作为工具添加到智能体，然后把智能体发布到 Microsoft 365 Copilot 和 Teams。Copilot Studio 从 Microsoft 的云端通过 Streamable HTTP 连接，AnythingMCP 支持这种方式。

1. 在 Copilot Studio 中打开你的智能体（或新建一个），进入 Tools，选择 Add a tool → New tool → Model Context Protocol。
2. 填写 Server name（例如 AnythingMCP）、说明连接器用途的 Server description，以及 Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。Copilot Studio 根据描述决定何时调用该服务器。
3. 身份验证选择 API key，把 Type 设为 Header，请求头名称填 X-API-Key，然后选择 Create。
4. 在 Add tool 中选择 Create a new connection，粘贴 AnythingMCP 的 MCP API 密钥（MCP Servers → 你的服务器 → API keys），然后选择 Add to agent。
5. 在智能体的 Test 窗格中试一试：提出需要用到 bol.com 的工具的请求。
6. 选择 Publish，然后进入 Channels → Microsoft 365 and Microsoft Teams，保持勾选 Make agent available in Microsoft Copilot，再选择 Add channel。See agent in Teams 会为你安装该智能体；在 Microsoft 365 Copilot 中输入 @ 并选择该智能体。

希望每个用户各自登录？请选择 OAuth 2.0 → Dynamic discovery 代替 API 密钥：每个用户会在智能体首次调用时登录 AnythingMCP。

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

可用工具

示例提示

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

常见问题

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

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

这适用于哪个 Copilot？ 适用于工作中的 Microsoft 365 Copilot，通过 Copilot Studio 的智能体实现。面向个人账户的 Microsoft Copilot 应用无法添加自己的 MCP 服务器。

我需要什么？ 一个可以使用 Copilot Studio 的工作账户（许可证或试用版），用于构建智能体。在 Microsoft 365 Copilot 或 Teams 中使用它的人需要拥有该智能体的访问权限：把它共享给他们，或请管理员为整个组织发布。如果你的组织对 Power Platform 连接器设置了数据策略，这些策略同样适用于 MCP 服务器。

智能体不调用工具。 检查请求头名称是否正好是 X-API-Key，密钥是否属于与 URL 相同的 MCP 服务器，并把 Server description 写得具体：Copilot Studio 根据它决定何时调用服务器。每次修改后重新发布智能体；在已打开的对话中输入 "start over" 即可使用新版本。

下一步

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