Routing24 como servidor MCP
Por Nathan ColeActualizado
Routing24 publica un servidor del Model Context Protocol en
https://routing24.ai/mcp. Un asistente compatible con MCP lista las
herramientas que ofrece Routing24 y las llama. Esta página cubre cómo se
dirige una llamada a su plan, las 45 herramientas que expone el servidor, qué
muestra la aplicación mientras un asistente conectado trabaja y qué significa
cada fallo.
Cómo se dirige una llamada a su plan
Una llamada se dirige en tres pasos. El trabajo ocurre en el último:
- El asistente conectado envía la llamada a
https://routing24.ai/mcp. - El servidor la dirige a su pestaña del navegador de Routing24 con sesión iniciada.
- La pestaña realiza el trabajo sobre el plan que tiene abierto y responde.
De ese enrutamiento se derivan tres condiciones. La mayoría de los fallos de esta página provienen de una de ellas:
- Ha iniciado sesión en Routing24 en un navegador.
- Hay una pestaña de
routing24.com/appabierta. Cualquier página de la aplicación cuenta. - Aprobó la conexión una vez desde ese navegador. Consulte Conectar Claude y ChatGPT.
Un navegador a la vez atiende la cuenta. Cuando aprueba la conexión en un segundo navegador, el primero deja de responder.
El asistente en la aplicación hace el mismo trabajo mediante las mismas herramientas. Los dos difieren en lo que los rodea:
| El asistente en la aplicación | Un asistente conectado |
|---|---|
| Se abre en la aplicación, sin configuración | Se conecta una vez con una URL y una aprobación |
| Puede acceder al plan, no a sus archivos ni a otros sistemas | Accede también a sus archivos, correo y otras herramientas |
| Importa un archivo que usted adjunta, guarda un convertidor, revisa una reparación de direcciones | Usa solo las 45 herramientas |
| Gasta el presupuesto de IA de la cuenta | Gasta el presupuesto de su propio proveedor |
| Se ejecuta mientras el panel está abierto | Necesita cualquier pestaña de la aplicación abierta, en cualquier página |
Qué expone Routing24
Cada herramienta lleva el prefijo routing24_. El vocabulario que lee un
asistente conectado es el vocabulario que usa la aplicación: franjas
horarias, capacidades, turnos, prioridades, etiquetas, pausas, traslados,
secuencias, recargas y costos.
Una herramienta marcada read a continuación solo lee. No puede cambiar el plan, y el servidor la declara como tal, que es como un cliente agrupa sus permisos. Todo lo que no está marcado escribe.
Planes y la cuenta
| Herramienta | Qué hace |
|---|---|
routing24_get_auth_userread | La cuenta con sesión iniciada a la que pertenecerá un plan guardado |
routing24_list_plansread | Los planes guardados: id, nombre, marcas de tiempo, número de entidades y cuál está cargado |
routing24_load_plan | Carga un plan guardado por id, guardando primero los cambios sin guardar del plan reemplazado |
routing24_new_plan | Inicia un plan nuevo vacío, reemplazando el cargado después de guardar sus cambios sin guardar |
routing24_save | Persiste el plan y devuelve su enlace |
routing24_plan_urlread | El enlace del plan actual |
Lectura del plan de rutas
| Herramienta | Qué hace |
|---|---|
routing24_statusread | El progreso más el resumen del plan de rutas: totales, costo y estadísticas por ruta |
routing24_routeread | Las paradas ordenadas de una ruta por su número de ruta en pantalla: ETA, cargas, esperas y problemas |
routing24_unassignedread | Qué pedidos están sin asignar y por qué: ids, diagnósticos y estimaciones de inserción |
Datos del plan
| Herramienta | Qué hace |
|---|---|
routing24_list_stopsread | Lee los pedidos del plan, paginados y filtrables |
routing24_list_vehiclesread | Lee los tipos de vehículo del plan |
routing24_list_depotsread | Lee los depósitos del plan |
routing24_list_addressesread | Lee la libreta de direcciones, con conteos de uso |
routing24_upsert_stops | Crea o actualiza pedidos por id |
routing24_upsert_vehicles | Crea o actualiza tipos de vehículo por id |
routing24_upsert_depots | Crea o actualiza depósitos por id |
routing24_upsert_addresses | Crea o actualiza filas de la libreta de direcciones |
routing24_delete_stops | Elimina pedidos por id |
routing24_delete_vehicles | Elimina tipos de vehículo por id |
routing24_delete_depots | Elimina depósitos: los vehículos que los referencian se eliminan con ellos |
routing24_delete_addresses | Elimina direcciones: los pedidos y depósitos ubicados en ellas se eliminan con ellas |
Edición de rutas
| Herramienta | Qué hace |
|---|---|
routing24_edit_move_stops | Mueve paradas a otra ruta u otra posición, ancladas o en la posición más económica |
routing24_edit_unassign_stops | Quita paradas de sus rutas |
routing24_edit_set_route_vehicle | Asigna un vehículo diferente a una ruta |
routing24_edit_create_route | Agrega una ruta vacía para un vehículo |
routing24_edit_remove_routes | Elimina rutas: las paradas que siguen en ellas quedan sin asignar en la misma edición |
routing24_edit_split_route | Divide una ruta en dos después de una parada |
routing24_edit_merge_routes | Mueve las paradas de otras rutas a una sola ruta |
routing24_edit_mark_user_assigned | Marca paradas como colocadas a mano, con un reporte de lo que eso incumple |
routing24_edit_clear_user_assigned | Quita esa marca y su reporte |
routing24_undo | Retrocede por el historial de edición compartido |
routing24_redo | Avanza de nuevo |
Optimización
| Herramienta | Qué hace |
|---|---|
routing24_reoptimize_plan | Optimiza directamente el plan cargado |
routing24_reoptimize_route | Reordena una ruta, de forma síncrona |
routing24_cancel | Aborta una optimización larga, conservando el mejor plan de rutas hasta el momento |
Datos y scripts
| Herramienta | Qué hace |
|---|---|
routing24_sql_queryread | Lee el plan con SQL sobre ocho tablas en vivo, desde los pedidos hasta las paradas del plan de rutas |
routing24_sql_update | Actualizaciones masivas de campos con SQL, validadas y aplicadas de forma atómica |
routing24_run_script | Transformaciones y análisis en JavaScript aislado sobre un borrador del plan |
La aplicación y la salida
| Herramienta | Qué hace |
|---|---|
routing24_renderread | Navega a la página de optimización para que se dibujen las rutas |
routing24_open_pageread | Abre una de las páginas de la aplicación |
routing24_show_on_mapread | Desplaza el mapa hasta un pedido, un depósito o una dirección |
routing24_export_excelread | Descarga el plan como un libro de Excel |
routing24_map_imageread | Captura el plan como una imagen de mapa Retina, con pines y líneas de ruta |
routing24_session_logread | Lee el registro de acciones de una sesión del asistente, para traspasos y auditorías |
Pestañas y sesiones
| Herramienta | Qué hace |
|---|---|
routing24_list_loaded_plansread | Las pestañas abiertas, el plan abierto en cada una y la sesión del asistente que lo edita |
Coordenadas en lugar de una dirección
Un pedido o un depósito necesita una ubicación. Normalmente usted le da una dirección, y Routing24 geocodifica esa dirección al guardar la fila.
Cuando ya conoce el punto exacto, ponga coordinates en la fila en su lugar,
con una lat y una lng en grados decimales. Routing24 coloca la fila en
ese punto y nunca llama al geocodificador. Agregue también una address para
conservar su propio texto en la fila. Sin ella, la fila muestra
25.19882, 55.27939.
Una dirección escrita como dos números decimales hace lo mismo. Envíe
25.19882, 55.27939 como dirección y la fila queda en ese punto.
Ambas formas funcionan en routing24_upsert_stops y
routing24_upsert_depots, y ambas funcionan por lotes completos a la vez.
Una lista de puntos que ya tiene entra en una sola llamada, sin nada que el
geocodificador pueda interpretar mal.
Las coordenadas solo entran. Ninguna herramienta las devuelve.
A qué plan se dirige una llamada
Un navegador puede tener varios planes abiertos, uno por pestaña. Dos entradas deciden a qué plan se dirige una llamada.
plan_id identifica el plan sobre el que debe operar la llamada. Ese plan
ya tiene que estar abierto en una pestaña. Cuando ninguna pestaña lo tiene
abierto, la llamada falla y nombra los planes que están abiertos.
session_id identifica la propia sesión de edición de un asistente
conectado. Routing24 genera una en el primer cambio del asistente a un plan y
la devuelve en el resultado. Un asistente que fija ese id en cada llamada
posterior conserva su propio plan, incluso cuando usted cambia a otra
pestaña. Las llamadas de solo lectura nunca generan una sesión.
routing24_list_loaded_plans reporta las pestañas abiertas, el plan que cada
una tiene abierto, si la pestaña está vacía, enfocada o visible, y la sesión
del asistente que lo edita. Dos asistentes que trabajan en dos planes lo usan
para mantener sus llamadas en sus propios planes.
Sin ninguna de las dos entradas, la llamada opera sobre el plan de la sesión del propio llamador. Sin sesión, opera sobre el plan de la pestaña enfocada, luego el de una pestaña visible, luego el de la pestaña vista más recientemente. La pestaña enfocada cambia cada vez que usted hace clic en otra.
Qué ve mientras un asistente conectado trabaja
- La insignia del encabezado. En las páginas del plan, una insignia
verde muestra el nombre del cliente y hace cuánto llamó, por ejemplo
Claude (now)oChatGPT (3 min ago). Su descripción emergente muestra la última herramienta por su nombre técnico: "Última acción de Claude: routing24_reoptimize_plan. Haga clic para ver el registro de la sesión." La insignia desaparece cinco minutos después de la última llamada. Presiónela para abrir el panel del asistente en el registro. - El registro de la sesión. El panel del asistente lista cada sesión
bajo un encabezado que dice
Session a1b2c3d4 (Claude), luego una fila por llamada con la hora, la acción en palabras llanas y si falló. Las filas de ciclo de vida dicen "inició esta sesión", "tomó el control de esta sesión" y "se reanudó en otra pestaña". - La barra de desconexión. Debajo del cuadro de mensaje, una barra dice "Claude está conectado a su cuenta" con un botón Desconectar. Consulte Conectar Claude y ChatGPT.
- El bloqueo. Una edición coloca la aplicación detrás de una superposición de pantalla completa titulada Controlado por el agente, que dice "Un agente de IA está editando este plan. La pantalla está bloqueada mientras trabaja; cada cambio queda en el historial de deshacer compartido.", con un contador de los cambios aplicados hasta el momento. Presione Tomar el control para recuperar la aplicación en cualquier momento.
- El panel. Mientras un asistente conectado trabaja, el cuadro de mensaje se reemplaza por "Claude está trabajando en este plan" y un botón Tomar el control.
Las eliminaciones y los cambios masivos de campos de un asistente conectado se aplican sin revisión. Los diálogos de revisión pertenecen al asistente en la aplicación.
Edición compartida
Las ediciones del asistente conectado y las suyas comparten un solo historial de deshacer. Continúe a mano exactamente donde el asistente se detuvo. Consulte Consultar, editar y exportar un plan con IA.
Cuando el plan cambió desde la última vez que el asistente conectado lo leyó, Routing24 rechaza la siguiente edición de ese asistente. No se escribe nada. El rechazo incluye la revisión actual del plan y el último editor. El asistente vuelve a leer el plan, y la misma llamada tiene éxito en el reintento. La aplicación no muestra nada mientras esto ocurre.
Qué significan los errores
Un asistente conectado los reporta en su propia transcripción.
| Lo que reporta el asistente | Qué ocurrió |
|---|---|
| Ninguna pestaña del navegador de Routing24 está conectada | Ningún navegador con sesión iniciada está vinculado. Abra la aplicación e inicie sesión |
| Ninguna pestaña de la aplicación de Routing24 está abierta | El navegador está vinculado, pero ninguna pestaña de la aplicación está abierta. Abra routing24.com/app |
| La pestaña se cerró mientras se ejecutaba una herramienta | La pestaña se cerró a mitad de la llamada. El cambio puede haberse aplicado o no |
| La pestaña no respondió en 60 s | Una herramienta superó el límite de 60 segundos. Una optimización en ejecución continúa en la pestaña |
| Otra pestaña tomó el control mientras esta llamada se ejecutaba | Un segundo navegador se vinculó y reemplazó al primero |
| El estado del plan cambió | El plan cambió desde la última vez que el asistente lo leyó. Lo vuelve a leer y reintenta |
Una optimización larga siempre supera el límite de 60 segundos. La
optimización sigue ejecutándose en la pestaña. El asistente consulta
routing24_status para obtener el resultado en lugar de repetir la llamada.
Límites
- Ocho llamadas en curso a la vez por sesión.
- 120 solicitudes por minuto por cuenta.
- 60 segundos por llamada.
- Una imagen de mapa de alrededor de 600 KB.
- Una pestaña visible para una imagen de mapa. Una ventana oculta deja de renderizar, así que la captura agota el tiempo de espera.
- Un navegador vinculado por cuenta. Un asistente conectado trabaja a través de ese navegador y en ningún otro lugar: Routing24 no ejecuta nada por cuenta propia mientras todas las pestañas están cerradas.
Dónde se ejecuta el trabajo
La optimización se ejecuta en su pestaña del navegador. La geocodificación y las matrices de distancias se ejecutan en los servidores de Routing24 bajo su propia sesión. El endpoint MCP es el único servidor de Routing24 al que accede un asistente conectado, con un token generado cuando usted aprueba la conexión. Privacidad y manejo de datos indica qué envía cada una de esas llamadas y quién recibe los datos que lee un asistente conectado.
Cuánto cuesta
Conectar un asistente está disponible en todos los niveles. Un asistente conectado gasta el presupuesto de su propio proveedor en lugar del presupuesto de IA de la cuenta. Una optimización que inicia gasta la misma asignación que el botón Optimizar. Consulte Describir restricciones en lenguaje natural y Planes, facturación y límites gratuitos.
La API de optimización es un producto Pro independiente para la integración de sistema a sistema, configurado con el equipo. Consulte Integraciones.
Siguiente paso
Las herramientas de escritura establecen los mismos campos que usted establece a mano. Agregar vehículos y depósitos abre la referencia de lo que significan esos campos.
FAQ
¿Qué necesito para que funcione un asistente conectado?
Un asistente conectado necesita tres cosas: que haya iniciado sesión en Routing24 en un navegador, que haya una pestaña de routing24.com/app abierta en cualquier página de la aplicación y que haya aprobado la conexión una vez desde ese navegador. Un navegador a la vez atiende la cuenta; aprobar la conexión en un segundo navegador hace que el primero deje de responder.
¿Dónde se ejecuta realmente el trabajo de un asistente conectado?
La llamada se dirige a su pestaña del navegador con sesión iniciada, y la pestaña realiza el trabajo sobre el plan que tiene abierto. La optimización se ejecuta en el navegador. La geocodificación y las matrices de distancias se ejecutan en los servidores de Routing24 bajo su propia sesión. El endpoint MCP es el único servidor de Routing24 al que accede un asistente conectado.
¿En qué se diferencia un asistente conectado del asistente en la aplicación?
Ambos hacen el mismo trabajo mediante las mismas herramientas. El asistente en la aplicación se abre sin configuración, puede acceder al plan pero no a sus archivos ni a otros sistemas, y gasta el presupuesto de IA de la cuenta. Un asistente conectado se conecta una vez con una URL y una aprobación, accede también a sus archivos y otras herramientas, y gasta el presupuesto de su propio proveedor.
¿Puedo detener a un asistente conectado mientras edita?
Sí. Una edición coloca la aplicación detrás de una superposición de pantalla completa titulada Controlado por el agente, con un contador de los cambios aplicados hasta el momento. Presione Tomar el control para recuperar la aplicación en cualquier momento. Cada cambio queda en el historial de deshacer compartido, así que puede continuar a mano exactamente donde el asistente se detuvo.
¿Por qué una optimización larga agota el tiempo de espera para un asistente conectado?
Cada llamada tiene un límite de 60 segundos, y una optimización larga siempre lo supera. La optimización sigue ejecutándose en la pestaña; solo termina la llamada. El asistente consulta la herramienta de estado para obtener el resultado en lugar de repetir la llamada y lee el plan de rutas cuando la ejecución termina.