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

Qué es esto: un tutorial paso a paso para conectar Claude a una agenda real (en entorno de pruebas) de operaciones de campo, reservar un trabajo en lenguaje natural, absorber una emergencia P0 con una reprogramación completa en cascada y finalizar con una lista de control de refuerzo 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 facturan nunca.

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

Tú: Trabajo de fontanería urgente ahora mismo en 99 Bank St para David Okafor (613-555-0198); muéstrame qué se reprograma.

Claude: llama a las herramientas de despacho y devuelve un plan: la emergencia programada a las 1:15 pm, dos trabajos movidos con nuevas horas estimadas de llegada (ETA), un SLA marcado como ajustado y nada confirmado aún. ¿Aprobar?

Lo importante de esta transcripción es lo que Claude no hizo: no inventó el plan. Claude interpreta la solicitud; el optimizador de restricciones determinista de Crisphive calcula la agenda —considerando tiempo de desplazamiento, habilidades, certificaciones, descansos protegidos y SLA como restricciones estrictas— y la devuelve para su aprobación. Misma entrada, misma agenda, siempre. Esta división del trabajo es toda la arquitectura de este tutorial, por lo que vale la pena ver un diagrama antes de empezar:

Tú (lenguaje natural)
→ Claude (interpreta la intención, elige herramientas)
→ Servidor MCP de Crisphive — https://api.crisphive.com/mcp (43 herramientas)
→ API REST → optimizador de restricciones determinista
← plan revisable (trabajos movidos, nuevas ETA, impacto en SLA)
← Claude explica el plan y los pros y contras
Tú apruebas → la agenda se confirma

Lo que necesitas

• Una cuenta de Claude — claude.ai, Claude Desktop o Claude Code sirven; el soporte de conectores depende de tu plan.

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

• Si eres desarrollador sin una empresa en Crisphive: una clave gratuita para el entorno de pruebas. Regístrate en la página de desarrolladores y obtén una clave chsk_test_: un entorno de prueba aislado en la misma URL base. Sin tarjeta de crédito ni llamadas comerciales.

En ninguno de los dos casos se instala ni ejecuta nada. El servidor MCP está alojado en la nube de forma remota mediante HTTP en flujo continuo (Streamable HTTP).

Paso 1 — Conectar Claude a Crisphive

Opción A — Operadores (OAuth, un clic)

Abre el directorio de conectores de Claude para Crisphive y haz clic en Conectar. Se te pedirá que inicies sesión como propietario de la empresa en Crisphive y apruebes la conexión. Eso es todo.

¿Prefieres hacerlo manualmente? En claude.ai o Claude Desktop: Configuración → Conectores → Añadir conector personalizado, pega https://api.crisphive.com/mcp y completa el inicio de sesión OAuth cuando se abra 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 tu entorno de pruebas aislado en lugar de a una empresa real, añade tu clave de prueba:

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

Otros clientes 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 admiten stdio pueden conectarse mediante mcp-remote.

Punto de comprobación: pregunta a Claude «¿Qué herramientas de Crisphive tienes disponibles?». Deberías ver 43 herramientas distribuidas 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 personal, territorios de servicio y flota.

Paso 2 — Presentación de la agenda

Empieza con las tres indicaciones del directorio: son las mismas tres que figuran en toda la documentación de Crisphive sobre este conector.

Prueba estas primero:

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

2. Trabajo de fontanería urgente ahora mismo en 99 Bank St para David Okafor (613-555-0198); muéstrame qué se reprograma.

3. Haz un resumen de mi día de mañana y señala cualquier posible riesgo.

Ejecuta primero la indicación 3: es solo de lectura, por lo que es una forma segura de confirmar la conexión de principio a fin.

Resultado esperado: Claude llama a las herramientas de despacho y disponibilidad y a las de órdenes de trabajo, y luego devuelve el día de mañana como una cronología ordenada: trayectos entre trabajos, margen de tiempo por trabajo y alertas sobre cualquier riesgo (ventanas de desplazamiento ajustadas o trabajos propensos a alargarse). Nada se mueve en el panel de despacho; las peticiones de lectura nunca modifican datos.

Paso 3 — Reservar un trabajo en lenguaje natural

Ahora ejecuta la indicación 1:

Programa mañana un trabajo de climatización de 2 horas en 145 Laurier Ave W 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 reservado con la explicación de su asignación: qué técnico, por qué ese técnico (habilidades, certificación, proximidad, ruta actual) y la ventana de tiempo exacta. Si quieres ver al motor de restricciones trabajar con más exigencia, ajusta la petición:

El mismo trabajo, pero solo con un técnico certificado en instalaciones de gas, y no añadas más de 20 minutos de conducción al día de nadie.

El optimizador trata estas condiciones como restricciones estrictas, no como sugerencias. Si nadie las cumple, recibirás un mensaje claro indicando que no hay un hueco viable e identificando la restricción limitante, en lugar de una suposición.

Paso 4 — Absorber una emergencia P0 (la reordenación en cascada)

Este es el paso que distingue a un agente de despacho de un chatbot con calendario. Una tubería reventada no pregunta qué hora te va mejor: ¿cómo reprogramar automáticamente los trabajos de los técnicos a mitad del día cuando surge una urgencia?

