In breve
Fai leggere alla tua AI la tua flotta Motive: dove si trovano ogni camion e ogni autista, contatori e violazioni delle Hours of Service, rapporti di ispezione, eventi di sicurezza, codici di guasto, miglia IFTA e rifornimenti. Solo lettura, con una API key aziendale.
Configurazione guidata
Collega Motive a ChatGPT in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Motive con la configurazione guidata e aggiungi il tuo URL MCP a ChatGPT. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
Il plugin AnythingMCP nella directory di ChatGPT risponde, su AnythingMCP Cloud, a domande sui database aziendali (PostgreSQL, MySQL, SQL Server, Oracle, SAP HANA, SQLite, MongoDB, in sola lettura): apri la scheda (si apre in una nuova scheda) e clicca Install plugin. Tutti gli altri connettori si aggiungono a ChatGPT come server MCP personalizzato con l'URL MCP del tuo AnythingMCP.
Prova a chiedere
Prompt di esempio per Motive
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Motive, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
Motive + ChatGPT
Fai leggere alla tua AI la tua flotta Motive: dove si trovano ogni camion e ogni autista, contatori e violazioni delle Hours of Service, rapporti di ispezione, eventi di sicurezza, codici di guasto, miglia IFTA e rifornimenti. Solo lettura, con una API key aziendale.
Prerequisiti
Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:
MOTIVE_API_KEY
Step 1 — Ottieni le credenziali
La configurazione richiede circa 3 minuti. Ti serve un ruolo da admin in Motive (in passato KeepTruckin) per creare una API key aziendale nella dashboard di Motive.
- Nella dashboard di Motive apri Admin → Developers → API Access e crea una API key aziendale (company API key). Dalle accesso in lettura (read) e gli scope per i dati che l'AI deve vedere: veicoli, posizioni, utenti, HOS, IFTA, carburante, ispezioni, eventi di sicurezza, codici di guasto, asset e gruppi. Una key si può anche limitare ad alcuni gruppi; l'AI vede allora solo quelli.
- Copia la key dalla finestra che compare una sola volta, perché la key completa viene mostrata solo allora, e incollala in
MOTIVE_API_KEY: solo la key, senza spazi né un nome di header comeX-Api-Key. AnythingMCP la invia come headerX-Api-Key. - Installa il connettore e verifica la connessione con
motive_list_vehicles.
Cloud e self-hosting funzionano allo stesso modo: la API key è l'unica impostazione.
Le key scadono e non si possono modificare: una key scade secondo la scadenza scelta alla creazione, e Motive avvisa gli admin una settimana prima. I suoi scope non si possono cambiare in seguito: per accedere ad altri dati crea una nuova key e incollala in MOTIVE_API_KEY.
Id: veicoli, utenti e asset hanno id numerici di Motive. Il numero di mezzo usato da chi fa dispatching ("Truck 12") è il campo number del veicolo; motive_lookup_vehicle lo trasforma in un id. Gli autisti sono utenti con ruolo driver.
Date, fusi orari e unità: i filtri per data sono YYYY-MM-DD e la maggior parte dei report copre per default gli ultimi 7 giorni; updated_after accetta un timestamp ISO 8601. Con la maggior parte dei tool l'AI può scegliere il fuso orario dei timestamp (inviato come X-Time-Zone, per esempio America/New_York) e le unità metriche o imperiali (inviate come X-Metric-Units: chilometri e litri, oppure miglia e galloni). Indica fuso orario e unità nel prompt quando contano. Le durate delle Hours of Service in motive_list_available_time sono in secondi.
Paginazione: le liste restituiscono per default 25 record per pagina, al massimo 100 (per_page), e si sfogliano con page_no. Ogni risposta contiene pagination con per_page, page_no e total; l'AI chiede la pagina successiva finché ci sono più record di quelli già visti.
Storico delle posizioni: motive_get_vehicle_location_history legge un veicolo su un periodo di al massimo 3 mesi; tieni l'intervallo breve per una risposta leggibile. Motive accetta al massimo 10 richieste simultanee su questo endpoint.
Alcuni dati richiedono hardware o un piano: gli eventi di sicurezza della dashcam AI (uso del telefono, cintura di sicurezza, distanza ravvicinata e così via), le posizioni dal Vehicle Gateway (motive_list_vehicle_gateway_locations; i veicoli con altri ELD rispondono tramite motive_list_vehicle_locations) e le posizioni dei rimorchi con un asset gateway.
Gli account UE non sono coperti: il connettore chiama https://api.gomotive.com; gli account sulla piattaforma UE di Motive usano un host diverso.
Errori frequenti: un 401 vuol dire che Motive ha rifiutato la key: non è stata copiata per intero, è scaduta o revocata, oppure è stata incollata con il nome dell'header X-Api-Key. Un 403 vuol dire che la key è valida ma le manca lo scope per quei dati: crea una nuova key con quello scope. Un 404 vuol dire che non esiste un record con quell'id: usa l'id numerico, non il numero del veicolo o il nome dell'autista. Quando Motive limita le richieste della key, aspetta un minuto, chiedi meno pagine e riprova.
Cosa legge: veicoli con VIN, marca, modello, targa, tipo di carburante, dispositivo ELD e autista; la posizione attuale di ogni veicolo e autista e il percorso di un veicolo in un periodo; autisti, fleet user e admin; i contatori delle Hours of Service (chi può ancora guidare e per quanto), i registri giornalieri e le violazioni; viaggi IFTA e miglia per stato o provincia; rifornimenti; rapporti di ispezione (DVIR) con i loro difetti; eventi di sicurezza con stato del coaching e link ai media; codici di guasto del motore; periodi di guida, compresi uso personale (personal conveyance), spostamenti in piazzale (yard move) e guida non identificata; rimorchi e altri asset con la loro ultima posizione; e i gruppi in cui è suddivisa la flotta.
Solo lettura: ogni tool legge soltanto e nessuno è disattivato all'installazione. In Motive non cambia nulla: creare o modificare veicoli, utenti, gruppi, geofence, rifornimenti o rapporti di ispezione, inviare messaggi agli autisti, i dispatch e i comandi di immobilizzazione del motore sono esclusi.
Step 2 — Installa l'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
Step 3 — Aggiungi il connettore in ChatGPT
L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (
https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostraYOUR_SERVER_ID.
ChatGPT aggiunge i server MCP come plugin dalla pagina Plugins, sul web e nei piani a pagamento. La modalità sviluppatore non serve più. In un workspace Business possono farlo solo admin e owner; in Enterprise ed Edu un amministratore può concedere il permesso Create plugins with MCPs.
- Vai su chatgpt.com/plugins, clicca Add e poi Add custom MCP server.
- Inserisci un nome, ad esempio Name:
Motive. - In Connection inserisci come Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDe lascia Authentication su OAuth. - Seleziona I understand and want to continue, poi Create as a plugin. Quando ChatGPT lo chiede, accedi ad AnythingMCP e consenti l'accesso.
- Installa il nuovo plugin dai tuoi plugin personali, poi digita @ in una chat e selezionalo.
Tool disponibili
| 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… |
Esempi di prompt
- "Dov'è adesso Truck 12, e chi lo sta guidando?"
- "Quali autisti possono ancora guidare oggi, e per quanto tempo?"
- "Quali autisti hanno avuto frenate brusche o eventi di uso del telefono la settimana scorsa?"
- "Quali veicoli hanno rapporti di ispezione con difetti o codici di guasto aperti?"
- "Quante miglia ha percorso ogni camion per stato nell'ultimo trimestre, per la dichiarazione IFTA?"
FAQ
Il piano free di ChatGPT funziona con i server MCP personalizzati? OpenAI documenta i server MCP personalizzati solo per i piani a pagamento; il piano Free non è nell'elenco.
Prossimi passi
Questa guida ti è stata utile?