Billbee 与 Microsoft Copilot 连接：MCP

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

Billbee + Microsoft Copilot

让你的 AI 处理 Billbee 订单管理：查找你所有电商平台和网店的订单，按 SKU 或 EAN 查询商品的价格和库存，查看客户的订单历史，并处理订单：设置订单状态、添加物流单号、通过 Billbee 中接入的物流商创建面单、更新库存、添加标签、修改订单和商品字段以及开具发票。使用 Billbee API 密钥、登录邮箱和 API 密码。

前提条件

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

BILLBEE_API_KEY, BILLBEE_LOGIN_EMAIL, BILLBEE_API_PASSWORD

步骤 1 — 获取凭证

1. 登录 Billbee，打开 Einstellungen（Settings）→ Billbee API。在该页面的常规设置中启用 API 访问，并设置一个 API 密码。这是专门用于 API 的独立密码，不是你的登录密码。
2. 向 Billbee 申请 API 密钥：使用他们的 API 申请表，或发邮件到 [email protected]，简单说明你要接入什么（这里是：通过 AnythingMCP 读取订单的 AI）。Billbee 会把密钥发给你。
3. 把密钥填入 BILLBEE_API_KEY，把你登录 Billbee 用的邮箱填入 BILLBEE_LOGIN_EMAIL，把第 1 步设置的 API 密码填入 BILLBEE_API_PASSWORD。
4. 安装连接器。不需要点击 Authorize with Provider：每次调用都会在 X-Billbee-Api-Key 请求头中发送 API 密钥，并通过 HTTP Basic 认证发送邮箱和 API 密码。
5. 先运行 billbee_list_shipping_providers：它不需要参数，会列出你账户中配置的物流服务商。只要有返回结果，就说明三个值都正确。

三个值缺一不可：只带 API 密钥，或只带邮箱和 API 密码的调用都会被 Billbee 拒绝。连接器上必须三个都填好。

保持登录：没有需要续期的令牌，连接器每次调用都会发送这三个值。如果你在 Billbee 中修改了 API 密码，或拿到了新的 API 密钥，请在连接器页面更新 BILLBEE_API_PASSWORD 或 BILLBEE_API_KEY。

读取和写入：17 个工具中有 9 个只读取订单、商品、客户、物流服务商和仓库。另外 8 个会修改你正在使用的 Billbee 账户，Billbee 会把大多数修改同步到已接入的网店和电商平台。安装后 17 个工具全部启用。如需只读使用，请在连接器页面关闭写入工具；你也可以单独禁用读取工具，例如不想让 AI 看到客户数据时，禁用 billbee_list_customers 和 billbee_get_customer_orders。

写入工具：

• billbee_set_order_state 设置订单状态，例如 3 已付款、4 已发货、8 已取消、13 已打包。网店或电商平台可能会给买家发邮件。
• billbee_add_shipment_to_order 记录在其他地方创建的物流单号；它不创建面单，也不更改状态。billbee_ship_order_with_label 通过 Billbee 中接入的物流商（DHL、DPD、GLS、Deutsche Post 等）用你自己的合同创建真实的收费面单；providerId 和 productId 来自 billbee_list_shipping_providers，AI 会在创建前先询问你。
• billbee_update_stock 按 SKU 设置商品的绝对库存数量，而不是增减量；使用多个仓库时需要 billbee_list_stocks 返回的 stockId。Billbee 会把新库存发送到你的网店和电商平台。
• billbee_add_order_tags 给订单添加标签。billbee_update_order 和 billbee_update_product 只修改传入的字段，字段名与 billbee_get_order 和 billbee_get_product 返回的一致，例如 SellerComment 或 Price。
• billbee_create_invoice 用你的发票模板为订单开具发票，同一订单每 5 分钟最多一次，并可返回 PDF。

写入工具需要 Billbee 内部订单 ID，而不是网店订单号：用 billbee_get_order_by_extref 可以根据平台订单号找到 ID。

订单：billbee_list_orders 可以按下单日期（minOrderDate、maxOrderDate）和最后修改时间（modifiedAtMin、modifiedAtMax）筛选，日期采用 ISO 8601 格式，例如 2026-01-01。billbee_get_order 根据 Billbee 订单 ID 返回完整订单，包括订单行、地址、付款和发货信息。billbee_get_order_by_extref 按电商平台或网店的订单号查找订单，例如 Amazon 或 eBay 订单号。订单状态以数字形式返回。

商品和客户：billbee_get_product 按 Billbee 商品 ID 查询商品；把 lookupBy 设为 sku 或 ean 时，也可以按 SKU 或 EAN 查询，并返回价格和库存。billbee_list_products 可以只列出某个日期之后创建的商品（minCreatedAt）。billbee_list_customers 没有搜索功能，按姓名找客户需要逐页翻看列表；有了客户 ID，billbee_get_customer_orders 就能列出该客户的订单。

分页和速率限制：列表类工具每页最多返回 250 行（pageSize），响应中包含 Page、TotalPages 和 TotalRows，AI 会依次请求下一个 page，直到最后一页。Billbee 对每个 API 密钥加用户的组合限制为每秒 2 个请求，超过后返回 429：稍等片刻再试。超出免费额度的 API 用量由 Billbee 收费，所以与其反复拉取全部数据，不如缩小日期范围并使用 modifiedAtMin。

常见错误：如果 Billbee 拒绝了凭据，请检查三个变量是否都已填写，是否已在 Einstellungen → Billbee API 中启用 API 访问，以及 BILLBEE_API_PASSWORD 中填的是 API 密码而不是登录密码。429 表示达到了每秒 2 个请求的限制。

该连接器不能创建或删除订单，不能创建或修改客户，也不能创建或删除商品。

步骤 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 — 在 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 窗格中试一试：提出需要用到 Billbee 的工具的请求。
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 无法使用。

可用工具

示例提示

• “过去 7 天收到了哪些订单？其中哪些还没有发货？”
• “查找平台订单号为 302-1234567-1234567 的订单，给我看订单行、收货地址和付款信息。”
• “SKU ABC-123 还有多少库存？售价是多少？”
• “列出 Billbee 客户 4567 的所有订单，带上日期和总额，按从新到旧排列。”
• “把 Amazon 订单 302-1234567-1234567 设为已发货，并添加 DHL 物流单号 00340434161234567890。”
• “通过 Billbee 为 eBay 订单 14-12688-90311 创建 DHL 面单，然后开具发票。”

FAQ

这适用于哪个 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
• 连接到 ChatGPT
• 连接到 Cursor
• 连接到 Gemini
• 连接到 Meta Muse