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.