Skip to main content
Glama

Automation Squad - MCP для Samsara

Полная интеграция управления автопарком Samsara для ИИ Claude
21 инструмент | Встроенные экспертные знания | Бета-версия

🚀 БЕСПЛАТНО В ПЕРИОД БЕТЫ — Зафиксируйте свою пожизненную скидку!


⚠️ Важное предупреждение

НЕОФИЦИАЛЬНАЯ ИНТЕГРАЦИЯ: Это неофициальный сторонний MCP-сервер. Он:

  • ❌ НЕ аффилирован, не одобрен и не спонсирован компанией Samsara Inc.

  • ❌ НЕ является официальным продуктом Samsara

  • ✅ Создан с использованием публичного API Samsara с вашими собственными учетными данными API

  • ✅ Полностью соответствует условиям использования API Samsara

Samsara® является зарегистрированным товарным знаком Samsara Inc.


Related MCP server: Samsara Fleet MCP Server

🎯 Что это делает

Подключает ИИ Claude к API управления автопарком Samsara с:

✅ 21 инструмент для транспортных средств, маршрутов, водителей, адресов, вебхуков и контактов
✅ Экспертные знания, встроенные в описание каждого инструмента
✅ Автоматическое сохранение состояния (идентификаторы остановок, данные маршрута)
✅ Интеллектуальное ограничение частоты запросов (не превышает лимиты API)
✅ Оптимизация маршрутов (встроенные алгоритмы эффективности)
✅ Лучшие практики для продакшена (обработка ошибок, повторные попытки)

Включенные инструменты

Управление транспортными средствами (4 инструмента)

  • Список транспортных средств, получение деталей ТС, местоположение в реальном времени, статистика

Управление маршрутами (6 инструментов) ⭐ Наша специализация

  • Создание, обновление, удаление маршрутов

  • Автосохранение состояния остановок (критически важно для отслеживания времени!)

  • Оптимизация маршрутов (минимизация расстояния/времени)

  • Список и получение деталей маршрутов

Управление водителями (4 инструмента)

  • Список водителей, получение деталей водителя

  • Отслеживание соблюдения режима труда и отдыха (HOS)

  • Мониторинг событий безопасности

Адреса и местоположения (2 инструмента)

  • Создание и управление сохраненными адресами

  • Интеграция геозон

Интеграция вебхуков (3 инструмента)

  • Уведомления о событиях в реальном времени

  • Обновления маршрутов, события ТС и т.д.

Управление контактами (2 инструмента)

  • Создание и управление контактами для остановок маршрута


🚀 Быстрый старт

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

  • Установленный Node.js 18+

  • Токен API Samsara (Получить здесь)

  • Claude Desktop или любой MCP-совместимый клиент

Установка

git clone https://github.com/AutomationSquadOS/mcp-samsara
cd mcp-samsara
npm install
npm run build

Примечание: npm-пакет @automation-squad/mcp-samsara еще не опубликован, поэтому клонирование и сборка — единственный доступный на сегодня путь установки. Когда он выйдет, однострочная команда npx заменит описанные выше шаги.

Конфигурация

Добавьте в файл конфигурации Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "samsara": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-samsara/build/index.js"],
      "env": {
        "SAMSARA_API_TOKEN": "your-api-token-here",
        "SAMSARA_BASE_URL": "https://api.samsara.com"
      }
    }
  }
}

Замените /absolute/path/to/mcp-samsara на путь, куда вы клонировали репозиторий. Путь должен быть абсолютным — Claude Desktop не разрешает ~ или относительные пути.

Клиенты из ЕС: Используйте https://api.eu.samsara.com для SAMSARA_BASE_URL

Перезапустите Claude

Закройте и снова откройте Claude Desktop. Вы должны увидеть доступные инструменты Samsara!


💡 Примеры использования

Создание маршрута с оптимизацией

Create a delivery route called "Morning Zone 1" with these stops:
1. Warehouse: 123 Main St, Springfield
2. Customer A: 456 Oak Ave, Springfield  
3. Customer B: 789 Pine Rd, Springfield
4. Return to warehouse

Then optimize it for minimum distance.

Claude:

  1. Создаст маршрут с правильными адресами

  2. Автоматически оптимизирует порядок остановок

  3. Сохранит все идентификаторы остановок для отслеживания

  4. Назначит ТС/водителя, если запрошено

Отслеживание местоположения ТС

Show me real-time locations for all vehicles currently on routes

Мониторинг соблюдения требований водителями

