Cree un agente de despacho para operaciones de campo con Claude + Crisphive MCP

Qué es esto: un tutorial paso a paso para conectar Claude a una agenda de operaciones de campo en vivo (en un entorno de pruebas), programar un trabajo en lenguaje natural, absorber una emergencia P0 reajustando la agenda en cascada y finalizar con una lista de verificación de preparación para producción. Tiempo: unos 15 minutos. Coste: ninguno; el entorno de pruebas es gratuito, sin tarjeta de crédito y las llamadas MCP no se cobran.

Al terminar, tendrá un asistente capaz de hacer esto:

Usted: Trabajo urgente de fontanería ahora en 99 Bank St para David Okafor (613-555-0198): muéstrame qué hay que reprogramar.

Claude: llama a las herramientas de despacho y devuelve un plan: la emergencia asignada a las 13:15, dos trabajos reprogramados con nuevas horas estimadas de llegada, una alerta por margen ajustado en un SLA y ningún cambio aplicado aún. ¿Aprobar?

Lo importante de esta interacción es lo que Claude no hizo: no inventó el plan. Claude interpreta la solicitud; el motor determinista de resolución de restricciones de Crisphive calcula la agenda (tiempos de desplazamiento, habilidades, certificaciones, descansos protegidos y SLA como restricciones estrictas) y la devuelve para su aprobación. Con los mismos datos de entrada, genera exactamente la misma agenda, siempre. Esta división del trabajo es la arquitectura de todo este tutorial, así que conviene ver un diagrama antes de empezar:

Usted (lenguaje natural)
→ Claude (interpreta la intención, selecciona herramientas)
→ Servidor MCP de Crisphive — https://api.crisphive.com/mcp (43 herramientas)
→ API REST → motor determinista de resolución de restricciones
← plan revisable (trabajos movidos, nuevas horas estimadas de llegada, impacto en SLA)
← Claude explica el plan y los pros y contras
Usted aprueba → la agenda se confirma

Lo que necesita

• Una cuenta de Claude: claude.ai, Claude Desktop o Claude Code sirven por igual; la compatibilidad de conectores depende de su plan.

• Si gestiona una empresa de operaciones de campo en Crisphive: nada más; iniciará sesión con OAuth como propietario de la empresa.

• Si es un desarrollador y no tiene una cuenta de empresa en Crisphive: una clave gratuita para el entorno de pruebas. Regístrese en la página para desarrolladores y obtenga una clave chsk_test_: un entorno de pruebas aislado sobre la misma URL base. Sin tarjeta de crédito ni llamadas comerciales.

En ninguno de los dos casos es necesario instalar ni ejecutar nada. El servidor MCP está alojado en la nube y es remoto, a través de Streamable HTTP.

Paso 1: Conectar Claude a Crisphive

Opción A: Operadores (OAuth, un solo clic)

Abra la ficha de Crisphive en el directorio de conectores de Claude y haga clic en Conectar. Se le solicitará iniciar sesión como propietario de la empresa en Crisphive y autorizar la conexión. Eso es todo la configuración.

¿Prefiere hacerlo manualmente? En claude.ai o Claude Desktop: Configuración → Conectores → Añadir conector personalizado, pegue https://api.crisphive.com/mcp y complete el inicio de sesión OAuth cuando aparezca la pantalla de consentimiento.

Opción B: Desarrolladores (Claude Code + clave de prueba)

claude mcp add --transport http crisphive https://api.crisphive.com/mcp

Para vincular la sesión a su entorno de pruebas aislado en lugar de a una empresa en producción, añada su clave de prueba:

claude mcp add --transport http crisphive https://api.crisphive.com/mcp --header "Authorization: Bearer chsk_test_YOUR_KEY"

Otros clientes de MCP (Cursor, VS Code, Windsurf, Cline, Zed, LM Studio, Gemini CLI) utilizan la misma URL; la tabla completa de clientes está disponible en el README de GitHub. Los clientes que solo admitan stdio pueden conectarse mediante mcp-remote.

Punto de verificación: pregunte a Claude «¿Qué herramientas de Crisphive tienes disponibles?». Debería ver 43 herramientas organizadas en ocho grupos: reserva de trabajos y citas, seguimiento de órdenes de trabajo, despacho y disponibilidad, sincronización de clientes (CRM), catálogos de servicios, cuadrillas y turnos, zonas de servicio y flota.

Paso 2: Explore la agenda

Comience con las tres peticiones del directorio; son las mismas tres que figuran en toda la documentación de Crisphive sobre este conector.

