Yango Delivery MCP

Yango Delivery MCP

英語 | Русский

A1 Yango Delivery MCP は、AI アプリを法人向け Yango Delivery アカウントに接続します。通常の言葉で、エクスプレス配送の見積もり、クーリエの注文、配送ルートの追跡、受取人への追跡リンクの共有ができます。

このサーバーは国際 Express Claims API を使用します。翌日配送、受取拠点、宅配ロッカーには対応していません。

• 13 個のツール。 配送の一連の流れに対応する 7 個、追跡とクーリエへの連絡に対応する 5 個、直接 API リクエスト用のツールが 1 個です。
• 注文前に見積もり。 配送クレームを作成せずに、現在の料金、ルート距離、到着予定時刻を確認できます。
• 作成と注文は別々。 クーリエの検索を開始する前に、クレームを準備して確認できます。
• 進行中の配送を追跡。 配送状況、クーリエの位置、各地点の到着予定時刻、一時的な電話番号、確認コード、受取人向け追跡リンクを取得できます。

次のように始めましょう。

[集荷先住所] から [配送先住所] まで、2 kg の荷物を配送する料金を見積もってください。

サーバーを接続する · ユースケースを見る · 技術ドキュメントを開く

1 分で動作を確認

あなた： 倉庫からお客様の住所まで、2 kg の荷物を配送する料金を見積もってください。

アシスタント： 現在の料金、ルート距離、到着予定時刻をお返ししました。配送クレームは作成されていません。

あなた： クレームを作成し、クーリエを注文する前の状態で止めてください。

アシスタント： クレームを作成しました。承認前に、ID、料金、ステータス、バージョンをお知らせします。

あなた： オファーを承認してください。

アシスタント： クレームが承認され、クーリエの検索が始まりました。

あなた： 受取人向けの追跡リンクを送ってください。

アシスタント： 配送先の公開追跡リンクをお返ししました。

料金、利用可否、ステータス、キャンセル条件は、常に接続された配送アカウントと最新の API レスポンスに基づきます。

目次

• クイックスタート
• できること
• 配送が実際に開始されるまで
• アカウントで行われる変更
• アクセス権の取得
• 設定
• データとテレメトリ
• 制限とバックグラウンド処理
• 技術ドキュメント
• サポート

クイックスタート

Node.js 20 以降、Yango Delivery の法人アカウント、インテグレーショントークンが必要です。

1. インテグレーショントークンを取得します。

2. 以下のいずれかの手順を使って、サーバーを AI アプリに追加します。

3. 料金の見積もりから始めます。

   [集荷先住所] から [配達先住所] まで、2 kg の荷物を配送する場合の料金を見積もってください。

codex mcp add yango-delivery \
  --env YANGO_DELIVERY_TOKEN=your_token \
  -- npx -y mcp-yango-delivery@latest

codex mcp list

claude mcp add \
  --env YANGO_DELIVERY_TOKEN=your_token \
  --transport stdio \
  --scope user \
  yango-delivery \
  -- npx -y mcp-yango-delivery@latest

claude mcp list

{
  "mcpServers": {
    "yango-delivery": {
      "command": "npx",
      "args": ["-y", "mcp-yango-delivery@latest"],
      "env": {
        "YANGO_DELIVERY_TOKEN": "your_token"
      }
    }
  }
}

{
  "mcpServers": {
    "yango-delivery": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-yango-delivery@latest"],
      "env": {
        "YANGO_DELIVERY_TOKEN": "your_token"
      }
    }
  }
}

{
  "servers": {
    "yango-delivery": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-yango-delivery@latest"],
      "env": {
        "YANGO_DELIVERY_TOKEN": "${input:yango_delivery_token}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "yango_delivery_token",
      "description": "Yango Delivery integration token",
      "password": true
    }
  ]
}

依頼できること

エクスプレス配送の見積もり

• 依頼を作成せずに、現在の料金、ルートの距離、到着予定時刻を算出します。
• 指定された住所、重量、寸法に基づいて、クーリエ、エクスプレス、または貨物配送の料金を見積もります。
• API がルートを作成できるか、指定された車両や配送要件を満たせるかを確認します。

クーリエ配送の準備と注文

• 差出人と受取人の連絡先、ルート地点、荷物、配送要件を含む依頼を作成します。
• 注文する前に、返された料金、ステータス、依頼のバージョンを確認します。
• 見積もりが正常に完了した後、依頼を受け付けてクーリエの検索を開始します。
• ID、電話番号、ステータス、日付、外部注文 ID で依頼を検索します。

配送状況の追跡とクーリエへの連絡

• 各ルート地点の現在のクーリエの位置と到着予定時刻を取得します。
• 受取人向けの公開追跡リンクを生成します。
• クーリエへの一時転送電話番号を取得します。
• 現在の依頼で対応している場合、集荷または配達の確認コードを取得します。

配送の確認とキャンセル

• キャンセルが無料か、有料か、または利用できなくなっているかを確認します。
• API が返した現在のバージョンとキャンセルモードを使用して、依頼をキャンセルします。

その他の API メソッドの使用

