跳过安装。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 + Cursor
在 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 — 在 Cursor 中添加连接器
你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（
https://cloud.anythingmcp.com/mcp/…）。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Cursor 从 ~/.cursor/mcp.json 读取 MCP 服务器。添加以下条目：
{
"mcpServers": {
"anythingmcp": {
"url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换
YOUR_MCP_API_KEY。 - 保存文件并重启 Cursor。
- 打开 Cursor → Settings → MCP，确认
anythingmcp已列出并处于已连接状态。 - 开始对话，智能体现在可以调用
BEX Express的工具。
可用工具
| 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
Cursor 免费套餐支持自定义 MCP 服务器吗？ 支持，Hobby、Pro 和 Business 套餐均可使用 MCP。
下一步
这份指南对你有帮助吗?
