Добавить сервер
СДЭК MCP
  1. Каталог MCP
  2. СДЭК MCP

СДЭК MCP

от theyahia
MCP сервер для работы с API СДЭК: 16 инструментов для расчета тарифов, управления заказами и отслеживания отправлений. Автоматизирует логистику в AI-ассистентах - от стоимости доставки до вызова курьера и печати квитанций.
GithubNPMСайт сервера

MCP-сервер для СДЭК API — 16 инструментов для ИИ-агента: тарифы, заказы, трекинг

Если вы искали, как подключить доставку СДЭК к Claude или другому ИИ-агенту, — этот сервер закрывает весь цикл отправления через CDEK API v2: расчёт тарифов и сроков, создание и отмена заказов, трекинг по накладной, поиск городов и пунктов выдачи, вызов курьера, штрихкоды и квитанции, вебхуки. Спрашиваете «сколько стоит и как долго везти 2 кг из Москвы в Казань» — получаете сравнение тарифов таблицей, а не форму на сайте. Работает и на тестовом контуре СДЭК, и на боевом.

npm CI License: MIT

Демонстрация: вопрос «сколько стоит и как долго везти 2 кг из Москвы в Казань» — агент вызывает calculate_tariff_list и отвечает таблицей тарифов

Инструменты (16)

Тарифы
Инструмент Описание
calculate_tariff Рассчитать стоимость и срок доставки по конкретному тарифу
calculate_tariff_list Все доступные тарифы с ценами по маршруту
Заказы
Инструмент Описание
create_order Создать заказ на доставку с отправителем, получателем и местами
get_order Детали и статус заказа по UUID
delete_order Отменить или удалить заказ по UUID
list_orders Поиск и фильтрация заказов по периоду, номеру ИМ или накладной СДЭК
Инструменты были проиндексированы:
calculate_tariff

Рассчитывает стоимость и сроки доставки СДЭК по конкретному тарифу, маршруту и параметрам груза. Используется для предварительной оценки перед созданием заказа. Требует код тарифа (136=склад-склад, 137=склад-дверь, 138=дверь-склад, 139=дверь-дверь). Для поиска кода города используется get_cities.

Параметры
  • from_locationobjectобязательный

    Departure location (code or postal_code required)

  • packagesobject[]обязательный

    Вот список мест (минимум одно, но для полноты даю несколько): 1. Санкт-Петербург — город на Неве, бывшая столица Российской империи. Славится разводными мостами, Эрмитажем и белыми ночами. 2. Москва — столица России. Здесь находятся Кремль, Красная площадь и высотки сталинской эпохи. 3. Байкал — самое глубокое озеро на планете. Зимой покрывается прозрачным льдом, летом — тёплая вода и живописные берега. 4. Казань — столица Татарстана. Сочетает православные храмы и мечети, известна своим кремлём и набережной. 5. Петрозаводск — город на берегу Онежского озера. Отсюда стартуют маршруты на Кижи и Валаам. 6. Владивосток — портовый город на Тихом океане. Знаменит мостом через бухту Золотой Рог и морскими деликатесами. Если нужно что-то конкретнее — уточни, под какой запрос подбираю список.

  • tariff_codenumberобязательный

    Код тарифа СДЭК (например 136=посылка склад-склад, 137=склад-дверь, 138=дверь-склад, 139=дверь-дверь)

  • to_locationobjectобязательный

    Место назначения (обязательно укажите code или postal_code)

calculate_tariff_list

Рассчитывает стоимость доставки СДЭК по всем доступным тарифам для маршрута. Используйте, когда нужно показать клиенту все варианты доставки с ценами и сроками, не зная заранее код тарифа.

