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 Microsoft 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 Microsoft Copilot. 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 + Microsoft Copilot
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 Microsoft Copilot
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.
Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.
- En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
- Escribe un Server name (por ejemplo
AnythingMCP), una Server description que diga qué hace el conector y la Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor. - En la autenticación, elige API key, pon Type en Header y
X-API-Keycomo nombre de la cabecera, y selecciona Create. - En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
- Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de
Motive. - Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.
¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.
¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.
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
¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.
¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.
El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.
Siguientes pasos
¿Te ha sido útil esta guía?