Yandex Delivery MCP

 Яндекс Доставка MCP

A1 Яндекс Доставка MCP позволяет управлять корпоративной доставкой из Claude, Codex, Cursor и других AI-приложений. Вы ставите задачу обычными словами, а ассистент обращается к вашему аккаунту Яндекс Доставки, рассчитывает стоимость, оформляет отправления и показывает их статус.

• День в день по городу. Рассчитайте доставку, вызовите курьера, узнайте его местоположение и получите ссылку для получателя.
• На следующий день и по России. Сравните доступные сроки и стоимость доставки до двери.
• В ПВЗ и постаматы. Найдите подходящую точку, рассчитайте варианты и оформите выбранную доставку.
• Сначала расчёт, затем заказ. Ассистент различает предварительную стоимость, подготовку отправления и момент, когда доставка действительно оформляется.
• Без собственной интеграции. Внутри уже есть 16 готовых действий, схемы данных и правила безопасной работы с повторными запросами.

Подходит компаниям и предпринимателям, которые уже подключены к B2B API Яндекс Доставки и получили токен в личном кабинете. Это не сервис для частных отправителей.

Быстро узнать стоимость

Вы: Рассчитай доставку коробки 2 кг с Льва Толстого, 16 на Тверскую, 7.

Ассистент: Проверил маршрут через Яндекс Доставку и вернул актуальную стоимость, расстояние и примерное время подачи из вашего аккаунта.

Подключить сервер · Посмотреть сценарии · Открыть техническую документацию

Увидеть работу за минуту

Вы: Рассчитай доставку букета сегодня к 18:00 из офиса на Льва Толстого, 16 клиенту на Тверскую, 7.

Ассистент: Проверил маршрут и получил предварительную стоимость, расстояние и ETA из вашего аккаунта Яндекс Доставки.

Вы: Оформи доставку, если итоговая цена не выше 1 000 ₽.

Ассистент: Итоговая цена укладывается в лимит. Доставка оформлена, поиск курьера начался.

Вы: Где сейчас курьер и какую ссылку отправить получателю?

Ассистент: Получил текущую позицию курьера и публичную ссылку для отслеживания заказа.

Вы: Теперь найди варианты доставки этой коробки в Казань на следующий день: до двери, в ПВЗ или постамат.

Ассистент: Получил доступные варианты по срокам и стоимости. Для ПВЗ и постаматов покажу адреса, расписание и поддерживаемые способы оплаты.

Вы: Можно бесплатно отменить первую доставку?

Ассистент: Сначала проверил условия отмены. Покажу, доступна ли она сейчас, будет ли бесплатной и какая сумма спишется при платной отмене.

Примеры показывают последовательность доступных действий. Конкретные цены, сроки, статусы и доступность доставки всегда приходят из вашего аккаунта Яндекс Доставки.

Содержание

• Быстрый старт
• Что можно поручить
• Как ассистент работает с доставкой
• Когда создаётся реальный заказ
• Получение доступа к API
• Технические настройки
• Данные и телеметрия
• Ограничения
• Техническая документация
• Помощь и обратная связь

クイックスタート

Node.js 20+ と、ヤンデックス配送の法人顧客用トークンが必要です。

1. ヤンデックス配送の個人アカウントでトークンを取得します。

2. MCP サーバーをお使いの AI アプリに追加します。

mcp-yandex-dostavka はお使いのコンピューター上で npx 経由で起動するため、ブラウザー版の ChatGPT と Claude から直接接続することはできません。

codex mcp add yandex-dostavka \
  --env YANDEX_DELIVERY_TOKEN=ваш_токен \
  -- npx -y mcp-yandex-dostavka@latest

codex mcp list

{
  "mcpServers": {
    "yandex-dostavka": {
      "command": "npx",
      "args": ["-y", "mcp-yandex-dostavka@latest"],
      "env": {
        "YANDEX_DELIVERY_TOKEN": "ваш_токен"
      }
    }
  }
}

claude mcp add \
  --env YANDEX_DELIVERY_TOKEN=ваш_токен \
  --transport stdio \
  --scope user \
  yandex-dostavka \
  -- npx -y mcp-yandex-dostavka@latest

