เริ่มต้นใช้ MCP server ด้านโลจิสติกส์กับ Claude, Cursor

เริ่มต้นใช้ MCP server ด้านโลจิสติกส์: เชื่อม Claude, Cursor หรือ MCP client ใดก็ได้กับ Navo24 แล้วให้โมเดลติดตามตู้และเทียบเที่ยวเรือเอง

Model Context Protocol ช่วยให้ผู้ช่วย AI เรียกใช้เครื่องมือได้โดยตรง Navo24 มี MCP server ด้านโลจิสติกส์แยกตามผลิตภัณฑ์ โมเดลจึงติดตามตู้คอนเทนเนอร์ เปรียบเทียบเที่ยวเรือ หรือวางแผนการบรรทุกได้ โดยคุณไม่ต้องเขียนโค้ดเชื่อมต่อ

รายการ server

ผลิตภัณฑ์	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 และคีย์ของคุณเป็น header แบบ bearer

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

client ที่รันได้เฉพาะคำสั่งในเครื่องสามารถเข้าถึง server เหล่านี้ได้ทุกตัวผ่าน 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_ เหมือนเดิม

ยอดคงเหลือเดียวเปิดใช้บริการ Navo ทั้งหมดผ่าน MCP ได้แก่ TrackingMCP, AirCargoMCP, FreightRatesMCP, SchedulesMCP และ LoadingMCP คุณไม่ต้องขอสิทธิ์ MCP แยกสำหรับแต่ละผลิตภัณฑ์ แต่ยังมีสองกรณีที่ทำให้การเรียกถูกหยุด คือ ผลิตภัณฑ์ที่ผู้จัดการบัญชีปิดไว้สำหรับบัญชีของคุณ และคีย์ที่กำหนดขอบเขตไม่ให้ใช้ผลิตภัณฑ์นั้น (ดูหัวข้อสิทธิ์การเข้าถึงรายผลิตภัณฑ์ด้านล่าง)

การใช้งาน MCP และ API นับแยกกัน การเรียก MCP จะไม่กินโควตาการเรียกรายเดือนของ API key และการเรียก REST ด้วย API key ของคุณจะไม่ใช้ Navo Tokens

การเรียก	Token
ติดตามตู้คอนเทนเนอร์ ใบตราส่ง (bill of lading) หรือ booking ใหม่	250
รีเฟรชหรืออ่านข้อมูลการขนส่งที่ติดตามอยู่	10 ต่อหมายเลขอ้างอิง
ติดตามใบตราส่งทางอากาศ (air waybill) ใหม่	200
รีเฟรชใบตราส่งทางอากาศ	10
ค่าระวางสำหรับคู่ท่าเรือ	100 หรือ 10 หากเรียกคู่เดิมซ้ำภายใน 24 ชั่วโมง
ตารางเดินเรือสำหรับคู่ท่าเรือ	80 หรือ 10 หากเรียกคู่เดิมซ้ำภายใน 24 ชั่วโมง
แผนการบรรทุกแบบ 3D ใหม่	50 หรือ 10 ต่อการคำนวณใหม่แต่ละครั้ง
ความแออัดของท่าเรือ	10
ความตรงต่อเวลาของตาราง เที่ยวเรือของสายเรือ	10
การแจ้งเตือนและ webhook	ฟรี

เครื่องมือที่รับหมายเลขอ้างอิงหลายรายการจะคิดค่าใช้จ่ายครั้งเดียวต่อหมายเลขอ้างอิงที่ไม่ซ้ำกันที่คุณส่งมา booking หรือใบตราส่งหนึ่งรายการคิดเพียงครั้งเดียวสำหรับตู้คอนเทนเนอร์ทั้งหมดในนั้น ผลลัพธ์ว่างไม่มีค่าใช้จ่าย และการเรียกที่ถูกปฏิเสธจะไม่ถูกเรียกเก็บใด ๆ แพ็กเกจและราคาดูได้ที่หน้าราคา

เมื่อยอดคงเหลือไม่พอชำระ

การเรียกจะถูกปฏิเสธ ไม่มีการเรียกเก็บเงิน และไม่มีข้อมูลส่งกลับ รหัสที่ได้ขึ้นอยู่กับผลิตภัณฑ์:

ผลิตภัณฑ์	การปฏิเสธ
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	จำนวน token ที่การเรียกนี้ต้องใช้ เป็น null เมื่อไม่ทราบราคา
`credits_balance`	integer หรือ null	จำนวน token ในยอดคงเหลือของคุณตอนนี้ เป็น null เมื่อบัญชียังไม่มียอดคงเหลือ
`top_up_url`	string หรือ null	หน้า Billing ในการตั้งค่าบัญชีของคุณ ซึ่งใช้ซื้อ token เพิ่ม เป็น null เมื่อไม่สามารถให้ลิงก์ได้
`packages`	อาร์เรย์ของ `{ plan, credits, usd }`	แพ็กเกจที่คุณซื้อได้: 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 }
    ]
  }
}

ฟิลด์เหล่านี้เป็นส่วนเพิ่มเติมและไม่บังคับ: ให้แยกเงื่อนไขตาม 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 แยกตามผลิตภัณฑ์ ผลิตภัณฑ์ที่ผู้จัดการบัญชีปิดไว้สำหรับบัญชีของคุณจะยังคงปิดอยู่แม้ใช้ 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