Trabajo de fontanería urgente ahora mismo en 99 Bank St para David Okafor (613-555-0198); muéstrame qué se reprograma.

Qué se activa: herramientas de despacho y disponibilidad, reserva de trabajos y órdenes de trabajo, y el optimizador ejecuta una reprogramación en cascada: replanifica cada trabajo posterior afectado por la inserción, manteniendo el tiempo de desplazamiento, el desplazamiento inicial, la recogida de materiales, los descansos protegidos y los márgenes de SLA como restricciones estrictas. Una cascada completa se calcula en menos de 3 segundos, medido en una simulación de flota de 3 vehículos y 20 ubicaciones con dichas restricciones activas.

Resultado esperado (y esto es fundamental): un plan, no un cambio directo. Claude presenta un plan doble: dónde se ubica la emergencia, cada trabajo que se desplaza, cada nueva hora estimada de llegada y el impacto total en los SLA. Nada se confirma hasta que lo apruebes. Cualquier flujo que modifique datos en este servidor es una vista previa con confirmación obligatoria por diseño; un agente que puede reorganizar silenciosamente un panel de despacho real no es una función útil, es un incidente.

Apruébalo y luego pregunta:

¿Por qué se movió el trabajo del termo de las 2 pm pero no la inspección de las 3 pm?

Claude lo explica basándose en los resultados reales del optimizador (la restricción aplicable y el margen disponible), ya que el plan proviene del optimizador y no de la imaginación del modelo.

Paso 5 — Adáptalo a tus necesidades

Tres formas de personalizar este agente base, cada una a una sola indicació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 de la agenda; no se mueve nada.

• Coincidencia por habilidades y desplazamientos: «¿Qué técnicos certificados en instalaciones de gas están libres el jueves por la mañana a menos de 20 minutos de Kanata?».

• Informe para el propietario: «Dame un resumen claro de la jornada de mañana para todas las cuadrillas: dónde están los riesgos y si estamos desbordados en algún sitio».

Las mismas 43 herramientas sirven para un despachador, un desarrollador o un propietario; la única diferencia es la forma de pedirlo. La página de MCP para Claude incluye una biblioteca de indicaciones copiables para los tres perfiles.

¿Quieres integrarlo directamente en tu software en lugar de usar una ventana de chat? El mismo motor funciona como una API REST: empieza en docs.crisphive.com o consulta la comparación de rutas de integración para saber cuándo conviene usar MCP o la API directa.

Paso 6 — Lista de control para el paso a producción

Antes de salir del entorno de pruebas:

1. Las claves caducan: el plazo predeterminado es de 30 días y el correo de aviso se envía al propietario de la empresa, no necesariamente a ti. Para agentes en producción, emite claves de 365 días y realiza una rotación con dos claves: emite la clave B, despliega, verifica el tráfico en B y revoca la clave A. Que el agente de un cliente falle con API_KEY_EXPIRED un mes después del lanzamiento es un motivo de pérdida de clientes, no un simple informe de error.

2. Prioriza OAuth para usuarios y claves para servicios. Los tokens de OAuth se pueden revocar desde ambos lados (la configuración del conector de Claude o la cuenta de Crisphive) y ninguna clave toca jamás una ventana de chat.

3. Mantén activa la opción de vista previa y confirmación. Resiste la tentación de autoaprobar cambios «para ahorrar un clic»: el paso de aprobación es lo que permite que el trabajo del agente sea auditable para el despachador que lo revise mañana.

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

5. Prueba primero las situaciones de error en el entorno de pruebas: un trabajo inviable (sin técnico cualificado), una reprogramación en cascada que incumpla un SLA o un token revocado a mitad de sesión. La gestión de errores de tu agente es lo que tus usuarios recordarán.

Preguntas frecuentes

¿Necesito una empresa registrada 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 OAuth está pensado para conectar una empresa real como propietario.

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

No, y ese es el punto clave. Claude interpreta tus peticiones; cada reserva, reprogramación en cascada o ajuste lo calcula el optimizador de restricciones determinista de Crisphive. Haz la misma pregunta dos veces y obtendrás exactamente la misma planificación.

¿Puede el agente modificar mi agenda real sin mi supervisión?

No. Cualquier cambio que mueva trabajos existentes devuelve un plan revisable (trabajos desplazados, nuevas horas estimadas de llegada e impacto en los SLA) y solo se aplica cuando lo apruebes.

¿Tiene algún coste adicional el servidor MCP?

No. El acceso a MCP está incluido en todos los planes para empresas y en el entorno de pruebas gratuito para desarrolladores. Las llamadas a MCP, las reprogramaciones en cascada, las modificaciones y las lecturas no se facturan nunca; la facturación solo contabiliza los trabajos activos.

¿Qué otros clientes funcionan además de Claude?

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

¿Diriges una cuadrilla de trabajo y quieres ver qué habría hecho este motor con la agenda del martes pasado? Solicita una auditoría gratuita de agenda en la sombra: envía la información de una jornada reciente de trabajo y recibe en 48 horas un análisis de las horas de conducción y la capacidad identificadas.