MCP server cho báo giá cước vận chuyển và theo dõi vận đơn
Trong bài viết này
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ả.
Cuộn ngang hoặc dùng phím mũi tên để xem tất cả các cột.
| Công cụ | Dùng để | Đầu vào thường gặp | Trả 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àng | Cá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_shipment | Trạng thái của kiện hàng hoặc đơn hàng | một mã vận đơn hoặc một danh sách | Các sự kiện mới nhất trên hành trình và gợi ý khi có bất thường |
| search_products | Tìm món hàng sẽ được vận chuyển | từ 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_detail | Xác nhận một mặt hàng trước khi báo giá | mã sản phẩm hoặc URL | Các trường thông số, gồm cả trọng lượng nếu có công bố |
| human_handoff | Chuyển cho người khi độ tin cậy thấp | ngôn ngữ, lý do | Một kênh hỗ trợ để người thật tiếp nhận |
| get_mcp_config | Kiểm tra kết nối | khô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.
Cuộn ngang hoặc dùng phím mũi tên để xem tất cả các cột.
| Phương thức | Yế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 nhanh | Giá trị lớn hơn giữa trọng lượng thực và trọng lượng thể tích | Trọ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ải | Hạ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ải | Tuyế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ông | Trọng lượng tính cước theo hệ số quy đổi thể tích | Trọ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à FCL | Số mét khối, hoặc số lượng và loại container | Thể 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/listchư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
- Model Context Protocol specification Model Context Protocol
- JTLGO Commerce MCP connector JTL Global