Параметры
  • from_locationobjectобязательный

    Departure location (code or postal_code required)

  • packagesobject[]обязательный

    Вот список мест (минимум одно, но для полноты даю несколько): 1. Санкт-Петербург — город на Неве, бывшая столица Российской империи. Славится разводными мостами, Эрмитажем и белыми ночами. 2. Москва — столица России. Здесь находятся Кремль, Красная площадь и высотки сталинской эпохи. 3. Байкал — самое глубокое озеро на планете. Зимой покрывается прозрачным льдом, летом — тёплая вода и живописные берега. 4. Казань — столица Татарстана. Сочетает православные храмы и мечети, известна своим кремлём и набережной. 5. Петрозаводск — город на берегу Онежского озера. Отсюда стартуют маршруты на Кижи и Валаам. 6. Владивосток — портовый город на Тихом океане. Знаменит мостом через бухту Золотой Рог и морскими деликатесами. Если нужно что-то конкретнее — уточни, под какой запрос подбираю список.

  • to_locationobjectобязательный

    Место назначения (обязательно укажите code или postal_code)

create_courier_pickup

Создаёт заявку на вызов курьера СДЭК для забора отправления. Требует UUID заказа и временной интервал. После создания можно отслеживать статус заявки через get_courier_pickup.

Параметры
  • commentstring

    Комментарий для курьера

  • intake_datestringобязательный

    Дата забора (YYYY-MM-DD)

  • intake_time_fromstringобязательный

    Время забора с (HH:MM)

  • intake_time_tostringобязательный

    Время забора до (HH:MM)

  • namestring

    ФИО отправителя

  • order_uuidstringобязательный

    UUID заказа для вызова курьера

  • phonestring

    Телефон отправителя

create_order

Создает заказ на доставку СДЭК с указанием отправителя, получателя и мест. Перед созданием рекомендуется рассчитать стоимость через calculate_tariff. После создания заказ можно отслеживать через get_order или track_shipment.

Параметры
  • commentstring

    Комментарий к заказу.

  • from_locationobjectобязательный

    Место отправления

  • packagesobject[]обязательный

    Список мест

  • recipientobjectобязательный

    Данные получателя

  • tariff_codenumberобязательный

    Код тарифа СДЭК

  • to_locationobjectобязательный

    Место назначения

create_webhook

Подписка на вебхуки СДЭК для получения уведомлений о смене статуса заказов (ORDER_STATUS) или готовности фото (DOWNLOAD_PHOTO). СДЭК будет отправлять POST-запросы на указанный HTTPS URL.

Параметры
  • typeenumобязательный

    Тип вебхука: ORDER_STATUS (статусы заказов) или DOWNLOAD_PHOTO

  • urlstringобязательный

    URL для получения уведомлений (HTTPS)

delete_order

Удаляет заказ СДЭК по UUID. Действует только для заказов, ещё не переданных в курьерскую службу. После удаления заказ нельзя восстановить.

Параметры
  • uuidstringобязательный

    UUID заказа СДЭК для удаления

delete_webhook

Удаляет подписку на вебхуки СДЭК по UUID вебхука. Используется для отключения уведомлений или смены URL получателя (удалить старый и создать новый).

Параметры
  • uuidstringобязательный

    UUID вебхука для удаления

generate_barcode

Генерирует штрихкод (этикетку) для заказа СДЭК по UUID. Поддерживает форматы A4, A5, A6 и до 10 копий. Ссылка на PDF появится в результатах get_order.

Параметры
  • copy_countinteger

    Количество копий (1-10, по умолчанию 1)

  • formatenum

    Формат печати (A4, A5, A6)

  • uuidstringобязательный

    UUID заказа СДЭК для генерации штрихкода

get_cities

Поиск городов в справочнике СДЭК по названию, индексу или стране. Возвращает код города, регион и ФИАС. Используйте для получения city_code перед вызовом calculate_tariff или create_order.

Параметры
  • citystring

    Название города (поиск по подстроке)

  • country_codesstring

    Коды стран через запятую (например RU,KZ)

  • pageinteger

    Номер страницы (с 0)

  • postal_codestring

    Почтовый индекс

  • sizeinteger

    Количество результатов (по умолчанию 50)

get_courier_pickup

