mcp-yandex-dostavka

 Yandex Dostavka MCP

A1 Yandex Dostavka MCP te permite gestionar la entrega corporativa desde Claude, Codex, Cursor y otras aplicaciones de IA. Tú planteas la tarea en palabras normales y el asistente accede a tu cuenta de Yandex Dostavka, calcula el costo, gestiona los envíos y muestra su estado.

• El mismo día en la ciudad. Calcula la entrega, llama a un mensajero, conoce su ubicación y obtén un enlace para el destinatario.
• Al día siguiente y por toda Rusia. Compara los plazos disponibles y el costo de entrega hasta la puerta.
• A puntos de recogida y taquillas. Encuentra el punto adecuado, calcula las opciones y gestiona la entrega seleccionada.
• Primero el cálculo, luego el pedido. El asistente distingue entre el costo preliminar, la preparación del envío y el momento en que la entrega realmente se gestiona.
• Sin integración propia. Ya incluye 16 acciones listas, esquemas de datos y reglas para trabajar de forma segura con solicitudes repetidas.

Es adecuado para empresas y emprendedores que ya están conectados a la API B2B de Yandex Dostavka y han obtenido un token en su cuenta personal. No es un servicio para remitentes particulares.

Conoce el costo rápidamente

Tú: Calcula la entrega de una caja de 2 kg desde Lva Tolstogo, 16 hasta Tverskaya, 7.

Asistente: Verifiqué la ruta a través de Yandex Dostavka y devolví el costo actual, la distancia y el tiempo aproximado de llegada desde tu cuenta.

Conectar el servidor · Ver escenarios · Abrir documentación técnica

Ver el funcionamiento en un minuto

Tú: Calcula la entrega de un ramo hoy antes de las 18:00 desde la oficina en Lva Tolstogo, 16 al cliente en Tverskaya, 7.

Asistente: Verifiqué la ruta y obtuve el costo preliminar, la distancia y el ETA desde tu cuenta de Yandex Dostavka.

Tú: Gestiona la entrega si el precio final no supera los 1 000 ₽.

Asistente: El precio final está dentro del límite. La entrega está gestionada y la búsqueda de mensajero ha comenzado.

Tú: ¿Dónde está el mensajero ahora y qué enlace debo enviar al destinatario?

Asistente: Obtuve la posición actual del mensajero y el enlace público para rastrear el pedido.

Tú: Ahora busca opciones de entrega para esta caja a Kazán para mañana: a domicilio, en punto de recogida o taquilla.

Asistente: Obtuve las opciones disponibles con plazos y costos. Para puntos de recogida y taquillas mostraré direcciones, horarios y métodos de pago admitidos.

Tú: ¿Puedo cancelar la primera entrega gratis?

Asistente: Primero verifiqué las condiciones de cancelación. Te mostraré si está disponible ahora, si será gratuita y qué monto se cobrará en caso de cancelación de pago.

Los ejemplos muestran la secuencia de acciones disponibles. Los precios, plazos, estados y disponibilidad concretos siempre provienen de tu cuenta de Yandex Dostavka.

Contenido

• Inicio rápido
• Qué se puede encargar
• Cómo trabaja el asistente con la entrega
• Cuándo se crea un pedido real
• Obtención de acceso a la API
• Configuración técnica
• Datos y telemetría
• Limitaciones
• Documentación técnica
• Ayuda y comentarios

Inicio rápido

Se necesitan Node.js 20+ y un token de cliente corporativo de Yandex Dostavka.

1. Obtén el token en tu cuenta personal de Yandex Dostavka.

2. Añade el servidor MCP a tu aplicación de IA.

mcp-yandex-dostavka se ejecuta en tu computadora a través de npx, por lo que las versiones de navegador de ChatGPT y Claude no pueden conectarlo directamente.

codex mcp add yandex-dostavka \
  --env YANDEX_DELIVERY_TOKEN=ваш_токен \
  -- npx -y mcp-yandex-dostavka@latest

codex mcp list

{
  "mcpServers": {
    "yandex-dostavka": {
      "command": "npx",
      "args": ["-y", "mcp-yandex-dostavka@latest"],
      "env": {
        "YANDEX_DELIVERY_TOKEN": "ваш_токен"
      }
    }
  }
}

