Skip to main content
Glama
mcp-yandex-dostavka

mcp-yandex-dostavka

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

npm Glama CI License: MIT

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

  • День в день по городу. Рассчитайте доставку, вызовите курьера, узнайте его местоположение и получите ссылку для получателя.

  • На следующий день и по России. Сравните доступные сроки и стоимость доставки до двери.

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

  • Сначала расчёт, затем заказ. Ассистент различает предварительную стоимость, подготовку отправления и момент, когда доставка действительно оформляется.

  • Без собственной интеграции. Внутри уже есть 16 готовых действий, схемы данных и правила безопасной работы с повторными запросами.

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

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

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

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

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


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

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

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

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

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

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

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

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

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

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

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

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


Related MCP server: Yandex Delivery MCP

Содержание

Быстрый старт

Нужны Node.js 20+ и токен корпоративного клиента Яндекс Доставки.

  1. Получите токен в личном кабинете Яндекс Доставки.

  2. Добавьте MCP-сервер в своё AI-приложение.

mcp-yandex-dostavka запускается на вашем компьютере через npx, поэтому браузерные версии ChatGPT и Claude не могут подключить его напрямую.

Через интерфейс приложения:

  1. Откройте Settings → MCP servers.

  2. Нажмите Add server.

  3. Выберите STDIO, затем укажите команду запуска npx -y mcp-yandex-dostavka@latest и переменную окружения YANDEX_DELIVERY_TOKEN со своим токеном.

  4. Нажмите Save, затем Restart.

Через командную строку:

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

Проверьте подключение:

codex mcp list

Команда сохраняет сервер в общей конфигурации Codex. Если Codex уже открыт, перезапустите его.

Официальная инструкция Codex

Актуальный официальный путь — Settings → Extensions. Для пользовательского desktop extension откройте Advanced settings → Extension Developer → Install Extension…, выберите файл .mcpb и следуйте подсказкам.

Этот репозиторий сейчас публикует npm-пакет со stdio и пока не содержит .mcpb. Поэтому используйте приведённый ниже JSON stdio-конфиг как fallback только в сборках Claude Desktop, где ещё поддерживается локальная конфигурация:

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

В таких сборках сохраните его в ~/Library/Application Support/Claude/claude_desktop_config.json на macOS или %APPDATA%\Claude\claude_desktop_config.json на Windows.

Сохраните файл и перезапустите Claude Desktop.

Официальная инструкция Claude Desktop

Откройте терминал и выполните:

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

Проверьте подключение:

claude mcp list

Официальная инструкция Claude Code

Пользовательский локальный сервер добавляется в Cursor через файл mcp.json:

  • macOS и Linux: ~/.cursor/mcp.json

  • Windows: %USERPROFILE%\.cursor\mcp.json

Создайте файл, если его ещё нет, и добавьте сервер. Если в файле уже есть другие серверы, сохраните их и добавьте только запись yandex-dostavka:

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

Сохраните файл. Если Cursor уже открыт, перезапустите его.

Официальная инструкция Cursor

  1. Откройте палитру команд: ⇧⌘P на macOS или Ctrl+Shift+P на Windows и Linux.

  2. Выполните команду MCP: Open User Configuration. Откроется пользовательский файл mcp.json, доступный во всех проектах.

  3. Добавьте сервер. Если в файле уже есть другие настройки, сохраните их:

{
  "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}"
      }
    }
  }
}
  1. Сохраните файл. VS Code попросит токен при первом запуске сервера и сохранит его как скрытое значение.

  2. Чтобы проверить сервер, выполните в палитре команд MCP: List Servers и выберите yandex-dostavka.

Официальная инструкция VS Code

После подключения откройте новый диалог в выбранном приложении и попросите:

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

Что можно поручить

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

  • Узнать стоимость. Рассчитать цену, расстояние и примерное время подачи курьера по адресам, весу и габаритам отправления.

  • Оформить отправление. Передать товары, адреса, контакты и требования к машине или курьеру.

  • Найти заказ. Искать отправления по статусу, телефону, периоду или номеру заказа вашей компании.

  • Следить за курьером. Получить его текущую позицию и публичную ссылку для получателя.

  • Отменить с известными последствиями. Сначала узнать, возможна ли отмена и будет ли она платной.

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

  • Сравнить варианты. Получить доступные интервалы и стоимость доставки до двери.

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

  • Проверить заказ. Узнать текущий статус и посмотреть историю его изменений.

  • Отменить заказ. Отправить запрос на отмену, пока текущий статус это позволяет.

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

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

  • Проверить условия. Посмотреть адрес, расписание, доступность самопривоза и способы оплаты.

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

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

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

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

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

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

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

