Chuyển đến nội dung chính
Quay lại tất cả bài viết

MCP server cho báo giá cước vận chuyển và theo dõi vận đơn

Đăng ngày 16 thg 9, 2026 Cập nhật 17 thg 9, 2026
Trách nhiệm biên tập JTLGO Editorial Team
Rà soát vận hành JTLGO Sourcing Operations Review 16 thg 9, 2026
Chính sách biên tập
Trong bài viết này
  1. MCP server cho logistics làm gì
  2. Các công cụ một MCP server vận chuyển nên cung cấp
  3. Báo giá khác nhau theo phương thức, và đầu vào cũng khác theo
  4. Kết nối một server
  5. Truy cập công khai và truy cập theo tài khoản
  6. Cần kiểm tra gì trước khi tin một connector vận chuyển
  7. Câu hỏi thường gặp
MCP server cho báo giá cước vận chuyển và theo dõi vận đơn

MCP server cho logistics làm gì

MCP server cho vận chuyển đưa chức năng báo giá cước và theo dõi vận đơn thành các công cụ có kiểu dữ liệu rõ ràng, để trợ lý AI có thể trực tiếp hỏi giá hay trạng thái lô hàng thay vì một người phải mở cổng tra cước. MCP, tức Model Context Protocol, là lớp giao diện: nó quy định cách một client như Claude, ChatGPT, Codex, Cursor hay VS Code khám phá server có những công cụ nào, mỗi công cụ nhận tham số gì, và kết quả trả về có dạng ra sao. Với logistics, điều đó biến hai việc lặp đi lặp lại, "hết bao nhiêu tiền" và "hàng đang ở đâu", thành các lệnh gọi hàm.

Phần còn lại của bài viết trình bày những gì nên kỳ vọng ở từng loại công cụ, báo giá khác nhau thế nào giữa các phương thức vận chuyển, và cách kết nối một server đang hoạt động. Các ví dụ dùng JTLGO Commerce MCP connector công khai, có chức năng báo giá các tuyến xuất phát từ Trung Quốc và theo dõi vận đơn.

Các công cụ một MCP server vận chuyển nên cung cấp

Một server hữu ích thì nhỏ gọn. Bốn đến sáu công cụ được mô tả kỹ tốt hơn hai mươi công cụ mơ hồ, vì client phải chọn giữa chúng chỉ dựa vào phần mô tả.

Công cụDùng đểĐầu vào thường gặpTrả về
quote_shipping_ratesƯớc tính tuyến và chi phítrọng lượng, quốc gia đến, dài, rộng, cao, loại hàngCác phương án tuyến kèm trọng lượng tính cước và thời gian vận chuyển dự kiến
track_shipmentTrạng thái của kiện hàng hoặc đơn hàngmột mã vận đơn hoặc một danh sáchCác sự kiện mới nhất trên hành trình và gợi ý khi có bất thường
search_productsTìm món hàng sẽ được vận chuyểntừ khóa, nền tảng, giới hạn số kết quảCác mặt hàng ứng viên kèm mã định danh
get_product_detailXác nhận một mặt hàng trước khi báo giámã sản phẩm hoặc URLCác trường thông số, gồm cả trọng lượng nếu có công bố
human_handoffChuyển cho người khi độ tin cậy thấpngôn ngữ, lý doMột kênh hỗ trợ để người thật tiếp nhận
get_mcp_configKiểm tra kết nốikhông cóSiêu dữ liệu của connector và danh sách công cụ

Hai công cụ cuối quan trọng hơn vẻ ngoài của chúng. Công cụ cấu hình cho bạn cách chứng minh connector truy cập được mà không tốn một lượt tra cước, còn công cụ chuyển cho người cho trợ lý AI một lối đi khi câu trả lời thực sự không chắc chắn, thay vì bịa ra một con số.

Báo giá khác nhau theo phương thức, và đầu vào cũng khác theo