Get HOS logs for driver John Smith for the past week and check for any violations

🔥 Что делает это лучше

По сравнению с прямой интеграцией API

Функция

Прямой API

Этот MCP

Время настройки

Дни

Минуты

Сохранение состояния остановок

Вручную

Автоматически

Ограничение частоты запросов

Самостоятельно

Встроено

Обработка ошибок

Своя

Протестировано в продакшене

Оптимизация маршрутов

Создавать самим

Включено

Лучшие практики

Нужно изучать

Встроены

По сравнению с официальным MCP (если бы он существовал)

Функция

Гипотетический официальный

Automation Squad

Количество инструментов

~8-12 базовых

21

Охват API

~10%

Автопарк, маршруты, водители, HOS, вебхуки

Экспертные знания

❌

✅ Встроены

Оптимизация маршрутов

❌

✅ Включена

Сохранение состояния

Вручную

Автоматически

Обновления

Эпизодические

Постоянные


🛠️ Архитектура

Ограничение частоты запросов

Консервативные 5 запросов/секунду с автоматическим регулированием и логикой повторных попыток.

Обработка ошибок

  • Автоматический повтор при 429 (превышение лимита)

  • Понятные сообщения об ошибках

  • Плавная деградация

Сохранение состояния

Критически важная функция: При обновлении маршрутов мы автоматически:

  1. Получаем существующий маршрут

  2. Извлекаем идентификаторы остановок

  3. Сохраняем их при обновлениях

  4. Предотвращаем потерю данных

Это лучшая практика, которая предотвращает потерю времени прибытия/отправления.


📚 Документация

Переменные окружения

Переменная

Обязательная

По умолчанию

Описание

SAMSARA_API_TOKEN

✅ Да

-

Ваш токен API Samsara

SAMSARA_BASE_URL

Нет

https://api.samsara.com

Базовый URL API (используйте EU endpoint при необходимости)

Соглашение об именовании инструментов

Все инструменты имеют префикс samsara_ для ясности:

  • samsara_list_vehicles

  • samsara_create_route

  • samsara_get_driver_hos

  • и т.д.


🤝 Интеграция с TMS

Используйте externalIds в маршрутах/ТС/водителях для связи с вашей TMS:

{
  "externalIds": {
    "tmsOrderId": "ORD-12345",
    "customerId": "CUST-789"
  }
}

Затем запрашивайте по внешнему ID:

Find the route linked to TMS order ORD-12345

🐛 Устранение неполадок

«Ошибка: требуется переменная окружения SAMSARA_API_TOKEN»

Установите свой токен API в файле конфигурации Claude (см. Конфигурацию выше).

«Ошибка API Samsara (401): Неавторизован»

Ваш токен API недействителен или истек. Сгенерируйте новый в панели управления Samsara.

«Ошибка API Samsara (429): Слишком много запросов»

MCP автоматически повторит попытку. Если вы часто видите это, возможно, другие интеграции также обращаются к API.

Инструменты не отображаются в Claude

  1. Проверьте синтаксис файла конфигурации (должен быть валидный JSON)

  2. Полностью перезапустите Claude (закройте и откройте заново)

  3. Проверьте логи Claude на наличие ошибок


📦 Что включено

mcp-samsara/
├── src/
│   └── index.ts          # Main MCP server
├── build/                # Compiled JavaScript
├── package.json          # NPM package config
├── tsconfig.json         # TypeScript config
├── README.md            # This file
└── LICENSE              # MIT License

🔐 Безопасность

  • Ваши учетные данные остаются локальными — токен API хранится на вашем компьютере

  • Сбор данных отсутствует — мы не видим ваши данные Samsara

  • Открытый исходный код — вы можете проверить код самостоятельно

  • Нет обратной связи — MCP работает полностью локально


📈 План развития

  • Добавить больше инструментов (диспетчеризация, активы, теги)

  • Поддержка пакетных операций

  • Улучшенные алгоритмы оптимизации

  • Оптимизация нескольких маршрутов

  • Расчет стоимости топлива

  • Инструменты отчетности о соответствии


🎓 Узнать больше


💬 Поддержка

Пользователи бета-версии:


📝 Лицензия

Лицензия MIT — см. файл LICENSE для подробностей


🙏 Благодарности

Создано с ❤️ командой Automation Squad

Не аффилировано с Samsara Inc. Это независимая интеграция с использованием публичного API Samsara.


⭐ Больше от Automation Squad

