MCP и CLI для СДЭК: заказы и отслеживание

mcp-server-cdek

MCP-сервер, CLI-утилита и Pydantic-модели для API СДЭК v2: создание заказов, штрихкоды, этикетки, накладные, поиск ПВЗ и локальный справочник товаров

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

dontsovcmc/mcp-server-cdekАвтор:dontsovcmc

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/mcp-server-cdek

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

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

Выполните в терминале

claude mcp add --transport stdio --env 'CDEK_CLIENT=<ваш CDEK_CLIENT>' --env 'CDEK_SECRET=<ваш CDEK_SECRET>' cdek -- uvx mcp-server-cdek==0.6.0

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "cdek": {
      "command": "uvx",
      "args": [
        "mcp-server-cdek==0.6.0"
      ],
      "env": {
        "CDEK_CLIENT": "<ваш CDEK_CLIENT>",
        "CDEK_SECRET": "<ваш CDEK_SECRET>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

CDEK_CLIENTсекрет, обязательная
CDEK_SECRETсекрет, обязательная
CDEK_SENDER_COMPANYнеобязательная: Sender company name (can also be set via config_set tool)
CDEK_SENDER_NAMEнеобязательная: Sender short name (can also be set via config_set tool)
CDEK_SENDER_FULL_NAMEнеобязательная: Sender full name (can also be set via config_set tool)
CDEK_SENDER_EMAILнеобязательная: Sender email (can also be set via config_set tool)
CDEK_SENDER_PHONEнеобязательная: Sender phone (can also be set via config_set tool)
CDEK_MY_PVZнеобязательная: My PVZ code for returns (can also be set via config_set tool)
CDEK_TIMEOUTнеобязательная: HTTP request timeout in seconds (default 30)
CDEK_FILE_TIMEOUTнеобязательная: File download timeout in seconds (default 60)

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "cdek": {
      "command": "uvx",
      "args": [
        "mcp-server-cdek==0.6.0"
      ],
      "env": {
        "CDEK_CLIENT": "<ваш CDEK_CLIENT>",
        "CDEK_SECRET": "<ваш CDEK_SECRET>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

CDEK_CLIENTсекрет, обязательная
CDEK_SECRETсекрет, обязательная
CDEK_SENDER_COMPANYнеобязательная: Sender company name (can also be set via config_set tool)
CDEK_SENDER_NAMEнеобязательная: Sender short name (can also be set via config_set tool)
CDEK_SENDER_FULL_NAMEнеобязательная: Sender full name (can also be set via config_set tool)
CDEK_SENDER_EMAILнеобязательная: Sender email (can also be set via config_set tool)
CDEK_SENDER_PHONEнеобязательная: Sender phone (can also be set via config_set tool)
CDEK_MY_PVZнеобязательная: My PVZ code for returns (can also be set via config_set tool)
CDEK_TIMEOUTнеобязательная: HTTP request timeout in seconds (default 30)
CDEK_FILE_TIMEOUTнеобязательная: File download timeout in seconds (default 60)

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

code --add-mcp '{"name":"cdek","type":"stdio","command":"uvx","args":["mcp-server-cdek==0.6.0"],"env":{"CDEK_CLIENT":"<ваш CDEK_CLIENT>","CDEK_SECRET":"<ваш CDEK_SECRET>"}}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "cdek": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-server-cdek==0.6.0"
      ],
      "env": {
        "CDEK_CLIENT": "<ваш CDEK_CLIENT>",
        "CDEK_SECRET": "<ваш CDEK_SECRET>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

CDEK_CLIENTсекрет, обязательная
CDEK_SECRETсекрет, обязательная
CDEK_SENDER_COMPANYнеобязательная: Sender company name (can also be set via config_set tool)
CDEK_SENDER_NAMEнеобязательная: Sender short name (can also be set via config_set tool)
CDEK_SENDER_FULL_NAMEнеобязательная: Sender full name (can also be set via config_set tool)
CDEK_SENDER_EMAILнеобязательная: Sender email (can also be set via config_set tool)
CDEK_SENDER_PHONEнеобязательная: Sender phone (can also be set via config_set tool)
CDEK_MY_PVZнеобязательная: My PVZ code for returns (can also be set via config_set tool)
CDEK_TIMEOUTнеобязательная: HTTP request timeout in seconds (default 30)
CDEK_FILE_TIMEOUTнеобязательная: File download timeout in seconds (default 60)

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add cdek --env 'CDEK_CLIENT=<ваш CDEK_CLIENT>' --env 'CDEK_SECRET=<ваш CDEK_SECRET>' -- uvx mcp-server-cdek==0.6.0

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.cdek]
command = "uvx"
args = ["mcp-server-cdek==0.6.0"]
env = { CDEK_CLIENT = "<ваш CDEK_CLIENT>", CDEK_SECRET = "<ваш CDEK_SECRET>" }

Если файл уже есть, допишите блок в конец.

Ключи и настройки

CDEK_CLIENTсекрет, обязательная
CDEK_SECRETсекрет, обязательная
CDEK_SENDER_COMPANYнеобязательная: Sender company name (can also be set via config_set tool)
CDEK_SENDER_NAMEнеобязательная: Sender short name (can also be set via config_set tool)
CDEK_SENDER_FULL_NAMEнеобязательная: Sender full name (can also be set via config_set tool)
CDEK_SENDER_EMAILнеобязательная: Sender email (can also be set via config_set tool)
CDEK_SENDER_PHONEнеобязательная: Sender phone (can also be set via config_set tool)
CDEK_MY_PVZнеобязательная: My PVZ code for returns (can also be set via config_set tool)
CDEK_TIMEOUTнеобязательная: HTTP request timeout in seconds (default 30)
CDEK_FILE_TIMEOUTнеобязательная: File download timeout in seconds (default 60)

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

gemini mcp add -s user -e 'CDEK_CLIENT=<ваш CDEK_CLIENT>' -e 'CDEK_SECRET=<ваш CDEK_SECRET>' cdek uvx mcp-server-cdek==0.6.0

Или добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "cdek": {
      "command": "uvx",
      "args": [
        "mcp-server-cdek==0.6.0"
      ],
      "env": {
        "CDEK_CLIENT": "<ваш CDEK_CLIENT>",
        "CDEK_SECRET": "<ваш CDEK_SECRET>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

CDEK_CLIENTсекрет, обязательная
CDEK_SECRETсекрет, обязательная
CDEK_SENDER_COMPANYнеобязательная: Sender company name (can also be set via config_set tool)
CDEK_SENDER_NAMEнеобязательная: Sender short name (can also be set via config_set tool)
CDEK_SENDER_FULL_NAMEнеобязательная: Sender full name (can also be set via config_set tool)
CDEK_SENDER_EMAILнеобязательная: Sender email (can also be set via config_set tool)
CDEK_SENDER_PHONEнеобязательная: Sender phone (can also be set via config_set tool)
CDEK_MY_PVZнеобязательная: My PVZ code for returns (can also be set via config_set tool)
CDEK_TIMEOUTнеобязательная: HTTP request timeout in seconds (default 30)
CDEK_FILE_TIMEOUTнеобязательная: File download timeout in seconds (default 60)

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "cdek": {
      "command": "uvx",
      "args": [
        "mcp-server-cdek==0.6.0"
      ],
      "env": {
        "CDEK_CLIENT": "<ваш CDEK_CLIENT>",
        "CDEK_SECRET": "<ваш CDEK_SECRET>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

CDEK_CLIENTсекрет, обязательная
CDEK_SECRETсекрет, обязательная
CDEK_SENDER_COMPANYнеобязательная: Sender company name (can also be set via config_set tool)
CDEK_SENDER_NAMEнеобязательная: Sender short name (can also be set via config_set tool)
CDEK_SENDER_FULL_NAMEнеобязательная: Sender full name (can also be set via config_set tool)
CDEK_SENDER_EMAILнеобязательная: Sender email (can also be set via config_set tool)
CDEK_SENDER_PHONEнеобязательная: Sender phone (can also be set via config_set tool)
CDEK_MY_PVZнеобязательная: My PVZ code for returns (can also be set via config_set tool)
CDEK_TIMEOUTнеобязательная: HTTP request timeout in seconds (default 30)
CDEK_FILE_TIMEOUTнеобязательная: File download timeout in seconds (default 60)

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "cdek": {
      "command": "uvx",
      "args": [
        "mcp-server-cdek==0.6.0"
      ],
      "env": {
        "CDEK_CLIENT": "<ваш CDEK_CLIENT>",
        "CDEK_SECRET": "<ваш CDEK_SECRET>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

CDEK_CLIENTсекрет, обязательная
CDEK_SECRETсекрет, обязательная
CDEK_SENDER_COMPANYнеобязательная: Sender company name (can also be set via config_set tool)
CDEK_SENDER_NAMEнеобязательная: Sender short name (can also be set via config_set tool)
CDEK_SENDER_FULL_NAMEнеобязательная: Sender full name (can also be set via config_set tool)
CDEK_SENDER_EMAILнеобязательная: Sender email (can also be set via config_set tool)
CDEK_SENDER_PHONEнеобязательная: Sender phone (can also be set via config_set tool)
CDEK_MY_PVZнеобязательная: My PVZ code for returns (can also be set via config_set tool)
CDEK_TIMEOUTнеобязательная: HTTP request timeout in seconds (default 30)
CDEK_FILE_TIMEOUTнеобязательная: File download timeout in seconds (default 60)

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "cdek": {
      "command": "uvx",
      "args": [
        "mcp-server-cdek==0.6.0"
      ],
      "env": {
        "CDEK_CLIENT": "<ваш CDEK_CLIENT>",
        "CDEK_SECRET": "<ваш CDEK_SECRET>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

CDEK_CLIENTсекрет, обязательная
CDEK_SECRETсекрет, обязательная
CDEK_SENDER_COMPANYнеобязательная: Sender company name (can also be set via config_set tool)
CDEK_SENDER_NAMEнеобязательная: Sender short name (can also be set via config_set tool)
CDEK_SENDER_FULL_NAMEнеобязательная: Sender full name (can also be set via config_set tool)
CDEK_SENDER_EMAILнеобязательная: Sender email (can also be set via config_set tool)
CDEK_SENDER_PHONEнеобязательная: Sender phone (can also be set via config_set tool)
CDEK_MY_PVZнеобязательная: My PVZ code for returns (can also be set via config_set tool)
CDEK_TIMEOUTнеобязательная: HTTP request timeout in seconds (default 30)
CDEK_FILE_TIMEOUTнеобязательная: File download timeout in seconds (default 60)

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "cdek": {
      "type": "local",
      "command": [
        "uvx",
        "mcp-server-cdek==0.6.0"
      ],
      "environment": {
        "CDEK_CLIENT": "<ваш CDEK_CLIENT>",
        "CDEK_SECRET": "<ваш CDEK_SECRET>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

CDEK_CLIENTсекрет, обязательная
CDEK_SECRETсекрет, обязательная
CDEK_SENDER_COMPANYнеобязательная: Sender company name (can also be set via config_set tool)
CDEK_SENDER_NAMEнеобязательная: Sender short name (can also be set via config_set tool)
CDEK_SENDER_FULL_NAMEнеобязательная: Sender full name (can also be set via config_set tool)
CDEK_SENDER_EMAILнеобязательная: Sender email (can also be set via config_set tool)
CDEK_SENDER_PHONEнеобязательная: Sender phone (can also be set via config_set tool)
CDEK_MY_PVZнеобязательная: My PVZ code for returns (can also be set via config_set tool)
CDEK_TIMEOUTнеобязательная: HTTP request timeout in seconds (default 30)
CDEK_FILE_TIMEOUTнеобязательная: File download timeout in seconds (default 60)

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "cdek": {
      "command": "uvx",
      "args": [
        "mcp-server-cdek==0.6.0"
      ],
      "env": {
        "CDEK_CLIENT": "<ваш CDEK_CLIENT>",
        "CDEK_SECRET": "<ваш CDEK_SECRET>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

CDEK_CLIENTсекрет, обязательная
CDEK_SECRETсекрет, обязательная
CDEK_SENDER_COMPANYнеобязательная: Sender company name (can also be set via config_set tool)
CDEK_SENDER_NAMEнеобязательная: Sender short name (can also be set via config_set tool)
CDEK_SENDER_FULL_NAMEнеобязательная: Sender full name (can also be set via config_set tool)
CDEK_SENDER_EMAILнеобязательная: Sender email (can also be set via config_set tool)
CDEK_SENDER_PHONEнеобязательная: Sender phone (can also be set via config_set tool)
CDEK_MY_PVZнеобязательная: My PVZ code for returns (can also be set via config_set tool)
CDEK_TIMEOUTнеобязательная: HTTP request timeout in seconds (default 30)
CDEK_FILE_TIMEOUTнеобязательная: File download timeout in seconds (default 60)

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "cdek": {
      "command": "uvx",
      "args": [
        "mcp-server-cdek==0.6.0"
      ],
      "env": {
        "CDEK_CLIENT": "<ваш CDEK_CLIENT>",
        "CDEK_SECRET": "<ваш CDEK_SECRET>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

CDEK_CLIENTсекрет, обязательная
CDEK_SECRETсекрет, обязательная
CDEK_SENDER_COMPANYнеобязательная: Sender company name (can also be set via config_set tool)
CDEK_SENDER_NAMEнеобязательная: Sender short name (can also be set via config_set tool)
CDEK_SENDER_FULL_NAMEнеобязательная: Sender full name (can also be set via config_set tool)
CDEK_SENDER_EMAILнеобязательная: Sender email (can also be set via config_set tool)
CDEK_SENDER_PHONEнеобязательная: Sender phone (can also be set via config_set tool)
CDEK_MY_PVZнеобязательная: My PVZ code for returns (can also be set via config_set tool)
CDEK_TIMEOUTнеобязательная: HTTP request timeout in seconds (default 30)
CDEK_FILE_TIMEOUTнеобязательная: File download timeout in seconds (default 60)

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: uv

Сверено с репозиторием 25 сент. 2026, коммит cd52e97.

Текст для агента

Получи Client ID и Client Secret в личном кабинете СДЭК (Настройки → Интеграция), затем добавь сервер командой claude mcp add cdek -e CDEK_CLIENT=... -e CDEK_SECRET=... -- uvx mcp-server-cdek.

Другие способы из описания автора

claude mcp add cdek -e CDEK_CLIENT=ваш_client_id -e CDEK_SECRET=ваш_client_secret -- uvx mcp-server-cdek

Не требует установки пакета, нужен uv.

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

Что делает

Пакет дает три способа работать с API СДЭК v2 из одного кода: MCP-сервер для Claude Code и Desktop, CLI-утилиту для терминала и скриптов, и типизированные Pydantic-модели для своих Python-программ. Инструменты создают заказ на доставку (от отправителя или к нему, на ПВЗ или до двери), отслеживают его по номеру, скачивают PDF штрихкода, этикетки и накладной, ищут ПВЗ и города СДЭК. Есть локальный справочник товаров: один раз описав товар (вес, габариты, цена), при создании заказа можно не повторять эти параметры каждый раз. Все ключи и данные остаются на компьютере пользователя.

Для кого. Для продавцов и небольших складов, которые хотят создавать и отслеживать заказы СДЭК прямо из диалога с агентом или из своих скриптов.

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

Нужно создать заказ на доставку и сразу получить этикетку или накладную
Нужен локальный справочник часто отправляемых товаров, чтобы не вводить габариты заново
Нужна CLI-утилита для автоматизации через скрипты, а не только диалоговый режим

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

Нет своего личного кабинета юрлица СДЭК с Client ID и Client Secret
Нужна интеграция с другими перевозчиками одновременно: сервер покрывает только СДЭК

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

Отправь посылку Иванову на ближайший ПВЗ СДЭК в Москве и скачай этикетку

Ограничения

Нужен собственный личный кабинет юрлица СДЭК с ключами интеграции, для физлиц без договора сервис недоступен. Настройки отправителя и справочник товаров хранятся локально в ~/.config/mcp-server-cdek. Полный тестовый охват заявлен, но реальная работа с заказами требует боевых или тестовых ключей СДЭК.

Как отключить. Удалите сервер командой claude mcp remove cdek и очистите ~/.config/mcp-server-cdek с локальными настройками.

MCP

Транспорт: stdio
Авторизация: API-ключ

Переменные окружения
Переменные окружения
CDEK_CLIENT обязательная, секрет	Client ID из личного кабинета юрлица СДЭК
CDEK_SECRET обязательная, секрет	Client Secret из личного кабинета юрлица СДЭК
CDEK_SENDER_COMPANY	Название компании отправителя по умолчанию

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

Может создавать реальные заказы на доставку и накладные под боевыми ключами СДЭК
Ключи Client ID и Secret дают полный доступ к личному кабинету юрлица

Коротко о README

README дает подробное оглавление по трем режимам использования (MCP, CLI, Pydantic-модели), таблицы инструментов по доставке, локальному справочнику товаров и настройкам, шаги подключения к Claude Code и Claude Desktop через uvx или pip, примеры команд CLI и полную таблицу переменных окружения включая настройки отправителя по умолчанию.

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

Можно ли использовать без установки пакета?

Да, через uvx mcp-server-cdek сервер запускается без отдельной установки, нужен только uv.

Работает ли как обычная командная строка?

Да, без аргументов запускается MCP-сервер, а с командой запускается CLI-утилита, все команды выводят JSON.

n8n-MCP

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

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

MCP-серверВысокий рискБез VPN23 тыс.

Zapier MCP

Официальный

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

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

Awesome Claude Skills от Composio

Awesome Claude Skills

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

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

CLI-Anything

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

ПлагинВысокий рискБез VPN50,9 тыс.

Установка

Что делает

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

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

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

Ограничения

MCP

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

Коротко о README

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

Похожие

n8n-MCP

Zapier MCP

Awesome Claude Skills от Composio

CLI-Anything