Guía rápida de MCP

El Model Context Protocol permite que un asistente llame a herramientas directamente. Navo24 ofrece un servidor MCP logístico por producto, así un modelo puede rastrear un contenedor, comparar salidas o planificar una carga sin que usted escriba código de integración.

Los servidores

Producto	Servidor	Endpoint	Transporte
TrackingMCP	container-tracking	https://mcp.trackingmcp.com/mcp	Streamable HTTP
SchedulesMCP	ocean-schedules	https://mcp.schedulesmcp.com/mcp	Streamable HTTP
LoadingMCP	container-loading	https://mcp.loadingmcp.com/mcp	Streamable HTTP
AirCargoMCP	air-cargo	https://mcp.aircargomcp.com/mcp	Streamable HTTP
FreightRatesMCP	freight-rates	https://mcp.freightratesmcp.com/mcp	Streamable HTTP

En AirCargoMCP, resolve_awb_prefix responde sin clave; track_awb y air_rate_quote necesitan su clave de la familia tmcp_.

Claude Desktop y Cursor

Añada un servidor a la configuración de su cliente. Para un servidor Streamable HTTP, indique el endpoint y su clave como cabecera bearer.

{
  "mcpServers": {
    "container-tracking": {
      "url": "https://mcp.trackingmcp.com/mcp",
      "headers": { "Authorization": "Bearer tmcp_YOUR_API_KEY" }
    }
  }
}

Un cliente que solo ejecuta comandos locales llega a cualquiera de estos servidores a través de mcp-remote. Para carga aérea:

{
  "mcpServers": {
    "air-cargo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.aircargomcp.com/mcp",
               "--header", "Authorization: Bearer tmcp_YOUR_API_KEY"]
    }
  }
}

Reinicie el cliente y aparecerán las herramientas. Pídale que rastree un contenedor y llamará a get_container_detail por su cuenta.

Qué puede llamar el modelo

Cada servidor expone las mismas funciones que la API REST, en forma de herramientas. Tracking ofrece add_container, get_container_detail, get_shipment_summary y más. Schedules ofrece find_best_sailings, carrier_reliability y port_congestion. La lista completa de herramientas está en la página de referencia de cada producto.

La misma clave, los mismos datos

Una llamada a una herramienta MCP y una llamada REST llegan al mismo backend con la misma clave. Use MCP cuando el trabajo lo dirige un modelo y REST cuando lo hace su propio código.

Navo Tokens

En una cuenta que dispone de Navo Tokens, un único saldo prepago compartido por los productos de Navo, las llamadas MCP se pagan con ese saldo. Los campos JSON que describen el saldo conservan sus nombres credits_.

Un solo saldo da acceso a todos los servicios de Navo a través de MCP: TrackingMCP, AirCargoMCP, FreightRatesMCP, SchedulesMCP y LoadingMCP. No necesita un acceso MCP independiente para cada producto. Hay dos cosas que siguen bloqueando una llamada: un producto que su gestor de cuenta ha cerrado para su cuenta y una clave cuyo alcance excluye un producto (consulte Acceso por producto más abajo).

El uso de MCP y el de la API se contabilizan por separado. Una llamada MCP nunca consume el límite mensual de llamadas de una clave de API, y una llamada REST con su clave de API nunca consume Navo Tokens.

Llamada	Tokens
Rastrear un nuevo contenedor, conocimiento de embarque o booking	250
Actualizar o consultar un envío rastreado	10 por referencia
Rastrear una nueva guía aérea	200
Actualizar una guía aérea	10
Tarifas de flete para un par de puertos	100, o 10 si repite el par en un plazo de 24 horas
Itinerarios de salidas para un par de puertos	80, o 10 si repite el par en un plazo de 24 horas
Un nuevo plan de carga 3D	50, o 10 por cada recálculo
Congestión portuaria	10
Fiabilidad de itinerarios, salidas de una naviera	10
Alertas y webhooks	gratis

Una herramienta que admite varias referencias cobra una vez por cada referencia única enviada. Un booking o un conocimiento de embarque es un único cargo para todos sus contenedores. Un resultado vacío es gratuito y una llamada rechazada no cobra nada. Los paquetes y precios están en la página de precios.

Cuando el saldo no alcanza

La llamada se rechaza, no se cobra nada y no se devuelven datos. El código depende del producto:

Producto	Rechazo
TrackingMCP	402 INSUFFICIENT_CREDITS
AirCargoMCP	402 con el código insufficient_balance (o trial_expired, wallet_inactive, no_wallet)
FreightRatesMCP	402 con el código insufficient_credits (o trial_expired, wallet_inactive, no_wallet)
SchedulesMCP	429 QUOTA_EXCEEDED antes de leer ningún dato, o 402 INSUFFICIENT_CREDITS cuando el saldo ya no podía pagar una vez lista la respuesta
LoadingMCP	402 INSUFFICIENT_CREDITS, rechazado antes de calcular el plan

En todos los productos, además de code y message, el objeto error incluye los mismos cuatro campos opcionales:

Campo	Tipo	Qué contiene
credits_required	entero o null	Los tokens que necesita esta llamada; null cuando no se conoce el precio.
credits_balance	entero o null	Los tokens que tiene ahora su saldo; null cuando la cuenta aún no tiene saldo.
top_up_url	cadena o null	La página de facturación (Billing) de la configuración de su cuenta, donde se compran más tokens; null cuando no se puede ofrecer un enlace.
packages	array de { plan, credits, usd }	Los paquetes que puede comprar: Starter, 7.000 tokens por $69; Growth, 40.000 tokens por $349; Scale, 200.000 tokens por $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 }
    ]
  }
}

Los campos son adicionales y opcionales: siga basando la lógica en code y léalos cuando estén presentes. Todos los servidores MCP de Navo los convierten en la misma frase, que puede mostrar al usuario tal cual: “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).” La página de referencia de cada producto tiene los detalles en el apartado Navo Tokens.

Acceso por producto

Navo Tokens no requiere acceso MCP por producto. Un producto que su gestor de cuenta ha cerrado para su cuenta sigue cerrado también con Navo Tokens, por ejemplo “Ship Schedules is not enabled for MCP on this account. Ask your account manager.” en SchedulesMCP. Una clave cuyo alcance excluye un producto se rechaza con 403, por ejemplo “Ship Schedules is not enabled for this API key.” en SchedulesMCP y “Freight Rates is not enabled for this API key. Contact your account manager to open it.” en FreightRatesMCP.