Servidor MCP · OAuth 2.1

Tu TMS, dentro de el asistente de IA que ya usas

Transportial habla el Model Context Protocol. Conecta Claude, ChatGPT, Cursor o VS Code una sola vez, inicia sesión y pregunta en lenguaje natural por viajes, pedidos, vehículos y facturas. El asistente trabaja como tú: ve lo que tú ves y solo cambia lo que tú permites.

Conecta tu asistente Guía paso a paso

ClaudeChatGPTClaude CodeCursorVS CodeOAuth 2.1

Asistente de IA · Transportial conectado

¿Qué viajes van con retraso hoy y dónde están ahora esos camiones?

search_trips viajes en curso, ordenados por retraso

get_vehicle_locations última posición de los 3 vehículos

Tres viajes van con retraso:

T-1042 Róterdam → Lyon, 45 min de retraso. Camión cerca de Reims, la siguiente parada es la descarga en Lyon.
T-1057 Venlo → Duisburgo, 20 min de retraso. Esperando en el muelle de carga en Venlo.
T-1063 Amberes → Gante, 15 min de retraso. En la E17, llegada a las 14:25.

MCP es el estándar abierto que permite a los asistentes de IA usar otro software. Con el servidor MCP de Transportial, tu asistente puede consultar viajes, pedidos, vehículos, conductores, clientes, presupuestos y facturas y, cuando tú lo permites, crearlos y modificarlos. Sin exportaciones ni copiar y pegar entre ventanas: tú preguntas, el asistente hace el trabajo en Transportial y te cuenta lo que ha hecho.

Conecta en dos minutos

Añade la URL del servidor a tu asistente. La primera vez que se conecta, se abre una ventana de Transportial donde inicias sesión y apruebas la conexión.

Claude

claude.ai y la aplicación de escritorio de Claude

Abre Configuración › Conectores.
Elige Añadir conector personalizado.
Ponle el nombre Transportial y pega la URL del servidor.
Haz clic en Conectar, inicia sesión en Transportial y aprueba.

ChatGPT

chatgpt.com, con el modo de desarrollador

Abre Configuración › Aplicaciones y conectores y activa el modo de desarrollador en los ajustes avanzados.
Crea un conector con la URL del servidor y OAuth como autenticación.
Inicia sesión en Transportial y aprueba.
Selecciona el conector en un chat nuevo.

Claude Code

En tu terminal

Ejecuta el comando de abajo.
Inicia Claude Code y escribe /mcp.
Elige transportial, después Authenticate, e inicia sesión en el navegador.

Terminal

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

Cursor

Global o por proyecto

Añade el servidor a ~/.cursor/mcp.json, o a .cursor/mcp.json en un proyecto.
Abre los ajustes de MCP en Cursor e inicia sesión en transportial cuando te lo pida.
Inicia sesión en Transportial y aprueba.

Añadir a Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "transportial": {
      "url": "https://api.app.transportial.com/mcp"
    }
  }
}

VS Code

Modo agente de GitHub Copilot

Añade el servidor a .vscode/mcp.json, o ejecuta MCP: Add Server desde la paleta de comandos.
Inicia el servidor y permite el inicio de sesión cuando VS Code te lo pida.
Inicia sesión en Transportial y aprueba.

Añadir a VS Code

.vscode/mcp.json

{
  "servers": {
    "transportial": {
      "type": "http",
      "url": "https://api.app.transportial.com/mcp"
    }
  }
}

Cualquier otro cliente MCP

Servidores remotos por HTTP con OAuth

Apunta el cliente a la URL del servidor.
El cliente encuentra el inicio de sesión por sí mismo mediante el descubrimiento estándar de OAuth y se registra solo.
Inicia sesión en Transportial y aprueba.

Los nombres de los menús pueden variar ligeramente entre versiones y planes de cada asistente. En los planes de equipo y empresa, puede que un propietario tenga que añadir primero el conector para la organización.

Qué ocurre cuando conectas

Tienes el control en cada paso. No se comparte nada hasta que lo apruebas en la propia Transportial.