claude mcp add \
  --env YANDEX_DELIVERY_TOKEN=ваш_токен \
  --transport stdio \
  --scope user \
  yandex-dostavka \
  -- npx -y mcp-yandex-dostavka@latest

claude mcp list

{
  "mcpServers": {
    "yandex-dostavka": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-yandex-dostavka@latest"],
      "env": {
        "YANDEX_DELIVERY_TOKEN": "ваш_токен"
      }
    }
  }
}

{
  "inputs": [
    {
      "type": "promptString",
      "id": "yandex-delivery-token",
      "description": "Токен Яндекс Доставки",
      "password": true
    }
  ],
  "servers": {
    "yandex-dostavka": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-yandex-dostavka@latest"],
      "env": {
        "YANDEX_DELIVERY_TOKEN": "${input:yandex-delivery-token}"
      }
    }
  }
}

Después de conectarte, abre un nuevo diálogo en la aplicación seleccionada y pide:

Calcula la entrega de una caja de 2 kg desde Lva Tolstogo, 16 hasta Tverskaya, 7.

Qué se puede encargar

Entrega el mismo día en la ciudad

• Conocer el costo. Calcular el precio, la distancia y el tiempo aproximado de llegada del mensajero según direcciones, peso y dimensiones del envío.
• Gestionar el envío. Transmitir productos, direcciones, contactos y requisitos del vehículo o mensajero.
• Buscar pedidos. Buscar envíos por estado, teléfono, período o número de pedido de tu empresa.
• Seguir al mensajero. Obtener su posición actual y el enlace público para el destinatario.
• Cancelar con consecuencias conocidas. Primero saber si la cancelación es posible y si tendrá costo.

Entrega al día siguiente y por toda Rusia

• Comparar opciones. Obtener los intervalos disponibles y el costo de entrega hasta la puerta.
• Gestionar la opción seleccionada. Confirmar el plazo, el método de entrega y el precio adecuados.
• Verificar el pedido. Conocer el estado actual y ver el historial de cambios.
• Cancelar el pedido. Enviar una solicitud de cancelación mientras el estado actual lo permita.

Entrega a puntos de recogida y taquillas

• Encontrar el punto adecuado. Buscar puntos de recogida y taquillas por ciudad, coordenadas, tipo y método de pago.
• Verificar condiciones. Consultar dirección, horario, disponibilidad de autoenvío y métodos de pago.
• Calcular y gestionar. Obtener opciones de entrega al punto seleccionado y confirmar la adecuada.

Cómo trabaja el asistente con la entrega

Para entrega el mismo día, el asistente primero calcula la ruta. Cuando pides gestionar el envío, transmite los datos a Yandex Dostavka, espera la evaluación final e inicia la búsqueda de mensajero. Después puedes consultar el estado, ver la posición del mensajero y obtener el enlace de seguimiento.

Para entrega al día siguiente, por toda Rusia, a punto de recogida o taquilla, el asistente obtiene las opciones disponibles con plazos y costos. Tú eliges la opción adecuada y el asistente gestiona el pedido y puede leer su estado actual e historial.

Los valores no se inventan. El costo, el ETA, los intervalos disponibles, las direcciones de los puntos y los estados provienen de tu cuenta de Yandex Dostavka.

El asistente no observa los pedidos constantemente. Verifica el estado de la entrega cuando le planteas una tarea. Si la aplicación de IA admite tareas programadas, puedes configurar verificaciones periódicas en su interfaz, por ejemplo, consultar el estado del pedido cada hora hasta la entrega.

Cuándo se crea un pedido real

Una orden explícita de gestión o cancelación autoriza la acción correspondiente. El comportamiento de confirmaciones adicionales depende de la aplicación de IA: algunos clientes piden permiso antes de cada escritura, otros siguen sus propias políticas.

Obtención de acceso a la API

1. Regístrate como cliente corporativo en dostavka.yandex.ru y firma el contrato. Para entrega al día siguiente, por toda Rusia, a puntos de recogida y taquillas, también conecta una estación de envío.
2. En tu cuenta personal, abre la pestaña «Integraciones» y haz clic en «Obtener token».
3. Transfiere el token al servidor en YANDEX_DELIVERY_TOKEN.

El token tiene validez indefinida, pero deja de funcionar después de cambiar la contraseña de la cuenta personal. Más información: acceso a la API de entrega el mismo día y acceso a la API de entrega para otro día.

