国際輸送の見積もりと貨物追跡のためのMCPサーバー
この記事の内容
物流向けMCPサーバーができること
物流向けのMCPサーバーは、運賃見積もりと貨物追跡を型付きツールとして公開します。これにより、人が運賃ポータルを開く代わりに、アシスタントが見積もりや配送状況を直接問い合わせられます。MCP(Model Context Protocol)はインターフェース層です。Claude、ChatGPT、Codex、Cursor、VS Codeなどのクライアントが、サーバーにどんなツールがあり、それぞれがどんな引数を取り、どんな形で答えが返ってくるかを把握する方法を定めています。物流では、「いくらかかるか」と「今どこにあるか」という繰り返し発生する2つの作業が、関数呼び出しになります。
この記事では、ツールの種類ごとに期待できること、輸送モードによる見積もりの違い、実際に動くサーバーの接続方法を説明します。例には、公開されているJTLGO Commerce MCPコネクタを使います。中国発ルートの見積もりと貨物追跡に対応したコネクタです。
物流MCPサーバーが公開すべきツール
使いやすいサーバーは小さくまとまっています。クライアントは説明文だけを頼りにツールを選ぶため、曖昧なツール20個よりも、仕様のはっきりした4〜6個のほうが優れています。
横にスクロールするか矢印キーで全列を確認できます。
| ツール | 用途 | 主な入力 | 返り値 |
|---|---|---|---|
| quote_shipping_rates | ルートと費用の見積もり | 重量、仕向け国、長さ、幅、高さ、貨物の種類 | 課金重量と輸送日数の目安を含むルート候補 |
| track_shipment | 荷物や注文の状況確認 | 追跡番号1件、またはそのリスト | 最新のタイムラインと例外の兆候 |
| search_products | 発送する商品を探す | キーワード、プラットフォーム、件数上限 | 識別子付きの候補商品 |
| get_product_detail | 見積もり前に商品を1件確認する | 商品IDまたはURL | 仕様フィールド(公開されていれば重量を含む) |
| human_handoff | 確信度が低いときのエスカレーション | 言語、理由 | 担当者が引き継げるサポート窓口 |
| get_mcp_config | 接続の確認 | なし | コネクタのメタデータとツール一覧 |
最後の2つは見た目以上に重要です。設定ツールがあれば、運賃照会を消費せずにコネクタに到達できることを確認できます。明示的な引き継ぎツールがあれば、答えが本当に不確かなとき、アシスタントは数字をでっち上げる代わりに頼れる先を持てます。
見積もりは輸送モードで異なり、必要な入力も異なる
買い手は「LTL見積もり用のMCPサーバー」「FTL見積もり用のMCPサーバー」と、まるで運賃算出が1つの問題であるかのように検索します。エージェントのプロトコルスタックをひとまとめに扱うのと同じです。しかし実際は違います。輸送モードによって見積もりツールが求めるべき入力が決まり、受け取る情報が少なすぎるツールは、もっともらしいでたらめを返します。
横にスクロールするか矢印キーで全列を確認できます。
| 輸送モード | 価格を決める要素 | 見積もりツールが必須とすべき入力 |
|---|---|---|
| 小口貨物・国際宅配便 | 実重量と容積重量の大きいほう | 重量、3辺すべての寸法、仕向け地、貨物の種類 |
| LTL(トラック混載) | 貨物クラスまたは密度、および付帯サービス | パレット数、寸法、クラスまたは密度、集荷・配達時の付帯サービス |
| FTL(トラック貸切) | 区間(レーン)、車両の種類、日付 | 出発地と到着地、トレーラーの種類、集荷日 |
| 航空貨物 | 容積換算係数で計算した課金重量 | 総重量、寸法、空港の組み合わせ、品目の制限 |
| 海上輸送(LCL・FCL) | 立方メートル、またはコンテナの本数と種類 | 容積またはコンテナの種類、港の組み合わせ、インコタームズ |
実務上の帰結は2つあります。第一に、寸法なしで重量だけを受け付ける見積もりツールは当て推量をしています。ほぼすべての輸送モードで、課金される数値は容積重量に基づくからです。第二に、仕向け国内でのLTL・FTLの運賃算出は、国際輸出の運賃算出とはデータソースが異なります。一方に対応しているサーバーが、もう一方にも自動的に対応しているわけではありません。ワークフローを組む前に、どちらに接続しているのかを確認してください。
JTLGOのコネクタが見積もるのは中国発のルートです。つまり中国からの国際宅配便・航空・海上の選択肢で、課金重量は入力された寸法から計算されます。仕向け国内でのトラック輸送の運賃は算出しません。同じ運賃エンジンはRate and Shipから、同じタイムラインは貨物追跡から、人も利用できます。これは意図的に絞った対応範囲です。エージェントのループの中で気づくより、最初から知っておくほうがよいでしょう。
サーバーに接続する
ホスト型MCPサーバーの実体はURLです。ほとんどのクライアントはそれ以上何も必要とせず、通信方式はHTTP POST上のJSON-RPCです。
{
"mcpServers": {
"jtlgo": {
"url": "https://jtlgo.com/api/mcp"
}
}
}
クライアントに組み込む前に手動で接続を確認するには、initialize呼び出しを送り、続けてツール一覧を取得します。エンドポイントはPOSTと、JSONとイベントストリームの両方の形式を指定したAcceptヘッダーを必須としています。単純なGETは意図的に拒否されます。
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"}'
見積もりの呼び出しも、ほかのツール呼び出しと同じ形です。重量だけでなく寸法も指定してください。
{
"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"
}
}
}
公開アクセスとアカウントアクセス
物流コネクタには一般に2つの階層が必要で、これを混同するのが最もよくある連携ミスです。運賃見積もりや公開の貨物追跡のようなオープンなツールには、守るべきアカウント固有の情報がないため、サインインは不要です。一方、顧客自身の注文、作業項目、サポート履歴を読み取るものにはサインインが必要で、そこでOAuthを使います。
JTLGOはこれを、1つのサーバーに対する2つのURLとして提供しています。6つの公開ツール用のhttps://jtlgo.com/api/mcpと、同じ6つに加えてアカウント単位の4つのツールを使えるhttps://jtlgo.com/api/mcp/accountです。後者では、アカウントデータが実際に求められたときにだけ、クライアントがOAuthフローを開始します。特定の顧客の貨物についてアシスタントに答えさせる必要があるならアカウント用URLを、そうでなければ公開URLを選んでください。両方を設定しても利点はありません。
物流コネクタを信頼する前に確認すること
- ツール呼び出しは実際に上流まで届いているか。
tools/listに応答するサーバーが、正常に動いているとは限りません。一覧の呼び出しは通常、静的なスキーマから返されます。実際のツールを呼び出してください。 - 見積もりツールは寸法を必須にしているか。重量だけで受け付けるなら、軽くてかさばるもの、つまり一般消費財の大半では結果が誤ったものになります。
- 追跡は「まだデータがない」と「見つからない」を区別しているか。顧客にとって両者の意味は異なります。この2つをまとめてしまうコネクタでは、アシスタントが自信たっぷりに誤った安心材料を伝えてしまいます。
- 明示的なエスカレーション経路があるか。運賃エンジンは、制限品や珍しい区間に対しては何も返しません。正しい振る舞いは、推測で補うことではなく人に引き継ぐことです。
- 対応範囲が明記されているか。発送地域、対応する輸送モード、そして仕向け国内のトラック運賃に対応しているかどうか。
よくある質問
物流向けMCPサーバーとは何ですか?
運賃見積もりと貨物追跡を、Model Context Protocol経由で呼び出せるツールとして公開するサービスです。人が運賃ポータルを使う代わりに、AIアシスタントが見積もりや状況を直接問い合わせられます。
MCPサーバーでLTLやFTLの運賃を見積もれますか?
それらのモードに対応した運送会社の運賃エンジンに接続し、正しい入力を必須にしていれば可能です。必要な入力は、LTLならパレット数・寸法・貨物クラス、FTLなら区間・車両の種類・集荷日です。JTLGOを含む多くの物流コネクタは、仕向け国内のトラック輸送ではなく国際輸出のモードを対象としているので、頼る前に対応範囲を確認してください。
物流MCPサーバーを使うのにAPIキーは必要ですか?
公開の運賃見積もりと追跡なら、通常は不要です。特定の顧客アカウントを読み取るものには必要です。その場合は、設定ファイルにキーを貼り付けるのではなく、クライアントが開始するOAuthフローであるべきです。
どのMCPクライアントで使えますか?
ホスト型HTTPサーバーに対応したクライアントなら利用できます。現時点ではClaude、ChatGPT、Codex、Cursor、VS Codeが含まれます。コネクタの実体はURLで、通信はクライアントが処理します。
エンドポイントがGETリクエストを拒否するのはなぜですか?
MCPのHTTPトランスポートが、POST上のJSON-RPCだからです。メタデータを返すGETは、文書化されていない2つ目のインターフェースになってしまいます。そのため非公式にサポートするのではなく、405で拒否しています。
出典と参考資料
- Model Context Protocol specification Model Context Protocol
- JTLGO Commerce MCP connector JTL Global