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
- El cliente MCP lanza el servidor localmente con
npx -y <paquete-mcp-verificado>@latest. - El servidor se autentica contra la API con la variable de entorno de tu clave.
- Expone herramientas del estilo de cálculo de rutas y costes (el corpus documenta
calculate_routecomo herramienta de ejemplo para ruteo y peajes). - 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.