Người mua tìm kiếm "MCP server báo giá LTL" và "MCP server báo giá FTL" như thể báo giá cước chỉ là một bài toán, giống như cách họ coi chồng giao thức agent là một thứ duy nhất. Thực tế không phải vậy. Phương thức vận chuyển quyết định công cụ báo giá phải đòi những đầu vào nào, và một công cụ nhận quá ít thông tin sẽ cho ra những con số vô nghĩa nhưng trông rất tự tin.

Phương thứcYếu tố quyết định giáĐầu vào công cụ báo giá bắt buộc phải có
Hàng kiện và chuyển phát nhanhGiá trị lớn hơn giữa trọng lượng thực và trọng lượng thể tíchTrọng lượng, đủ ba kích thước, nơi đến, loại hàng
LTL, hàng lẻ không đủ một xe tảiHạng cước hoặc mật độ hàng, cộng các phụ phí dịch vụSố pallet, kích thước, hạng cước hoặc mật độ, phụ phí khi lấy và giao hàng
FTL, nguyên xe tảiTuyến, loại phương tiện và ngày điĐiểm đi và điểm đến, loại rơ-moóc, ngày lấy hàng
Hàng khôngTrọng lượng tính cước theo hệ số quy đổi thể tíchTrọng lượng cả bì, kích thước, cặp sân bay, hạn chế về loại hàng
Đường biển, LCL và FCLSố mét khối, hoặc số lượng và loại containerThể tích hoặc loại container, cặp cảng, điều kiện Incoterm

Có hai hệ quả thực tế. Thứ nhất, bất kỳ công cụ báo giá nào nhận trọng lượng mà không cần kích thước đều đang đoán, vì với hầu hết mọi phương thức, con số tính cước là trọng lượng thể tích. Thứ hai, báo giá LTL và FTL nội địa tại nước đến là một nguồn dữ liệu khác với báo giá xuất khẩu quốc tế; server làm được việc này không mặc nhiên làm được việc kia. Hãy kiểm tra mình đang kết nối với loại nào trước khi xây dựng quy trình trên nó.

Connector của JTLGO báo giá các tuyến xuất phát từ Trung Quốc, nghĩa là các phương án chuyển phát nhanh, hàng không và đường biển đi từ Trung Quốc, với trọng lượng tính cước được tính từ kích thước bạn cung cấp. Nó không báo giá vận chuyển xe tải nội địa tại nước đến. Cùng công cụ tính cước đó cũng được cung cấp cho người dùng qua Rate and Ship, và cùng dòng thời gian hành trình qua theo dõi vận đơn. Đó là phạm vi được giới hạn có chủ đích, và tốt hơn hết là biết điều đó từ đầu thay vì phát hiện ra giữa vòng lặp của agent.

Kết nối một server

Một MCP server được lưu trữ sẵn chỉ là một URL. Phần lớn client không cần gì thêm, và giao thức truyền tải là JSON-RPC qua HTTP POST.

{
  "mcpServers": {
    "jtlgo": {
      "url": "https://jtlgo.com/api/mcp"
    }
  }
}

Để kiểm tra kết nối thủ công trước khi gắn vào client, hãy gửi lệnh initialize, rồi liệt kê các công cụ. Endpoint yêu cầu POST và header Accept ghi cả JSON lẫn kiểu event-stream; một yêu cầu GET thông thường sẽ bị từ chối có chủ đích.

curl -X POST https://jtlgo.com/api/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Một lệnh gọi báo giá trông giống mọi lệnh gọi công cụ khác. Hãy cung cấp kích thước, không chỉ trọng lượng.

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "quote_shipping_rates",
    "arguments": {
      "weight": 12,
      "countryCode": "US",
      "length": 40,
      "width": 30,
      "height": 25,
      "goodsType": "general"
    }
  }
}

Truy cập công khai và truy cập theo tài khoản

Connector vận chuyển thường cần hai cấp truy cập, và nhập nhằng giữa hai cấp là lỗi tích hợp phổ biến nhất. Các công cụ mở như báo giá cước và tra cứu vận đơn công khai không cần đăng nhập, vì không có gì thuộc riêng tài khoản cần bảo vệ. Bất cứ thứ gì đọc đơn hàng, công việc hay lịch sử hỗ trợ của chính khách hàng thì cần, và đó là nơi dành cho OAuth.

