Szybki start MCP

Model Context Protocol pozwala asystentowi wywoływać narzędzia bezpośrednio. Navo24 udostępnia osobny serwer MCP dla logistyki dla każdego produktu, więc model może śledzić kontener, porównać rejsy albo zaplanować załadunek bez pisania kodu integracyjnego.

Serwery

Produkt	Serwer	Endpoint	Transport
TrackingMCP	container-tracking	https://mcp.trackingmcp.com/mcp	Streamable HTTP
SchedulesMCP	ocean-schedules	https://mcp.schedulesmcp.com/mcp	Streamable HTTP
LoadingMCP	container-loading	https://mcp.loadingmcp.com/mcp	Streamable HTTP
AirCargoMCP	air-cargo	https://mcp.aircargomcp.com/mcp	Streamable HTTP
FreightRatesMCP	freight-rates	https://mcp.freightratesmcp.com/mcp	Streamable HTTP

W AirCargoMCP resolve_awb_prefix odpowiada bez klucza, natomiast track_awb i air_rate_quote wymagają Twojego klucza z rodziny tmcp_.

Claude Desktop i Cursor

Dodaj serwer do konfiguracji klienta. Dla serwera Streamable HTTP podaj endpoint i swój klucz w nagłówku bearer.

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

Klient, który uruchamia wyłącznie lokalne polecenia, połączy się z każdym z tych serwerów przez mcp-remote. Dla frachtu lotniczego:

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

Uruchom klienta ponownie, a narzędzia się pojawią. Poproś go o śledzenie kontenera, a sam wywoła get_container_detail.

Co model może wywołać

Każdy serwer udostępnia te same funkcje co REST API, tylko jako narzędzia. Tracking ma add_container, get_container_detail, get_shipment_summary i inne. Schedules ma find_best_sailings, carrier_reliability i port_congestion. Pełna lista narzędzi jest na stronie referencyjnej każdego produktu.

Ten sam klucz, te same dane

Wywołanie narzędzia MCP i wywołanie REST trafiają do tego samego backendu z tym samym kluczem. MCP wybierz, gdy pracą steruje model, a REST, gdy robi to Twój kod.

Navo Tokens

Na koncie z Navo Tokens, czyli jednym przedpłaconym saldem wspólnym dla produktów Navo, wywołania MCP są opłacane z tego salda. Pola JSON opisujące saldo zachowują nazwy z prefiksem credits_.

Jedno saldo otwiera przez MCP wszystkie usługi Navo: TrackingMCP, AirCargoMCP, FreightRatesMCP, SchedulesMCP i LoadingMCP. Nie potrzebujesz osobnego dostępu MCP do każdego produktu. Wywołanie mogą zablokować jeszcze tylko dwie rzeczy: produkt, który opiekun klienta zamknął dla Twojego konta, oraz klucz, którego zakres wyklucza dany produkt (zobacz niżej Dostęp do poszczególnych produktów).

Użycie MCP i API jest liczone osobno. Wywołanie MCP nigdy nie zużywa miesięcznego limitu wywołań klucza API, a wywołanie REST z Twoim kluczem API nigdy nie zużywa Navo Tokens.

Wywołanie	Tokeny
Śledzenie nowego kontenera, konosamentu lub rezerwacji	250
Odświeżenie lub odczyt śledzonej przesyłki	10 za numer referencyjny
Śledzenie nowego lotniczego listu przewozowego	200
Odświeżenie lotniczego listu przewozowego	10
Stawki frachtowe dla pary portów	100 lub 10 za powtórzenie tej samej pary w ciągu 24 godzin
Rozkłady rejsów dla pary portów	80 lub 10 za powtórzenie tej samej pary w ciągu 24 godzin
Nowy plan załadunku 3D	50 lub 10 za każde ponowne przeliczenie
Zatłoczenie portu	10
Terminowość rozkładów, rejsy przewoźnika	10
Alerty i webhooki	bezpłatnie

Narzędzie przyjmujące kilka numerów referencyjnych pobiera opłatę raz za każdy unikalny przesłany numer. Rezerwacja lub konosament to jedna opłata za wszystkie należące do nich kontenery. Pusty wynik jest bezpłatny, a odrzucone wywołanie nic nie kosztuje. Pakiety i ceny znajdziesz na stronie z cennikiem.

Gdy saldo nie wystarcza

Wywołanie zostaje odrzucone, nic nie jest pobierane i nie są zwracane żadne dane. Kod zależy od produktu:

Produkt	Odmowa
TrackingMCP	402 INSUFFICIENT_CREDITS
AirCargoMCP	402 z kodem insufficient_balance (lub trial_expired, wallet_inactive, no_wallet)
FreightRatesMCP	402 z kodem insufficient_credits (lub trial_expired, wallet_inactive, no_wallet)
SchedulesMCP	429 QUOTA_EXCEEDED przed odczytem jakichkolwiek danych lub 402 INSUFFICIENT_CREDITS, gdy po przygotowaniu odpowiedzi saldo nie pozwalało już na opłatę
LoadingMCP	402 INSUFFICIENT_CREDITS, odmowa przed obliczeniem planu

W każdym produkcie obiekt error oprócz code i message zawiera te same cztery opcjonalne pola:

Pole	Typ	Zawartość
credits_required	integer lub null	Liczba tokenów potrzebnych do tego wywołania; null, gdy cena nie jest znana.
credits_balance	integer lub null	Liczba tokenów na Twoim saldzie w tej chwili; null, gdy konto nie ma jeszcze salda.
top_up_url	string lub null	Strona Billing w ustawieniach konta, gdzie dokupisz tokeny; null, gdy nie można podać linku.
packages	tablica { plan, credits, usd }	Pakiety dostępne do zakupu: Starter 7,000 tokenów za $69, Growth 40,000 tokenów za $349, Scale 200,000 tokenów za $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 }
    ]
  }
}

Te pola są dodatkowe i opcjonalne: nadal rozgałęziaj logikę na podstawie code, a pola odczytuj, gdy są obecne. Każdy serwer MCP Navo zamienia je w to samo zdanie, które możesz pokazać użytkownikowi bez zmian: “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).” Szczegóły znajdziesz w sekcji Navo Tokens na stronie referencyjnej każdego produktu.

Dostęp do poszczególnych produktów

Navo Tokens nie wymagają osobnego dostępu MCP do każdego produktu. Produkt, który opiekun klienta zamknął dla Twojego konta, pozostaje zamknięty także przy Navo Tokens, na przykład “Ship Schedules is not enabled for MCP on this account. Ask your account manager.” w SchedulesMCP. Klucz, którego zakres wyklucza dany produkt, zostaje odrzucony z kodem 403, na przykład “Ship Schedules is not enabled for this API key.” w SchedulesMCP oraz “Freight Rates is not enabled for this API key. Contact your account manager to open it.” w FreightRatesMCP.