mcp-samsara
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:
Создаст маршрут с правильными адресами
Автоматически оптимизирует порядок остановок
Сохранит все идентификаторы остановок для отслеживания
Назначит ТС/водителя, если запрошено
Отслеживание местоположения ТС
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 (превышение лимита)
Понятные сообщения об ошибках
Плавная деградация
Сохранение состояния
Критически важная функция: При обновлении маршрутов мы автоматически:
Получаем существующий маршрут
Извлекаем идентификаторы остановок
Сохраняем их при обновлениях
Предотвращаем потерю данных
Это лучшая практика, которая предотвращает потерю времени прибытия/отправления.
📚 Документация
Переменные окружения
Переменная | Обязательная | По умолчанию | Описание |
| ✅ Да | - | Ваш токен API Samsara |
| Нет |
| Базовый URL API (используйте EU endpoint при необходимости) |
Соглашение об именовании инструментов
Все инструменты имеют префикс samsara_ для ясности:
samsara_list_vehiclessamsara_create_routesamsara_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
Проверьте синтаксис файла конфигурации (должен быть валидный JSON)
Полностью перезапустите Claude (закройте и откройте заново)
Проверьте логи 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 работает полностью локально
📈 План развития
Добавить больше инструментов (диспетчеризация, активы, теги)
Поддержка пакетных операций
Улучшенные алгоритмы оптимизации
Оптимизация нескольких маршрутов
Расчет стоимости топлива
Инструменты отчетности о соответствии
🎓 Узнать больше
💬 Поддержка
Пользователи бета-версии:
Присоединяйтесь к сообществу Automation Squad
Эл. почта: rob@matrix.digital
GitHub Issues: Сообщить об ошибке
📝 Лицензия
Лицензия MIT — см. файл LICENSE для подробностей
🙏 Благодарности
Создано с ❤️ командой Automation Squad
Не аффилировано с Samsara Inc. Это независимая интеграция с использованием публичного API Samsara.
⭐ Больше от Automation Squad
Документация, шаги установки и что этот сервер не делает: automationsquad.com/mcp/samsara
The AI Five — пять вещей, которые стоит знать об ИИ и автоматизации, еженедельно. Подписаться бесплатно →
Готовы автоматизировать управление автопарком? Поехали! 🚀
Available Tools
21 toolssamsara_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
Scored across 21 tools
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.
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.
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.
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
Related MCP Connectors
Tesla Fleet API for AI: send navigation destinations, read battery and location, run car commands.
AI for your car: check charge, start climate, lock/unlock, open trunk via Tesla Fleet API. OAuth.
Read-only access to your Drivara fleet — jobs, drivers, vehicles, fuel, profit & analytics.
Plan last-mile deliveries from your AI assistant. Turns orders from spreadsheets, URLs, or pasted text into optimized delivery routes. It geocodes addresses, flags locations that need confirmation, and assigns stops across your fleet while respecting vehicle capacity, delivery time windows, and stop limits. Manage vehicles and depots, review route maps, and plan anything from a small delivery run to thousands of stops. Connect with your Vepathos account using OAuth.
Related MCP Servers
- FlicenseAqualityCmaintenanceEnables AI agents to query orders, manage routes, track drivers, and analyze delivery performance on the FleetSync last-mile delivery platform through natural language.18-
- FlicenseNot gradedqualityCmaintenanceExposes live Samsara fleet data via MCP tools for searching assets and retrieving GPS locations.-
- AlicenseNot gradedqualityCmaintenanceIntegrates with Tesla Fleet API and TeslaMate API to control vehicles, monitor energy (Powerwall/Solar), manage charging, and analyze driving data, with generative UI and skill workflows.5MIT
- AlicenseNot gradedqualityBmaintenanceProvides real-time freight tracking and load visibility for logistics and AI agents: create loads, get live GPS positions, trip stats, and confirm deliveries via geofenced statuses.1MIT