Γρήγορος οδηγός MCP

Το Model Context Protocol επιτρέπει σε έναν βοηθό να καλεί εργαλεία απευθείας. Η Navo24 διαθέτει ένα MCP server για logistics ανά προϊόν, οπότε ένα μοντέλο μπορεί να εντοπίσει ένα κοντέινερ, να συγκρίνει αναχωρήσεις ή να σχεδιάσει μια φόρτωση χωρίς να γράψετε κώδικα σύνδεσης.

Οι servers

Προϊόν	Server	Endpoint	Μεταφορά
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

Στο AirCargoMCP, το resolve_awb_prefix απαντά χωρίς κλειδί, ενώ τα track_awb και air_rate_quote απαιτούν το κλειδί σας της οικογένειας tmcp_.

Claude Desktop και Cursor

Προσθέστε έναν server στις ρυθμίσεις του client σας. Για server Streamable HTTP δώστε το endpoint και το κλειδί σας ως κεφαλίδα bearer.

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

Ένας client που εκτελεί μόνο τοπικές εντολές συνδέεται με οποιονδήποτε από αυτούς τους servers μέσω mcp-remote. Για τα αεροπορικά φορτία:

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

Κάντε επανεκκίνηση του client και τα εργαλεία εμφανίζονται. Ζητήστε του να εντοπίσει ένα κοντέινερ και θα καλέσει μόνο του το get_container_detail.

Τι μπορεί να καλέσει το μοντέλο

Κάθε server προσφέρει τις ίδιες δυνατότητες με το REST API, με τη μορφή εργαλείων. Το Tracking έχει add_container, get_container_detail, get_shipment_summary και άλλα. Το Schedules έχει find_best_sailings, carrier_reliability και port_congestion. Η πλήρης λίστα εργαλείων βρίσκεται στη σελίδα αναφοράς κάθε προϊόντος.

Ίδιο κλειδί, ίδια δεδομένα

Μια κλήση εργαλείου MCP και μια κλήση REST φτάνουν στο ίδιο backend με το ίδιο κλειδί. Χρησιμοποιήστε MCP όταν τη δουλειά την οδηγεί ένα μοντέλο και REST όταν την κάνει ο δικός σας κώδικας.

Navo Tokens

Σε λογαριασμό με Navo Tokens, δηλαδή ένα ενιαίο προπληρωμένο υπόλοιπο κοινό για τα προϊόντα Navo, οι κλήσεις MCP χρεώνονται από αυτό το υπόλοιπο. Τα πεδία JSON που περιγράφουν το υπόλοιπο διατηρούν τα ονόματα με πρόθεμα credits_.

Ένα υπόλοιπο ανοίγει μέσω MCP όλες τις υπηρεσίες Navo: TrackingMCP, AirCargoMCP, FreightRatesMCP, SchedulesMCP και LoadingMCP. Δεν χρειάζεστε ξεχωριστή πρόσβαση MCP για κάθε προϊόν. Μια κλήση μπορούν να τη σταματήσουν μόνο δύο πράγματα: ένα προϊόν που ο account manager σας έχει κλείσει για τον λογαριασμό σας και ένα κλειδί του οποίου το εύρος εξαιρεί ένα προϊόν (δείτε παρακάτω Πρόσβαση ανά προϊόν).

Η χρήση MCP και η χρήση API μετρώνται χωριστά. Μια κλήση MCP δεν καταναλώνει ποτέ το μηνιαίο όριο κλήσεων ενός κλειδιού API, και μια κλήση REST με το κλειδί API σας δεν καταναλώνει ποτέ Navo Tokens.

Κλήση	Tokens
Παρακολούθηση νέου κοντέινερ, φορτωτικής ή κράτησης	250
Ανανέωση ή ανάγνωση αποστολής υπό παρακολούθηση	10 ανά αριθμό αναφοράς
Παρακολούθηση νέας αεροπορικής φορτωτικής	200
Ανανέωση αεροπορικής φορτωτικής	10
Ναύλοι για ζεύγος λιμένων	100, ή 10 για επανάληψη του ίδιου ζεύγους εντός 24 ωρών
Δρομολόγια πλόων για ζεύγος λιμένων	80, ή 10 για επανάληψη του ίδιου ζεύγους εντός 24 ωρών
Νέο τρισδιάστατο πλάνο φόρτωσης	50, ή 10 ανά επανυπολογισμό
Συμφόρηση λιμένα	10
Αξιοπιστία δρομολογίων, πλόες ενός μεταφορέα	10
Ειδοποιήσεις και webhooks	δωρεάν

Ένα εργαλείο που δέχεται πολλούς αριθμούς αναφοράς χρεώνει μία φορά ανά μοναδικό αριθμό που υποβάλατε. Μια κράτηση ή μια φορτωτική χρεώνεται μία φορά για όλα τα κοντέινερ της. Ένα κενό αποτέλεσμα είναι δωρεάν και μια κλήση που απορρίπτεται δεν χρεώνεται τίποτα. Τα πακέτα και οι τιμές βρίσκονται στη σελίδα τιμών.

Όταν το υπόλοιπο δεν επαρκεί

Η κλήση απορρίπτεται, δεν γίνεται καμία χρέωση και δεν επιστρέφονται δεδομένα. Ο κωδικός εξαρτάται από το προϊόν:

Προϊόν	Απόρριψη
TrackingMCP	402 INSUFFICIENT_CREDITS
AirCargoMCP	402 με τον κωδικό insufficient_balance (ή trial_expired, wallet_inactive, no_wallet)
FreightRatesMCP	402 με τον κωδικό insufficient_credits (ή trial_expired, wallet_inactive, no_wallet)
SchedulesMCP	429 QUOTA_EXCEEDED πριν διαβαστούν οποιαδήποτε δεδομένα, ή 402 INSUFFICIENT_CREDITS όταν το υπόλοιπο δεν μπορούσε πλέον να πληρώσει τη στιγμή που η απάντηση ήταν έτοιμη
LoadingMCP	402 INSUFFICIENT_CREDITS, απόρριψη πριν υπολογιστεί το πλάνο

Σε κάθε προϊόν, εκτός από τα code και message, το αντικείμενο error περιέχει τα ίδια τέσσερα προαιρετικά πεδία:

Πεδίο	Τύπος	Τι περιέχει
credits_required	integer ή null	Τα tokens που χρειάζεται αυτή η κλήση· null όταν η τιμή δεν είναι γνωστή.
credits_balance	integer ή null	Τα tokens που έχει τώρα το υπόλοιπό σας· null όταν ο λογαριασμός δεν έχει ακόμη υπόλοιπο.
top_up_url	string ή null	Η σελίδα Billing στις ρυθμίσεις του λογαριασμού σας, όπου αγοράζετε περισσότερα tokens· null όταν δεν μπορεί να δοθεί σύνδεσμος.
packages	πίνακας { plan, credits, usd }	Τα πακέτα που μπορείτε να αγοράσετε: Starter 7,000 tokens για $69, Growth 40,000 tokens για $349, Scale 200,000 tokens για $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 server της 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 ανά προϊόν. Ένα προϊόν που ο account manager σας έχει κλείσει για τον λογαριασμό σας παραμένει κλειστό και με 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.