El token se almacena en texto plano en la configuración de la aplicación de IA. Trátalo como una contraseña y no agregues la configuración con el token real a Git.

Uno o dos tokens

Normalmente basta con el YANDEX_DELIVERY_TOKEN general. Si diferentes tipos de entrega están conectados en diferentes cuentas, define dos tokens separados:

• YANDEX_DELIVERY_EXPRESS_TOKEN — token de entrega el mismo día;
• YANDEX_DELIVERY_PLATFORM_TOKEN — token de entrega para otro día, por toda Rusia, a puntos de recogida y taquillas.

Si no hay un token general, el servidor necesita ambos tokens separados.

Entorno de prueba

El entorno de prueba solo existe para entrega a otro día, por toda Rusia, a puntos de recogida y taquillas. Define YANDEX_DELIVERY_PLATFORM_BASE_URL=https://b2b.taxi.tst.yandex.net y usa los datos de prueba de la instrucción oficial. Solo procesa direcciones de Moscú.

Para entrega el mismo día no hay entorno de prueba: es seguro verificar el cálculo de costos y la lectura de solicitudes existentes, pero los envíos gestionados entran en el sistema de producción.

Configuración técnica

A nivel técnico, el servidor trabaja con dos partes independientes de la API B2B de Yandex Delivery: la API de entrega el mismo día y la API de entrega para otro día. Pueden tener diferentes tokens, direcciones de servidor, formatos de dinero y unidades de medida — el servidor MCP selecciona los parámetros necesarios por sí mismo.

* El token general no es necesario si se especifican ambos tokens separados.

Datos y telemetría

Solicitudes a Yandex Delivery

El servidor se ejecuta localmente y se comunica directamente con la API de Yandex Delivery. El token Bearer se agrega solo a las solicitudes de la API seleccionada. Incluso la herramienta universal acepta una ruta relativa: si conduce a un servidor externo, la solicitud se bloquea para que el token no se envíe a una dirección ajena.

Telemetría anónima

Por defecto, el servidor envía a usage.gistrec.cloud tres tipos de eventos técnicos: inicio del servidor, nombre de la herramienta invocada y código de motivo del inicio sin token configurado.

El evento incluye un identificador de instalación aleatorio, versión del paquete, nombre y versión de la aplicación de IA, versión de Node.js y sistema operativo. El token, los datos de la cuenta, los argumentos de las herramientas y los textos de las solicitudes no se leen ni se envían. El envío se realiza en segundo plano con un tiempo de espera de 2 segundos y no afecta el funcionamiento del servidor.

Para desactivar la telemetría para servidores MCP A1, agregue a la configuración:

ASKADS_TELEMETRY=0

La implementación se encuentra en src/telemetry.ts.

Limitaciones

• No es solo lectura. El asistente puede crear y cancelar entregas reales; la cancelación puede tener costo.
• La aplicación de IA influye en las confirmaciones. El servidor MCP informa el tipo de cada acción, pero la decisión sobre una pregunta adicional antes de escribir la toma la aplicación y su agente.
• No hay entorno de prueba para entrega el mismo día. Se puede verificar de forma segura el cálculo del costo y la lectura de solicitudes existentes.
• No hay monitoreo continuo. El servidor funciona durante la llamada desde la aplicación de IA. Si la aplicación admite tareas programadas, configure una verificación periódica de estado en su interfaz.
• Puede haber demora durante limitaciones temporales. El servidor espera y reintenta la solicitud por sí mismo. Si Yandex Delivery sigue sin estar disponible, intente nuevamente más tarde.
• No hay reversión automática. La posibilidad y el costo de la cancelación dependen del estado actual y de las reglas de Yandex Delivery.

Documentación técnica

• Catálogo de 16 capacidades MCP — páginas individuales de herramientas en el idioma de las tareas del usuario.
• Referencia técnica de herramientas — datos de entrada, respuestas, estados, errores, formatos de dinero y unidades de medida.
• Desarrollo — ejecución local, verificaciones, compilación y prueba smoke segura.
• Publicación — lanzamiento del paquete npm y listado en catálogos MCP.
• Paquete npm — versión publicada mcp-yandex-dostavka.
• API de entrega el mismo día y API de entrega para otro día — documentación oficial de Yandex Delivery.

Ayuda y comentarios

¿Encontró un error o falta un escenario? Cree un issue o escriba a Telegram.

¡Ha llegado al final!