Démarrage rapide MCP

Le Model Context Protocol permet à un assistant d’appeler des outils directement. Navo24 propose un serveur MCP logistique par produit : un modèle peut suivre un conteneur, comparer des départs ou planifier un chargement sans que vous écriviez de code d’intégration.

Les serveurs

Produit	Serveur	Endpoint	Transport
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

Sur AirCargoMCP, resolve_awb_prefix répond sans clé ; track_awb et air_rate_quote nécessitent votre clé de la famille tmcp_.

Claude Desktop et Cursor

Ajoutez un serveur à la configuration de votre client. Pour un serveur Streamable HTTP, indiquez l’endpoint et votre clé dans un en-tête bearer.

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

Un client qui n’exécute que des commandes locales accède à n’importe lequel de ces serveurs via mcp-remote. Pour le fret aérien :

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

Redémarrez le client et les outils apparaissent. Demandez-lui de suivre un conteneur : il appelle get_container_detail de lui-même.

Ce que le modèle peut appeler

Chaque serveur expose les mêmes fonctions que l’API REST, sous forme d’outils. Tracking propose add_container, get_container_detail, get_shipment_summary et d’autres. Schedules propose find_best_sailings, carrier_reliability et port_congestion. La liste complète des outils figure sur la page de référence de chaque produit.

Même clé, mêmes données

Un appel d’outil MCP et un appel REST atteignent le même backend avec la même clé. Utilisez MCP quand un modèle pilote le travail, et REST quand c’est votre propre code.

Navo Tokens

Sur un compte qui dispose de Navo Tokens, un solde prépayé unique partagé entre les produits Navo, les appels MCP sont payés sur ce solde. Les champs JSON qui décrivent le solde conservent leurs noms credits_.

Un seul solde ouvre tous les services Navo via MCP : TrackingMCP, AirCargoMCP, FreightRatesMCP, SchedulesMCP et LoadingMCP. Vous n’avez pas besoin d’un accès MCP distinct pour chaque produit. Deux choses bloquent encore un appel : un produit que votre account manager a fermé pour votre compte, et une clé dont la portée exclut un produit (voir Accès par produit ci-dessous).

L’usage MCP et l’usage API sont comptabilisés séparément. Un appel MCP ne consomme jamais la limite mensuelle d’appels d’une clé API, et un appel REST avec votre clé API ne consomme jamais de Navo Tokens.

Appel	Tokens
Suivre un nouveau conteneur, connaissement ou booking	250
Actualiser ou consulter une expédition suivie	10 par référence
Suivre une nouvelle lettre de transport aérien	200
Actualiser une lettre de transport aérien	10
Tarifs de fret pour une paire de ports	100, ou 10 si la paire est redemandée sous 24 heures
Horaires de départ pour une paire de ports	80, ou 10 si la paire est redemandée sous 24 heures
Un nouveau plan de chargement 3D	50, ou 10 par recalcul
Congestion portuaire	10
Fiabilité des horaires, départs d’un transporteur	10
Alertes et webhooks	gratuit

Un outil qui accepte plusieurs références facture une fois par référence unique soumise. Un booking ou un connaissement donne lieu à un seul prélèvement pour l’ensemble de ses conteneurs. Un résultat vide est gratuit, et un appel refusé ne coûte rien. Les packs et les prix figurent sur la page des tarifs.

Quand le solde est insuffisant

L’appel est refusé, rien n’est facturé et aucune donnée n’est renvoyée. Le code dépend du produit :

Produit	Refus
TrackingMCP	402 INSUFFICIENT_CREDITS
AirCargoMCP	402 avec le code insufficient_balance (ou trial_expired, wallet_inactive, no_wallet)
FreightRatesMCP	402 avec le code insufficient_credits (ou trial_expired, wallet_inactive, no_wallet)
SchedulesMCP	429 QUOTA_EXCEEDED avant toute lecture de données, ou 402 INSUFFICIENT_CREDITS lorsque le solde ne suffisait plus une fois la réponse prête
LoadingMCP	402 INSUFFICIENT_CREDITS, refusé avant le calcul du plan

Sur tous les produits, en plus de code et message, l’objet error contient les mêmes quatre champs facultatifs :

Champ	Type	Contenu
credits_required	entier ou null	Les tokens nécessaires à cet appel ; null quand le prix n’est pas connu.
credits_balance	entier ou null	Les tokens actuellement disponibles sur votre solde ; null quand le compte n’a pas encore de solde.
top_up_url	chaîne ou null	La page Billing des paramètres de votre compte, où vous achetez des tokens ; null quand aucun lien ne peut être fourni.
packages	tableau de { plan, credits, usd }	Les packs disponibles à l’achat : Starter, 7 000 tokens pour $69 ; Growth, 40 000 tokens pour $349 ; Scale, 200 000 tokens pour $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 }
    ]
  }
}

Ces champs sont additionnels et facultatifs : continuez à vous baser sur code et lisez-les lorsqu’ils sont présents. Chaque serveur MCP de Navo les transforme en une même phrase que vous pouvez afficher telle quelle à l’utilisateur : “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 page de référence de chaque produit donne les détails dans la section Navo Tokens.

Accès par produit

Les Navo Tokens ne nécessitent aucun accès MCP par produit. Un produit que votre account manager a fermé pour votre compte reste aussi fermé avec les Navo Tokens, par exemple “Ship Schedules is not enabled for MCP on this account. Ask your account manager.” sur SchedulesMCP. Une clé dont la portée exclut un produit est refusée avec 403, par exemple “Ship Schedules is not enabled for this API key.” sur SchedulesMCP et “Freight Rates is not enabled for this API key. Contact your account manager to open it.” sur FreightRatesMCP.