mcp-samsara
Automation Squad - Samsara向けMCP
Claude AI向け完全なSamsaraフリート管理統合
21のツール | 組み込みの専門知識 | ベータ版
🚀 ベータ期間中は無料 - 生涯割引を今すぐ確保!
⚠️ 重要な免責事項
非公式統合: これは非公式のサードパーティMCPサーバーです。以下の点にご注意ください:
❌ Samsara Inc.との提携、承認、スポンサーは一切ありません
❌ 公式のSamsara製品ではありません
✅ お客様自身のAPI認証情報を使用してSamsaraの公開APIを利用して構築されています
✅ SamsaraのAPI利用規約に完全準拠しています
Samsara® はSamsara Inc.の登録商標です。
Related MCP server: Samsara Fleet MCP Server
🎯 機能概要
Claude AIをSamsaraフリート管理APIに接続します:
✅ 21のツール(車両、ルート、ドライバー、住所、ウェブフック、連絡先)
✅ 各ツールの説明に専門知識を組み込み
✅ 自動状態保存(停車ID、ルートデータ)
✅ スマートなレート制限(API制限に達しない)
✅ ルート最適化(組み込み効率アルゴリズム)
✅ プロダクションのベストプラクティス(エラーハンドリング、リトライ)
含まれるツール
車両管理(4ツール)
車両一覧、車両詳細、リアルタイム位置情報、統計情報
ルート管理(6ツール) ⭐ 当社の得意分野
ルートの作成、更新、削除
停車状態の自動保存(時間追跡に重要!)
ルート最適化(距離/時間を最小化)
ルート一覧と詳細取得
ドライバー管理(4ツール)
ドライバー一覧、ドライバー詳細
勤務時間(HOS)コンプライアンス追跡
安全イベント監視
住所・位置情報(2ツール)
保存済み住所の作成と管理
ジオフェンス統合
ウェブフック統合(3ツール)
リアルタイムイベント通知
ルート更新、車両イベントなど
連絡先管理(2ツール)
ルート停車用の連絡先の作成と管理
🚀 クイックスタート
前提条件
Node.js 18以上がインストールされていること
Samsara APIトークン(こちらから取得)
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は ~ や相対パスを解決しません。
EUのお客様: SAMSARA_BASE_URLには https://api.eu.samsara.com を使用してください
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は以下の処理を行います:
適切な住所でルートを作成
停車順序を自動最適化
追跡用にすべての停車IDを保存
必要に応じて車両/ドライバーを割り当て
車両位置情報の追跡
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(存在する場合)との比較
機能 | 仮想的な公式MCP | Automation Squad |
ツール数 | 約8~12の基本 | 21 |
APIカバレッジ | 約10% | フリート、ルート、ドライバー、HOS、ウェブフック |
専門知識 | ❌ | ✅ 組み込み |
ルート最適化 | ❌ | ✅ 含まれている |
状態保存 | 手動 | 自動 |
アップデート | 不定期 | 継続的 |
🛠️ アーキテクチャ
レート制限
控えめな毎秒5リクエストで、自動スロットリングとリトライロジックを備えています。
エラーハンドリング
429(レート制限)時の自動リトライ
明確なエラーメッセージ
グレースフルデグラデーション
状態保存
重要な機能: ルート更新時に、自動的に以下を実行:
既存ルートを取得
停車IDを抽出
更新時にそれらを保持
データ損失を防止
これは到着/出発時刻の喪失を防ぐベストプラクティスです。
📚 ドキュメント
環境変数
変数 | 必須 | デフォルト | 説明 |
| ✅ はい | - | お客様のSamsara APIトークン |
| いいえ |
| APIベースURL(必要な場合はEUエンドポイントを使用) |
ツール命名規則
すべてのツールは明確にするために 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環境変数が必要です」
Claude設定ファイルにAPIトークンを設定してください(上記「設定」を参照)。
「Samsara APIエラー(401):認証されていません」
APIトークンが無効または期限切れです。Samsaraダッシュボードで新しいトークンを生成してください。
「Samsara APIエラー(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は完全にローカルで動作します
📈 ロードマップ
ツール追加(派遣、アセット、タグ)
バッチ操作のサポート
最適化アルゴリズムの強化
マルチルート最適化
燃料費計算
コンプライアンスレポートツール
🎓 詳細情報
💬 サポート
ベータユーザー向け:
メール: rob@matrix.digital
GitHub Issues: バグを報告
📝 ライセンス
MITライセンス - 詳細はLICENSEファイルを参照
🙏 クレジット
❤️を込めて Automation Squad が構築
Samsara Inc.との提携はありません。 これはSamsaraの公開APIを使用した独立した統合です。
⭐ Automation Squadのその他の情報
ドキュメント、インストール手順、およびこのサーバーが行わないこと: automationsquad.com/mcp/samsara
The AI Five — AIと自動化に関する知っておくべき5つのこと、毎週配信。 無料購読 →
フリート管理の自動化を始めましょう? さあ行こう! 🚀
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