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 产品共享的一个预付余额），MCP 调用将从该余额中扣费。描述余额的 JSON 字段仍沿用 credits_ 前缀的名称。

一个余额即可通过 MCP 使用所有 Navo 服务：TrackingMCP、AirCargoMCP、FreightRatesMCP、SchedulesMCP 和 LoadingMCP。您无需为每个产品单独开通 MCP 访问权限。仍有两种情况会拒绝调用：客户经理为您的账户关闭了某个产品，或密钥的权限范围不包含该产品（见下文“按产品的访问权限”）。

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免费

接受多个参考号的工具，按您提交的每个唯一参考号计费一次。一个订舱或一份提单，无论包含多少集装箱，都只计费一次。空结果免费，被拒绝的调用不收取任何费用。套餐和价格见价格页面。

余额不足时

调用会被拒绝，不收取任何费用，也不返回任何数据。错误代码因产品而异：

产品拒绝方式
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 外，还带有相同的四个可选字段：

字段类型含义
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.”。