Skip to main content
Glama

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は以下の処理を行います:

  1. 適切な住所でルートを作成

  2. 停車順序を自動最適化

  3. 追跡用にすべての停車IDを保存

  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(存在する場合)との比較

機能

仮想的な公式MCP

Automation Squad

ツール数

約8~12の基本

21

APIカバレッジ

約10%

フリート、ルート、ドライバー、HOS、ウェブフック

専門知識

❌

✅ 組み込み

ルート最適化

❌

✅ 含まれている

状態保存

手動

自動

アップデート

不定期

継続的


🛠️ アーキテクチャ

レート制限

控えめな毎秒5リクエストで、自動スロットリングとリトライロジックを備えています。

エラーハンドリング

  • 429(レート制限)時の自動リトライ

  • 明確なエラーメッセージ

  • グレースフルデグラデーション

状態保存

重要な機能: ルート更新時に、自動的に以下を実行:

  1. 既存ルートを取得

  2. 停車IDを抽出

  3. 更新時にそれらを保持

  4. データ損失を防止

これは到着/出発時刻の喪失を防ぐベストプラクティスです。


📚 ドキュメント

環境変数

変数

必須

デフォルト

説明

SAMSARA_API_TOKEN

✅ はい

-

お客様のSamsara APIトークン

SAMSARA_BASE_URL

いいえ

https://api.samsara.com

APIベースURL(必要な場合はEUエンドポイントを使用)

ツール命名規則

すべてのツールは明確にするために 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環境変数が必要です」

Claude設定ファイルにAPIトークンを設定してください(上記「設定」を参照)。

「Samsara APIエラー(401):認証されていません」

APIトークンが無効または期限切れです。Samsaraダッシュボードで新しいトークンを生成してください。

「Samsara APIエラー(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.との提携はありません。 これはSamsaraの公開APIを使用した独立した統合です。


⭐ Automation Squadのその他の情報

ドキュメント、インストール手順、およびこのサーバーが行わないこと: automationsquad.com/mcp/samsara

The AI Five — AIと自動化に関する知っておくべき5つのこと、毎週配信。 無料購読 →


フリート管理の自動化を始めましょう? さあ行こう! 🚀

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