Перейти к основному содержанию
Вернуться ко всем статьям

MCP-сервер для расчёта стоимости грузоперевозок и отслеживания отправлений

Опубликовано 16 сент. 2026 г. Обновлено 17 сент. 2026 г.
Редакционная ответственность JTLGO Editorial Team
Операционная проверка JTLGO Sourcing Operations Review 16 сент. 2026 г.
Редакционная политика
В этой статье
  1. Что делает MCP-сервер для логистики
  2. Какие инструменты должен предоставлять MCP-сервер для грузоперевозок
  3. Расчёт стоимости зависит от вида перевозки, а вместе с ним — и входные данные
  4. Подключение сервера
  5. Публичный доступ и доступ к аккаунту
  6. Что проверить, прежде чем доверять коннектору для грузоперевозок
  7. Часто задаваемые вопросы
MCP-сервер для расчёта стоимости грузоперевозок и отслеживания отправлений

Что делает MCP-сервер для логистики

MCP-сервер для грузоперевозок открывает расчёт тарифов и трекинг как типизированные инструменты, чтобы ассистент мог напрямую запросить стоимость или статус отправления, а человеку не приходилось открывать тарифный портал. MCP, Model Context Protocol, — это интерфейсный уровень: он определяет, как клиент, например Claude, ChatGPT, Codex, Cursor или VS Code, узнаёт, какие инструменты предлагает сервер, какие аргументы принимает каждый из них и в какой форме возвращается ответ. В логистике это превращает две рутинные задачи — «сколько это будет стоить» и «где груз» — в вызовы функций.

Дальше в статье — чего ожидать от каждого типа инструментов, чем различается расчёт стоимости для разных видов перевозок и как подключить работающий сервер. В примерах используется публичный MCP-коннектор JTLGO Commerce, который рассчитывает маршруты из Китая и отслеживает отправления.

Какие инструменты должен предоставлять MCP-сервер для грузоперевозок

Полезный сервер невелик. Четыре–шесть чётко описанных инструментов лучше двадцати расплывчатых, потому что клиенту приходится выбирать между ними только по описанию.

ИнструментДля чегоТипичные входные данныеЧто возвращает
quote_shipping_ratesМаршрут и оценка стоимостивес, страна назначения, длина, ширина, высота, тип товараВарианты маршрутов с расчётным весом и ориентировочным сроком доставки
track_shipmentСтатус посылки или заказаодин трек-номер или списокПоследние события в истории перемещений и подсказка о проблеме
search_productsПоиск того, что будет отправленоключевое слово, платформа, лимитПодходящие товары с идентификаторами
get_product_detailПроверка одного товара перед расчётомID товара или URLПоля спецификации, включая вес, если он указан
human_handoffПередача человеку при низкой уверенностиязык, причинаКанал поддержки, который может подхватить человек
get_mcp_configПроверка подключениянетМетаданные коннектора и список инструментов

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

Расчёт стоимости зависит от вида перевозки, а вместе с ним — и входные данные

Покупатели ищут «MCP-сервер для расчёта LTL» и «MCP-сервер для расчёта FTL», как будто тарификация — это одна задача, примерно так же, как они воспринимают стек протоколов для агентов как нечто единое. Это не так. Вид перевозки определяет, какие входные данные должен требовать инструмент расчёта, а инструмент, принимающий слишком мало, выдаёт уверенную чепуху.

Вид перевозкиОт чего зависит ценаКакие данные должен требовать инструмент расчёта
Посылки и экспресс-доставкаБольшее из фактического и объёмного весаВес, все три размера, пункт назначения, тип товара
LTL, сборный груз (меньше полной машины)Класс груза или плотность плюс дополнительные услугиКоличество паллет, размеры, класс или плотность, дополнительные услуги при заборе и доставке
FTL, полная загрузка машиныНаправление, тип транспорта и датаПункты отправления и назначения, тип прицепа, дата забора
АвиаперевозкиПлатный вес по объёмному коэффициентуВес брутто, размеры, пара аэропортов, ограничения по товарам
Морские перевозки, LCL и FCLКубометры или количество и тип контейнеровОбъём или тип контейнера, пара портов, инкотермс

Отсюда два практических следствия. Во-первых, любой инструмент расчёта, принимающий вес без размеров, гадает, потому что почти для любого вида перевозки расчётная величина — объёмный вес. Во-вторых, внутренний расчёт LTL и FTL в стране назначения — это другой источник данных, чем расчёт международного экспорта; сервер, который умеет одно, не обязательно умеет другое. Проверьте, к какому из них вы подключаетесь, прежде чем строить на нём рабочий процесс.

