Conectar Motive MCP con Gemini CLI

💡 ¿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 + Gemini

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.

1. 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.
2. 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 como X-Api-Key. AnythingMCP la envía como cabecera X-Api-Key.
3. 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 Gemini

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 muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

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

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Motive.

Herramientas disponibles

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

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude