Путь посылки, который берет на себя агент
MCP-серверы из каталога покрывают путь отправления от расчета до этикетки. Они различаются глубиной и способом запуска.
- Сравнить тарифы. cdek-mcp дает 16 инструментов, считает стоимость и срок по одному тарифу или по всем тарифам маршрута, ищет ПВЗ по городу или координатам.
- Оформить заказ и вызвать курьера. Тот же cdek-mcp создает и отменяет заказ, заказывает курьера и выдает PDF квитанции. В комплекте 4 скилла для Claude Code.
- Отследить накладную. Оба сервера, cdek-mcp и MCP и CLI для СДЭК, находят заказ по номеру, а cdek-mcp еще подписывается на вебхуки СДЭК.
- Распечатать документы. MCP и CLI для СДЭК скачивает PDF штрихкода, этикетки и накладной и хранит локальный справочник товаров с весом и габаритами.
- Вызвать СДЭК с внешней платформы. MCP для СДЭК: калькулятор и HTTP-сервер работает в HTTP-режиме с эндпоинтами /health, /manifest и /tools. PDF-этикеток у него нет.
- Работать из 1С. Открытый пакет интеграций вызывает методы СДЭК из 1С, OneScript и консольного приложения oint. Навыки 1С для OpenIntegrations объясняют агенту эту библиотеку в 12 файлах SKILL.md.
Где взять ключ API СДЭК
Методы API доступны только после подключения к сервису интеграции, а его СДЭК открывает по договору. Физлицу без договора интеграция недоступна. Ключи выдают в личном кабинете СДЭК. В документации они называются Account и Secure password, а в MCP-серверах Client ID и Client Secret.
Токен агент получает по OAuth 2.0. Сервер отправляет POST-запрос на /v2/oauth/token с grant_type=client_credentials, client_id и client_secret. В ответ приходит JWT со сроком жизни 3600 секунд по умолчанию. Сервер cdek-mcp обновляет токен сам.
Для проверки есть тестовый контур api.edu.cdek.ru. Общая тестовая пара ключей периодически меняется. Тогда песочница отвечает ошибкой 401, и нужны свои тестовые ключи. Команда npx skillfoxx add mcp/cdek-mcp перед установкой предупредит о широком доступе этого сервера.
Как выбрать сервер для СДЭК
У большинства инструментов широкий доступ, потому что на боевом контуре они создают реальные заказы. Минимальный доступ у навыков 1С, потому что это текстовые инструкции. Все инструменты работают без VPN. Официального инструмента от СДЭК в каталоге нет.
- Нужен полный цикл в Claude Code — cdek-mcp, единственный с вебхуками и готовыми скиллами.
- Нужны печатные документы и свой Python-код — MCP и CLI для СДЭК с CLI-утилитой и Pydantic-моделями.
- Сравниваете СДЭК с другими службами — WWmcp, где серверы СДЭК и Почты России собраны на общем ядре.
- Учет ведется в 1С — Открытый пакет интеграций и навыки к нему.
- Нужна другая служба доставки — Почта России, Boxberry и другие собраны в разделе российский стек.
Риски боевых ключей
На боевом контуре заказы и вызовы курьера реальные и тарифицируются по договору. Поэтому сценарии сначала прогоняйте на тестовом контуре, а боевые ключи давайте агенту после проверки. Пара Client ID и Client Secret дает доступ ко всему кабинету юрлица, поэтому храните ее вне репозитория.
HTTP-режим сервера-калькулятора открывает его по сети, а аутентификацию внешних вызовов README не описывает. В том же README остались заглушки yourusername в ссылках. Такой режим держите за закрытым прокси или не включайте вовсе.