Что вы просите

Что происходит

Доставка оформлена

Рассчитать доставку день в день

Ассистент получает предварительную цену, расстояние и ETA

Нет

Подготовить доставку день в день

Создаётся заявка и получается итоговая оценка, но поиск курьера ещё не начинается

Ещё нет

Оформить доставку день в день

Ассистент подтверждает оценённую заявку и запускает поиск курьера

Да

Рассчитать доставку на следующий день, до ПВЗ или постамата

Ассистент получает доступные варианты и цены

Нет

Оформить выбранный вариант

Ассистент подтверждает вариант и создаёт заказ

Да

Проверить условия отмены

Ассистент узнаёт, возможна ли отмена и сколько она стоит

Нет

Отменить доставку

Ассистент изменяет реальный заказ; отмена может быть платной

Да, заказ изменяется

Точная команда на оформление или отмену разрешает соответствующее действие. Поведение дополнительных подтверждений зависит от 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 и используйте тестовые реквизиты из официальной инструкции. Она обрабатывает только московские адреса.

Для доставки день в день тестовой среды нет: безопасно проверять расчёт стоимости и чтение существующих заявок, а оформленные отправления попадают в рабочую систему.

Технические настройки

На техническом уровне сервер работает с двумя независимыми частями B2B API Яндекс Доставки: API доставки день в день и API доставки на другой день. У них могут быть разные токены, адреса серверов, форматы денег и единицы измерения — MCP-сервер выбирает нужные параметры сам.

Переменная

Обязательна

По умолчанию

Что задаёт

YANDEX_DELIVERY_TOKEN

да*

—

Общий Bearer-токен для обоих API

YANDEX_DELIVERY_EXPRESS_TOKEN

нет

—

Отдельный токен доставки день в день

YANDEX_DELIVERY_PLATFORM_TOKEN

нет

—

Отдельный токен доставки на другой день

YANDEX_DELIVERY_EXPRESS_BASE_URL

нет

https://b2b.taxi.yandex.net

Корневой URL API доставки день в день

YANDEX_DELIVERY_PLATFORM_BASE_URL

нет

https://b2b-authproxy.taxi.yandex.net

Корневой URL API доставки на другой день

YANDEX_DELIVERY_LANG

нет

ru

Заголовок Accept-Language

YANDEX_DELIVERY_TIMEOUT_MS

нет

60000

Таймаут одного запроса, мс

YANDEX_DELIVERY_MAX_RETRIES

нет

3

Число повторов временных ошибок

ASKADS_TELEMETRY

нет

включена

0, false, off или no отключает анонимную телеметрию

* Общий токен не нужен, если заданы оба отдельных токена.

Данные и телеметрия

Запросы к Яндекс Доставке

Сервер запускается локально и обращается к API Яндекс Доставки напрямую. Bearer-токен добавляется только к запросам выбранного API. Даже универсальный инструмент принимает относительный путь: если он ведёт на внешний сервер, запрос блокируется, чтобы токен не ушёл на чужой адрес.

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

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

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

При вызове инструмента сервер также отправляет его исход, а при ошибке - фрагмент её текста: код и сообщение, в которых e-mail, адреса, токены, числа от 4 цифр и текст в кавычках заменены на «#». Если в тексте ошибки есть значение из запроса, оно тоже может попасть во фрагмент. Чтобы отключить телеметрию для MCP-серверов A1, добавьте в конфигурацию:

ASKADS_TELEMETRY=0

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

Ограничения

  • Это не только чтение. Ассистент умеет оформлять и отменять настоящие доставки; отмена может быть платной.

  • AI-приложение влияет на подтверждения. MCP-сервер сообщает тип каждого действия, но решение о дополнительном вопросе перед записью принимает приложение и его агент.

  • Нет тестовой среды для доставки день в день. Безопасно проверить можно расчёт стоимости и чтение существующих заявок.

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

  • При временном ограничении возможна задержка. Сервер сам подождёт и повторит запрос. Если Яндекс Доставка по-прежнему недоступна, попробуйте ещё раз позже.

  • Нет автоматического отката. Возможность и стоимость отмены зависят от текущего статуса и правил Яндекс Доставки.

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

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

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

Available Tools

16 tools
express_accept_claimЭкспресс: подтвердить заявкуA

