インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、BEX Express をワンクリックで追加して、AI クライアント（Claude、ChatGPT、Copilot、Cursor）を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
概要
セルビアの宅配便 BEX Express を AI エージェントから利用します。配送番号による配送ステータス履歴、PDF の宛名ラベル、市町村・地区・通りからなる BEX の住所ディレクトリ、パーセルショップと拠点を扱えます。配送の作成と取り消しも含まれますが、インストール時はオフです。
こう聞いてみよう
BEX Express のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → BEX Express をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
BEX Express
セルビアの宅配便 BEX Express を AI エージェントから利用します。配送番号による配送ステータス履歴、PDF の宛名ラベル、市町村・地区・通りからなる BEX の住所ディレクトリ、パーセルショップと拠点を扱えます。配送の作成と取り消しも含まれますが、インストール時はオフです。
セットアップ
BEX からキーが届いていれば、セットアップは約 5 分です。セルビアの宅配便 BEX Express との契約と、その契約に対して BEX が発行する API キーが必要です。
- まだ BEX の顧客でない場合は、[email protected] に見積もりを依頼してください。API は契約顧客専用です。
- [email protected] にメールを送り、対象の契約を明記して API アクセスを申請します。
- BEX から API キー と KlijentId が届きます。キーを
BEX_API_TOKENに貼り付けます。キーはX-AUTH-TOKENヘッダーで送信されます。KlijentId は配送の差出人として自社を識別するものなので、手元に控えておいてください。 - コネクターをインストールし、
bex_express_list_municipalitiesを実行します。市町村の一覧が返ってくれば、キーは有効です。
読み取れるデータ: BEX の配送番号（ラベルに印字された番号）による配送ステータス履歴（各スキャン、ステータス、日付、場所、次に予定されるイベント）、配送の宛名ラベル（PDF）、市町村（opštine）、郵便番号付きの地区（mesta）、通りからなる BEX の住所ディレクトリ、そして約 120 か所のパーセルショップと拠点（コード、住所、営業時間、座標）です。
ステータスコード: 1 登録済み、11 差出人から集荷済み、21 配達完了、25 差出人へ返送予定、30 差出人へ返送済み、-21 コールセンターによる住所確認、-51 税関で保留中。AI がわかりやすい言葉で説明します。
ラベル: 1 ページに A6 ラベル 1 枚、または A4 用紙 1 枚に 4 枚を、配送のすべての荷物またはひとつの荷物について出力できます。PDF はサイズが大きいため、ラベルを印刷または保存したいときにだけ AI が取得します。
住所は BEX の ID で指定します: BEX は住所を市町村、地区、通りで表します。AI は市町村や地区をひとつずつ、順を追って調べます。セルビア全土の通り（約 100,000 件）を一度に BEX に問い合わせることはありません。
2 つのホストとポート 62503: 追跡、ラベル、住所ディレクトリは通常の HTTPS ポートを使いますが、パーセルショップの一覧と配送の作成・取り消しは https://api.bex.rs:62503 を使います。このポートには AnythingMCP Cloud から接続できます。ポート 443 しか通さないファイアウォールの内側にあるセルフホストのサーバーでは、これら 3 つのツールは失敗します。
インストール時はオフ: bex_express_create_shipments と bex_express_cancel_shipment。実際の配送を集荷依頼として登録したり取り消したりするため、管理者が意図して有効にします。その場合でも AI はまず配送の全内容（差出人、受取人、荷物、代金引換、保険、支払者）または取り消す配送番号を示し、あなたの承認を待ちます。すでに集荷された配送は取り消せません。
よくあるエラー: 401 はキーが誤っているか未設定であることを示します。403 はキーは有効でも、そのメソッドが契約で有効になっていないことを示すので、[email protected] に問い合わせてください。BEX の多くのメソッドは HTTP 200 を返しつつ、state が false で err に理由が入っていることがあるため、AI は結果を伝える前にこれらの項目を確認します。例外はパーセルショップの一覧で、一覧が完全でも BEX は state false とテキスト ok を返します。
このコネクターは請求書や代金引換の精算を扱わず、管理者がツールを有効にしない限り配送の作成や取り消しも行いません。
前提条件: BEX_API_TOKEN
ローカルでコネクタをインストール
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
http://localhost:3000/connectors/store を開き、 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 1 ページに 4 枚ずつで用意してください。印刷します。」
- 「ノヴィ・サドの Bulevar oslobođenja は BEX に登録されていますか。配送先住所用に地区と通りの ID を教えてください。」
次のステップ
このガイドは役に立ちましたか?
