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製品間で共有される1つのプリペイド残高）を保有しているアカウントでは、MCP呼び出しの料金はその残高から支払われます。残高を表すJSONフィールドは、引き続き credits_ で始まる名前のままです。

1つの残高で、MCP経由ですべてのNavoサービスを利用できます：TrackingMCP、AirCargoMCP、FreightRatesMCP、SchedulesMCP、LoadingMCP。製品ごとにMCPアクセスを個別に用意する必要はありません。ただし、次の2つの場合は呼び出しが拒否されます。アカウントマネージャーがお客様のアカウントで閉じた製品と、スコープ上その製品が対象外になっているキーです（下記の「製品ごとのアクセス」を参照）。

MCPとAPIの利用量は別々にカウントされます。MCP呼び出しがAPIキーの月間呼び出し上限を消費することはなく、APIキーによるREST呼び出しがNavo Tokensを消費することもありません。

呼び出しTokens
新しいコンテナ、船荷証券、ブッキングの追跡250
追跡中の貨物の更新または読み取り参照番号ごとに10
新しい航空運送状の追跡200
航空運送状の更新10
港の組み合わせの運賃100、24時間以内に同じ組み合わせを再照会する場合は10
港の組み合わせの船便スケジュール80、24時間以内に同じ組み合わせを再照会する場合は10
新しい3D積付計画50、再計算ごとに10
港湾混雑10
スケジュール信頼性、船社の運航便10
アラートとwebhook無料

複数の参照番号を受け付けるツールは、送信した一意の参照番号ごとに1回課金されます。ブッキングや船荷証券は、含まれるすべてのコンテナに対して1回の課金です。結果が空の場合は無料で、拒否された呼び出しには一切課金されません。パッケージと価格は料金ページをご覧ください。

残高が足りない場合

呼び出しは拒否され、課金は行われず、データも返されません。コードは製品によって異なります。

製品拒否
TrackingMCP402 INSUFFICIENT_CREDITS
AirCargoMCP402、コードは insufficient_balance（または trial_expired、wallet_inactive、no_wallet）
FreightRatesMCP402、コードは insufficient_credits（または trial_expired、wallet_inactive、no_wallet）
SchedulesMCPデータを読み取る前に 429 QUOTA_EXCEEDED、または回答の準備ができた時点で残高が足りなくなっていた場合は 402 INSUFFICIENT_CREDITS
LoadingMCP402 INSUFFICIENT_CREDITS、計画を計算する前に拒否

すべての製品で、error オブジェクトには code と message に加えて、同じ4つの任意フィールドが含まれます。

フィールド型内容
credits_requiredinteger または nullこの呼び出しに必要なtokens。価格が不明な場合はnull。
credits_balanceinteger または null現在の残高のtokens。アカウントにまだ残高がない場合はnull。
top_up_urlstring または nullアカウント設定のBillingページで、ここでtokensを追加購入できます。リンクを提供できない場合はnull。
packages{ plan, credits, usd } の配列購入できるパッケージ：Starter 7,000 tokensで$69、Growth 40,000 tokensで$349、Scale 200,000 tokensで$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でも閉じたままです。たとえばSchedulesMCPでは “Ship Schedules is not enabled for MCP on this account. Ask your account manager.” となります。スコープ上その製品が対象外のキーは 403 で拒否されます。たとえばSchedulesMCPでは “Ship Schedules is not enabled for this API key.”、FreightRatesMCPでは “Freight Rates is not enabled for this API key. Contact your account manager to open it.” となります。