Получает статус заявки на вызов курьера СДЭК по UUID заявки. Возвращает дату, время и историю статусов заявки.

Параметры
  • uuidstringобязательный

    UUID заявки на вызов курьера

get_order

Получает полную информацию о заказе СДЭК по UUID. Возвращает статусы, номер накладной и детали доставки. Используется после create_order для проверки обработки заказа.

Параметры
  • uuidstringобязательный

    UUID заказа СДЭК

get_regions

Получает справочник регионов СДЭК. Поддерживает фильтрацию по стране и названию региона, пагинацию. Используйте для построения иерархии локаций или фильтрации городов по региону.

Параметры
  • country_codesstring

    Коды стран через запятую (например RU,KZ)

  • pageinteger

    Номер страницы (с 0)

  • regionstring

    Название региона (поиск по подстроке)

  • sizeinteger

    Какой текст нужно перевести на русский язык?

list_delivery_points

Ищет пункты выдачи (ПВЗ) и постаматы СДЭК по городу, индексу или GPS-координатам. При указании latitude+longitude+radius_km фильтрует и сортирует пункты по расстоянию. Возвращает адрес, время работы, наличие примерочной и способы оплаты.

Параметры
  • city_codenumber

    Код города СДЭК

  • country_codestring

    Код страны (по умолчанию RU)

  • latitudenumber

    Latitude of the reference point for geo-search (longitude and radius_km are also required)

  • longitudenumber

    Долгота точки отсчёта для гео-поиска (нужны также latitude и radius_km)

  • pageinteger

    Номер страницы (с 0)

  • postal_codestring

    Почтовый индекс

  • radius_kmnumber

    Радиус поиска в км от (latitude, longitude). Фильтрация и сортировка по расстоянию на стороне клиента

  • sizeinteger

    Какой текст нужно перевести на русский язык?

  • typeenum

    Тип пункта: PVZ (пункт выдачи), POSTAMAT (постамат), ALL

list_orders

Ищет и фильтрует заказы СДЭК по дате, номеру ИМ или накладной СДЭК. Поддерживает пагинацию. Используйте для получения списка заказов за период или поиска конкретного заказа.

Параметры
  • cdek_numberstring

    Накладная СДЭК

  • date_invoice_fromstring

    Дата начала периода (формат YYYY-MM-DDTHH:MM:SS±HH:MM)

  • date_invoice_tostring

    Дата окончания периода

  • im_numberstring

    Номер заказа интернет-магазина

  • pagenumber

    Страница (индексация с нуля)

  • sizenumber

    Кол-во записей (макс. 1000)

print_receipt

Печатает квитанцию (накладную) для заказа СДЭК в формате PDF. Опрашивает API до готовности файла (до 10 секунд) и возвращает ссылку для скачивания.

Параметры
  • copy_countinteger

    Количество копий (1-10)

  • order_uuidstringобязательный

    UUID заказа для печати квитанции

track_shipment

Отслеживает отправление СДЭК по номеру накладной (cdek_number). Возвращает полную историю статусов с датами и городами. Если известен только UUID заказа, используйте get_order.

Параметры
  • cdek_numberstringобязательный

    Номер отправления СДЭК (например 1234567890)

2.2.0основная
2.0.2
2.0.1
2.0.0
1.1.0
1.0.2
1.0.1
1.0.0
0.0.1

Выберите клиент, чтобы установить СДЭК MCP:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

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

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

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

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

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

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"sdek-mcp-tt83\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"@theyahia/cdek-mcp\"],\"env\":{\"CDEK_CLIENT_ID\":\"<YOUR_CLIENT_ID>\",\"CDEK_CLIENT_SECRET\":\"<YOUR_CLIENT_SECRET>\",\"CDEK_SANDBOX\":\"true\"}}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

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

Добавьте сервер одной командой в терминале:

claude mcp add sdek-mcp-tt83 --env CDEK_CLIENT_ID=<YOUR_CLIENT_ID> --env CDEK_CLIENT_SECRET=<YOUR_CLIENT_SECRET> --env CDEK_SANDBOX=true -- npx -y @theyahia/cdek-mcp

