Automation Squad - MCP для Samsara

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

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

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

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

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

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

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

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

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

Related MCP server: fleetsync-mcp

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

Подключает ИИ 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Все инструменты имеют префикс 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 работает полностью локально

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

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

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

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

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

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

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

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

• Документация API Samsara

• Спецификация протокола MCP

• Веб-сайт Automation Squad

💬 Поддержка

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

• Присоединяйтесь к сообществу Automation Squad

• Эл. почта: rob@matrix.digital

• GitHub Issues: Сообщить об ошибке

📝 Лицензия

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

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

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

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

⭐ Больше от Automation Squad

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

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

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