Skip to main content
Glama

Automation Squad - MCP für Samsara

Komplette Samsara Flottenmanagement-Integration für Claude AI
21 Tools | Expertenwissen integriert | Beta

🚀 KOSTENLOS WÄHREND DER BETA - Sichern Sie sich Ihren lebenslangen Rabatt!


⚠️ Wichtiger Haftungsausschluss

INOFFIZIELLE INTEGRATION: Dies ist ein inoffizieller MCP-Server eines Drittanbieters. Er ist:

  • ❌ NICHT verbunden mit, unterstützt von oder gesponsert von Samsara Inc.

  • ❌ KEIN offizielles Samsara-Produkt

  • ✅ Erstellt unter Verwendung der öffentlichen API von Samsara mit Ihren eigenen API-Anmeldedaten

  • ✅ Vollständig konform mit den API-Nutzungsbedingungen von Samsara

Samsara® ist eine eingetragene Marke von Samsara Inc.


Related MCP server: Samsara Fleet MCP Server

🎯 Was dies tut

Verbindet Claude AI mit der Samsara Flottenmanagement-API mit:

✅ 21 Tools für Fahrzeuge, Routen, Fahrer, Adressen, Webhooks und Kontakte
✅ Expertenwissen in jede Tool-Beschreibung integriert
✅ Automatische Zustandserhaltung (Stopp-IDs, Routendaten)
✅ Intelligentes Rate-Limiting (erreicht keine API-Limits)
✅ Routenoptimierung (integrierte Effizienzalgorithmen)
✅ Best Practices für die Produktion (Fehlerbehandlung, Wiederholungen)

Enthaltene Tools

Fahrzeugverwaltung (4 Tools)

  • Fahrzeuge auflisten, Fahrzeugdetails abrufen, Echtzeit-Standorte, Statistiken

Routenverwaltung (6 Tools) ⭐ Unsere Spezialität

  • Routen erstellen, aktualisieren, löschen

  • Automatische Stopp-Zustandserhaltung (entscheidend für Zeiterfassung!)

  • Routenoptimierung (Distanz/Zeit minimieren)

  • Routendetails auflisten und abrufen

Fahrerverwaltung (4 Tools)

  • Fahrer auflisten, Fahrerdetails abrufen

  • Überwachung der Einhaltung der Lenk- und Ruhezeiten (HOS)

  • Sicherheitsereignis-Überwachung

Adress- & Standortverwaltung (2 Tools)

  • Gespeicherte Adressen erstellen und verwalten

  • Geofence-Integration

Webhook-Integration (3 Tools)

  • Echtzeit-Benachrichtigungen über Ereignisse

  • Routenaktualisierungen, Fahrzeugereignisse usw.

Kontaktverwaltung (2 Tools)

  • Kontakte für Routenstopps erstellen und verwalten


🚀 Schnellstart

Voraussetzungen

  • Node.js 18+ installiert

  • Samsara API-Token (Hier erhalten)

  • Claude Desktop oder ein MCP-kompatibler Client

Installation

git clone https://github.com/AutomationSquadOS/mcp-samsara
cd mcp-samsara
npm install
npm run build

Hinweis: Das npm-Paket @automation-squad/mcp-samsara ist noch nicht veröffentlicht, daher ist der Klon-und-Build-Pfad derzeit der einzige Installationsweg. Wenn es veröffentlicht wird, wird ein npx-Einzeiler die obigen Schritte ersetzen.

Konfiguration

Fügen Sie zu Ihrer Claude Desktop-Konfigurationsdatei hinzu:

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"
      }
    }
  }
}

Ersetzen Sie /absolute/path/to/mcp-samsara durch den Pfad, in den Sie das Repository geklont haben. Der Pfad muss absolut sein – Claude Desktop löst ~ oder relative Pfade nicht auf.

EU-Kunden: Verwenden Sie https://api.eu.samsara.com für SAMSARA_BASE_URL

Claude neu starten

Beenden Sie Claude Desktop und öffnen Sie es erneut. Die Samsara-Tools sollten nun verfügbar sein!


💡 Beispielnutzung

Route mit Optimierung erstellen

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 wird:

  1. Die Route mit den richtigen Adressen erstellen

  2. Die Stopp-Reihenfolge automatisch optimieren

  3. Alle Stopp-IDs für die Nachverfolgung erhalten

  4. Fahrzeug/Fahrer zuweisen, falls gewünscht

Fahrzeugstandorte verfolgen

Show me real-time locations for all vehicles currently on routes

Fahrer-Compliance überwachen

Get HOS logs for driver John Smith for the past week and check for any violations

🔥 Was dies besser macht

vs. Direkte API-Integration

Funktion

Direkte API

Dieser MCP

Einrichtungszeit

