СД

СДЭК

на подключении неофициальный

Расчёт тарифов, создание заказов, печать этикеток, трекинг и вызов курьера. Поддержка ПВЗ и постаматов.

Отдельного адреса у магазина нет: он вызывается через общий эндпоинт аргументом server="cdek".

Ещё не подключён Манифест JSON

категория

Доставка

тип сервера

неофициальный

авторизация

OAuth 2.0

происхождение

РФ

статус

на подключении

Об источнике

Что это за источник

СДЭК — служба экспресс-доставки с собственной сетью пунктов выдачи и постаматов в России и соседних странах. У неё открытый программный интерфейс для интеграторов: интернет-магазины подключают его, чтобы считать доставку прямо в корзине, создавать заказы и отслеживать посылки.

Что будет доступно после подключения

Посчитать стоимость и срок доставки по нескольким тарифам — до двери и до пункта выдачи — ещё до того, как покупатель оформил заказ.
Сравнить тариф СДЭК с другими службами одним вызовом estimate_delivery. Именно для такого сравнения и нужна единая точка подключения: по отдельности агент его не соберёт.
Принять адрес в том виде, в каком его написал человек: перед расчётом он приводится к стандартному виду через DaData, а в службу уходит только индекс.
Узнать текущий статус отправления по номеру заказа.

Что есть в API СДЭК

Интерфейс второй версии: калькулятор по списку доступных тарифов и по коду конкретного тарифа, справочники городов и офисов, регистрация и изменение заказов, печать накладных и этикеток, уведомления о смене статуса. Авторизация — по OAuth 2.0: пара идентификатор и секрет обменивается на короткоживущий токен. Для разработки есть отдельный тестовый контур, доступ к нему тоже выдаётся по учётным данным.

Границы

Роутер только считает и показывает варианты. Создание отправления, вызов курьера и оплата доставки остаются на стороне магазина и без человека агентом не выполняются.

Статус подключения

Не подключён. Описание источника для расчёта тарифов написано по документации СДЭК, но ни одно поле не сверено с живым ответом: расчёт требует авторизации и на боевом, и на тестовом контуре, а ключей пока нет. Когда они появятся, estimate_delivery заработает без каких-либо изменений в настройках агента.

Установка

# СДЭК ещё не подключён (на подключении).
# Ниже — как это будет выглядеть.

# ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "e-suppy": {
      "url": "https://mcp.e-suppy.com/mcp"
    }
  }
}

# СДЭК ещё не подключён (на подключении).
# Ниже — как это будет выглядеть.

curl -X POST https://mcp.e-suppy.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
        "params":{"name":"search_products",
                  "arguments":{"query":"сметана 15%"}}}'

# СДЭК ещё не подключён (на подключении).
# Ниже — как это будет выглядеть.

from mcp.client.streamable_http import streamablehttp_client

async with streamablehttp_client("https://mcp.e-suppy.com/mcp") as (r, w, _):
    async with ClientSession(r, w) as s:
        await s.initialize()
        await s.call_tool("search_products", {"query": "cdek"})

Типовые операции в API категории

Так эти операции обычно называются у вендоров категории. Агенту они не видны: в e-suppy источник вызывается через общие инструменты роутера, и их набор при подключении не меняется.

calculate_tariffСтоимость и срок по адресам, весу и габаритамread

list_pickup_pointsПВЗ и постаматы в радиусе от координатread

create_shipmentСоздание заказа на доставкуwrite

print_labelЭтикетка в PDF или ZPLwrite

track_shipmentТекущий статус и история скановread

Пример ответа

{
  "tariff_code": 136,
  "tariff": "Посылка склад-дверь",
  "price": "418.00",
  "currency": "RUB",
  "delivery_days": [2, 3],
  "_meta": { "latency_ms": 184 }
}

Попробовать

Вызовы идут через тот же адрес, что и у агентов — https://mcp.e-suppy.com/mcp. Только чтение: создание корзины отсюда недоступно.