Resumen
Deja que tu IA lea tu flota de Motive: dónde está cada camión y cada conductor, relojes y violaciones de Hours of Service, informes de inspección, eventos de seguridad, códigos de falla, millas IFTA y compras de combustible. Solo lectura, con una API key de empresa.
Configuración guiada
Conecta Motive a Claude, ChatGPT o Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Motive con la configuración guiada y añade tu URL MCP a tu asistente de IA. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para Motive
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Motive, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
Motive
Deja que tu IA lea tu flota de Motive: dónde está cada camión y cada conductor, relojes y violaciones de Hours of Service, informes de inspección, eventos de seguridad, códigos de falla, millas IFTA y compras de combustible. Solo lectura, con una API key de empresa.
Configuración
La configuración lleva unos 3 minutos. Necesitas un rol de administrador en Motive (antes KeepTruckin) para crear una API key de empresa en el panel de Motive.
- En el panel de Motive abre Admin → Developers → API Access y crea una API key de empresa (company API key). Dale acceso de lectura (read) y los scopes de los datos que la IA debe ver: vehículos, ubicaciones, usuarios, HOS, IFTA, combustible, inspecciones, eventos de seguridad, códigos de falla, activos y grupos. Una key también se puede limitar a algunos grupos; la IA solo ve entonces esos.
- Copia la key del diálogo que aparece una sola vez, porque la key completa solo se muestra entonces, y pégala en
MOTIVE_API_KEY: solo la key, sin espacios ni un nombre de cabecera comoX-Api-Key. AnythingMCP la envía como cabeceraX-Api-Key. - Instala el conector y comprueba la conexión con
motive_list_vehicles.
Cloud y self-hosted funcionan igual: la API key es el único ajuste.
Las keys caducan y no se pueden editar: una key caduca según el plazo elegido al crearla, y Motive avisa a los administradores una semana antes. Sus scopes no se pueden cambiar después: para llegar a más datos, crea una key nueva y pégala en MOTIVE_API_KEY.
Ids: vehículos, usuarios y activos tienen ids numéricos de Motive. El número de unidad que usa un despachador ("Truck 12") es el campo number del vehículo; motive_lookup_vehicle lo convierte en un id. Los conductores son usuarios con el rol driver.
Fechas, zonas horarias y unidades: los filtros de fecha son YYYY-MM-DD y la mayoría de los informes cubren por defecto los últimos 7 días; updated_after acepta una marca de tiempo ISO 8601. Con la mayoría de las herramientas la IA puede elegir la zona horaria de las marcas de tiempo (enviada como X-Time-Zone, por ejemplo America/New_York) y unidades métricas o imperiales (enviadas como X-Metric-Units: kilómetros y litros, o millas y galones). Indica la zona horaria y las unidades en tu prompt cuando importen. Las duraciones de Hours of Service en motive_list_available_time están en segundos.
Paginación: las listas devuelven por defecto 25 registros por página, como máximo 100 (per_page), y se paginan con page_no. Cada respuesta lleva pagination con per_page, page_no y total; la IA pide la página siguiente mientras haya más registros de los que ha visto.
Historial de ubicaciones: motive_get_vehicle_location_history lee un vehículo durante como máximo 3 meses; mantén el rango corto para una respuesta legible. Motive acepta como máximo 10 peticiones simultáneas en este endpoint.
Algunos datos necesitan hardware o un plan: los eventos de seguridad de la dashcam con IA (uso del móvil, cinturón de seguridad, distancia insuficiente, etc.), las ubicaciones del Vehicle Gateway (motive_list_vehicle_gateway_locations; los vehículos con otros ELD responden a través de motive_list_vehicle_locations) y las ubicaciones de remolques con un asset gateway.
Las cuentas de la UE no están cubiertas: el conector llama a https://api.gomotive.com; las cuentas de la plataforma de Motive en la UE usan otro host.
Errores frecuentes: un 401 significa que Motive rechazó la key: no se copió completa, caducó o se revocó, o se pegó con el nombre de cabecera X-Api-Key. Un 403 significa que la key es válida pero le falta el scope de esos datos: crea una key nueva con ese scope. Un 404 significa que no hay ningún registro con ese id: usa el id numérico, no el número del vehículo ni el nombre del conductor. Cuando Motive limita las peticiones de la key, espera un minuto, pide menos páginas y vuelve a intentarlo.
Qué lee: vehículos con VIN, marca, modelo, matrícula, tipo de combustible, dispositivo ELD y conductor; la ubicación actual de cada vehículo y conductor, y la ruta de un vehículo durante un periodo; conductores, fleet users y administradores; los relojes de Hours of Service (quién puede seguir conduciendo y cuánto tiempo), los registros diarios y las violaciones; viajes IFTA y millas por estado o provincia; compras de combustible; informes de inspección (DVIR) con sus defectos; eventos de seguridad con estado de coaching y enlaces a los medios; códigos de falla del motor; periodos de conducción, incluidos uso personal (personal conveyance), movimientos en patio (yard move) y conducción no identificada; remolques y otros activos con su última ubicación; y los grupos en que se divide la flota.
Solo lectura: todas las herramientas solo leen y ninguna está desactivada al instalar. No se cambia nada en Motive: crear o editar vehículos, usuarios, grupos, geocercas, compras de combustible o informes de inspección, enviar mensajes a conductores, los despachos y los comandos del inmovilizador del motor quedan fuera.
Requisitos previos: MOTIVE_API_KEY
Instalar el conector localmente
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
Abre http://localhost:3000/connectors/store, elige Motive e introduce las variables listadas en los Requisitos previos.
Herramientas disponibles
| Tool | What it does |
|---|---|
motive_list_vehicles | List the company vehicles in Motive: id, number (the fleet unit name), status, VIN, make, model, year, license plate, fuel type, IFTA flag… |
motive_get_vehicle | Read one vehicle by its Motive id: number, status, VIN, make, model, year, plate, fuel type, groups, ELD device and assigned driver |
motive_lookup_vehicle | Find a vehicle by its fleet unit number (the "number" shown in the Motive dashboard, for example "Truck 12") and return its full record… |
motive_list_vehicle_locations | Current location of every vehicle (v2): for each vehicle its id, number, VIN and current_location with latitude, longitude, a place… |
motive_list_vehicle_gateway_locations | Current location of vehicles fitted with the Motive Vehicle Gateway (v3), with richer telemetry than v2 and, on request, the auxiliary… |
motive_get_vehicle_location_history | Location breadcrumbs of one vehicle between two dates (v2): each point with latitude, longitude, description, located_at, speed, bearing… |
motive_list_driver_locations | Drivers with their last known location and the vehicle they are in: user id, name, current_location (lat, lon, description, located_at) and… |
motive_list_users | List the users of the Motive account (drivers, fleet users and admins): id, first and last name, email, phone, role, status, duty status… |
motive_get_user | Read one user (driver or fleet user) by Motive id: name, contact details, role, status, duty status, licence, cycle and exceptions settings |
motive_list_available_time | Hours of Service clocks per driver: current duty status and the time still available on the drive, shift, cycle and break clocks (in… |
motive_list_hos_logs | Daily Hours of Service logs (records of duty status) of the drivers: per driver and day the duty status events with start time and… |
motive_list_hos_violations | Hours of Service violations of the drivers, for example exceeding the 11-hour drive or 14-hour shift limit or a missed 30-minute break… |
motive_list_ifta_trips | IFTA trip report: distance driven per vehicle and jurisdiction (state or province) with dates, start and end odometer and location |
motive_get_ifta_mileage_summary | IFTA mileage summary: total distance per vehicle and jurisdiction over a period (default the last 7 days), the figure that goes on a… |
motive_list_fuel_purchases | Fuel purchases recorded in Motive (entered by drivers, imported or from a fuel card integration): date, vehicle, driver, jurisdiction, fuel… |
motive_list_inspection_reports | Driver vehicle inspection reports (DVIRs, v2) for vehicles and trailers: date, driver, vehicle or asset, inspection type, location… |
motive_list_driver_performance_events | Safety events detected by Motive (v2): harsh acceleration, braking and cornering, crashes, and with AI dashcams events such as cell phone… |
motive_list_fault_codes | Engine fault codes (diagnostic trouble codes) reported by the vehicles: code, label, description, source, status (open or closed), type… |
motive_list_driving_periods | Driving periods of the vehicles: each stretch of driving with start and end time, duration, distance, origin and destination, vehicle and… |
motive_list_assets | List the non-powered assets (trailers, containers, equipment): id, name, type, status, make, model, year, VIN, plate, groups and the asset… |
motive_list_asset_locations | Last known location of the assets that carry a Motive asset gateway: asset id and name, latitude, longitude, place description, located_at… |
motive_list_groups | List the groups of the account (the way the fleet is split into terminals, regions or teams): id, name, parent group, status and member… |
Ejemplos de prompts
- "¿Dónde está ahora Truck 12 y quién lo conduce?"
- "¿Qué conductores pueden seguir conduciendo hoy y durante cuánto tiempo?"
- "¿Qué conductores tuvieron frenadas bruscas o eventos de uso del móvil la semana pasada?"
- "¿Qué vehículos tienen informes de inspección con defectos o códigos de falla abiertos?"
- "¿Cuántas millas recorrió cada camión por estado el último trimestre para la declaración IFTA?"
Siguientes pasos
¿Te ha sido útil esta guía?