JTLGO cung cấp điều này dưới dạng hai URL trên cùng một server: https://jtlgo.com/api/mcp cho sáu công cụ công khai, và https://jtlgo.com/api/mcp/account cho cùng sáu công cụ đó cộng thêm bốn công cụ theo phạm vi tài khoản, trong đó client chỉ khởi động luồng OAuth khi thực sự cần dữ liệu tài khoản. Chọn URL tài khoản khi trợ lý AI cần trả lời câu hỏi về lô hàng của một khách hàng cụ thể, và URL công khai khi không cần. Cấu hình cả hai không mang lại lợi ích gì.

Cần kiểm tra gì trước khi tin một connector vận chuyển

  • Lệnh gọi công cụ có thực sự tới được hệ thống phía sau không? Một server trả lời được tools/list chưa chắc đã hoạt động. Lệnh liệt kê thường được trả về từ một schema tĩnh. Hãy gọi một công cụ thật.
  • Công cụ báo giá có bắt buộc kích thước không? Nếu nó chỉ cần trọng lượng, kết quả sẽ sai với mọi món hàng nhẹ mà cồng kềnh, tức là phần lớn hàng tiêu dùng.
  • Tính năng theo dõi có phân biệt "chưa có dữ liệu" với "không tìm thấy" không? Hai điều này có ý nghĩa khác nhau với khách hàng, và một connector gộp chúng làm một sẽ khiến trợ lý AI trấn an khách một cách tự tin nhưng sai.
  • Có lối chuyển tiếp rõ ràng cho con người không? Công cụ tính cước không trả về gì với hàng hạn chế và các tuyến bất thường. Cách xử lý đúng là chuyển cho người, không phải ngoại suy.
  • Phạm vi có được nêu rõ ràng không? Khu vực xuất phát, các phương thức được hỗ trợ, và có bao gồm báo giá xe tải nội địa hay không.

Câu hỏi thường gặp

MCP server cho vận chuyển là gì?

Là một dịch vụ cung cấp chức năng báo giá cước và theo dõi vận đơn dưới dạng công cụ gọi được qua Model Context Protocol, để trợ lý AI có thể trực tiếp yêu cầu báo giá hay trạng thái thay vì một người phải dùng cổng tra cước.

MCP server có báo giá cước LTL và FTL được không?

Được, nếu nó kết nối với công cụ tính cước của hãng vận chuyển cho các phương thức đó và bắt buộc đúng đầu vào: số pallet, kích thước và hạng cước với LTL; tuyến, loại phương tiện và ngày lấy hàng với FTL. Nhiều connector logistics, kể cả của JTLGO, hỗ trợ các phương thức xuất khẩu quốc tế chứ không phải xe tải nội địa, vì vậy hãy xác nhận phạm vi trước khi dựa vào nó.

Tôi có cần API key để dùng MCP server logistics không?

Với báo giá cước và tra cứu vận đơn công khai, thường là không. Với bất cứ thứ gì đọc tài khoản của một khách hàng cụ thể thì có, và đó nên là luồng OAuth do client khởi động thay vì một key dán vào file cấu hình.

Những MCP client nào dùng được?

Bất kỳ client nào hỗ trợ server HTTP được lưu trữ sẵn, hiện bao gồm Claude, ChatGPT, Codex, Cursor và VS Code. Connector chỉ là một URL; client lo phần truyền tải.

Vì sao endpoint từ chối yêu cầu GET?

Vì giao thức truyền tải HTTP của MCP là JSON-RPC qua POST. Một yêu cầu GET trả về siêu dữ liệu sẽ là giao diện thứ hai không được tài liệu hóa, nên nó bị từ chối với mã 405 thay vì được hỗ trợ một cách không chính thức.

Nguồn và tài liệu tham khảo

Chia sẻ bài viết: