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 en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Motive con la configuración guiada y añade tu URL MCP a Claude. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
AnythingMCP está en el directorio de conectores de Claude: añádelo a Claude con un clic (se abre en una pestaña nueva), inicia sesión y elige qué servidores MCP puede usar Claude.
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 + Claude
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.
Requisitos previos
Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:
MOTIVE_API_KEY
Paso 1 — Obtener credenciales
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.
Paso 2 — Instalar el adapter
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
Paso 3 — Añadir el conector en Claude
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
Ruta recomendada: funciona en claude.ai web sin tocar ningún archivo de configuración.
- En Claude, abre Customize → Connectors.
- Pulsa + y después Add custom connector.
- Escribe un nombre, por ejemplo
Motive, y la URL del servidor MCP remotohttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, y pulsa Add. - Pulsa Connect e inicia sesión en AnythingMCP (OAuth) para permitir el acceso.
Todas las herramientas debajo aparecen en tu chat: empieza a escribir prompts.
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?"
FAQ
¿Funciona con Claude Code igual que con Claude Desktop? Sí, apunta ambos a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Siguientes pasos
- Página del conector
- Conectar a ChatGPT
- Conectar a Cursor
- Conectar a Gemini
- Conectar a Meta Muse
- Conectar a Microsoft Copilot
¿Te ha sido útil esta guía?