Añades el servidor
Pega la URL del servidor en tu asistente. Reconoce Transportial y te pide que inicies sesión.
Inicias sesión en Transportial
Se abre una ventana del navegador en Transportial. Inicia sesión como siempre, incluida la autenticación en dos pasos o el inicio de sesión único.
Eliges plataforma y acceso
Elige la plataforma en la que puede trabajar el asistente y si solo puede ver datos o también crearlos, modificarlos y eliminarlos. Después haz clic en Permitir.
Preguntas
De vuelta en el asistente, haz tu pregunta. Llama a Transportial como tú y muestra qué herramientas ha usado.

Qué puede hacer tu asistente

37 herramientas específicas cubren las preguntas y tareas más habituales. Tres herramientas generales llegan al resto de la API de Transportial, más de 800 operaciones, para que el asistente no se quede atascado en el límite de una lista.

Pedidos y envíos

Busca, lee, crea, actualiza y cancela pedidos de transporte, y consulta sus envíos y viajes.

search_transport_ordersVer
get_transport_orderVer
list_transport_order_tripsVer
create_transport_orderModificar
update_transport_orderModificar
cancel_transport_orderModificar
search_consignmentsVer
get_consignmentVer

Viajes

Busca viajes por texto, estado, vehículo, conductor o fecha, lee el viaje completo, confírmalo o cancélalo.

search_tripsVer
get_tripVer
confirm_tripModificar
cancel_tripModificar

Vehículos y conductores

Encuentra vehículos y conductores, consulta los viajes de un vehículo y la última posición conocida de tu flota.

search_vehiclesVer
get_vehicleVer
list_vehicle_tripsVer
get_vehicle_locationsVer
search_chauffeursVer
get_chauffeurVer

Clientes y direcciones

Encuentra clientes, transportistas y otras relaciones comerciales, y direcciones de tu libreta de direcciones. Crea nuevas cuando haga falta.

search_businessesVer
get_businessVer
create_businessModificar
search_locationsVer
get_locationVer
create_locationModificar

Presupuestos y facturas

Busca facturas y presupuestos por administración, crea un presupuesto y envíalo al cliente.

search_administrationsVer
search_invoicesVer
get_invoiceVer
search_quotesVer
get_quoteVer
create_quoteModificar
send_quoteModificar

Licitaciones

Consulta licitaciones y sus detalles.

search_tendersVer
get_tenderVer

Alertas, eventos y chat

Lee las alertas abiertas de planificación y ejecución y resuélvelas, busca eventos y envía un mensaje en un chat.

list_alertsVer
solve_alertModificar
search_eventsVer
send_chat_messageModificar

Todo lo demás

Busca en toda la API, lee cómo funciona una operación y llámala, como el usuario conectado en su plataforma.

search_operations
describe_operation
call_operation

Cosas que preguntar

Pregunta como se lo preguntarías a un compañero. El asistente elige las herramientas adecuadas.

“¿Qué viajes van con retraso hoy y quién los conduce?”
“¿Dónde está ahora el camión 12-BXL-4 y cuál es su próxima parada?”
“Crea un pedido de transporte: 12 palés de Róterdam a Lyon, carga el martes a las 08:00.”
“¿Qué facturas de este cliente siguen abiertas y cuál es el total?”
“Haz un presupuesto para un camión completo de Venlo a Milán y envíalo al cliente.”
“Resume las alertas abiertas de hoy y resuelve las que ya están gestionadas.”
“Envía al conductor del viaje T-1042 un mensaje diciendo que el muelle de descarga ha cambiado al 7.”
“¿Cuáles de nuestros vehículos no tienen viajes planificados mañana?”

Seguro por diseño

El asistente recibe exactamente el acceso que le das, y puedes retirarlo en cualquier momento.

