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
შეტყობინებები და webhook-ებიუფასო

ხელსაწყო, რომელიც რამდენიმე ნომერს იღებს, თითო უნიკალურ გაგზავნილ ნომერზე ერთხელ იხდის. ჯავშანი ან კონოსამენტი ერთი ჩამოწერაა მისი ყველა კონტეინერისთვის. ცარიელი შედეგი უფასოა, უარყოფილ გამოძახებაზე კი არაფერი ჩამოიწერება. პაკეტები და ფასები ფასების გვერდზეა.

როცა ბალანსი არ ყოფნის

გამოძახება უარყოფილია, არაფერი ჩამოიწერება და მონაცემები არ ბრუნდება. კოდი პროდუქტზეა დამოკიდებული:

პროდუქტიუარი
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-ის მიხედვით დაატოტეთ, ველები კი წაიკითხეთ, როცა ისინი არსებობს. Navo-ს ყველა MCP სერვერი მათ ერთსა და იმავე წინადადებად აქცევს, რომელიც მომხმარებელს შეგიძლიათ უცვლელად აჩვენოთ: “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-ში.