cdek-mcp
MCP-сервер для API СДЭК: расчет тарифов, поиск ПВЗ, трекинг, создание заказов, вызов курьера и печать накладных
Установка
{
"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
Официальный плагин Zapier MCP: агент получает доступ к действиям в тысячах приложений через подключенный аккаунт Zapier
Awesome Claude Skills от Composio
Awesome Claude Skills
Каталог скиллов и плагинов для Claude и других агентов, плюс собственные скиллы автоматизации 78 SaaS-сервисов через Composio
Плагин и каталог CLI для агентов: генерирует командный интерфейс к GUI-программам вроде GIMP и Blender и ставит готовые через CLI-Hub