Trabaja como tú
Cada llamada se ejecuta como el usuario conectado, con el rol y los permisos de ese usuario. Un asistente nunca puede hacer más de lo que puedes hacer tú.
Solo lectura o acceso completo
Concede solo Ver datos y la conexión es de solo lectura a todos los niveles: las herramientas que modifican datos desaparecen y Transportial rechaza los cambios.
Una plataforma por conexión
La conexión solo llega a la plataforma que elegiste al aprobarla, aunque trabajes en varias.
Desconecta en cualquier momento
Configuración › Seguridad › Aplicaciones conectadas muestra cada asistente con su plataforma, su acceso y cuándo se usó por última vez. Desconectar termina su acceso de inmediato.
OAuth 2.1 estándar
Inicio de sesión con PKCE, tokens de acceso que duran una hora y tokens de actualización que cambian en cada uso. Reutilizar un token de actualización antiguo termina toda la conexión.
Activado por plataforma
Las aplicaciones conectadas se activan por plataforma. Si la tuya aún no está activada, la pantalla de aprobación lo indica. Pide a tu administrador que lo active o contáctanos.

Detalles técnicos

Para desarrolladores que conectan un cliente o crean su propio agente. El servidor sigue la especificación MCP y los estándares OAuth en los que se basa.

Hub de desarrolladores

Endpoint: POST https://api.app.transportial.com/mcp
Transporte: Streamable HTTP con respuestas JSON. Sin estado, sin flujo de eventos enviados por el servidor.
Versiones del protocolo: 2025-11-25, 2025-06-18 y 2025-03-26.
Descubrimiento: /.well-known/oauth-protected-resource (RFC 9728) y /.well-known/oauth-authorization-server (RFC 8414).
Registro de clientes: Registro dinámico de clientes (RFC 7591) en /oauth/register. URI de redirección HTTPS, loopback y de esquema de aplicación.
Autorización: Código de autorización con PKCE (solo S256). Los tokens están vinculados al servidor MCP como su audiencia.
Scopes: read y write. Un token sin write solo puede llamar a operaciones get, search y exists.
Duraciones: Token de acceso 1 hora, token de actualización 30 días, rotado en cada uso.
Agentes sin usuario: Crea una integración de acceso a la API y usa su clave y secreto con la concesión client_credentials. El token lleva los permisos de la integración.
Límites: Una llamada a una herramienta caduca a los 120 segundos. Los resultados muy largos se cortan con una indicación para pedir menos resultados.

Preguntas frecuentes

¿Qué es MCP?

El Model Context Protocol es un estándar abierto que permite a los asistentes de IA conectarse a otro software mediante herramientas. Claude, ChatGPT, Cursor, VS Code y muchos otros asistentes lo admiten.

¿Qué asistentes de IA puedo conectar?

Cualquier asistente que admita servidores MCP remotos por HTTP con inicio de sesión OAuth, como Claude, ChatGPT en modo de desarrollador, Claude Code, Cursor y VS Code con GitHub Copilot.

¿El asistente ve todos nuestros datos?

Ve lo que ve el usuario conectado en la única plataforma elegida durante la aprobación, y nada más. Los permisos del rol se aplican a cada llamada.

¿Puede el asistente modificar o eliminar datos?

Solo si concedes Crear, modificar y eliminar datos. Con Ver datos únicamente, se rechaza cualquier cambio.

¿Cómo desconecto un asistente?

Abre Configuración › Seguridad, búscalo en Aplicaciones conectadas y haz clic en Desconectar. Su acceso termina de inmediato.

¿Podemos conectar nuestro propio agente de IA?

Sí. Un agente que actúa en nombre de una persona inicia sesión con OAuth como cualquier otro cliente. Un agente que funciona por sí solo usa la clave y el secreto de una integración de acceso a la API.

¿Por qué la pantalla de aprobación dice que las aplicaciones conectadas no están activadas?

Las aplicaciones conectadas se activan por plataforma. Pide a tu administrador o contacta con Transportial para activarlas en tu plataforma.

Lleva Transportial a tu asistente

Añade la URL del servidor, inicia sesión y haz tu primera pregunta.

Lee la guía paso a paso Habla con nosotros