Либо через JSON-конфиг:

claude mcp add-json sdek-mcp-tt83 "{\"command\":\"npx\",\"args\":[\"-y\",\"@theyahia/cdek-mcp\"],\"env\":{\"CDEK_CLIENT_ID\":\"<YOUR_CLIENT_ID>\",\"CDEK_CLIENT_SECRET\":\"<YOUR_CLIENT_SECRET>\",\"CDEK_SANDBOX\":\"true\"}}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add sdek-mcp-tt83 --env CDEK_CLIENT_ID=<YOUR_CLIENT_ID> --env CDEK_CLIENT_SECRET=<YOUR_CLIENT_SECRET> --env CDEK_SANDBOX=true -- npx -y @theyahia/cdek-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.sdek-mcp-tt83]
command = "npx"
args = ["-y", "@theyahia/cdek-mcp"]

[mcp_servers.sdek-mcp-tt83.env]
CDEK_CLIENT_ID = "<YOUR_CLIENT_ID>"
CDEK_CLIENT_SECRET = "<YOUR_CLIENT_SECRET>"
CDEK_SANDBOX = "true"
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите СДЭК MCP, а в поле команды запуска — строку ниже:
npx -y @theyahia/cdek-mcp

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

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

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

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

Создайте файл в .continue/mcpServers/ (например sdek-mcp-tt83.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: sdek-mcp-tt83
    command: npx
    args:
      - "-y"
      - "@theyahia/cdek-mcp"
    env:
      CDEK_CLIENT_ID: <YOUR_CLIENT_ID>
      CDEK_CLIENT_SECRET: <YOUR_CLIENT_SECRET>
      CDEK_SANDBOX: true
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

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

Похожие MCP-сервера

catrinmdonnelly/royalmail-mcp

catrinmdonnelly/royalmail-mcp

от catrinmdonnelly

MCP сервер для управления отправлениями Royal Mail и Parcelforce: бронирование, отслеживание, отмена заказов и печать этикеток через Click & Drop API. Автоматизируйте доставку прямо из ИИ-ассистентов.

JavaScript⭐ 3
aarsiv-groups/shipi-mcp-server

aarsiv-groups/shipi-mcp-server

от aarsiv-groups

Shipi MCP сервер для управления доставкой через диалог с ИИ. Сравнивайте тарифы, создавайте отправления и отслеживайте грузы. Работает с FedEx, UPS, USPS и десятками других перевозчиков. Автоматизируйте логистику в Claude Desktop.

JavaScript⭐ 1
PCDCK/ozon-mcp

PCDCK/ozon-mcp

от pcdck

MCP-сервер для подключения AI-агентов к Ozon Seller API. 15 инструментов дают доступ к 466 методам с автоподкачкой и защитой. 13 готовых сценариев для анализа остатков, цен, контента и синхронизаци...

Python⭐ 23
Вкусвилл MCP

Вкусвилл MCP

официальный

от lukentui

Ищет товары ВкусВилл с учётом акций, подбирает аналоги и рецепты, собирает готовую корзину по ссылке. Официальный сервер.

⭐ 1
roamzy-io/mcp-server

roamzy-io/mcp-server

от roamzy-io

MCP сервер для покупки eSIM в 193 странах через Claude, Cursor и другие клиенты. Работает анонимно, без регистрации — агенты сами покупают и управляют eSIM. Встроенная реферальная программа: 20% от платежей пользователей и других агентов навсегда. Оплата USDT/USDC, только за реально потраченные м...

TypeScript⭐ 3
skedgo/tripgo-mcp-server

skedgo/tripgo-mcp-server

от skedgo

MCP-сервер для интеграции с API TripGo: поиск транспортных локаций, отправлений и мультимодальное построение маршрутов. Полезен разработчикам ИИ-агентов для планирования поездок и анализа транспорта.

TypeScript⭐ 5
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин