cdek-mcp

MCP-сервер для API СДЭК: расчет тарифов, поиск ПВЗ, трекинг, создание заказов, вызов курьера и печать накладных

MCP-серверВысокий рискРоссийский стек

theyahia/cdek-mcp

Установка

{
  "mcpServers": {
    "cdek": {
      "command": "npx",
      "args": ["-y", "@theyahia/cdek-mcp"],
      "env": {
        "CDEK_CLIENT_ID": "<YOUR_CLIENT_ID>",
        "CDEK_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
        "CDEK_SANDBOX": "true"
      }
    }
  }
}

Тот же блок подходит для .cursor/mcp.json и .windsurf/mcp.json. В .vscode/mcp.json ключ верхнего уровня servers. Для боевого контура уберите CDEK_SANDBOX.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер работает с CDEK API v2 и дает агенту 16 инструментов на весь путь отправления. Агент считает стоимость и срок по одному тарифу или сравнивает все тарифы маршрута, ищет города, регионы и пункты выдачи по городу или координатам. Он может создать, найти и отменить заказ, отследить накладную, заказать курьера, получить штрихкод и PDF квитанции, подписаться на вебхуки. Поддерживаются тестовый и боевой контуры, OAuth-токен обновляется автоматически. В комплекте четыре скилла для Claude Code: расчет доставки, поиск ПВЗ, оформление и трекинг.

Для кого. Для интернет-магазинов, продавцов и разработчиков, которые отправляют посылки через СДЭК.

Подходит, если

  • Нужно сравнить тарифы и сроки доставки между городами
  • Нужно найти ближайшие пункты выдачи или постаматы
  • Нужно отследить посылку по номеру накладной
  • Нужно оформить отправление и вызвать курьера из агента

Не подходит, если

  • Нет договора и ключей API в личном кабинете СДЭК
  • Нужна массовая выгрузка заказов из учетной системы: лучше готовая интеграция магазина

Пример запроса к агенту

Сколько стоит и сколько дней везти посылку 2 кг из Москвы в Казань? Сравни тарифы

Ограничения

Нужны Client ID и Client Secret из личного кабинета СДЭК. Общая тестовая пара ключей периодически меняется, тогда песочница отвечает 401 и нужны свои тестовые ключи. На боевом контуре заказы и вызовы курьера создаются по-настоящему и тарифицируются по договору.

Как отключить. Удалите блок cdek из конфигурации MCP-клиента или выполните claude mcp remove cdek, если добавляли через Claude Code.

MCP

Транспорт
stdio, http
Авторизация
OAuth
Переменные окружения
Переменные окружения
CDEK_CLIENT_ID
обязательная, секрет
Client ID из личного кабинета СДЭК
CDEK_CLIENT_SECRET
обязательная, секрет
Client Secret из личного кабинета СДЭК
CDEK_SANDBOX
true для тестового контура api.edu.cdek.ru
HTTP_PORT
Порт HTTP-транспорта, включает HTTP-режим

Проверка безопасности

  • На боевом контуре создает и отменяет реальные заказы и вызовы курьера, которые оплачиваются по договору
  • Хранит секреты API СДЭК

Коротко о README

README группирует 16 инструментов по разделам: тарифы, заказы, трекинг, география, печать, курьер и вебхуки. Даны конфигурации для Claude Desktop, Cursor, Windsurf и VS Code, запуск по HTTP и таблица переменных окружения. Отдельно описаны песочница с общим тестовым аккаунтом, устройство OAuth и примеры запросов. Проект входит в серию WWmcp, лицензия MIT.

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

Где взять ключи?

В личном кабинете СДЭК, раздел интеграции, ключи API.

Можно попробовать без реальных заказов?

Да, с CDEK_SANDBOX=true сервер работает с тестовым контуром api.edu.cdek.ru.

Выбор редакции

MCP-сервер со справкой по нодам и шаблонам n8n: агент подбирает ноды, проверяет конфигурацию и при наличии API создает воркфлоу в вашем n8n

MCP-серверВысокий риск22,9 тыс.
Выбор редакции

Официальный плагин Zapier MCP: агент получает доступ к действиям в тысячах приложений через подключенный аккаунт Zapier

ПлагинВысокий риск409

Каталог скиллов и плагинов для Claude и других агентов, плюс собственные скиллы автоматизации 78 SaaS-сервисов через Composio

СкиллВысокий риск75 тыс.

Плагин и каталог CLI для агентов: генерирует командный интерфейс к GUI-программам вроде GIMP и Blender и ставит готовые через CLI-Hub

ПлагинВысокий риск49,4 тыс.