Automation Squad - Samsara向けMCP

Claude AI向け完全なSamsaraフリート管理統合
21のツール | 組み込みの専門知識 | ベータ版

🚀 ベータ期間中は無料 - 生涯割引を今すぐ確保！

⚠️ 重要な免責事項

非公式統合: これは非公式のサードパーティMCPサーバーです。以下の点にご注意ください：

• ❌ Samsara Inc.との提携、承認、スポンサーは一切ありません

• ❌ 公式のSamsara製品ではありません

• ✅ お客様自身のAPI認証情報を使用してSamsaraの公開APIを利用して構築されています

• ✅ SamsaraのAPI利用規約に完全準拠しています

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

Related MCP server: fleetsync-mcp

🎯 機能概要

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統合との比較

公式MCP（存在する場合）との比較

🛠️ アーキテクチャ

レート制限

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

エラーハンドリング

• 429（レート制限）時の自動リトライ

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

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

状態保存

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

1. 既存ルートを取得

2. 停車IDを抽出

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環境変数が必要です」

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

📈 ロードマップ

• ツール追加（派遣、アセット、タグ）

• バッチ操作のサポート

• 最適化アルゴリズムの強化

• マルチルート最適化

• 燃料費計算

• コンプライアンスレポートツール

🎓 詳細情報

• Samsara APIドキュメント

• MCPプロトコル仕様

• Automation Squadウェブサイト

💬 サポート

ベータユーザー向け：

• Automation Squadコミュニティに参加

• メール: rob@matrix.digital

• GitHub Issues: バグを報告

📝 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照

🙏 クレジット

❤️を込めて Automation Squad が構築

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

⭐ Automation Squadのその他の情報

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

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

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