Коннектор JTLGO рассчитывает маршруты из Китая, то есть экспресс-, авиа- и морские варианты отправки из Китая, с расчётным весом, вычисленным по указанным вами размерам. Он не рассчитывает внутренние автоперевозки в стране назначения. Тот же движок расчёта доступен людям через Rate and Ship, а та же история перемещений — через отслеживание отправлений. Это осознанное ограничение области применения, и лучше знать о нём заранее, чем обнаружить его внутри цикла агента.

Подключение сервера

Облачный MCP-сервер — это URL. Большинству клиентов больше ничего не нужно, а транспорт — JSON-RPC поверх HTTP POST.

{
  "mcpServers": {
    "jtlgo": {
      "url": "https://jtlgo.com/api/mcp"
    }
  }
}

Чтобы вручную проверить подключение, прежде чем настраивать его в клиенте, отправьте вызов initialize, а затем запросите список инструментов. Эндпоинт требует POST и заголовок Accept, в котором указаны и JSON, и тип event-stream; обычный GET отклоняется намеренно.

curl -X POST https://jtlgo.com/api/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Вызов расчёта выглядит как вызов любого другого инструмента. Указывайте размеры, а не только вес.

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "quote_shipping_rates",
    "arguments": {
      "weight": 12,
      "countryCode": "US",
      "length": 40,
      "width": 30,
      "height": 25,
      "goodsType": "general"
    }
  }
}

Публичный доступ и доступ к аккаунту

Коннекторам для грузоперевозок обычно нужны два уровня доступа, и их смешение — самая частая ошибка интеграции. Открытые инструменты, такие как расчёт тарифов и публичный трекинг, не требуют входа, потому что защищать там нечего — данных конкретного аккаунта нет. А всё, что читает собственные заказы клиента, его задачи или историю обращений в поддержку, требует входа, и именно здесь нужен OAuth.

JTLGO реализует это как два URL одного сервера: https://jtlgo.com/api/mcp для шести публичных инструментов и https://jtlgo.com/api/mcp/account для тех же шести плюс четырёх инструментов уровня аккаунта, причём клиент запускает OAuth-авторизацию, только когда действительно запрашиваются данные аккаунта. Выбирайте URL аккаунта, когда ассистенту нужно отвечать на вопросы об отправлениях конкретного клиента, и публичный URL, когда не нужно. Настраивать оба смысла нет.

Что проверить, прежде чем доверять коннектору для грузоперевозок

  • Доходит ли вызов инструмента до вышестоящей системы? Сервер, который отвечает на tools/list, не обязательно работает. Запросы списка обычно обслуживаются из статической схемы. Вызовите реальный инструмент.
  • Требует ли инструмент расчёта размеры? Если он принимает только вес, результат будет неверным для всего лёгкого и объёмного, а это большая часть потребительских товаров.
  • Различает ли трекинг «данных пока нет» и «не найдено»? Для клиента это разные вещи, и коннектор, который их смешивает, заставит ассистента уверенно и ошибочно успокаивать.
  • Есть ли явный путь эскалации? Движки расчёта ничего не возвращают для товаров с ограничениями и необычных направлений. Правильное поведение — передать запрос человеку, а не экстраполировать.
  • Чётко ли указана область применения? Регионы отправления, охваченные виды перевозок и входит ли расчёт внутренних автоперевозок.

Часто задаваемые вопросы

Что такое MCP-сервер для грузоперевозок?

Сервис, который открывает расчёт стоимости перевозки и отслеживание отправлений как вызываемые инструменты по Model Context Protocol, чтобы ИИ-ассистент мог напрямую запросить стоимость или статус, а человеку не приходилось пользоваться тарифным порталом.

Может ли MCP-сервер рассчитывать тарифы LTL и FTL?

Может, если он подключён к тарифному движку перевозчика для этих видов перевозок и требует правильные входные данные: количество паллет, размеры и класс груза для LTL, а также направление, тип транспорта и дату забора для FTL. Многие логистические коннекторы, включая коннектор JTLGO, охватывают международные экспортные перевозки, а не внутренние автоперевозки, поэтому уточните область применения, прежде чем на него полагаться.

Нужен ли API-ключ для логистического MCP-сервера?

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

Какие MCP-клиенты могут его использовать?

Любой клиент, поддерживающий облачные HTTP-серверы; сейчас это Claude, ChatGPT, Codex, Cursor и VS Code. Коннектор — это URL, транспорт обеспечивает клиент.

Почему эндпоинт отклоняет GET-запросы?

Потому что HTTP-транспорт MCP — это JSON-RPC поверх POST. GET, возвращающий метаданные, стал бы вторым, недокументированным интерфейсом, поэтому он отклоняется с кодом 405, а не поддерживается неофициально.

Источники и ссылки

Поделиться статьёй: