mcp-yango-delivery

Yango Delivery MCP

Español | Русский

A1 Yango Delivery MCP conecta una aplicación de IA con una cuenta corporativa de Yango Delivery. Calcula el costo de un envío exprés, solicita un mensajero, sigue la ruta y comparte un enlace de seguimiento con el destinatario usando lenguaje natural.

Este servidor funciona con la API internacional de Express Claims. No admite entrega al día siguiente, puntos de recogida ni taquillas de paquetes.

• 13 herramientas. Siete para el ciclo de vida de la entrega, cinco para seguimiento y contacto con el mensajero, más una herramienta de solicitud directa a la API.
• Calcula antes de pedir. Consulta el precio actual, la distancia de la ruta y el tiempo estimado de llegada sin crear una solicitud de entrega.
• Crea y solicita por separado. Una solicitud se puede preparar y revisar antes de que comience la búsqueda de mensajero.
• Sigue una entrega activa. Obtén su estado, la posición del mensajero, los tiempos estimados por punto, el número de teléfono temporal, el código de confirmación y el enlace de seguimiento para el destinatario.

Comienza con:

Calcula la entrega de un paquete de 2 kg desde [dirección de recogida] hasta [dirección de entrega].

Conectar el servidor · Explorar casos de uso · Abrir documentación técnica

Véalo funcionar en un minuto

Usted: Calcula la entrega de un paquete de 2 kg desde nuestro almacén hasta la dirección del cliente.

Asistente: Devolví el precio actual, la distancia de la ruta y el tiempo estimado de llegada. No se creó ninguna solicitud de entrega.

Usted: Crea la solicitud y detente antes de pedir el mensajero.

Asistente: La solicitud se ha creado. Mostraré su id, precio, estado y versión antes de la aceptación.

Usted: Acepta la oferta.

Asistente: La solicitud se ha aceptado y la búsqueda de mensajero ha comenzado.

Usted: Envíame el enlace de seguimiento del destinatario.

Asistente: Devolví el enlace público de seguimiento para el destino.

El precio, la disponibilidad, el estado y las condiciones de cancelación siempre provienen de la cuenta de entrega conectada y de la respuesta actual de la API.

Contenido

• Inicio rápido
• Qué puede pedirle que haga
• Cómo se concreta una entrega
• Qué cambia en la cuenta
• Cómo obtener acceso
• Configuración
• Datos y telemetría
• Límites y trabajo en segundo plano
• Documentación técnica
• Soporte

Inicio rápido

Necesita Node.js 20+, una cuenta corporativa de Yango Delivery y un token de integración.

1. Obtenga un token de integración.

2. Agregue el servidor a su aplicación de IA usando una de las instrucciones a continuación.

3. Comience con un cálculo de precio:

   Calcula la entrega de un paquete de 2 kg desde [dirección de recogida] hasta [dirección de entrega].

codex mcp add yango-delivery \
  --env YANGO_DELIVERY_TOKEN=your_token \
  -- npx -y mcp-yango-delivery@latest

codex mcp list

claude mcp add \
  --env YANGO_DELIVERY_TOKEN=your_token \
  --transport stdio \
  --scope user \
  yango-delivery \
  -- npx -y mcp-yango-delivery@latest

claude mcp list

{
  "mcpServers": {
    "yango-delivery": {
      "command": "npx",
      "args": ["-y", "mcp-yango-delivery@latest"],
      "env": {
        "YANGO_DELIVERY_TOKEN": "your_token"
      }
    }
  }
}

{
  "mcpServers": {
    "yango-delivery": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-yango-delivery@latest"],
      "env": {
        "YANGO_DELIVERY_TOKEN": "your_token"
      }
    }
  }
}

{
  "servers": {
    "yango-delivery": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-yango-delivery@latest"],
      "env": {
        "YANGO_DELIVERY_TOKEN": "${input:yango_delivery_token}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "yango_delivery_token",
      "description": "Yango Delivery integration token",
      "password": true
    }
  ]
}

Qué puede pedirle que haga

Calcular una entrega exprés

• Calcule el precio actual, la distancia de la ruta y el tiempo estimado de llegada sin crear una solicitud.
• Calcule el servicio de mensajero, exprés o carga para las direcciones, el peso y las dimensiones proporcionadas.
• Verifique si la API puede construir la ruta y satisfacer el vehículo solicitado o los requisitos de entrega.

Preparar y solicitar un mensajero

• Cree una solicitud con los contactos del remitente y del destinatario, puntos de ruta, artículos y requisitos de entrega.
• Revise el precio devuelto, el estado y la versión de la solicitud antes de pedir.
• Acepte una solicitud después de una estimación exitosa y comience la búsqueda de mensajero.
• Encuentre una solicitud por id, número de teléfono, estado, fecha o id de pedido externo.

Seguir la entrega y contactar al mensajero

• Obtenga la posición actual del mensajero y el tiempo estimado de llegada para cada punto de ruta.
• Genere un enlace público de seguimiento para el destinatario.
• Obtenga un número de teléfono reenviado temporal para el mensajero.
• Obtenga un código de confirmación de recogida o entrega cuando la solicitud actual lo admita.

Verificar y cancelar una entrega

