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: fleetsync-mcp

🎯 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

vs. Offizieller MCP (falls vorhanden)

🛠️ 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

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

• Samsara API-Dokumentation

• MCP-Protokollspezifikation

• Automation Squad Website

💬 Support

Beta-Benutzer:

• Treten Sie der Automation Squad Community bei

• E-Mail: rob@matrix.digital

• GitHub Issues: Einen Fehler melden

📝 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! 🚀