インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、YunExpress をワンクリックで追加して、AI クライアント（Claude、ChatGPT、Copilot、Cursor）を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
概要
YunExpress（云途物流）OMS API：仕向国、配送方法と貨物種別、運賃見積もり、追跡番号付きの出荷オーダー、ラベル、ラストマイル配送業者、追跡イベントと請求済み料金、重量変更とインターセプト。オーダー削除はインストール時にオフです。
こう聞いてみよう
YunExpress のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → YunExpress をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
YunExpress + ChatGPT
YunExpress（云途物流）OMS API：仕向国、配送方法と貨物種別、運賃見積もり、追跡番号付きの出荷オーダー、ラベル、ラストマイル配送業者、追跡イベントと請求済み料金、重量変更とインターセプト。オーダー削除はインストール時にオフです。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
YUNEXPRESS_API_TOKEN
ステップ 1 — 認証情報を取得
設定は約 5 分です。API アクセスのある YunExpress の顧客アカウントが必要です。
- YunExpress の顧客センター（www.yunexpress.cn またはご利用の YunExpress 顧客ポータル）にサインインし、API セクションを開きます。顧客コード（客户编号、例
C12345）と API シークレット（API密钥）を控えます。まだない場合はそこで申請します。 - YunExpress は
Authorization: Basic <token>で認証します。トークンは顧客コード、アンパサンド、API シークレットをつないだ文字列の Base64 です（コロンではなく&）。手元のコンピューターで一度だけ計算し（例printf '%s' 'C12345&YourApiSecret' | base64）、結果だけをYUNEXPRESS_API_TOKENに貼り付けます。暗号化して保存されます。 - コネクタをインストールし、
yunexpress_list_countriesを実行します。仕向国の一覧が返り、トークンが確認できます。
使用する API: コネクタは YunExpress の OMS API（バージョン 1.4.x、http://oms.api.yunexpress.com）を使います。このホストはプレーンな HTTP でのみ応答します。YunExpress には、すべてのリクエストをタイムスタンプと OAuth トークンで署名する新しいオープンプラットフォーム（openapi.yunexpress.cn）もありますが、このコネクタは使いません。
読み取れるデータ: 2 文字コード付きの仕向国；アカウントの配送方法（物流商品）のコード、中国語名と英語名、追跡の有無（特定の国向けのものだけに絞ることも可能）；一般貨物や電池入り貨物などの貨物種別；配送方法ごとの運賃見積もり（基本料、書留料、燃油料などの料金、合計、通貨、課金重量、配達日数。yunexpress_get_price_quote で、遠隔地サーチャージ用に郵便番号も指定可能）；ウェイビル番号、顧客オーダー番号、追跡番号、配送方法、ステータス、重量、受取人、通関明細、料金を含む出荷オーダー；オーダーの差出人住所；荷物の状態、追跡ステータス、ラストマイル配送業者、配達証明、イベントを含む追跡（yunexpress_get_tracking は追跡表示設定に従い、yunexpress_get_full_tracking は配送方法が対応していれば全履歴を返します）；ラストマイル配送業者とその番号；YunExpress が計量して請求した後の実際の請求料金。
荷物を送る: AI は仕向国と貨物種別に合う配送方法を確認し、見積もりを取ってから、1 回の呼び出しで 1〜10 件のオーダーを yunexpress_create_orders で作成します。各結果には Success、WayBillNumber、TrackingNumber、TrackType（1 追跡番号あり、2 保留中、3 なし）が含まれます。追跡番号が保留中の場合は、後で yunexpress_get_tracking_numbers が顧客オーダー番号から取得します（結果は 30 分間キャッシュされます）。yunexpress_get_labels は最大 50 件のオーダーのラベルを一時的な PDF の URL として返します。
書き込める内容: yunexpress_create_orders は実際の出荷を予約し、yunexpress_update_weight は YunExpress が計量する前に申告重量を変更し、yunexpress_intercept_order は理由を添えて YunExpress に荷物の差し止めを依頼します。書き込みの前に、AI はオーダー（受取人、配送方法、重量、通関申告）を示してあなたの同意を待ちます。タイムアウトで結果が不明な場合は、再試行の前に yunexpress_get_order でオーダーを読み、二重に予約されないようにします。
インストール時はオフ: yunexpress_delete_order です。YunExpress がまだ受け取っていないオーダーを削除し、元に戻せません。チームが必要とするときに管理者がオンにします。
数値と単位: 重量は kg（小数点以下 3 桁まで）、寸法は整数の cm、申告価格（UnitPrice）は指定した CurrencyCode での単価です。OrderNumber にはウェイビル番号、顧客オーダー番号、追跡番号のいずれも使えます。インターセプトと削除では OrderType で種類を指定します（1 ウェイビル、2 顧客オーダー、3 追跡番号）。荷物の状態：0 不明、1 提出済み、2 輸送中、3 配達済み、4 受領済み、5 キャンセル、6 配達失敗、7 返送。追跡ステータス：0 見つからない、10 事前通知、20 輸送中、30 受取可能、40 失敗、50 配達済み、60 例外、80 不明、90 返送、100 キャンセル。
制限: ページングはなく、一覧は 1 回の応答で返ります。オーダー作成は 1 回 10 件、ラベルは 50 件までです。YunExpress がコード 10000 を返したらリクエスト上限に達しています。少し待ってください。
よくあるエラー: すべての応答には Code（0000 が成功）、Message、Item または Items 内のデータ、YunExpress サポートに伝える RequestId があります。HTTP 421 と ResultCode 401、またはコード 1002 か 1003 はトークンの誤りです。顧客コードとシークレットを & でつないで計算し直してください。1004 はパラメーターエラー、1006 はデータなし、1011 は一部成功、2004 は顧客オーダー番号の重複、2005 は既存のオーダー、2006 はこの配送方法では追跡番号なし、2009 は重量が正の値でない、2010 は配送方法が仕向地に対応していない、9999 はプラットフォームエラーです。
このコネクタは YunExpress のオープンプラットフォームを使わず、アカウント、請求書、支払いも管理しません。読み取るコスト情報は見積もりとウェイビルごとの請求料金だけです。
ステップ 2 — アダプターをインストール
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 では、Web 版の Plugins ページから MCP サーバーをプラグインとして追加します。有料プランで利用でき、開発者モードはもう必要ありません。Business ワークスペースで追加できるのは管理者とオーナーだけです。Enterprise・Edu では、管理者が Create plugins with MCPs 権限を付与できます。
- chatgpt.com/plugins を開き、Add をクリックして Add custom MCP server を選びます。
- 名前を入力します（例: Name:
YunExpress）。 - 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 |
|---|---|
yunexpress_list_countries | List the destination countries YunExpress ships to with their two-letter codes and names, for CountryCode in quotes and orders |
yunexpress_list_shipping_methods | List the shipping methods (logistics products) of your account with code, Chinese and English name and whether they are tracked; with… |
yunexpress_list_goods_types | List the goods types (id and name) YunExpress distinguishes, e.g. general goods or goods with batteries |
yunexpress_get_price_quote | Quote the freight for a parcel to a country: per shipping method the base, registration, fuel and other fees, total, currency, billable… |
yunexpress_get_tracking_numbers | Get the tracking numbers of orders by your customer order numbers (comma-separated), for methods where the tracking number arrives after… |
yunexpress_get_order | Get one shipment order: waybill number, customer order number, tracking number, shipping method, status, weights, receiver, parcels… |
yunexpress_get_sender | Get the sender address YunExpress holds for an order (for methods that need a sender address) |
yunexpress_get_tracking | Track a parcel: package state, tracking status, last-mile carrier, proof of delivery and the events with time, place and description, shown… |
yunexpress_get_full_tracking | Get the full tracking history of a parcel (origin and last-mile events) regardless of display settings, for the shipping methods that… |
yunexpress_get_shipping_fee | Get the fees actually charged for a waybill (freight, surcharges, chargeable weight), once YunExpress has weighed and billed it |
yunexpress_get_labels | Get the shipping labels of up to 50 orders as a temporary PDF URL |
yunexpress_get_carriers | Get the last-mile carrier and its tracking number for orders (waybill, customer order or tracking numbers), to track on the local carrier… |
yunexpress_create_orders | Create shipment orders (waybills), 1 to 10 per call |
yunexpress_update_weight | Change the forecast weight of a submitted order before YunExpress weighs it |
yunexpress_intercept_order | Ask YunExpress to stop (intercept) a submitted or received order before it leaves, with a reason |
yunexpress_delete_order | Delete a draft or submitted order that YunExpress has not received yet |
プロンプトの例
- 「ドイツ向けの YunExpress 配送方法はどれで、そのうち追跡できるのはどれですか？」
- 「電池入りで 0.35 kg、20 x 15 x 5 cm の荷物をフランスへ送る場合の見積もりを、配送方法ごとに合計と配達日数付きで出してください。」
- 「SO-1042 の YunExpress オーダーを、配送方法 THPHR でベルリンの Anna Muster 宛てに作成してください。先に受取人、重量、通関明細を見せてください。」
- 「追跡番号 YT2430012345678901 の荷物は今どこにあり、ラストマイルはどの業者が配達しますか？」
- 「今日のオーダー SO-1040 から SO-1045 のラベルを 1 つの PDF で取得してください。」
FAQ
ChatGPT の無料プランでカスタム MCP サーバーは使えますか? OpenAI がカスタム MCP サーバーを案内しているのは有料プランだけで、Free プランは対象に含まれていません。
次のステップ
このガイドは役に立ちましたか?