Подтверждает заявку после успешной оценки (status ready_for_approval) и запускает поиск курьера — с этого момента доставка реально заказана. version берётся из express_get_claim. Ошибки 409: inappropriate_status (заявка не в подходящем статусе), old_version (устаревшая версия — перечитайте заявку), offer_expired / offer_already_used (оффер истёк — пересоздайте заявку).

Inputs: version (required), claim_id (required).

express_cancel_claimЭкспресс: отменить заявкуA
Destructive

Отменяет заявку (в том числе уже подтверждённую). Перед вызовом получите условия отмены через express_cancel_info и передайте её cancel_state: при paid спишется стоимость отмены. version берётся из express_get_claim. Ошибки 409: устаревшая версия, недопустимый статус или бесплатная отмена уже недоступна.

Inputs: version (required), claim_id (required), cancel_state (required).

express_cancel_infoЭкспресс: условия отменыA
Read-onlyIdempotent

Условия отмены заявки — вызывайте ПЕРЕД express_cancel_claim. Возвращает cancel_state: free (бесплатная), paid (платная — вернётся price/price_with_vat и currency) или unavailable (отменить уже нельзя).

Inputs: claim_id (required).

express_check_priceЭкспресс: оценка стоимостиA
Read-onlyIdempotent

Первичная оценка стоимости экспресс-доставки (день в день) БЕЗ создания заявки. Возвращает price (строка-decimal, не число!), currency_rules {code, sign}, distance_meters, eta (минуты) и zone_id. Точки маршрута задаются координатами [долгота, широта] и/или адресом строкой. Типовые ошибки: 400 address_not_found (адрес не распознан), 409 estimating.cant_construct_route (маршрут не строится).

Inputs: items (required), route_points (required), requirements, skip_door_to_door.

express_create_claimЭкспресс: создать заявкуA

Создаёт заявку на экспресс-доставку. ВАЖНО: заявка не запускается сразу — после создания она проходит оценку (status: new → estimating → ready_for_approval), затем её нужно подтвердить инструментом express_accept_claim; либо передайте auto_accept=true. Возвращает id (claim_id), status, version, route_points, pricing, created_ts. Идемпотентность обеспечивает request_id: повторный вызов с тем же request_id вернёт ту же заявку, а не создаст дубликат.

Inputs: items (required), route_points (required), client_requirements (required), due, +10 more.

express_get_claimЭкспресс: информация о заявкеA
Read-onlyIdempotent

Полная информация по заявке: status, version (нужен для accept/cancel), items, route_points, pricing {offer, final_price, currency}, performer_info (имя курьера, транспорт), eta, created_ts/updated_ts. Статусы: new, estimating, ready_for_approval, accepted, performer_lookup, performer_found, performer_not_found, pickup_arrived, pickuped, delivery_arrived, delivered, returning, returned, failed, cancelled, cancelled_by_taxi. ВНИМАНИЕ: ошибки оценки могут прийти массивом error_messages [{code, message}] внутри успешного 200-ответа — проверяйте и HTTP-ошибку, и это поле.

Inputs: claim_id (required).

express_performer_positionЭкспресс: позиция курьераA
Read-onlyIdempotent

Текущая геопозиция курьера по активной заявке: position {lat, lon, timestamp (unix), accuracy, speed (м/с), direction (0–360°)} и route_points с sharing_link. Ошибки: 404 — курьер/позиция не найдены, 409 — заявка не в активном статусе.

Inputs: claim_id (required).

express_search_claimsЭкспресс: поиск заявокA
Read-onlyIdempotent

Поиск заявок по фильтрам с пагинацией (сортировка — по дате создания). Возвращает claims (каждая — как в express_get_claim) и cursor для следующей страницы. Пагинация: либо offset/limit, либо курсорная — передайте cursor из предыдущего ответа (тогда остальные фильтры не нужны).

Inputs: limit, phone, state, cursor, +8 more.

platform_cancel_requestПлатформа: отменить заказA
Destructive

Отменяет заказ в логистической платформе. Курьерский заказ можно отменить до статуса DELIVERY_TRANSPORTATION_RECIPIENT (передача получателю). Возвращает status (CREATED | SUCCESS | ERROR), reason и description. Ошибки: 403 — чужой заказ/нет прав, 404 — не найден.

Inputs: request_id (required).

platform_confirm_offerПлатформа: подтвердить офферA