Документация, шаги установки и что этот сервер не делает: automationsquad.com/mcp/samsara

The AI Five — пять вещей, которые стоит знать об ИИ и автоматизации, еженедельно. Подписаться бесплатно →


Готовы автоматизировать управление автопарком? Поехали! 🚀

Available Tools

21 tools
samsara_create_addressC

Create a saved address/location in Samsara for reuse in routes

Inputs: name (required), latitude, longitude, externalIds, +1 more.

samsara_create_contactC

Create a contact (person at a stop location) for route management

Inputs: firstName (required), email, phone, lastName, +1 more.

samsara_create_routeA

Create a new route with stops. IMPORTANT: Each stop needs address (with lat/long or formatted address), optional arrival/departure times, and names. Use externalIds to link with your TMS.

Inputs: name (required), stops (required), driverId, startTime, +2 more.

samsara_create_webhookB

Create a webhook to receive real-time notifications from Samsara (route updates, vehicle events, etc.)

Inputs: url (required), eventTypes (required), secret.

samsara_delete_routeC

Delete a route permanently

Inputs: routeId (required).

samsara_delete_webhookC

Delete a webhook subscription

Inputs: webhookId (required).

samsara_get_driverC

Get detailed information about a specific driver

Inputs: driverId (required).

samsara_get_driver_hosC

Get Hours of Service (HOS) logs for a driver. Essential for compliance tracking.

Inputs: endTime (required), driverId (required), startTime (required).

samsara_get_driver_safety_eventsC

Get safety events (harsh braking, acceleration, speeding, etc.) for a driver

Inputs: endTime (required), driverId (required), startTime (required).

samsara_get_routeA

Get detailed information about a specific route including all stops, assigned vehicle/driver, and status

Inputs: routeId (required).

samsara_get_vehicleB

Get detailed information about a specific vehicle by ID

Inputs: vehicleId (required).

samsara_get_vehicle_locationsA

Get real-time or recent locations for vehicles. Uses the feed API pattern for efficient streaming of location data.

Inputs: after, vehicleIds.

samsara_get_vehicle_statsB

Get vehicle statistics including odometer, engine hours, and fuel usage over a time range

Inputs: endTime (required), startTime (required), vehicleIds (required).

samsara_list_addressesB

List all saved addresses

Inputs: after, limit.

samsara_list_contactsD

List all contacts

Inputs: limit.

samsara_list_driversC

List all drivers in the organization with their details and external IDs

Inputs: after, limit.

samsara_list_routesA

List all routes. Routes contain ordered stops with addresses, times, and status tracking.

Inputs: after, limit.

samsara_list_vehiclesA

List all vehicles in the fleet. Returns vehicle details including ID, name, VIN, make, model, and external IDs for TMS integration.

Inputs: after, limit.

samsara_list_webhooksB

List all configured webhooks

Inputs: no named parameters.

samsara_optimize_routeB

Optimize route stop order to minimize distance/time. This is a value-add feature that reorders stops for efficiency while preserving all stop data and IDs.

Inputs: routeId (required), optimizationGoal.

samsara_update_routeA

Update a route. CRITICAL BEST PRACTICE: This tool automatically preserves stop IDs to maintain arrival/departure time tracking. You can update name, vehicle, driver, status, or modify stops. When updating stops, the tool fetches existing stop IDs and preserves them.

Inputs: routeId (required), name, stops, status, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 21 tools

    Disambiguation4/5

    Most tools have distinct purposes (vehicles, routes, drivers, addresses, webhooks, contacts). However, samsara_list_vehicles and samsara_get_vehicle could be confused by an agent as simply different granularities of the same resource, which is acceptable. No major overlapping ambiguity.

    Naming Consistency5/5

    All tools follow a consistent samsara_{verb}_{noun} pattern with clear CRUD verbs (list, get, create, update, delete) and one value-add verb (optimize). The naming is predictable and uniform, making it easy for an agent to infer tool purpose.

    Tool Count4/5

    21 tools covers a fleet management domain (vehicles, routes, drivers, HOS, safety, addresses, webhooks, contacts) reasonably well. It is on the higher side but each tool serves a clear function. Slightly over 15 but not excessive for the scope.

    Completeness4/5

    The toolset provides good CRUD coverage for routes, addresses, webhooks, and contacts, plus read-only access for vehicles and drivers with HOS and safety. Missing update/delete for drivers and vehicles, and no update for addresses/contacts, but the core fleet workflows (routing, driver monitoring) are well-covered.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers