跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用,一键添加 BEX Express,然后将你的 AI 客户端(Claude、ChatGPT、Copilot 或 Cursor)指向生成的 MCP 端点。无需 Docker,无需 git clone,无需任何工程经验。
摘要
在 AI 智能体中使用塞尔维亚快递 BEX Express:按货件号查询状态历史,获取 PDF 地址面单,查询 BEX 的市镇、地点和街道地址目录,以及自提点和网点。也包含创建和取消货件,但安装时处于关闭状态。
试试这样问
BEX Express 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → BEX Express、粘贴凭证、生成 MCP API key,即可完成。无 Docker、无
git clone、无本地服务器。
BEX Express + Microsoft Copilot
在 AI 智能体中使用塞尔维亚快递 BEX Express:按货件号查询状态历史,获取 PDF 地址面单,查询 BEX 的市镇、地点和街道地址目录,以及自提点和网点。也包含创建和取消货件,但安装时处于关闭状态。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
BEX_API_TOKEN
步骤 1 — 获取凭证
在 BEX 发来密钥之后,设置大约需要 5 分钟。你需要与塞尔维亚快递公司 BEX Express 签订的合同,以及 BEX 为该合同签发的 API 密钥。
- 如果你还不是 BEX 客户,请发邮件到 [email protected] 索取报价:API 只面向签约客户。
- 发邮件到 [email protected] 申请 API 访问,并注明对应的合同。
- BEX 会回复一个 API key 和你的 KlijentId。把密钥粘贴到
BEX_API_TOKEN;它通过X-AUTH-TOKEN请求头发送。请保存好 KlijentId:它用于把你的公司标识为货件的寄件人。 - 安装连接器并运行
bex_express_list_municipalities。如果返回了市镇列表,说明密钥有效。
可读取的内容:按 BEX 货件号(印在面单上的号码)查询货件状态历史,包括每次扫描、状态、日期、地点和下一个预计事件;货件的 PDF 地址面单;BEX 地址目录,包括市镇(opštine)、带邮编的地点(mesta)和街道;以及约 120 个自提点和网点的代码、地址、营业时间和坐标。
状态码:1 已登记,11 已从寄件人处揽收,21 已签收,25 待退回寄件人,30 已退回寄件人,-21 呼叫中心核实地址,-51 海关处理中。AI 会用通俗的话向你解释。
面单:每页一张 A6 面单,或一张 A4 纸上四张面单,可以打印货件的全部包裹或只打印其中一个。PDF 文件较大,所以只有在你要打印或保存面单时 AI 才会获取。
地址使用 BEX 的 ID:BEX 用市镇、地点和街道来描述地址。AI 会一步一步查找,每次只查一个市镇或一个地点。连接器绝不会一次性向 BEX 请求塞尔维亚的全部街道(将近 100,000 条)。
两个主机和 62503 端口:跟踪、面单和地址目录走普通 HTTPS 端口,而自提点列表以及货件的创建和取消走 https://api.bex.rs:62503。AnythingMCP Cloud 可以访问该端口;如果自托管服务器位于只放行 443 端口的防火墙之后,这三个工具会失败。
安装时关闭:bex_express_create_shipments 和 bex_express_cancel_shipment。它们会向快递员登记真实的揽收货件或将其取消,因此需要管理员有意识地开启。即便开启后,AI 也会先向你展示完整的货件信息(寄件人、收件人、包裹、货到付款、保险、付款方)或要取消的货件号,等你同意后再执行。快递员已经揽收的货件无法取消。
常见错误:401 表示密钥错误或缺失。403 表示密钥有效,但你的合同没有开通该方法:请联系 [email protected]。很多 BEX 方法虽然返回 HTTP 200,但 state 为 false,并在 err 中给出原因,所以 AI 会先检查这些字段再告诉你结果。自提点列表是个例外:即使列表完整,BEX 也会返回 state false 和文本 ok。
该连接器不处理发票或货到付款的结算;在管理员开启相关工具之前,它也不会创建或取消货件。
步骤 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 支持这种方式。
- 在 Copilot Studio 中打开你的智能体(或新建一个),进入 Tools,选择 Add a tool → New tool → Model Context Protocol。
- 填写 Server name(例如
AnythingMCP)、说明连接器用途的 Server description,以及 Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。Copilot Studio 根据描述决定何时调用该服务器。 - 身份验证选择 API key,把 Type 设为 Header,请求头名称填
X-API-Key,然后选择 Create。 - 在 Add tool 中选择 Create a new connection,粘贴 AnythingMCP 的 MCP API 密钥(MCP Servers → 你的服务器 → API keys),然后选择 Add to agent。
- 在智能体的 Test 窗格中试一试:提出需要用到
BEX Express的工具的请求。 - 选择 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 无法使用。
可用工具
| Tool | What it does |
|---|---|
bex_express_get_shipment_history | Get the status history of a BEX shipment by its shipment number: every scan with status name, scan and reason code, date, place, timestamp… |
bex_express_get_label | Get the address labels of a shipment as a Base64-encoded PDF (parcelLabel), with state true on success or false and an err text. page_size… |
bex_express_list_municipalities | List the municipalities (opštine) in the BEX address directory with id and name |
bex_express_list_settlements | List the places (mesta) of one municipality in the BEX address directory with id, name, postcode and municipality id |
bex_express_list_streets | List the streets of one place in the BEX address directory with id, name, old name and place id |
bex_express_list_parcel_shops | List BEX parcel shops and depots with code, region, name, city, street and house number, opening hours on weekdays and Saturday, and… |
bex_express_create_shipments | Create shipments and announce them to BEX for pickup by a courier (postShipments) |
bex_express_cancel_shipment | Cancel (delete) an announced BEX shipment by its shipment number |
示例提示
- “货件 206897445 现在在哪里?下一步预计什么时候发生?”
- “206897445、206897446 和 206897447 这几个货件中,哪些已经退回寄件人?”
- “诺维萨德有哪些 BEX 自提点?周六营业吗?”
- “帮我取货件 206897445 的面单,每张 A4 纸四张,我要打印。”
- “BEX 的地址目录里有诺维萨德的 Bulevar oslobođenja 吗?给我寄件地址要用的地点 ID 和街道 ID。”
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" 即可使用新版本。
下一步
这份指南对你有帮助吗?