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 Routing24 ofrece y las llama. Esta página describe 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 la sesión iniciada.
- La pestaña realiza el trabajo en el plan que tiene abierto y responde.
De ese enrutamiento se derivan tres condiciones. La mayoría de los fallos de esta página proceden 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 sirve. - Ha aprobado la conexión una vez desde ese navegador. Consulte Conectar Claude y ChatGPT.
Solo un navegador atiende la cuenta a la vez. Cuando aprueba la conexión en un segundo navegador, el primero deja de responder.
El asistente de la aplicación hace el mismo trabajo con las mismas herramientas. Los dos se diferencian en lo que los rodea:
| El asistente de 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 conversor, revisa una reparación de direcciones | Usa solo las 45 herramientas |
| Consume el presupuesto de IA de la cuenta | Consume 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 costes.
Una herramienta marcada con read a continuación solo lee. No puede cambiar el plan, y el servidor la declara como tal, que es el criterio por el que un cliente agrupa sus permisos. Todo lo no 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, recuentos de entidades y cuál está cargado |
routing24_load_plan | Carga un plan guardado por id, guardando antes los cambios sin guardar del plan sustituido |
routing24_new_plan | Inicia un plan vacío nuevo, sustituyendo el cargado tras guardar sus cambios sin guardar |
routing24_save | Guarda el plan de forma persistente y devuelve su enlace |
routing24_plan_urlread | El enlace del plan actual |
Leer el plan de rutas
| Herramienta | Qué hace |
|---|---|
routing24_statusread | El progreso más el resumen del plan de rutas: totales, coste 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 recuentos 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 situados 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 barata |
routing24_edit_unassign_stops | Quita paradas de sus rutas |
routing24_edit_set_route_vehicle | Asigna otro vehículo a una ruta |
routing24_edit_create_route | Añade una ruta vacía para un vehículo |
routing24_edit_remove_routes | Elimina rutas: las paradas que sigan 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 informe de lo que eso incumple |
routing24_edit_clear_user_assigned | Quita esa marca y su informe |
routing24_undo | Retrocede por el historial de edición compartido |
routing24_redo | Avanza de nuevo |
Optimización
| Herramienta | Qué hace |
|---|---|
routing24_reoptimize_plan | Optimiza el plan cargado directamente |
routing24_reoptimize_route | Reordena una ruta, de forma síncrona |
routing24_cancel | Interrumpe una optimización larga, conservando el mejor plan de rutas obtenido hasta el momento |
Datos y scripts
| Herramienta | Qué hace |
|---|---|
routing24_sql_queryread | Lee el plan con SQL sobre ocho tablas en vivo, de los pedidos a 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 a un pedido, depósito o dirección |
routing24_export_excelread | Descarga el plan como libro de Excel |
routing24_map_imageread | Captura el plan como imagen de mapa Retina, con marcadores 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 le asigna 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 un lat y un lng en grados decimales. Routing24 sitúa la fila en ese
punto y nunca llama al geocodificador. Añada también un address para
conservar su propio texto en la fila. Sin él, 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 se sitúa 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 usted ya posee 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 tiene que estar ya 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 crea una con el primer cambio del asistente en 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 crean una sesión.
routing24_list_loaded_plans informa de 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
la usan para mantener sus llamadas en sus propios planes.
Sin ninguna de las dos entradas, la llamada opera sobre el plan de la propia sesión del llamante. Sin sesión, opera sobre el plan de la pestaña enfocada, luego de una pestaña visible y luego de la pestaña vista más recientemente. La pestaña enfocada cambia cada vez que hace clic en otra.
Qué ve mientras un asistente conectado trabaja
- La insignia de la cabecera. En las páginas de ámbito de plan, una
insignia verde muestra el nombre del cliente y hace cuánto llamó, por
ejemplo
Claude (now)oChatGPT (3 min ago). Su tooltip 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. Púlsela 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 con el texto
Session a1b2c3d4 (Claude), y después una fila por llamada con la hora, la acción en palabras llanas y si falló. Las filas de ciclo de vida indican "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 indica "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 tras una superposición a pantalla completa titulada Controlado por el agente, con el texto "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. Pulse Tomar el control para recuperar la aplicación en cualquier momento.
- El panel. Mientras un asistente conectado trabaja, el cuadro de mensaje se sustituye 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 de la aplicación.
Edición compartida
Las ediciones del asistente conectado y las suyas comparten un 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 ha cambiado desde la última lectura del asistente conectado, 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 informa de estos errores en su propia transcripción.
| Qué informa el asistente | Qué ha ocurrido |
|---|---|
| No hay ninguna pestaña del navegador de Routing24 conectada | Ningún navegador con sesión iniciada está vinculado. Abra la aplicación e inicie sesión |
| No hay ninguna pestaña de la aplicación de Routing24 abierta | El navegador está vinculado, pero no hay ninguna pestaña de la aplicación abierta. Abra routing24.com/app |
| La pestaña se cerró mientras ejecutaba una herramienta | La pestaña se cerró en 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 curso continúa en la pestaña |
| Otra pestaña tomó el control mientras esta llamada se ejecutaba | Un segundo navegador se vinculó y sustituyó al primero |
| El estado del plan divergió | El plan cambió desde la última lectura del asistente. 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 unos 600 KB.
- Una pestaña visible para una imagen de mapa. Una ventana oculta deja de renderizar, por lo que la captura agota el tiempo de espera.
- Un navegador vinculado por cuenta. Un asistente conectado trabaja a través de ese navegador y de ningún otro sitio: 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 punto de conexión MCP es el único servidor de Routing24 al que accede un asistente conectado, con un token creado cuando usted aprueba la conexión. Privacidad y tratamiento de datos indica qué envía cada una de esas llamadas y quién recibe los datos que lee un asistente conectado.
Qué cuesta
Conectar un asistente está disponible en todos los niveles. Un asistente conectado consume el presupuesto de su propio proveedor en lugar del presupuesto de IA de la cuenta. Una optimización que inicie consume 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 aparte para la integración entre sistemas, que se configura con el equipo. Consulte Integraciones.
Siguiente paso
Las herramientas de escritura establecen los mismos campos que usted establece a mano. Añadir vehículos y depósitos abre la referencia de lo que significan esos campos.
FAQ
¿Qué necesito para que un asistente conectado funcione?
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. Solo un navegador atiende la cuenta a la vez; 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 la sesión iniciada, y la pestaña realiza el trabajo en 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 punto de conexión MCP es el único servidor de Routing24 al que accede un asistente conectado.
¿En qué se diferencia un asistente conectado del asistente de la aplicación?
Ambos hacen el mismo trabajo con las mismas herramientas. El asistente de la aplicación se abre sin configuración, puede acceder al plan pero no a sus archivos ni a otros sistemas, y consume 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 a otras herramientas, y consume el presupuesto de su propio proveedor.
¿Puedo detener un asistente conectado mientras edita?
Sí. Una edición coloca la aplicación tras una superposición a pantalla completa titulada Controlado por el agente, con un contador de los cambios aplicados hasta el momento. Pulse Tomar el control para recuperar la aplicación en cualquier momento. Cada cambio queda en el historial de deshacer compartido, de modo 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.