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 Microsoft Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Motive con la configurazione guidata e aggiungi il tuo URL MCP a Microsoft Copilot. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
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 + Microsoft Copilot
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 Microsoft Copilot
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.
Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
Motive. - Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.
Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.
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
Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.
Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.
L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.
Prossimi passi
Questa guida ti è stata utile?