Бронирует выбранный оффер — СОЗДАЁТ заказ в логистической платформе. Возвращает request_id (id заказа, например «77241d8009bb46d0bff5c65a73077bcd-udp») — используйте его в platform_get_request, platform_request_history и platform_cancel_request. Оффер должен быть не просрочен (см. expires_at из platform_create_offers), иначе 400 bad_request.

Inputs: offer_id (required).

platform_create_offersПлатформа: рассчитать варианты доставкиA

Рассчитывает варианты доставки (офферы) для заказа «в другой день» (НДД/ПВЗ). Возвращает offers [{offer_id, expires_at, offer_details {delivery_interval {min, max, policy}, pickup_interval, pricing, pricing_total, pricing_commission_on_delivery_payment}}]. Оффер действует до expires_at — выбранный вариант бронируется инструментом platform_confirm_offer (до подтверждения заказ НЕ создан). Ошибка 400 no_delivery_options — на выбранный интервал вариантов доставки нет. Денежные суммы — в копейках (целые числа).

Inputs: info (required), items (required), places (required), source (required), +6 more.

platform_get_requestПлатформа: информация о заказеA
Read-onlyIdempotent

Информация о заказе НДД: state {status (например CREATED), description, timestamp, timestamp_utc, reason}, request (адреса, товары, получатель) и courier_order_id. Возможные причины отмены: SHOP_CANCELLED, USER_CHANGED_MIND, DELIVERY_PROBLEMS, BROKEN_ITEM и др.

Inputs: request_id (required), slim, request_code.

platform_list_pickup_pointsПлатформа: список ПВЗ и постаматовA
Read-onlyIdempotent

Список ПВЗ, постаматов и точек самопривоза платформенного контура (доставка «в другой день»). Возвращает points [{id, operator_id, name, type, position {latitude, longitude}, address, payment_methods, schedule, available_for_dropoff, dayoffs}]. id точки используется как platform_station в destination инструмента platform_create_offers. ВНИМАНИЕ: пустое тело вернёт ВСЕ точки (их очень много) — задавайте хотя бы один фильтр (geo_id, диапазон координат или pickup_point_ids).

Inputs: type, geo_id, latitude, longitude, +7 more.

platform_request_historyПлатформа: история статусов заказаA
Read-onlyIdempotent

История смены статусов заказа НДД: state_history [{status, description, timestamp (unix), timestamp_utc (ISO-8601), reason?}] — от создания до текущего момента.

Inputs: request_id (required).

raw_requestПроизвольный вызов API Яндекс ДоставкиA
Destructive

Запасной выход: прямой вызов любого метода B2B API Яндекс Доставки — для эндпоинтов без выделенного инструмента (тарифы, points-eta, ярлыки/акты, мерчанты, склады, отгрузки, proof-of-delivery и т.д.). contour выбирает контур и хост: express — b2b.taxi.yandex.net (пути вида «b2b/cargo/integration/v2/...»), platform — b2b-authproxy.taxi.yandex.net (пути вида «api/b2b/platform/...»). query — параметры строки запроса, body отправляется как JSON. ОСТОРОЖНО: инструмент может выполнять и изменяющие операции; 5xx/сетевые ошибки ретраятся только для GET.

Inputs: path (required), contour (required), body, query, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 16 tools

    Disambiguation5/5

    All tools are cleanly separated by domain prefix (express_ vs platform_) and each tool has a distinct purpose: price estimation, claim management, tracking, offers, and order management. No two tools overlap in function; even similar ones like get_claim and search_claims are clearly different (single item vs list).

    Naming Consistency4/5

    The prefix convention (express_ and platform_) is consistent, and most tools follow a verb_noun pattern (check_price, create_claim, accept_claim, cancel_claim, list_pickup_points, create_offers). However, a few tools are noun phrases without an explicit verb (express_performer_position, express_tracking_links, platform_request_history), creating minor inconsistency. Still, overall naming is predictable and readable.

    Tool Count4/5

    With 16 tools, the server is slightly over the typical 3–15 range, but the number is justified by covering two distinct delivery contours (express and platform) plus a raw fallback. Each tool serves a clear workflow step, so the count feels appropriate rather than bloated.

    Completeness4/5

    Core lifecycles are covered for both express (price check, create, get, accept, cancel info/cancel, search, tracking) and platform (list points, create offers, confirm, get, history, cancel). Minor gaps such as dedicated tools for specific edge operations (e.g., proof-of-delivery) are mitigated by the raw_request fallback, but those operations are not first-class tools. This is a solid, nearly complete surface.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers