Grundlagen
MCP-Schnellstart
Schnellstart für den Logistik-MCP-Server: Claude, Cursor oder einen anderen MCP-Client mit Navo24 verbinden, dann verfolgt das Modell Container selbst.
Mit dem Model Context Protocol ruft ein Assistent Tools direkt auf. Navo24 betreibt für jedes Produkt einen eigenen Logistik-MCP-Server. So kann ein Modell einen Container verfolgen, Abfahrten vergleichen oder eine Ladung planen, ohne dass Sie Verbindungscode schreiben.
Die Server
| Produkt | Server | Endpunkt | 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 |
Bei AirCargoMCP antwortet resolve_awb_prefix ohne Key; track_awb und air_rate_quote benötigen Ihren Key der tmcp_-Familie.
Claude Desktop und Cursor
Tragen Sie einen Server in die Konfiguration Ihres Clients ein. Bei einem Streamable-HTTP-Server übergeben Sie den Endpunkt und Ihren Key als Bearer-Header.
{
"mcpServers": {
"container-tracking": {
"url": "https://mcp.trackingmcp.com/mcp",
"headers": { "Authorization": "Bearer tmcp_YOUR_API_KEY" }
}
}
}Ein Client, der nur lokale Befehle ausführt, erreicht jeden dieser Server über mcp-remote. Für Luftfracht:
{
"mcpServers": {
"air-cargo": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.aircargomcp.com/mcp",
"--header", "Authorization: Bearer tmcp_YOUR_API_KEY"]
}
}
}Starten Sie den Client neu, dann erscheinen die Tools. Bitten Sie ihn, einen Container zu verfolgen, und er ruft get_container_detail von selbst auf.
Was das Modell aufrufen kann
Jeder Server bietet dieselben Funktionen wie die REST-API, nur als Tools benannt. Tracking hat add_container, get_container_detail, get_shipment_summary und weitere. Schedules hat find_best_sailings, carrier_reliability und port_congestion. Die vollständige Tool-Liste steht auf der Referenzseite des jeweiligen Produkts.
Gleicher Key, gleiche Daten
Ein MCP-Tool-Aufruf und ein REST-Aufruf landen im selben Backend, mit demselben Key. Nehmen Sie MCP, wenn ein Modell die Arbeit steuert, und REST, wenn es Ihr eigener Code tut.
Navo Tokens
Hat ein Konto Navo Tokens, also ein gemeinsames Prepaid-Guthaben für alle Navo-Produkte, werden MCP-Aufrufe aus diesem Guthaben bezahlt. Die JSON-Felder, die das Guthaben beschreiben, behalten ihre credits_-Namen.
Ein einziges Guthaben öffnet jeden Navo-Dienst über MCP: TrackingMCP, AirCargoMCP, FreightRatesMCP, SchedulesMCP und LoadingMCP. Sie brauchen keinen separaten MCP-Zugang pro Produkt. Zwei Dinge blockieren einen Aufruf trotzdem: ein Produkt, das Ihr Account Manager für Ihr Konto gesperrt hat, und ein Key, dessen Berechtigung ein Produkt ausschließt (siehe Zugang pro Produkt weiter unten).
MCP- und API-Nutzung werden getrennt gezählt. Ein MCP-Aufruf verbraucht nie das monatliche Aufruflimit eines API-Keys, und ein REST-Aufruf mit Ihrem API-Key verbraucht nie Navo Tokens.
| Aufruf | Tokens |
|---|---|
| Neuen Container, neues Konnossement oder neue Buchung verfolgen | 250 |
| Verfolgte Sendung aktualisieren oder abrufen | 10 pro Referenz |
| Neuen Luftfrachtbrief verfolgen | 200 |
| Luftfrachtbrief aktualisieren | 10 |
| Frachtraten für ein Hafenpaar | 100, oder 10 bei Wiederholung des Paars innerhalb von 24 Stunden |
| Fahrpläne für ein Hafenpaar | 80, oder 10 bei Wiederholung des Paars innerhalb von 24 Stunden |
| Neuer 3D-Ladeplan | 50, oder 10 pro Neuberechnung |
| Hafenüberlastung | 10 |
| Fahrplanzuverlässigkeit, Abfahrten einer Reederei | 10 |
| Alerts und Webhooks | kostenlos |
Ein Tool, das mehrere Referenzen annimmt, berechnet einmal pro eindeutiger übermittelter Referenz. Eine Buchung oder ein Konnossement wird einmal für alle zugehörigen Container berechnet. Ein leeres Ergebnis ist kostenlos, und ein abgelehnter Aufruf kostet nichts. Pakete und Preise finden Sie auf der Preisseite.
Wenn das Guthaben nicht reicht
Der Aufruf wird abgelehnt, nichts wird berechnet und es werden keine Daten zurückgegeben. Der Code hängt vom Produkt ab:
| Produkt | Ablehnung |
|---|---|
| TrackingMCP | 402 INSUFFICIENT_CREDITS |
| AirCargoMCP | 402 mit dem Code insufficient_balance (oder trial_expired, wallet_inactive, no_wallet) |
| FreightRatesMCP | 402 mit dem Code insufficient_credits (oder trial_expired, wallet_inactive, no_wallet) |
| SchedulesMCP | 429 QUOTA_EXCEEDED, bevor Daten gelesen werden, oder 402 INSUFFICIENT_CREDITS, wenn das Guthaben nicht mehr reichte, als die Antwort fertig war |
| LoadingMCP | 402 INSUFFICIENT_CREDITS, abgelehnt, bevor der Plan berechnet wird |
Bei jedem Produkt enthält das error-Objekt neben code und message dieselben vier optionalen Felder:
| Feld | Typ | Inhalt |
|---|---|---|
credits_required | Integer oder null | Die Tokens, die dieser Aufruf benötigt; null, wenn der Preis nicht bekannt ist. |
credits_balance | Integer oder null | Die Tokens, die Ihr Guthaben aktuell enthält; null, wenn das Konto noch kein Guthaben hat. |
top_up_url | String oder null | Die Billing-Seite in Ihren Kontoeinstellungen, auf der Sie weitere Tokens kaufen; null, wenn kein Link angegeben werden kann. |
packages | Array aus { plan, credits, usd } | Die Pakete, die Sie kaufen können: Starter mit 7.000 Tokens für $69, Growth mit 40.000 Tokens für $349, Scale mit 200.000 Tokens für $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 }
]
}
}Die Felder sind zusätzlich und optional: Verzweigen Sie weiterhin anhand von code und lesen Sie die Felder, wenn sie vorhanden sind. Jeder Navo-MCP-Server macht daraus denselben Satz, den Sie dem Nutzer unverändert anzeigen können: “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).” Details stehen auf der Referenzseite jedes Produkts im Abschnitt Navo Tokens.
Zugang pro Produkt
Navo Tokens erfordern keinen MCP-Zugang pro Produkt. Ein Produkt, das Ihr Account Manager für Ihr Konto gesperrt hat, bleibt auch mit Navo Tokens gesperrt, zum Beispiel “Ship Schedules is not enabled for MCP on this account. Ask your account manager.” bei SchedulesMCP. Ein Key, dessen Berechtigung ein Produkt ausschließt, wird mit 403 abgelehnt, zum Beispiel “Ship Schedules is not enabled for this API key.” bei SchedulesMCP und “Freight Rates is not enabled for this API key. Contact your account manager to open it.” bei FreightRatesMCP.