Skip to content
Navo24Navo24
Начать бесплатно

Основы

Быстрый старт MCP

Быстрый старт логистического MCP-сервера: подключите Claude, Cursor или другой MCP-клиент к Navo24, и модель сама отслеживает контейнеры и сравнивает рейсы.

Model Context Protocol позволяет ассистенту вызывать инструменты напрямую. У Navo24 для каждого продукта свой логистический MCP-сервер, поэтому модель может отследить контейнер, сравнить рейсы или спланировать загрузку без вашего связующего кода.

Серверы

ПродуктСерверEndpointТранспорт
TrackingMCPcontainer-trackinghttps://mcp.trackingmcp.com/mcpStreamable HTTP
SchedulesMCPocean-scheduleshttps://mcp.schedulesmcp.com/mcpStreamable HTTP
LoadingMCPcontainer-loadinghttps://mcp.loadingmcp.com/mcpStreamable HTTP
AirCargoMCPair-cargohttps://mcp.aircargomcp.com/mcpStreamable HTTP
FreightRatesMCPfreight-rateshttps://mcp.freightratesmcp.com/mcpStreamable HTTP

В AirCargoMCP resolve_awb_prefix отвечает без ключа, а track_awb и air_rate_quote требуют вашего ключа семейства tmcp_.

Claude Desktop и Cursor

Добавьте сервер в конфигурацию клиента. Для сервера Streamable HTTP укажите endpoint и свой ключ в заголовке bearer.

{
  "mcpServers": {
    "container-tracking": {
      "url": "https://mcp.trackingmcp.com/mcp",
      "headers": { "Authorization": "Bearer tmcp_YOUR_API_KEY" }
    }
  }
}

Клиент, который запускает только локальные команды, подключается к любому из этих серверов через mcp-remote. Для авиагрузов:

{
  "mcpServers": {
    "air-cargo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.aircargomcp.com/mcp",
               "--header", "Authorization: Bearer tmcp_YOUR_API_KEY"]
    }
  }
}

Перезапустите клиент, и появятся инструменты. Попросите отследить контейнер, и он сам вызовет get_container_detail.

Что может вызывать модель

Каждый сервер даёт те же возможности, что и REST API, только в виде инструментов. В Tracking есть add_container, get_container_detail, get_shipment_summary и другие. В Schedules есть find_best_sailings, carrier_reliability и port_congestion. Полный список инструментов есть на справочной странице каждого продукта.

Тот же ключ, те же данные

Вызов MCP-инструмента и REST-запрос попадают в один бэкенд с одним и тем же ключом. MCP подходит, когда работой управляет модель, REST, когда ваш собственный код.

На аккаунте с Navo Tokens, то есть единым предоплаченным балансом для всех продуктов Navo, вызовы MCP оплачиваются из этого баланса. Поля JSON, описывающие баланс, сохраняют названия с префиксом credits_.

Один баланс открывает через MCP все сервисы Navo: TrackingMCP, AirCargoMCP, FreightRatesMCP, SchedulesMCP и LoadingMCP. Отдельный доступ MCP к каждому продукту не нужен. Остановить вызов могут только две вещи: продукт, который ваш менеджер закрыл для вашего аккаунта, и ключ, область действия которого не охватывает продукт (см. ниже Доступ к отдельным продуктам).

Использование MCP и API учитывается раздельно. Вызов MCP никогда не расходует месячный лимит вызовов API-ключа, а REST-запрос с вашим API-ключом никогда не расходует Navo Tokens.

ВызовТокены
Отслеживание нового контейнера, коносамента или букинга250
Обновление или чтение отслеживаемого груза10 за каждый номер
Отслеживание новой авианакладной200
Обновление авианакладной10
Фрахтовые ставки для пары портов100 или 10 за повтор той же пары в течение 24 часов
Расписания рейсов для пары портов80 или 10 за повтор той же пары в течение 24 часов
Новый 3D-план загрузки50 или 10 за каждый пересчёт
Загруженность порта10
Надёжность расписаний, рейсы перевозчика10
Оповещения и вебхукибесплатно

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

Когда баланса не хватает

Вызов отклоняется, ничего не списывается и данные не возвращаются. Код зависит от продукта:

ПродуктОтказ
TrackingMCP402 INSUFFICIENT_CREDITS
AirCargoMCP402 с кодом insufficient_balance (или trial_expired, wallet_inactive, no_wallet)
FreightRatesMCP402 с кодом insufficient_credits (или trial_expired, wallet_inactive, no_wallet)
SchedulesMCP429 QUOTA_EXCEEDED ещё до чтения каких-либо данных, или 402 INSUFFICIENT_CREDITS, если к моменту готовности ответа баланс уже не мог его оплатить
LoadingMCP402 INSUFFICIENT_CREDITS, отказ до расчёта плана

В каждом продукте объект error, помимо code и message, содержит одни и те же четыре необязательных поля:

ПолеТипЧто содержит
credits_requiredinteger или nullКоличество токенов, нужное для этого вызова; null, если цена неизвестна.
credits_balanceinteger или nullКоличество токенов на вашем балансе сейчас; null, если у аккаунта ещё нет баланса.
top_up_urlstring или nullСтраница Billing в настройках аккаунта, где можно докупить токены; null, если ссылку дать невозможно.
packagesмассив { plan, credits, usd }Пакеты, доступные для покупки: Starter 7,000 токенов за $69, Growth 40,000 токенов за $349, Scale 200,000 токенов за $1,399.
{
  "ok": false,
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Not enough Navo Tokens: this needs 10, your balance is 4. Buy more tokens: https://app.trackingmcp.com/settings?tab=billing&buy=credits (Starter 7,000 tokens for $69, Growth 40,000 tokens for $349, Scale 200,000 tokens for $1,399).",
    "severity": "warning",
    "credits_required": 10,
    "credits_balance": 4,
    "top_up_url": "https://app.trackingmcp.com/settings?tab=billing&buy=credits",
    "packages": [
      { "plan": "starter", "credits": 7000, "usd": 69 },
      { "plan": "growth", "credits": 40000, "usd": 349 },
      { "plan": "scale", "credits": 200000, "usd": 1399 }
    ]
  }
}

Эти поля дополнительные и необязательные: по-прежнему ветвите логику по code, а поля читайте, когда они есть. Каждый MCP-сервер Navo превращает их в одно и то же предложение, которое можно показать пользователю как есть: “Not enough Navo Tokens: this needs 10, your balance is 4. Buy more tokens: <link> (Starter 7,000 tokens for $69, Growth 40,000 tokens for $349, Scale 200,000 tokens for $1,399).” Подробности есть в разделе Navo Tokens на справочной странице каждого продукта.

Доступ к отдельным продуктам

Navo Tokens не требуют отдельного доступа MCP к каждому продукту. Продукт, который ваш менеджер закрыл для вашего аккаунта, остаётся закрытым и при Navo Tokens, например “Ship Schedules is not enabled for MCP on this account. Ask your account manager.” в SchedulesMCP. Ключ, область действия которого не охватывает продукт, получает отказ с кодом 403, например “Ship Schedules is not enabled for this API key.” в SchedulesMCP и “Freight Rates is not enabled for this API key. Contact your account manager to open it.” в FreightRatesMCP.