Skip to content
Navo24Navo24
Ücretsiz başlayın

Temel kavramlar

MCP hızlı başlangıç

Lojistik MCP sunucusu hızlı başlangıç: Claude, Cursor veya başka bir MCP istemcisini Navo24'e bağlayın, model konteynerleri kendisi takip etsin.

Model Context Protocol, bir asistanın araçları doğrudan çağırmasını sağlar. Navo24 her ürün için ayrı bir lojistik MCP sunucusu çalıştırır. Böylece model, siz bağlantı kodu yazmadan bir konteyneri takip edebilir, seferleri karşılaştırabilir ya da yükleme planlayabilir.

Sunucular

ÜrünSunucuEndpointTaşıma
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’de resolve_awb_prefix anahtar olmadan yanıt verir; track_awb ve air_rate_quote için tmcp_ aile anahtarınız gerekir.

Claude Desktop ve Cursor

İstemci yapılandırmanıza bir sunucu ekleyin. Streamable HTTP sunucusu için endpoint’i ve anahtarınızı bearer başlığı olarak verin.

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

Yalnızca yerel komut çalıştırabilen bir istemci, bu sunucuların hepsine mcp-remote üzerinden ulaşır. Hava kargo için:

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

İstemciyi yeniden başlatın, araçlar görünür. Bir konteyneri takip etmesini isteyin, get_container_detail aracını kendisi çağırır.

Model neleri çağırabilir

Her sunucu, REST API ile aynı yetenekleri araç adlarıyla sunar. Tracking’de add_container, get_container_detail, get_shipment_summary ve daha fazlası var. Schedules’ta find_best_sailings, carrier_reliability ve port_congestion var. Araçların tam listesi her ürünün referans sayfasında.

Aynı anahtar, aynı veri

Bir MCP araç çağrısı ile bir REST çağrısı aynı anahtarla aynı backend’e gider. İşi bir model yürütüyorsa MCP, kendi kodunuz yürütüyorsa REST kullanın.

Navo Tokens bulunan bir hesapta, yani Navo ürünlerinin ortak kullandığı tek bir ön ödemeli bakiyede, MCP çağrıları bu bakiyeden ödenir. Bakiyeyi tanımlayan JSON alanları credits_ adlarını korur.

Tek bir bakiye, MCP üzerinden tüm Navo hizmetlerini açar: TrackingMCP, AirCargoMCP, FreightRatesMCP, SchedulesMCP ve LoadingMCP. Her ürün için ayrı MCP erişimine ihtiyacınız yoktur. Bir çağrıyı yine de iki durum durdurur: hesap yöneticinizin hesabınız için kapattığı bir ürün ve kapsamı bir ürünü dışarıda bırakan bir anahtar (aşağıdaki Ürün bazında erişim bölümüne bakın).

MCP ve API kullanımı ayrı sayılır. Bir MCP çağrısı hiçbir zaman API anahtarının aylık çağrı limitinden düşmez, API anahtarınızla yapılan bir REST çağrısı da hiçbir zaman Navo Tokens harcamaz.

ÇağrıToken
Yeni bir konteyner, konşimento veya booking takibi250
Takip edilen bir sevkiyatı yenileme veya okumaReferans başına 10
Yeni bir hava konşimentosu (AWB) takibi200
Bir hava konşimentosunu yenileme10
Bir liman çifti için navlun fiyatları100, aynı çift 24 saat içinde tekrarlanırsa 10
Bir liman çifti için sefer tarifeleri80, aynı çift 24 saat içinde tekrarlanırsa 10
Yeni bir 3D yükleme planı50, her yeniden hesaplama için 10
Liman yoğunluğu10
Tarife güvenilirliği, bir taşıyıcının seferleri10
Uyarılar ve webhook’larücretsiz

Birden fazla referans alan bir araç, gönderdiğiniz her benzersiz referans için bir kez ücretlendirilir. Bir booking veya konşimento, tüm konteynerleri için tek bir ücrettir. Boş sonuç ücretsizdir, reddedilen bir çağrıdan da hiçbir ücret alınmaz. Paketler ve fiyatlar fiyatlandırma sayfasında.

Bakiye ödemeye yetmediğinde

Çağrı reddedilir, ücret alınmaz ve veri döndürülmez. Kod ürüne göre değişir:

ÜrünRet
TrackingMCP402 INSUFFICIENT_CREDITS
AirCargoMCPinsufficient_balance koduyla 402 (veya trial_expired, wallet_inactive, no_wallet)
FreightRatesMCPinsufficient_credits koduyla 402 (veya trial_expired, wallet_inactive, no_wallet)
SchedulesMCPHerhangi bir veri okunmadan önce 429 QUOTA_EXCEEDED, yanıt hazır olduğunda bakiye artık ödemeye yetmiyorsa 402 INSUFFICIENT_CREDITS
LoadingMCP402 INSUFFICIENT_CREDITS, plan hesaplanmadan önce reddedilir

Her üründe error nesnesi, code ve message alanlarının yanında aynı dört isteğe bağlı alanı taşır:

AlanTürİçeriği
credits_requiredinteger veya nullBu çağrının gerektirdiği token sayısı; fiyat bilinmiyorsa null.
credits_balanceinteger veya nullBakiyenizde şu anda bulunan token sayısı; hesabın henüz bakiyesi yoksa null.
top_up_urlstring veya nullHesap ayarlarınızdaki, daha fazla token satın aldığınız Billing sayfası; bağlantı verilemiyorsa null.
packages{ plan, credits, usd } dizisiSatın alabileceğiniz paketler: Starter 7,000 token $69, Growth 40,000 token $349, Scale 200,000 token $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 }
    ]
  }
}

Bu alanlar ek niteliğindedir ve isteğe bağlıdır: dallanmayı code üzerinden yapmaya devam edin, alanlar mevcutsa onları da okuyun. Her Navo MCP sunucusu bu alanları, kullanıcıya olduğu gibi gösterebileceğiniz aynı cümleye dönüştürür: “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).” Ayrıntılar her ürünün referans sayfasında, Navo Tokens başlığı altında.

Ürün bazında erişim

Navo Tokens, ürün başına MCP erişimi gerektirmez. Hesap yöneticinizin hesabınız için kapattığı bir ürün Navo Tokens ile de kapalı kalır; örneğin SchedulesMCP’de “Ship Schedules is not enabled for MCP on this account. Ask your account manager.” Kapsamı bir ürünü dışarıda bırakan bir anahtar 403 ile reddedilir; örneğin SchedulesMCP’de “Ship Schedules is not enabled for this API key.”, FreightRatesMCP’de “Freight Rates is not enabled for this API key. Contact your account manager to open it.”