Motive MCP с Gemini CLI: данные автопарка

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Motive, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Motive + Gemini

Дайте ИИ читать данные вашего автопарка в Motive: где сейчас каждый грузовик и каждый водитель, часы и нарушения Hours of Service, отчёты об осмотрах, события безопасности, коды неисправностей, пробег для IFTA и заправки. Только чтение, с API-ключом компании.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

MOTIVE_API_KEY

Шаг 1 — Получите учётные данные

Настройка занимает около 3 минут. Чтобы создать API-ключ компании в дашборде Motive, нужна роль администратора в Motive (ранее KeepTruckin).

1. В дашборде Motive откройте Admin → Developers → API Access и создайте API-ключ компании (company API key). Дайте ему доступ на чтение (read) и scopes для данных, которые должен видеть ИИ: машины, местоположения, пользователи, HOS, IFTA, топливо, осмотры, события безопасности, коды неисправностей, активы и группы. Ключ можно также ограничить отдельными группами; тогда ИИ видит только их.
2. Скопируйте ключ из окна, которое показывается один раз: полный ключ больше не отображается. Вставьте его в MOTIVE_API_KEY: только сам ключ, без пробелов и без имени заголовка вроде X-Api-Key. AnythingMCP передаёт его в заголовке X-Api-Key.
3. Установите коннектор и проверьте подключение через motive_list_vehicles.

Cloud и self-hosting работают одинаково: API-ключ — единственная настройка.

Ключи истекают и не редактируются: ключ истекает по графику, выбранному при создании, и Motive предупреждает администраторов за неделю. Scopes потом изменить нельзя: чтобы получить доступ к другим данным, создайте новый ключ и вставьте его в MOTIVE_API_KEY.

Id: у машин, пользователей и активов числовые id в Motive. Бортовой номер, которым пользуется диспетчер («Truck 12»), — это поле number машины; motive_lookup_vehicle превращает его в id. Водители — это пользователи с ролью driver.

Даты, часовые пояса и единицы: фильтры по дате задаются как YYYY-MM-DD, большинство отчётов по умолчанию охватывают последние 7 дней; updated_after принимает метку времени ISO 8601. В большинстве инструментов ИИ может выбрать часовой пояс меток времени (передаётся как X-Time-Zone, например America/New_York) и метрические или имперские единицы (передаётся как X-Metric-Units: километры и литры или мили и галлоны). Если это важно, укажите часовой пояс и единицы в запросе. Длительности Hours of Service в motive_list_available_time указаны в секундах.

Страницы: списки по умолчанию возвращают 25 записей на страницу, не больше 100 (per_page), и листаются через page_no. В каждом ответе есть pagination с per_page, page_no и total; ИИ запрашивает следующую страницу, пока записей больше, чем он уже видел.

История местоположений: motive_get_vehicle_location_history читает одну машину за период не длиннее 3 месяцев; держите период коротким, чтобы ответ оставался читаемым. Этот endpoint Motive принимает не больше 10 одновременных запросов.

Для части данных нужно оборудование или тариф: события безопасности AI-видеорегистратора (телефон за рулём, ремень безопасности, опасная дистанция и так далее), местоположения через Vehicle Gateway (motive_list_vehicle_gateway_locations; машины с другими ELD отвечают через motive_list_vehicle_locations) и местоположения прицепов с asset gateway.

Аккаунты ЕС не поддерживаются: коннектор обращается к https://api.gomotive.com; аккаунты на платформе Motive в ЕС используют другой хост.

Частые ошибки: 401 — Motive отклонил ключ: он скопирован не полностью, истёк или отозван, либо вставлен вместе с именем заголовка X-Api-Key. 403 — ключ действителен, но у него нет scope для этих данных: создайте новый ключ с этим scope. 404 — записи с таким id нет: используйте числовой id, а не номер машины или имя водителя. Если Motive ограничивает запросы ключа, подождите минуту, запрашивайте меньше страниц и повторите.

Что читает коннектор: машины с VIN, маркой, моделью, госномером, типом топлива, устройством ELD и водителем; текущее местоположение каждой машины и каждого водителя и маршрут машины за период; водителей, fleet users и администраторов; часы Hours of Service (кто ещё может ехать сегодня и сколько), суточные журналы и нарушения; поездки IFTA и пробег по штатам и провинциям; заправки; отчёты об осмотрах (DVIR) с дефектами; события безопасности со статусом коучинга и ссылками на медиа; коды неисправностей двигателя; периоды движения, включая личное использование (personal conveyance), перемещения по площадке (yard move) и неидентифицированное вождение; прицепы и другие активы с последним местоположением; и группы, на которые разделён автопарк.

Только чтение: каждый инструмент только читает, и ни один не отключён при установке. В Motive ничего не меняется: создание и изменение машин, пользователей, групп, геозон, заправок и отчётов об осмотрах, сообщения водителям, диспетчерские задания и команды иммобилайзеру двигателя не входят в коннектор.

Шаг 2 — Установите адаптер

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

Шаг 3 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows — %USERPROFILE%\.gemini\settings.json). Добавь:

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

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале) — anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Motive.

Доступные инструменты

Примеры запросов

• «Где сейчас Truck 12 и кто за рулём?»
• «Кто из водителей ещё может ехать сегодня и сколько времени?»
• «У каких водителей на прошлой неделе были резкие торможения или события с телефоном за рулём?»
• «У каких машин есть отчёты об осмотре с дефектами или открытые коды неисправностей?»
• «Сколько миль проехал каждый грузовик по штатам за прошлый квартал, для декларации IFTA?»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

• Страница коннектора
• Подключить к Claude