Automation Squad - MCP para Samsara

Integración completa de Samsara Fleet Management para Claude AI
21 herramientas | Conocimiento experto incorporado | Beta

🚀 GRATIS DURANTE LA BETA - ¡Asegura tu descuento de por vida!

⚠️ Aviso Importante

INTEGRACIÓN NO OFICIAL: Este es un servidor MCP de terceros no oficial. Es:

• ❌ NO afiliado, respaldado o patrocinado por Samsara Inc.

• ❌ NO es un producto oficial de Samsara

• ✅ Construido usando la API pública de Samsara con tus propias credenciales API

• ✅ Totalmente compatible con los términos de servicio de la API de Samsara

Samsara® es una marca registrada de Samsara Inc.

Related MCP server: fleetsync-mcp

🎯 Qué Hace Esto

Conecta Claude AI a la API de Samsara Fleet Management con:

✅ 21 herramientas en vehículos, rutas, conductores, direcciones, webhooks y contactos
✅ Conocimiento experto integrado en la descripción de cada herramienta
✅ Preservación automática del estado (IDs de paradas, datos de rutas)
✅ Límite de velocidad inteligente (no alcanzará los límites de la API)
✅ Optimización de rutas (algoritmos de eficiencia incorporados)
✅ Mejores prácticas de producción (manejo de errores, reintentos)

Herramientas Incluidas

Gestión de Vehículos (4 herramientas)

• Listar vehículos, obtener detalles de vehículos, ubicaciones en tiempo real, estadísticas

Gestión de Rutas (6 herramientas) ⭐ Nuestra especialidad

• Crear, actualizar, eliminar rutas

• Preservación automática del estado de las paradas (¡crítico para el seguimiento del tiempo!)

• Optimización de rutas (minimizar distancia/tiempo)

• Listar y obtener detalles de rutas

Gestión de Conductores (4 herramientas)

• Listar conductores, obtener detalles de conductores

• Seguimiento de cumplimiento de Horas de Servicio (HOS)

• Monitoreo de eventos de seguridad

Dirección y Ubicación (2 herramientas)

• Crear y gestionar direcciones guardadas

• Integración de geocercas

Integración de Webhooks (3 herramientas)

• Notificaciones de eventos en tiempo real

• Actualizaciones de rutas, eventos de vehículos, etc.

Gestión de Contactos (2 herramientas)

• Crear y gestionar contactos para paradas de rutas

🚀 Inicio Rápido

Requisitos Previos

• Node.js 18+ instalado

• Token de API de Samsara (Consíguelo aquí)

• Claude Desktop o cualquier cliente compatible con MCP

Instalación

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

Nota: el paquete npm @automation-squad/mcp-samsara aún no está publicado, por lo que clonar y compilar es la única ruta de instalación que funciona hoy. Cuando se lance, un comando de una línea con npx reemplazará los pasos anteriores.

Configuración

Añade a tu archivo de configuración de 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"
      }
    }
  }
}

Reemplaza /absolute/path/to/mcp-samsara con la ubicación donde clonaste el repositorio. La ruta debe ser absoluta — Claude Desktop no resuelve ~ ni rutas relativas.

Clientes de la UE: Usa https://api.eu.samsara.com para SAMSARA_BASE_URL

Reiniciar Claude

Sal y vuelve a abrir Claude Desktop. ¡Deberías ver las herramientas de Samsara disponibles!

💡 Ejemplo de Uso

Crear una ruta con optimización

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. Creará la ruta con las direcciones adecuadas

2. Optimizará automáticamente el orden de las paradas

3. Preservará todos los IDs de paradas para el seguimiento

4. Asignará vehículo/conductor si se solicita

Rastrear ubicaciones de vehículos

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

Monitorear el cumplimiento del conductor

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

🔥 Qué lo Hace Mejor

vs. Construir Integración Directa con la API

vs. MCP Oficial (si existiera)

🛠️ Arquitectura

Límite de Velocidad

5 solicitudes/segundo conservadoras con limitación automática y lógica de reintento.

Manejo de Errores

• Reintento automático en 429 (límite de velocidad)

• Mensajes de error claros

• Degradación gradual

Preservación del Estado

Característica crítica: Al actualizar rutas, automáticamente:

1. Obtenemos la ruta existente

2. Extraemos los IDs de las paradas

3. Los preservamos en las actualizaciones

4. Evitamos la pérdida de datos

Esta es una mejor práctica que evita perder los tiempos de llegada/salida.

📚 Documentación

Variables de Entorno

Convención de Nombres de Herramientas

Todas las herramientas tienen el prefijo samsara_ para mayor claridad:

• samsara_list_vehicles

• samsara_create_route

• samsara_get_driver_hos

• etc.

🤝 Integración con TMS

Usa externalIds en rutas/vehículos/conductores para vincular con tu TMS:

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

Luego consulta por ID externo:

Find the route linked to TMS order ORD-12345

🐛 Solución de Problemas

"Error: la variable de entorno SAMSARA_API_TOKEN es obligatoria"

Establece tu token de API en el archivo de configuración de Claude (consulta Configuración más arriba).

"Error de API de Samsara (401): No autorizado"

Tu token de API no es válido o ha caducado. Genera uno nuevo en el panel de Samsara.

"Error de API de Samsara (429): Demasiadas solicitudes"

El MCP reintentará automáticamente. Si ves esto con frecuencia, es posible que tengas otras integraciones accediendo a la API.

Las herramientas no aparecen en Claude

1. Verifica la sintaxis del archivo de configuración (JSON válido)

2. Reinicia Claude por completo (salir y volver a abrir)

3. Revisa los registros de Claude en busca de errores

📦 Qué Está Incluido

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

🔐 Seguridad

• Tus credenciales se quedan en local - El token de API se almacena en tu máquina

• Sin recopilación de datos - No vemos tus datos de Samsara

• Código abierto - Revisa el código tú mismo

• Sin llamadas a casa - El MCP se ejecuta completamente en local

📈 Hoja de Ruta

• Añadir más herramientas (despacho, activos, etiquetas)

• Soporte para operaciones por lotes

• Algoritmos de optimización mejorados

• Optimización de múltiples rutas

• Cálculos de costos de combustible

• Herramientas de informes de cumplimiento

🎓 Aprende Más

• Documentación de la API de Samsara

• Especificación del Protocolo MCP

• Sitio web de Automation Squad

💬 Soporte

Usuarios Beta:

• Únete a la comunidad de Automation Squad

• Correo electrónico: rob@matrix.digital

• Issues de GitHub: Reportar un error

📝 Licencia

Licencia MIT - Consulta el archivo LICENSE para más detalles

🙏 Créditos

Construido con ❤️ por Automation Squad

No afiliado a Samsara Inc. Esta es una integración independiente que utiliza la API pública de Samsara.

⭐ Más de Automation Squad

Documentación, pasos de instalación y qué no hace este servidor: automationsquad.com/mcp/samsara

The AI Five — cinco cosas que vale la pena saber sobre IA y automatización, semanalmente. Suscríbete gratis →

¿Listo para automatizar la gestión de tu flota? ¡Vamos! 🚀