MCP Server

Conecta Routal a Claude, ChatGPT o cualquier cliente MCP — importa paradas, optimiza planes y consulta analítica operativa hablando con tu asistente de IA.

Routal ofrece un servidor MCP hosteado. Conéctalo una vez y tu asistente de IA puede listar tus proyectos, importar paradas, crear y optimizar planes, y responder preguntas sobre tu operación — usando tu propia cuenta de Routal, con tus propios permisos. Un solo servidor funciona con cualquier cliente MCP: Claude, ChatGPT, Claude Code, Cursor y cualquier otro que hable el protocolo. Esta página es la guía de setup para todos ellos.

Datos de conexión


URL del servidor	`https://api.routal.com/mcp`
Transporte	Streamable HTTP
Autenticación	OAuth 2.1 — inicia sesión con tu cuenta de Routal cuando el cliente te lo pida
Credenciales necesarias	Ninguna. Sin API key, sin configuración — el flujo OAuth lo gestiona todo

El servidor soporta dynamic client registration y PKCE, así que cualquier cliente MCP compatible puede conectarse sin credenciales pre-registradas. El asistente actúa como tu usuario de Routal: ve los mismos proyectos, planes y paradas que tú ves en planner.routal.com, y nada más.

Directorio vs. URL manual

Si Routal aparece en el directorio de conectores o apps de tu cliente, conecta desde ahí — un click, el mismo servidor. Los pasos de abajo son para conectar por URL directamente, que funciona hoy en cualquier cliente.

Conectar desde Claude

En claude.ai (web, desktop o móvil — requiere un plan de pago de Claude):

Abre Settings → Connectors.
Click en Add custom connector.
Pega https://api.routal.com/mcp y click en Add.
Click en Connect e inicia sesión con tu cuenta de Routal cuando se abra la ventana de OAuth.

En una conversación nueva ya están disponibles las herramientas de Routal — Claude pide confirmación antes de cualquier herramienta que escriba datos.

Para Claude Code, añade el servidor desde tu terminal:

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

Después ejecuta /mcp dentro de Claude Code para completar el login OAuth.

Conectar desde ChatGPT

En chatgpt.com (web — requiere Plus, Pro, Business, Enterprise o Edu):

Activa el developer mode: Settings → Apps & Connectors → Advanced settings → Developer mode.
Ve a Settings → Apps & Connectors y crea un conector nuevo:
- Name: Routal
- MCP server URL: https://api.routal.com/mcp
- Authentication: OAuth
Inicia sesión con tu cuenta de Routal cuando se abra la ventana de OAuth.
En una conversación, abre el menú de herramientas del composer y activa el conector de Routal.

Los nombres exactos de los menús de ChatGPT cambian entre versiones — si no ves estas opciones, consulta la guía de developer mode de OpenAI.

Conectar desde cualquier otro cliente MCP

Funciona cualquier cliente que soporte Streamable HTTP con OAuth. La forma genérica de configuración:

{
  "mcpServers": {
    "routal": {
      "type": "http",
      "url": "https://api.routal.com/mcp"
    }
  }
}

Cursor, VS Code, Windsurf y la mayoría de frameworks de agentes aceptan exactamente esto en su archivo de configuración MCP, y lanzan el login OAuth en el primer uso.

Qué puede hacer el asistente

El servidor expone 14 herramientas. Las de lectura corren libremente; los clientes bien diseñados piden tu confirmación antes de las cuatro que escriben.

Descubrir y preparar

Herramienta	Qué hace
`list_projects`	Lista los proyectos a los que tu cuenta tiene acceso.
`get_import_schema`	Qué campos y constraints acepta un proyecto — time windows, pickups, peso, custom fields.
`get_organization_resources`	Tu uso vs. los límites de suscripción (usuarios, vehículos, paradas por plan, créditos de SMS/WhatsApp/geocoding).

Planes, paradas y flota

Herramienta	Qué hace
`create_plan` ✏️	Crea un plan vacío para una fecha de ejecución.
`import_stops` ✏️	Importa hasta 100 paradas por llamada — geocodifica direcciones; soporta time windows, pares pickup+delivery, tareas del conductor y paquetes por bulto.
`search_stops`	Filtra paradas por predicado — estado, fecha de ejecución, motivo de cancelación, campos de texto.
`move_stops` ✏️	Mueve paradas a otro plan o de vuelta al inbox de no asignadas.
`list_plans`	Resúmenes paginados de planes con filtros de estado, rango de fechas y texto.
`get_plan`	Detalle completo de un plan — cada parada, ruta y vehículo.
`list_vehicles`	La flota del proyecto: capacidades, skills, precios, estado habilitado.

Optimizar

Herramienta	Qué hace
`optimize_plan` ✏️	Lanza una optimización — asigna paradas a vehículos, las ordena, calcula ETAs. Asíncrona.
`get_optimization_status`	Consulta si la optimización sigue en marcha.
`get_last_optimization`	El resultado final — asignaciones de rutas, tiempos por parada, paradas sin asignar.

Analizar

Herramienta	Qué hace
`get_analytics`	Series temporales de paradas, motivos de cancelación, pruebas de entrega y planes — agrupadas por día/semana/mes/trimestre/año.

✏️ = escribe datos.

Prompts para probar

Importa estas paradas en un plan nuevo para mañana y optimízalo: [pega filas de tu spreadsheet]

¿Qué entregas se cancelaron esta semana y cuál fue el motivo más común?

Busca las paradas incompletas del viernes y muévelas al plan del lunes.

¿Cómo de cerca estamos de los límites de suscripción? Quiero añadir cinco vehículos.

Una sesión de planificación típica encadena las herramientas por ti: el asistente resuelve tu proyecto (list_projects), comprueba qué campos acepta (get_import_schema), crea el plan, importa las paradas en lotes de 100, lanza la optimización, hace polling hasta que termina y lee las rutas resultantes — incluidas las paradas que el optimizador no pudo colocar.

Seguridad y acceso a datos

Autorizas con OAuth, por usuario. El servidor nunca ve una API key, y el asistente solo puede tocar los datos que tu usuario de Routal puede tocar.
Las escrituras son opt-in. Las cuatro herramientas que escriben están anotadas como tales; Claude y ChatGPT piden confirmación antes de ejecutarlas. Todo lo demás es solo lectura.
Revoca cuando quieras. Elimina el conector en los ajustes de tu cliente y su token de acceso deja de funcionar.
Los resultados pasan por tu proveedor de IA. Lo que devuelven las herramientas lo procesa Claude o ChatGPT bajo las políticas de datos de ese proveedor — la misma consideración que pegar los datos tú mismo en el chat.

Troubleshooting

Síntoma	Solución
Las herramientas fallan con `mcp.error.unauthorized` después de funcionar	El token OAuth fue revocado o expiró. Desconecta y reconecta el conector para volver a iniciar sesión.
La optimización "terminó al instante" pero las rutas no cambian	La optimización es asíncrona — la llamada inicial retorna inmediatamente. Pide al asistente que consulte el estado y lea el resultado cuando termine.
"Ya hay una optimización en curso"	Una optimización por plan a la vez. Espera a que termine la actual y reintenta.
Importar cientos de paradas se siente lento	`import_stops` limita a 100 paradas por llamada por diseño; el asistente hace los lotes automáticamente.
Las herramientas no aparecen en ChatGPT	Refresca el conector en Settings → Apps & Connectors y asegúrate de que está activado en el menú de herramientas de la conversación.

¿Sigues atascado? Escribe a developers@routal.com. El servidor MCP comparte el rate limit de la API (2.000 requests/min por organización) — ver Rate limits.

On this page