claude mcp list

{
  "mcpServers": {
    "yandex-dostavka": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-yandex-dostavka@latest"],
      "env": {
        "YANDEX_DELIVERY_TOKEN": "ваш_токен"
      }
    }
  }
}

{
  "inputs": [
    {
      "type": "promptString",
      "id": "yandex-delivery-token",
      "description": "Токен Яндекс Доставки",
      "password": true
    }
  ],
  "servers": {
    "yandex-dostavka": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-yandex-dostavka@latest"],
      "env": {
        "YANDEX_DELIVERY_TOKEN": "${input:yandex-delivery-token}"
      }
    }
  }
}

接続したら、選択したアプリで新しい会話を開き、次のように依頼してください：

レフ・トルストイ通り16番地からトヴェルスカヤ通り7番地まで、2 kg の箱を配送する料金を計算してください。

依頼できること

Доставка день в день по городу

• Узнать стоимость. Рассчитать цену, расстояние и примерное время подачи курьера по адресам, весу и габаритам отправления.
• Оформить отправление. Передать товары, адреса, контакты и требования к машине или курьеру.
• Найти заказ. Искать отправления по статусу, телефону, периоду или номеру заказа вашей компании.
• Следить за курьером. Получить его текущую позицию и публичную ссылку для получателя.
• Отменить с известными последствиями. Сначала узнать, возможна ли отмена и будет ли она платной.

Доставка на следующий день и по России

• Сравнить варианты. Получить доступные интервалы и стоимость доставки до двери.
• Оформить выбранный вариант. Подтвердить подходящие срок, способ вручения и цену.
• Проверить заказ. Узнать текущий статус и посмотреть историю его изменений.
• Отменить заказ. Отправить запрос на отмену, пока текущий статус это позволяет.

Доставка в ПВЗ и постаматы

• Найти подходящую точку. Искать ПВЗ и постаматы по городу, координатам, типу и способу оплаты.
• Проверить условия. Посмотреть адрес, расписание, доступность самопривоза и способы оплаты.
• Рассчитать и оформить. Получить варианты доставки в выбранную точку и подтвердить подходящий.

Как ассистент работает с доставкой

Для доставки день в день ассистент сначала рассчитывает маршрут. Когда вы просите оформить отправление, он передаёт данные в Яндекс Доставку, дожидается итоговой оценки и запускает поиск курьера. После этого можно узнавать статус, смотреть позицию курьера и получать ссылку для отслеживания.

Для доставки на следующий день, по России, в ПВЗ или постамат ассистент получает доступные варианты со сроками и стоимостью. Вы выбираете подходящий вариант, после чего ассистент оформляет заказ и может читать его текущий статус и историю.

Значения не придумываются. Стоимость, ETA, доступные интервалы, адреса точек и статусы приходят из вашего аккаунта Яндекс Доставки.

Ассистент не наблюдает за заказами постоянно. Он проверяет состояние доставки, когда вы ставите ему задачу. Если AI-приложение поддерживает задачи по расписанию, в его интерфейсе можно настроить регулярную проверку — например, каждый час узнавать статус заказа до вручения.

Когда создаётся реальный заказ

Точная команда на оформление или отмену разрешает соответствующее действие. Поведение дополнительных подтверждений зависит от AI-приложения: некоторые клиенты спрашивают разрешение перед каждой записью, другие следуют собственным политикам.

API へのアクセス

1. dostavka.yandex.ru で法人顧客として登録し、契約を締結します。翌日配送、ロシア国内配送、受取拠点および宅配ロッカーへの配送を利用する場合は、発送ステーションも登録してください。
2. 個人アカウントで 「Интеграции」 タブを開き、「Получить токен」 をクリックします。
3. トークンを YANDEX_DELIVERY_TOKEN でサーバーに渡します。

トークンの有効期限はありませんが、個人アカウントのパスワードを変更すると使用できなくなります。詳しくは、当日配送 API へのアクセス および 翌日配送 API へのアクセス をご覧ください。

トークンは AI アプリケーションの設定ファイルに平文で保存されます。 パスワードと同様に扱い、実際のトークンを含む設定を Git に追加しないでください。

