MCP-сервер для расчёта стоимости грузоперевозок и отслеживания отправлений
В этой статье
- Что делает MCP-сервер для логистики
- Какие инструменты должен предоставлять 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, а не поддерживается неофициально.
Источники и ссылки
- Model Context Protocol specification Model Context Protocol
- JTLGO Commerce MCP connector JTL Global