• Verifique si la cancelación es gratuita, de pago o ya no está disponible.
• Cancele una solicitud usando su versión actual y el modo de cancelación devuelto por la API.

Usar métodos adicionales de la API

raw_request cubre métodos sin una herramienta dedicada, incluidos tarifas, métodos de entrega, comprobante de entrega, edición de solicitudes y operaciones de devolución. Puede crear o cambiar datos reales, por lo que está destinado a usuarios técnicos que comprenden la API upstream.

Los esquemas completos, los campos de respuesta y los detalles de estado están disponibles en la referencia de herramientas.

Cómo se concreta una entrega

1. Calcular. Una verificación de precio devuelve la oferta actual, la distancia y el tiempo estimado de llegada sin crear nada.
2. Crear. Se agrega una solicitud a la cuenta y avanza por la estimación. De forma predeterminada, aún no se solicita ningún mensajero.
3. Revisar. Lea el estado, el precio y la versión más recientes de la solicitud. Una solicitud exitosa queda lista para aprobación.
4. Aceptar. La aceptación inicia la búsqueda de mensajero. A partir de este punto, la entrega está solicitada y puede generar un cargo real.
5. Seguir. Una vez asignado un mensajero, el servidor puede devolver la posición, el tiempo estimado de llegada, los datos de contacto y el enlace del destinatario.

La oferta con precio suele expirar unos diez minutos después de la estimación. Si se pasa auto_accept: true al crear una solicitud, se omite el paso separado de revisión y aceptación, y el mensajero se puede solicitar automáticamente.

Qué cambia en la cuenta

El servidor expone anotaciones MCP para acciones de lectura, escritura y destructivas. El cliente de IA decide cuándo y cómo solicitar confirmación.

La creación de solicitudes usa un request_id único, por lo que repetirla con el mismo id devuelve la misma solicitud. La aceptación y la cancelación no se repiten automáticamente después de un error de red o una respuesta 5xx porque la operación puede ya haber tenido éxito. Lea la solicitud actual antes de intentarlo de nuevo.

Cómo obtener acceso

1. Regístrese como cliente corporativo de Yango Delivery y firme el contrato de servicio de entrega.
2. Abra la pestaña Integración en la cuenta de entrega.
3. Seleccione Obtener token.
4. Agregue el token al cliente de IA como YANGO_DELIVERY_TOKEN.

El token está vinculado a la cuenta corporativa. No expira por sí solo, pero cambiar la contraseña de la cuenta lo restablece.

El token de integración se almacena como texto plano en la configuración local del cliente de IA. Trátelo como una contraseña y nunca confirme una configuración que contenga un token real.

Configuración

Datos y telemetría

Solicitudes a Yango Delivery

El servidor se ejecuta en su máquina y envía los datos de la solicitud directamente a b2b.taxi.yandex.net. El token de integración se adjunta solo a las solicitudes al host de API configurado. Incluso raw_request acepta una ruta relativa y bloquea las solicitudes que se resuelven a otro host.

Telemetría anónima

De forma predeterminada, el servidor envía eventos técnicos a usage.gistrec.cloud: inicio del servidor, nombre de la herramienta llamada y un código de motivo fijo cuando falla el inicio.

Los eventos contienen un id de instalación aleatorio, versión del paquete, nombre y versión del cliente de IA, versión de Node.js y sistema operativo. El token de integración, los datos de la solicitud, los argumentos de las herramientas y las indicaciones no se leen ni se envían. La telemetría tiene un tiempo de espera de dos segundos y no bloquea una llamada de herramienta.

Para desactivar la telemetría, agregue:

ASKADS_TELEMETRY=0

La implementación está en src/telemetry.ts.

Límites y trabajo en segundo plano

• No hay sandbox documentado. Trate la creación y aceptación de solicitudes como operaciones de producción.
• La oferta tiene límite de tiempo. La oferta con precio suele expirar unos diez minutos después de la estimación; lea la solicitud actual antes de aceptar.
• El seguimiento requiere una solicitud activa. La posición, el tiempo estimado de llegada, los datos de contacto y los enlaces de seguimiento pueden no estar disponibles hasta que se asigne un mensajero o después de que se complete la solicitud.
• No se publican cuotas numéricas de la API. Cuando la API devuelve 429, el servidor sigue Retry-After cuando está presente y reintenta hasta YANGO_DELIVERY_MAX_RETRIES.
• No hay monitoreo en segundo plano. El servidor solo funciona cuando se llama desde la aplicación de IA. Si la aplicación admite tareas programadas, puede verificar una solicitud activa periódicamente.
• No hay reversión automática. Después de un resultado incierto de aceptación o cancelación, lea la solicitud antes de repetir la acción.

Documentación técnica

• Catálogo de capacidades MCP — páginas orientadas a tareas para cada herramienta.
• Todas las herramientas — esquemas de entrada, respuestas, estados y errores.
• Desarrollo — configuración local y verificaciones del proyecto.
• Publicación — lanzamiento del paquete y listado en el catálogo MCP.
• Paquete npm — el paquete mcp-yango-delivery publicado.
• API de Yango/Yandex Delivery — documentación de métodos upstream.

Soporte

¿Encontró un error o le falta un caso de uso? Cree un issue o escríbanos en Telegram.

¡Llegaste al final!