Motive MCP mit Claude verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Motive klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Motive + Claude

Lass deine KI deine Motive-Flotte lesen: wo jeder Lkw und jeder Fahrer gerade ist, Hours-of-Service-Uhren und -Verstöße, Inspektionsberichte, Sicherheitsereignisse, Fehlercodes, IFTA-Meilen und Tankvorgänge. Nur lesend, mit einem Company API Key.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

MOTIVE_API_KEY

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 3 Minuten. Du brauchst eine Admin-Rolle in Motive (früher KeepTruckin), um im Motive-Dashboard einen Company API Key anzulegen.

1. Öffne im Motive-Dashboard Admin → Developers → API Access und leg einen Company API Key an. Gib ihm Lesezugriff (read) und die Scopes für die Daten, die die KI sehen soll: Fahrzeuge, Standorte, Benutzer, HOS, IFTA, Kraftstoff, Inspektionen, Sicherheitsereignisse, Fehlercodes, Assets und Gruppen. Ein Key lässt sich auch auf einzelne Gruppen beschränken; die KI sieht dann nur diese.
2. Kopiere den Key aus dem Dialog, denn der vollständige Key wird nur einmal angezeigt, und füg ihn in MOTIVE_API_KEY ein: nur den Key, ohne Leerzeichen und ohne einen Header-Namen wie X-Api-Key. AnythingMCP sendet ihn als Header X-Api-Key.
3. Installiere den Connector und prüfe die Verbindung mit motive_list_vehicles.

Cloud und Self-Hosting funktionieren gleich: Der API Key ist die einzige Einstellung.

Keys laufen ab und lassen sich nicht bearbeiten: Ein Key läuft nach dem Zeitplan ab, der beim Anlegen gewählt wurde, und Motive warnt die Admins eine Woche vorher. Seine Scopes lassen sich später nicht ändern: Für weitere Daten legst du einen neuen Key an und fügst ihn in MOTIVE_API_KEY ein.

IDs: Fahrzeuge, Benutzer und Assets haben numerische Motive-IDs. Die Fahrzeugnummer, die ein Disponent nutzt („Truck 12“), ist das Feld number des Fahrzeugs; motive_lookup_vehicle macht daraus eine ID. Fahrer sind Benutzer mit der Rolle driver.

Datum, Zeitzonen und Einheiten: Datumsfilter sind YYYY-MM-DD, und die meisten Berichte umfassen standardmäßig die letzten 7 Tage; updated_after nimmt einen ISO-8601-Zeitstempel. Bei den meisten Tools kann die KI die Zeitzone der Zeitstempel wählen (gesendet als X-Time-Zone, zum Beispiel America/New_York) sowie metrische oder imperiale Einheiten (gesendet als X-Metric-Units: Kilometer und Liter oder Meilen und Gallonen). Nenn Zeitzone und Einheiten im Prompt, wenn es darauf ankommt. Die Hours-of-Service-Zeiten in motive_list_available_time sind Sekunden.

Seiten: Listen liefern standardmäßig 25 Einträge pro Seite, höchstens 100 (per_page), und blättern mit page_no. Jede Antwort enthält pagination mit per_page, page_no und total; die KI holt die nächste Seite, solange es mehr Einträge gibt, als sie gesehen hat.

Standortverlauf: motive_get_vehicle_location_history liest ein Fahrzeug über höchstens 3 Monate; halte den Zeitraum kurz, damit die Antwort lesbar bleibt. Motive nimmt an diesem Endpoint höchstens 10 gleichzeitige Anfragen an.

Manche Daten brauchen Hardware oder einen Tarif: Sicherheitsereignisse der AI-Dashcam (Handynutzung, Sicherheitsgurt, zu dichtes Auffahren und so weiter), Standorte über das Vehicle Gateway (motive_list_vehicle_gateway_locations; Fahrzeuge mit anderen ELDs liefern ihre Standorte über motive_list_vehicle_locations) und die Standorte von Anhängern mit Asset Gateway.

EU-Konten werden nicht abgedeckt: Der Connector ruft https://api.gomotive.com auf; Konten auf Motives EU-Plattform nutzen einen anderen Host.

Häufige Fehler: Ein 401 heißt, dass Motive den Key abgelehnt hat: Er wurde nicht vollständig kopiert, ist abgelaufen oder widerrufen, oder er wurde mit dem Header-Namen X-Api-Key eingefügt. Ein 403 heißt, dass der Key gültig ist, ihm aber der Scope für diese Daten fehlt: Leg einen neuen Key mit diesem Scope an. Ein 404 heißt, dass es keinen Datensatz mit dieser ID gibt: Nimm die numerische ID, nicht die Fahrzeugnummer oder den Namen des Fahrers. Begrenzt Motive die Anfragen des Keys, warte eine Minute, frag weniger Seiten ab und versuch es dann erneut.

Was der Connector liest: Fahrzeuge mit VIN, Hersteller, Modell, Kennzeichen, Kraftstoffart, ELD-Gerät und Fahrer; den aktuellen Standort jedes Fahrzeugs und Fahrers und die Route eines Fahrzeugs über einen Zeitraum; Fahrer, Fleet User und Admins; Hours-of-Service-Uhren (wer heute noch fahren darf und wie lange), Tagesprotokolle und Verstöße; IFTA-Fahrten und Meilen pro Bundesstaat oder Provinz; Tankvorgänge; Inspektionsberichte (DVIRs) mit ihren Mängeln; Sicherheitsereignisse mit Coaching-Status und Medienlinks; Motorfehlercodes; Fahrtabschnitte, auch Privatfahrten (Personal Conveyance), Rangierfahrten (Yard Moves) und nicht zugeordnete Fahrten; Anhänger und andere Assets mit ihrem letzten Standort; und die Gruppen, in die die Flotte aufgeteilt ist.

Nur lesend: Jedes Tool liest nur, und keines ist bei der Installation deaktiviert. In Motive wird nichts geändert: Anlegen oder Bearbeiten von Fahrzeugen, Benutzern, Gruppen, Geofences, Tankvorgängen oder Inspektionsberichten, Nachrichten an Fahrer, Dispatches und Befehle an die Wegfahrsperre sind nicht enthalten.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Claude hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Empfohlener Weg: funktioniert auf claude.ai web ohne Anfassen einer Konfigurationsdatei.

1. Öffne in Claude Customize → Connectors.
2. Klicke auf + und dann auf Add custom connector.
3. Gib einen Namen ein, z. B. Motive, und die Remote-MCP-Server-URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, dann klicke auf Add.
4. Klicke auf Connect und melde dich bei AnythingMCP an (OAuth), um den Zugriff zu erlauben.

Alle unten gelisteten Tools erscheinen in deinem Chat: Leg los mit Prompts.

Verfügbare Tools

Beispiel-Prompts

• „Wo ist Truck 12 gerade, und wer fährt ihn?“
• „Welche Fahrer dürfen heute noch fahren, und wie lange?“
• „Welche Fahrer hatten letzte Woche starke Bremsungen oder Handy-Ereignisse?“
• „Welche Fahrzeuge haben Inspektionsberichte mit Mängeln oder offene Fehlercodes?“
• „Wie viele Meilen ist jeder Lkw im letzten Quartal pro Bundesstaat gefahren, für die IFTA-Erklärung?“

FAQ

Funktioniert es mit Claude Code genauso wie mit Claude Desktop? Ja, beide auf https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID zeigen lassen.

Nächste Schritte

• Connector-Startseite
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden