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+ 和 Yandex Delivery 企业客户令牌。

1. 在 Yandex Delivery 个人账户中获取令牌。

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}"
      }
    }
  }
}

连接后，在所选应用中打开新对话并询问：

计算一个 2 kg 箱子的配送费用，起点是列夫·托尔斯泰街 16 号，终点是特维尔街 7 号。

可以交办的任务

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

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

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

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

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

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

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

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

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

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

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

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

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

获取 API 访问权限

1. 在 dostavka.yandex.ru 注册为企业客户并签订合同。如需次日配送、俄罗斯境内配送、配送至自提点和包裹柜，还需连接发货站点。
2. 在个人账户中打开 “集成” 标签页，然后点击 “获取令牌”。
3. 将令牌通过 YANDEX_DELIVERY_TOKEN 提供给服务。

令牌长期有效，但更改个人账户密码后会失效。详情请参阅：当日配送 API 访问权限和次日配送 API 访问权限。

令牌以明文形式存储在 AI 应用的配置中。 请将其视为密码，不要将含有真实令牌的配置添加到 Git。

一个或两个令牌

通常只需使用通用的 YANDEX_DELIVERY_TOKEN。如果不同配送类型在不同账户中开通，请设置两个单独的令牌：

• YANDEX_DELIVERY_EXPRESS_TOKEN — 当日配送令牌；
• YANDEX_DELIVERY_PLATFORM_TOKEN — 次日配送、俄罗斯境内配送、配送至自提点和包裹柜的令牌。

如果没有通用令牌，服务需要两个单独的令牌。

测试环境

只有次日配送、俄罗斯境内配送、配送至自提点和包裹柜提供测试环境。设置 YANDEX_DELIVERY_PLATFORM_BASE_URL=https://b2b.taxi.tst.yandex.net，并使用官方指南中的测试凭据。该环境只处理莫斯科地址。

当日配送没有测试环境：可以安全地测试费用计算和读取现有订单；已创建的配送订单则会进入生产系统。

技术设置

在技术层面，服务使用 Yandex Delivery B2B API 的两个独立部分：当日配送 API 和次日配送 API。它们可能使用不同的令牌、服务器地址、金额格式和计量单位；MCP 服务会自行选择适用的参数。

* 如果已设置两个单独的令牌，则无需设置通用令牌。

数据与遥测

向 Yandex Delivery 发送请求

服务在本地运行，并直接访问 Yandex Delivery 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.

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