跳过安装。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 + ChatGPT
在 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 — 在 ChatGPT 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
ChatGPT 在网页版的 Plugins 页面把 MCP 服务器添加为插件,仅付费套餐可用,不再需要开发者模式。在 Business 工作区中只有管理员和所有者可以添加;在 Enterprise 和 Edu 中,管理员可以授予 Create plugins with MCPs 权限。
- 前往 chatgpt.com/plugins,点击 +,然后选择 Add custom MCP server。
- 填写名称,例如 Name:
BEX Express。 - 在 Connection 下的 Server URL 中填入
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID,Authentication 保持为 OAuth。 - 选择 I understand and want to continue,然后点击 Create as a plugin。ChatGPT 提示时,登录 AnythingMCP 并允许访问。
- 在个人插件中安装这个新插件,然后在对话中输入 @ 并选择它。
可用工具
| 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
ChatGPT 免费套餐能用自定义 MCP 服务器吗? OpenAI 只为付费套餐提供自定义 MCP 服务器的说明,Free 套餐不在其列。
下一步
这份指南对你有帮助吗?