Tage

Minuten

Stopp-Zustandserhaltung

Manuell

Automatisch

Rate-Limiting

Selbst gemacht

Integriert

Fehlerbehandlung

Benutzerdefiniert

Produktionsgetestet

Routenoptimierung

Selbst bauen

Enthalten

Best Practices

Recherche nötig

Integriert

vs. Offizieller MCP (falls vorhanden)

Funktion

Hypothetisch offiziell

Automation Squad

Anzahl Tools

~8-12 grundlegende

21

API-Abdeckung

~10%

Flotte, Routen, Fahrer, HOS, Webhooks

Expertenwissen

❌

✅ Integriert

Routenoptimierung

❌

✅ Enthalten

Zustandserhaltung

Manuell

Automatisch

Aktualisierungen

Sporadisch

Kontinuierlich


🛠️ Architektur

Rate-Limiting

Konservative 5 Anfragen/Sekunde mit automatischer Drosselung und Wiederholungslogik.

Fehlerbehandlung

  • Automatische Wiederholung bei 429 (Rate-Limit)

  • Klare Fehlermeldungen

  • Graceful Degradation

Zustandserhaltung

Kritisches Feature: Beim Aktualisieren von Routen werden automatisch:

  1. Bestehende Route abgerufen

  2. Stopp-IDs extrahiert

  3. Diese bei Aktualisierungen erhalten

  4. Datenverlust verhindert

Dies ist eine Best Practice, die den Verlust von Ankunfts-/Abfahrtszeiten verhindert.


📚 Dokumentation

Umgebungsvariablen

Variable

Erforderlich

Standard

Beschreibung

SAMSARA_API_TOKEN

✅ Ja

-

Ihr Samsara API-Token

SAMSARA_BASE_URL

Nein

https://api.samsara.com

API-Basis-URL (bei Bedarf EU-Endpunkt)

Tool-Namenskonvention

Alle Tools sind zur Klarheit mit samsara_ präfigiert:

  • samsara_list_vehicles

  • samsara_create_route

  • samsara_get_driver_hos

  • usw.


🤝 TMS-Integration

Verwenden Sie externalIds in Routen/Fahrzeugen/Fahrern, um eine Verbindung zu Ihrem TMS herzustellen:

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

Dann nach externer ID abfragen:

Find the route linked to TMS order ORD-12345

🐛 Fehlerbehebung

"Fehler: SAMSARA_API_TOKEN Umgebungsvariable ist erforderlich"

Setzen Sie Ihren API-Token in der Claude-Konfigurationsdatei (siehe Konfiguration oben).

"Samsara API-Fehler (401): Nicht autorisiert"

Ihr API-Token ist ungültig oder abgelaufen. Generieren Sie einen neuen im Samsara-Dashboard.

"Samsara API-Fehler (429): Zu viele Anfragen"

Der MCP wird automatisch wiederholen. Wenn Sie dies häufig sehen, haben Sie möglicherweise andere Integrationen, die auf die API zugreifen.

Tools werden in Claude nicht angezeigt

  1. Überprüfen Sie die Syntax der Konfigurationsdatei (gültiges JSON)

  2. Starten Sie Claude vollständig neu (beenden und erneut öffnen)

  3. Überprüfen Sie die Claude-Protokolle auf Fehler


📦 Was ist enthalten

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

🔐 Sicherheit

  • Ihre Anmeldedaten bleiben lokal - API-Token wird auf Ihrem Rechner gespeichert

  • Keine Datenerfassung - Wir sehen Ihre Samsara-Daten nicht

  • Open Source - Überprüfen Sie den Code selbst

  • Kein Phone-Home - MCP läuft vollständig lokal


📈 Fahrplan

  • Weitere Tools hinzufügen (Disposition, Assets, Tags)

  • Unterstützung für Batch-Operationen

  • Verbesserte Optimierungsalgorithmen

  • Multi-Routen-Optimierung

  • Kraftstoffkostenberechnungen

  • Compliance-Berichtstools


🎓 Mehr erfahren


💬 Support

Beta-Benutzer:


📝 Lizenz

MIT-Lizenz - Siehe LICENSE-Datei für Details


🙏 Danksagungen

Erstellt mit ❤️ von Automation Squad

Nicht verbunden mit Samsara Inc. Dies ist eine unabhängige Integration unter Verwendung der öffentlichen API von Samsara.


⭐ Mehr von Automation Squad

Dokumentation, Installationsschritte und was dieser Server nicht tut: automationsquad.com/mcp/samsara

The AI Five — fünf wissenswerte Dinge über KI und Automatisierung, wöchentlich. Kostenlos abonnieren →


Bereit, Ihr Flottenmanagement zu automatisieren? Los geht's! 🚀

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