Pruebe primero estas:

1. Programa un trabajo de climatización de 2 horas en 145 Laurier Ave W mañana para Marie Tremblay, 613-555-0142.

2. Trabajo urgente de fontanería ahora en 99 Bank St para David Okafor (613-555-0198): muéstrame qué hay que reprogramar.

3. Haz un resumen de mi jornada de mañana y señala cualquier riesgo.

Ejecute primero la tercera petición: es de solo lectura, por lo que resulta ideal para verificar la conexión de extremo a extremo de forma segura.

Resultado esperado: Claude consulta las herramientas de despacho, disponibilidad y órdenes de trabajo, y después presenta la jornada de mañana como un cronograma ordenado: trayectos entre trabajos, margen por servicio y alertas sobre cualquier riesgo (márgenes de desplazamiento ajustados o trabajos propensos a alargarse). Nada cambia en el panel de despacho; las peticiones de lectura nunca modifican datos.

Paso 3: Programe un trabajo en lenguaje natural

Ahora ejecute la primera petición:

Programa un trabajo de climatización de 2 horas en 145 Laurier Ave W mañana para Marie Tremblay, 613-555-0142.

Qué se activa: reserva de trabajos y citas, sincronización de clientes (para asignar la reserva a la cuenta correcta) y despacho y disponibilidad (quién puede realizarlo realmente).

Resultado esperado: un trabajo programado junto con la justificación de la asignación: qué técnico, por qué se eligió a ese profesional (habilidades, certificación, cercanía, ruta asignada) y el intervalo exacto. Si desea poner a prueba la capacidad de análisis del motor de restricciones, concrete más la solicitud:

El mismo trabajo, pero solo con un técnico certificado en instalaciones de gas, y sin añadir más de 20 minutos de tiempo de conducción al día de ningún trabajador.

El motor de resolución procesa esos requisitos como restricciones estrictas, no como simples sugerencias. Si nadie cumple los criterios, devolverá un aviso claro de «no hay hueco viable» indicando la restricción determinante, en lugar de una estimación al azar.

Paso 4: Absorba una emergencia P0 (reorganización en cascada)

Este paso marca la diferencia entre un agente de programación para operaciones de campo y un simple asistente conversacional con calendario. La rotura de una tubería no espera a un horario conveniente: ¿cómo reprogramar automáticamente el trabajo de los técnicos a mitad del día cuando surge una urgencia?

Trabajo urgente de fontanería ahora en 99 Bank St para David Okafor (613-555-0198): muéstrame qué hay que reprogramar.

Qué se activa: herramientas de despacho y disponibilidad, reserva de trabajos y órdenes de trabajo. El motor de resolución ejecuta una reprogramación en cascada: reordena cada servicio posterior afectado por la inserción, manteniendo como restricciones estrictas los tiempos de desplazamiento, la preparación, el abastecimiento de materiales, los descansos obligatorios y las ventanas de SLA. Una reprogramación completa en cascada se calcula en menos de 3 segundos, según mediciones en una simulación con 20 ubicaciones y una flota de 3 vehículos con todas esas restricciones activas.

Resultado esperado (y esto es fundamental): una propuesta de plan, no una modificación directa. Claude presenta la planificación detallada: dónde se ubica la emergencia, cada trabajo afectado, las nuevas horas estimadas de llegada y el impacto global en los SLA. Nada se aplica definitivamente hasta que usted lo apruebe. En este servidor, todo flujo que modifique datos funciona mediante el par vista previa/confirmación por diseño; un agente que reordene en silencio el panel de despacho real no es una funcionalidad útil, es un incidente operacional.

Apruébelo y, a continuación, pregunte:

¿Por qué se movió el trabajo del calentador de agua de las 14:00 y no la inspección de las 15:00?

Claude lo explicará basándose en los resultados reales del motor de resolución (la restricción determinante y el margen disponible), ya que la planificación proviene del motor de cálculo y no de una suposición del modelo.

Paso 5: Adapte el agente a sus necesidades

Tres formas de personalizar el agente base, cada una a una sola petición de distancia:

• Búsqueda de disponibilidad: «Busca un hueco de 3 horas en mi semana laboral para salir en bicicleta con mi mujer sin poner en riesgo ningún trabajo». Clasifica los huecos libres según el margen disponible en la agenda; no modifica nada.

• Asignación por habilidades y desplazamiento: «¿Qué técnicos certificados en instalaciones de gas tienen disponibilidad el jueves por la mañana a menos de 20 minutos de Kanata?».

