Samsara MCP

Automation Squad - Samsara 向け MCP

Claude AI 向けの完全な Samsara Fleet Management 連携
21 個のツール | 専門知識を内蔵 | ベータ版

---

⚠️ 重要な免責事項

非公式の連携機能：これは非公式のサードパーティ製 MCP サーバーです。

• ❌ Samsara Inc. との提携、同社による推奨または後援を受けていません
• ❌ 公式の Samsara 製品ではありません
• ✅ お客様自身の API 認証情報を使い、Samsara の公開 API を利用して構築されています
• ✅ Samsara の API 利用規約に完全に準拠しています

Samsara® は Samsara Inc. の登録商標です。

サードパーティに関する免責事項の全文はNOTICEをご覧ください。ライセンス：MIT。

---

🎯 このツールでできること

Claude AI を Samsara Fleet Management API に接続し、次の機能を利用できます。

✅ 車両、ルート、ドライバー、住所、Webhook、連絡先に関する21 個のツール
✅ すべてのツールの説明に専門知識を内蔵
✅ 状態を自動的に保持（停止地点 ID、ルートデータ）
✅ スマートなレート制限（API 制限に抵触しません）
✅ ルート最適化（効率化アルゴリズムを内蔵）
✅ 本番環境でのベストプラクティス（エラー処理、再試行）

含まれるツール

車両管理（4 ツール）

• 車両一覧の取得、車両詳細の取得、リアルタイム位置情報、統計情報

ルート管理（6 ツール） ⭐ 当社の専門分野

• ルートの作成、更新、削除
• 停止地点の状態を自動的に保持（時間追跡に不可欠です！）
• ルート最適化（距離や時間を最小化）
• ルート一覧と詳細の取得

ドライバー管理（4 ツール）

• ドライバー一覧と詳細の取得
• 運転時間（HOS）のコンプライアンス追跡
• 安全イベントの監視

住所と位置情報（2 ツール）

• 保存済み住所の作成と管理
• ジオフェンス連携

Webhook 連携（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 パッケージ @automationsquad/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（もし存在する場合）との比較

機能	仮想の公式版	Automation Squad
ツール数	基本機能が約8～12個	21
API カバレッジ	約10％	Fleet、ルート、ドライバー、HOS、ウェブフック
専門知識	❌	✅ 組み込み
ルート最適化	❌	✅ 含まれています
状態の保持	手動	自動
更新	不定期	継続的

---

🛠️ アーキテクチャ

レート制限

自動スロットリングと再試行ロジックを備え、1秒あたり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 との統合

ルート／車両／ドライバーを TMS とリンクするには、externalIds を使用します。

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

次に、外部 ID で検索します。

Find the route linked to TMS order ORD-12345

---

🐛 トラブルシューティング

「Error: SAMSARA_API_TOKEN environment variable is required」

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

「Samsara API error (401): Unauthorized」

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

「Samsara API error (429): Too Many Requests」

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 は完全にローカルで動作します

---

📈 ロードマップ

• ツールの追加（ディスパッチ、アセット、タグ）
• 一括操作のサポート
• 最適化アルゴリズムの強化
• 複数ルートの最適化
• 燃料費の計算
• コンプライアンスレポート用ツール

---

🎓 詳細情報

• Samsara API ドキュメント
• MCP プロトコル仕様
• Automation Squad のウェブサイト

---

💬 サポート

ベータユーザー向け：

• Automation Squad コミュニティに参加する
• メール：[email protected]
• GitHub の Issue：バグを報告

---

📝 ライセンス

MIT ライセンス - 詳細は LICENSE ファイルを参照してください

---

🙏 クレジット

Automation Squad が ❤️ を込めて開発しました

Samsara Inc. とは提携していません。 Samsara の公開 API を使用した独立した統合です。

---

⭐ Automation Squad のその他の情報

ドキュメント、インストール手順、このサーバーでできないこと： automationsquad.com/mcp/samsara

The AI Five — AI と自動化について知っておく価値のある5つのことを、毎週お届けします。 無料で購読 →

---

フリート管理を自動化する準備はできましたか？ さあ、始めましょう！ 🚀