トークンを 1 つにするか 2 つにするか

通常は共通の YANDEX_DELIVERY_TOKEN で十分です。異なる配送タイプを別々のアカウントで利用している場合は、次の 2 つの個別トークンを設定します。

• YANDEX_DELIVERY_EXPRESS_TOKEN — 当日配送のトークン。
• YANDEX_DELIVERY_PLATFORM_TOKEN — 翌日配送、ロシア国内配送、受取拠点および宅配ロッカーへの配送のトークン。

共通トークンがない場合、サーバーには 2 つの個別トークンが必要です。

テスト環境

テスト環境は、翌日配送、ロシア国内配送、受取拠点および宅配ロッカーへの配送にのみ用意されています。YANDEX_DELIVERY_PLATFORM_BASE_URL=https://b2b.taxi.tst.yandex.net を設定し、公式ガイド のテスト用認証情報を使用します。この環境で処理できるのはモスクワの住所のみです。

当日配送にはテスト環境がありません。料金の計算や既存の依頼の読み取りは安全にテストできますが、作成した配送依頼は本番システムに登録されます。

技術設定

技術的には、サーバーはヤンデックス配送の B2B API の独立した 2 つの部分、当日配送 API と翌日配送 API を利用します。トークン、サーバーアドレス、金額の形式、測定単位が異なる場合がありますが、MCP サーバーが必要なパラメーターを自動的に選択します。

* 2 つの個別トークンを設定している場合、共通トークンは不要です。

データとテレメトリー

ヤンデックス配送へのリクエスト

サーバーはローカルで起動し、ヤンデックス配送 API に直接アクセスします。Bearer トークンは、選択された API へのリクエストにのみ追加されます。汎用ツールでも相対パスのみを受け付けます。外部サーバーにつながるパスへのリクエストはブロックされ、トークンが無関係なアドレスに送信されることはありません。

Анонимная телеметрия

По умолчанию сервер отправляет на usage.gistrec.cloud три вида технических событий: запуск сервера, имя вызванного инструмента и код причины старта без настроенного токена.

В событие входят случайный идентификатор установки, версия пакета, имя и версия AI-приложения, версия Node.js и операционная система. Токен, данные аккаунта, аргументы инструментов и тексты запросов не читаются и не отправляются. Отправка выполняется в фоне с таймаутом 2 секунды и не влияет на работу сервера.

Чтобы отключить телеметрию для MCP-серверов A1, добавьте в конфигурацию:

ASKADS_TELEMETRY=0

Реализация находится в src/telemetry.ts.

Ограничения

• Это не только чтение. Ассистент умеет оформлять и отменять настоящие доставки; отмена может быть платной.
• AI-приложение влияет на подтверждения. MCP-сервер сообщает тип каждого действия, но решение о дополнительном вопросе перед записью принимает приложение и его агент.
• Нет тестовой среды для доставки день в день. Безопасно проверить можно расчёт стоимости и чтение существующих заявок.
• Нет постоянного наблюдения. Сервер работает во время вызова из AI-приложения. Если приложение поддерживает задачи по расписанию, настройте в его интерфейсе регулярную проверку статуса.
• При временном ограничении возможна задержка. Сервер сам подождёт и повторит запрос. Если Яндекс Доставка по-прежнему недоступна, попробуйте ещё раз позже.
• Нет автоматического отката. Возможность и стоимость отмены зависят от текущего статуса и правил Яндекс Доставки.

Техническая документация

• Каталог 16 MCP-возможностей — отдельные страницы инструментов на языке пользовательских задач.
• Технический справочник инструментов — входные данные, ответы, статусы, ошибки, форматы денег и единицы измерения.
• Разработка — локальный запуск, проверки, сборка и безопасная smoke-проверка.
• Публикация — выпуск npm-пакета и листинг в каталогах MCP.
• npm-пакет — опубликованная версия mcp-yandex-dostavka.
• API доставки день в день и API доставки на другой день — официальная документация Яндекс Доставки.

Помощь и обратная связь

Нашли ошибку или не хватает сценария? Создайте issue или напишите в Telegram.

Вы дочитали до конца!