• Informe para la gerencia: «Dame un resumen en lenguaje claro sobre la jornada de mañana de todas mis cuadrillas: dónde están los riesgos y si tenemos sobrecarga de trabajo en algún punto».

Las mismas 43 herramientas sirven para un encargado de despacho, un desarrollador o el dueño del negocio: la única diferencia reside en la perspectiva con la que se formule la consulta. En la página de MCP para Claude encontrará una biblioteca de peticiones listas para copiar en esos tres enfoques.

¿Prefiere integrar esto en su propio software en lugar de usar una ventana de chat? Este mismo motor está disponible como API REST: comience en docs.crisphive.com o consulte la comparativa de opciones de integración para evaluar cuándo conviene utilizar MCP frente a la API directa.

Paso 6: Lista de verificación para la puesta en producción

Antes de pasar del entorno de pruebas a producción:

1. Las claves caducan: la validez predeterminada es de 30 días y el correo de aviso de caducidad se envía al propietario de la cuenta de la empresa, no necesariamente a usted. Para agentes en producción, genere claves de 365 días y ejecute una rotación con dos claves: cree la clave B, despliegue, verifique que el tráfico pasa por B y revoque la clave A. Que el agente de una agencia deje de funcionar por un error API_KEY_EXPIRED un mes después del lanzamiento provoca la pérdida del cliente, no un simple informe de fallo.

2. Utilice OAuth para usuarios humanos y claves para servicios. Los tokens OAuth se pueden revocar desde cualquiera de los dos lados (la configuración del conector en Claude o la cuenta de Crisphive) y ninguna clave privada queda expuesta en la ventana de chat.

3. Mantenga activa la opción de vista previa/confirmación. Evite la tentación de autorizar automáticamente las reprogramaciones en cascada para «ahorrar un clic»: el paso de aprobación es lo que permite auditar la labor del agente ante el encargado de despacho que deba ajustar la agenda mañana.

4. Verificación de permisos: el conector solo accede a datos de programación (trabajos, órdenes de trabajo, clientes, cuadrillas, catálogos, zonas y flota). Los datos de facturación y cobros no están expuestos. Verifique que esto se mantenga en cualquier desarrollo posterior.

5. Pruebe los escenarios con errores en el entorno de pruebas primero: un trabajo inviable (sin técnicos cualificados disponibles), una reprogramación en cascada que incumpla un SLA o un token revocado a mitad de sesión. La gestión de errores de su agente es lo que recordarán sus usuarios.

Preguntas frecuentes

¿Necesito una cuenta de empresa en Crisphive para probar esto?

No: el entorno de pruebas gratuito con clave chsk_test_ es un entorno aislado en la misma URL base y no requiere tarjeta de crédito. El inicio de sesión con OAuth se utiliza únicamente para conectar una empresa real como su propietario.

¿Es Claude quien realiza la programación de la agenda?

No, y ese es precisamente el aspecto central. Claude interpreta lo que se le solicita; cada reserva, reprogramación en cascada o ajuste es calculado por el motor determinista de resolución de restricciones de Crisphive. Si hace la misma pregunta dos veces, obtendrá exactamente el mismo plan ambas veces.

¿Puede el agente modificar mi agenda real de forma autónoma?

No. Cualquier acción que modifique servicios existentes se presenta primero como un plan revisable (trabajos movidos, nuevas horas estimadas de llegada e impacto en los SLA) y solo se aplica cuando usted lo aprueba.

¿Tiene algún coste adicional el servidor MCP?

No. El acceso a MCP está incluido en todos los planes de empresa y en el entorno de pruebas gratuito para desarrolladores: las llamadas MCP, las reprogramaciones en cascada y las consultas de lectura no se cobran; la facturación solo contabiliza los trabajos reales en producción.

¿Qué otros clientes son compatibles además de Claude?

Cualquier cliente compatible con servidores MCP remotos mediante Streamable HTTP: ChatGPT, Gemini CLI, Cursor, VS Code, Windsurf, Cline, Zed y LM Studio, entre otros. Los clientes que solo admitan stdio pueden conectarse mediante mcp-remote.

¿Gestiona un equipo de campo y quiere saber qué habría hecho este motor con la agenda del martes pasado? Solicite una auditoría gratuita de agenda: envíe los datos de un día reciente de trabajo y reciba un informe sobre las horas de conducción y la capacidad optimizada en un plazo de 48 horas.