El servidor MCP de Samsara conecta asistentes y agentes de IA con sus datos de Samsara mediante el Protocolo de Contexto de Modelos (MCP), un estándar abierto que herramientas como Claude utilizan para comunicarse con sistemas externos. Cuando conecta un cliente compatible, puede hacer preguntas sobre su flota en lenguaje natural y obtener respuestas basadas en sus datos de Samsara en tiempo real, sin copiar y pegar, exportar ni cambiar entre herramientas.
La misma conexión funciona con Claude, Cursor, agentes empresariales de Copilot y marcos de agentes que usted cree. El servidor MCP es de solo lectura: puede responder preguntas sobre sus datos, pero no puede cambiar la configuración, enviar mensajes ni realizar asignaciones en su cuenta de Samsara. MCP no reemplaza la API REST de Samsara, que sigue siendo la opción adecuada para integraciones y transferencias de datos de gran volumen. MCP es para flujos de trabajo conversacionales e impulsados por agentes.
El servidor MCP de Samsara utiliza OAuth. La primera vez que su cliente de IA se conecta, abre una ventana del navegador en la que usted inicia sesión con sus credenciales de Samsara.
El acceso coincide con su identidad, rol y alcance de etiquetas en el panel de Samsara. Un agente que actúa en su nombre solo puede ver los datos que usted puede ver. Los administradores ven datos de nivel de administrador; un usuario limitado a una etiqueta solo ve esa etiqueta.
Cualquier persona con un inicio de sesión de panel de Samsara puede utilizar el servidor MCP. Cada usuario inicia sesión de forma individual. El servidor MCP expone los propios datos operativos de su organización: los mismos datos que ve en el panel.
Nota
Si encuentra una incidencia, comparta la transcripción completa de la conversación (sus prompts y las llamadas a herramientas que realizó el agente) con su contacto de Samsara o en un ticket de soporte. El agente se ejecuta en su cliente de IA, no del lado de Samsara, por lo que la transcripción es la forma más rápida de obtener un diagnóstico.
Utilice la URL de MCP que corresponda a la región de su panel de Samsara. Su cliente le solicita iniciar sesión con su inicio de sesión de Samsara en la primera conexión.
|
Región |
Panel |
Punto de conexión de MCP |
|---|---|---|
|
Estados Unidos |
|
|
|
Europa / Reino Unido |
|
|
|
Canadá |
|
|
Haga coincidir la URL de MCP con el panel en el que inicia sesión. Algunos clientes canadienses que todavía están en la nube de EE. UU. (cloud.samsara.com) deben utilizar el punto de conexión de EE. UU. Si su organización tiene organizaciones en más de una región, agregue el servidor MCP una vez por región.
Agregue el servidor a .cursor/mcp.json (por proyecto) o a ~/.cursor/mcp.json (global). Sustituya la URL por la correspondiente a su región de la tabla anterior:
{
"mcpServers": {
"samsara": {
"url": "https://mcp.samsara.com/v2/mcp"
}
}
}
Cursor le solicita iniciar sesión con sus credenciales de Samsara la primera vez que se utiliza el servidor.
-
Agregue el servidor:
claude mcp add --transport http samsara https://mcp.samsara.com/v2/mcp
Use
https://mcp.eu.samsara.com/v2/mcpohttps://mcp.ca.samsara.com/v2/mcpsi esa es su región. -
Ejecute
/mcpen Claude Code para autenticarse y actualizar la lista de herramientas después de las actualizaciones.
El propietario de la organización de Claude puede poner el MCP a disposición de todos los usuarios agregándolo como un conector personalizado. Use la URL correspondiente a su región de la tabla anterior.
-
En Claude, abra Configuración > Conectores > Agregar conector personalizado.
-
Agregue el punto de conexión del MCP de Samsara. Después de agregarlo, cualquier usuario puede buscar el MCP en Configuración > Conectores.
Para ver instrucciones detalladas de Claude, consulte Comenzar a usar conectores personalizados con MCP remoto.
Cualquier cliente que admita servidores MCP remotos con inicio de sesión mediante OAuth (por ejemplo, Microsoft Copilot Studio o marcos de agentes como Bedrock AgentCore) puede conectarse usando la misma URL de servidor regional de la tabla anterior. Los detalles de configuración varían según el cliente.
El conjunto de herramientas abarca visibilidad de la flota y los activos, grupos de remolques, datos de conductores y seguridad vial, cumplimiento normativo (horas de servicio e inspecciones vehiculares) y ubicaciones. Ejemplos de preguntas que puede hacer:
-
¿Qué conductores tienen horas de servicio disponibles en este momento?
-
Enumere los informes de inspección de ayer con defectos sin resolver para que pueda crear órdenes de trabajo.
-
Antes del traslado de la cuadrilla de mañana, ¿qué camiones tienen menos de un cuarto de tanque de combustible?
Para consultar todas las herramientas con prompts de ejemplo, vea la Referencia de herramientas del MCP de Samsara.
Comentarios
0 comentarios
El artículo está cerrado para comentarios.