MCPModel Context Protocolagentes IApeajesAPI

MCP de peajes: conectar agentes IA a la API de Tolls Calculator

Qué es un servidor MCP de peajes, cómo funciona @cargoffer/mcp-server-transcend, configuración en Claude Desktop y Cursor, y cómo diseñar una integración para calcular peajes.

Por Jorge Parada, CTO de Cargoffer

MCP de peajes: conectar agentes IA a la API de Tolls Calculator

Respuesta directa: MCP (Model Context Protocol) es el estándar que permite a un asistente o agente IA llamar a herramientas externas. Para peajes, el servidor MCP configurado por el equipo integrador actúa de puente: el agente (Claude Desktop, Cursor u otro cliente MCP compatible) le pide rutas, peajes y costes, y el servidor ejecuta las llamadas reales contra la API de Tolls Calculator con tu API key local. Es la integración más directa: una vez configurada, funciona igual en todos los clientes MCP.

Cómo funciona el servidor MCP de peajes

  1. El cliente MCP lanza el servidor localmente con npx -y <paquete-mcp-verificado>@latest.
  2. El servidor se autentica contra la API con la variable de entorno de tu clave.
  3. Expone herramientas del estilo de cálculo de rutas y costes (el corpus documenta calculate_route como herramienta de ejemplo para ruteo y peajes).
  4. El agente decide cuándo llamarlas y presenta el resultado con el desglose que devuelve la API.

Configuración en Claude Desktop

En claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

{
  "mcpServers": {
    "tolls": {
      "command": "npx",
      "args": ["-y", "@cargoffer/mcp-server-transcend@latest"],
      "env": { "CARGOFFER_API_KEY": "tu_api_key" }
    }
  }
}

Guía completa paso a paso: integrar Tolls Calculator en Claude Desktop.

Configuración en Cursor

Cursor → Settings → Features → MCP → Add New MCP Server, con el mismo comando. La ventaja práctica: el agente de Cursor puede escribirte código que consuma la API comprobando en vivo parámetros y respuestas. Guía: automatizar logística desde Cursor.

¿MCP o Acciones/function calling?

  • MCP: una sola configuración, todos los clientes MCP; la key vive en tu máquina. Ideal para usuarios de Claude/Cursor y agentes locales.
  • GPT con Acciones: usuarios de ChatGPT sin instalar nada, pero la key queda registrada en la plataforma. Ver calcular peajes con ChatGPT.
  • Function calling: control total, pero es código tuyo. Ver calcular peajes con Gemini.

Seguridad y límites honestos

  • El servidor MCP corre en tu máquina y usa tu clave: no expongas la cuenta maestra a usuarios no técnicos.
  • El agente puede alucinar en la interpretación (comparar rutas, sugerir horarios); los importes vienen de la API, no del modelo —exige siempre el desglose.
  • Verifica la versión del paquete en el registro npm público; el corpus documenta @latest, pero en producción fija una versión.

Aviso: el nombre de paquete y las herramientas citadas son los documentados por Cargoffer en su corpus; confirma nombre exacto y versión en el registro npm y en las notas del producto antes de desplegar.

Preguntas frecuentes

¿Qué es un MCP de peajes?
Un servidor del estándar Model Context Protocol que expone las llamadas de la API de peajes como herramientas para agentes IA (Claude Desktop, Cursor, etc.).
¿Qué paquete implementa el MCP de Tolls Calculator?
El corpus documenta @cargoffer/mcp-server-transcend lanzado con npx; verifica la versión y el nombre exactos en el registro npm público antes de producción.
¿Dónde queda la API key con MCP?
En la configuración local del cliente MCP (variable de entorno de tu máquina); no se registra en la plataforma del modelo.
¿El agente puede inventarse un importe de peaje?
No si la integración es correcta: los importes los devuelve la API consultada en vivo; el agente solo los formatea. Desconfía de cifras sin desglose ni fecha de consulta.

Recursos relacionados

¿Listo para calcular peajes con datos en vivo?