Motive MCP mit Gemini CLI 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 + Gemini

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 Gemini 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.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal) — anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Motive-Tools aufrufen.

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

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden