Billbee 与 ChatGPT 连接：MCP 订单管理

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

Billbee + ChatGPT

让你的 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 — 在 ChatGPT 中添加连接器

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

ChatGPT 在网页版的 Plugins 页面把 MCP 服务器添加为插件，仅付费套餐可用，不再需要开发者模式。在 Business 工作区中只有管理员和所有者可以添加；在 Enterprise 和 Edu 中，管理员可以授予 Create plugins with MCPs 权限。

1. 前往 chatgpt.com/plugins，点击 Add，然后选择 Add custom MCP server。
2. 填写名称，例如 Name: Billbee。
3. 在 Connection 下的 Server URL 中填入 https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID，Authentication 保持为 OAuth。
4. 选择 I understand and want to continue，然后点击 Create as a plugin。ChatGPT 提示时，登录 AnythingMCP 并允许访问。
5. 在个人插件中安装这个新插件，然后在对话中输入 @ 并选择它。

可用工具

示例提示

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

FAQ

ChatGPT 免费套餐能用自定义 MCP 服务器吗? OpenAI 只为付费套餐提供自定义 MCP 服务器的说明，Free 套餐不在其列。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 Cursor
• 连接到 Gemini
• 连接到 Meta Muse
• 连接到 Microsoft Copilot