raw_request は、料金表、配送方法、配達証明、依頼の編集、返品操作など、専用ツールのないメソッドに対応します。実データを作成または変更できるため、上流の API を理解している技術ユーザー向けです。

スキーマ、レスポンスフィールド、ステータスの詳細については、ツールのリファレンスを参照してください。

配送が実際に行われるまで

1. 見積もり。 料金を確認すると、何も作成せずに現在の料金、距離、到着予定時刻が返されます。
2. 作成。 アカウントに依頼が追加され、見積もりの処理に進みます。デフォルトでは、まだ配達員は手配されません。
3. 確認。 最新の依頼ステータス、料金、バージョンを読み取ります。依頼が正常に作成されると、承認可能な状態になります。
4. 承認。 承認すると配達員の検索が始まります。この時点で配送が注文され、実際に料金が発生する可能性があります。
5. 追跡。 配達員が割り当てられると、サーバーから位置、到着予定時刻、連絡先、受取人向けリンクが返されます。

見積もりで提示された料金は通常、見積もりから約10分後に有効期限が切れます。依頼の作成時に auto_accept: true を渡すと、確認と承認の手順が省略され、配達員が自動的に手配される場合があります。

アカウントに反映される変更

サーバーは、読み取り、書き込み、破壊的な操作に対する MCP アノテーションを公開します。確認をいつ、どのように求めるかは AI クライアントが判断します。

依頼の作成には一意の request_id を使用するため、同じ ID で繰り返すと同じ依頼が返されます。操作がすでに成功している可能性があるため、ネットワークエラーまたは 5xx レスポンスの後に、承認やキャンセルが自動的に再試行されることはありません。再試行する前に、現在の依頼を読み取ってください。

アクセスの取得

1. 法人向け Yango Delivery クライアントとして登録し、配送サービス契約に署名します。
2. 配送アカウントの 連携 タブを開きます。
3. トークンを取得 を選択します。
4. YANGO_DELIVERY_TOKEN として、トークンを AI クライアントに追加します。

トークンは法人アカウントに紐付けられています。トークン自体に有効期限はありませんが、アカウントのパスワードを変更するとリセットされます。

連携トークンは、AI クライアントのローカル設定にプレーンテキストで保存されます。パスワードと同様に扱い、実際のトークンを含む設定を絶対にコミットしないでください。

設定

データとテレメトリ

Yango Delivery へのリクエスト

サーバーはお使いのマシン上で実行され、依頼データを b2b.taxi.yandex.net に直接送信します。連携トークンが付加されるのは、設定された API ホストへのリクエストのみです。raw_request でも相対パスのみを受け付け、別のホストに解決されるリクエストはブロックします。

匿名テレメトリ

デフォルトでは、サーバーは技術イベントを usage.gistrec.cloud に送信します。送信されるイベントは、サーバーの起動、呼び出されたツール名、起動に失敗した場合の固定の理由コードです。

イベントには、ランダムなインストール ID、パッケージのバージョン、AI クライアント名とバージョン、Node.js のバージョン、オペレーティングシステムが含まれます。連携トークン、依頼データ、ツールの引数、プロンプトは読み取られず、送信されません。 テレメトリのタイムアウトは2秒で、ツールの呼び出しを妨げることはありません。

テレメトリを無効にするには、次を追加します。

ASKADS_TELEMETRY=0

実装は src/telemetry.ts にあります。

制限事項とバックグラウンド処理

• 文書化されたサンドボックスはありません。 請求の作成と受諾は、本番環境での操作として扱ってください。
• オファーには有効期限があります。 価格が提示されたオファーは通常、見積もりから約10分後に期限切れになります。受諾する前に、現在の請求を確認してください。
• 追跡には有効な請求が必要です。 配達員が割り当てられるまで、または請求の完了後は、現在地、到着予定時刻、連絡先、追跡リンクを利用できない場合があります。
• 数値で示された API クォータは公開されていません。 API が 429 を返した場合、サーバーは Retry-After があればそれに従い、最大 YANGO_DELIVERY_MAX_RETRIES 回まで再試行します。
• バックグラウンドでの監視はありません。 サーバーは AI アプリから呼び出されたときのみ動作します。アプリがスケジュールタスクに対応している場合は、有効な請求を定期的に確認できます。
• 自動ロールバックはありません。 受諾またはキャンセルの結果が不確かな場合は、操作を繰り返す前に請求を確認してください。

技術ドキュメント

• MCP 機能カタログ — 各ツールのタスク別ページ。
• すべてのツール — 入力スキーマ、レスポンス、ステータス、エラー。
• 開発 — ローカル環境のセットアップとプロジェクトのチェック。
• 公開 — パッケージのリリースと MCP カタログへの掲載。
• npm パッケージ — 公開されている mcp-yango-delivery パッケージ。
• Yango/Yandex Delivery API — 上流 API のメソッドドキュメント。

サポート

バグを見つけた場合や、対応してほしいユースケースがある場合は、イシューを作成するか、Telegram でご連絡ください。

最後まで読んでいただき、ありがとうございます！