Yango Delivery MCP

Yango Delivery MCP

English | Русский

A1 Yango Delivery MCP 可将 AI 应用连接到企业 Yango Delivery 账户。使用日常语言估算快递费用、下单呼叫快递员、跟踪路线，并与收件人分享跟踪链接。

此服务适用于国际 Express Claims API。不支持次日送达、取件点或包裹柜。

• 13 个工具。 七个用于配送全流程，五个用于跟踪和联系快递员，另有一个用于直接发起 API 请求。
• 下单前先估算。 无需创建配送申请，即可查询当前价格、路线距离和预计送达时间。
• 创建申请和下单分开进行。 可以先准备并审核申请，再开始搜索快递员。
• 跟踪进行中的配送。 获取配送状态、快递员位置、各地点的预计到达时间、临时电话号码、确认码和收件人跟踪链接。

可以这样开始：

估算将一个 2 kg 的包裹从[取件地址]送到[送达地址]的费用。

连接服务 · 探索使用场景 · 查看技术文档

一分钟了解其工作方式

你： 估算将一个 2 kg 的包裹从我们的仓库送到客户地址的费用。

助手： 已返回当前价格、路线距离和预计送达时间。未创建配送申请。

你： 创建申请，但先不要下单呼叫快递员。

助手： 已创建申请。接受前，我会显示其 ID、价格、状态和版本。

你： 接受报价。

助手： 已接受申请，并开始搜索快递员。

你： 把收件人的跟踪链接发给我。

助手： 已返回目的地的公开跟踪链接。

价格、可用性、状态和取消条款始终以连接的配送账户及当前 API 响应为准。

目录

• 快速开始
• 可以让它做什么
• 配送如何正式开始
• 账户中会发生哪些变化
• 获取访问权限
• 配置
• 数据与遥测
• 限制和后台工作
• 技术文档
• 支持

快速开始

你需要 Node.js 20+、Yango Delivery 企业账户和集成令牌。

1. 获取集成令牌。

2. 使用以下任一说明，将服务添加到你的 AI 应用。

3. 先估算价格：

   估算将一个 2 kg 的包裹从 [取件地址] 运送到 [送达地址] 的费用。

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
    }
  ]
}

你可以让它执行哪些操作

估算快递费用

• 计算当前价格、路线距离和预计送达时间，不创建配送请求。
• 根据提供的地址、重量和尺寸，估算快递、加急或货运服务的费用。
• 检查 API 是否能规划路线并满足所需的车辆或配送要求。

准备并下单预约快递

• 使用发件人和收件人联系方式、路线点、物品及配送要求创建配送请求。
• 在下单前查看返回的价格、状态和请求版本。
• 成功估价后确认请求并开始寻找快递员。
• 按 ID、电话号码、状态、日期或外部订单 ID 查找请求。

跟踪配送并联系快递员

• 获取快递员当前位置以及每个路线点的预计送达时间。
• 为收件人生成公开跟踪链接。
• 获取转接给快递员的临时电话号码。
• 如果当前请求支持，可获取取件或送达确认码。

检查并取消配送

• 检查取消是否免费、需要付费或已无法取消。
• 使用当前版本以及 API 返回的取消模式取消请求。

使用其他 API 方法

raw_request 覆盖没有专用工具的方法，包括资费、配送方式、送达证明、编辑请求和退货操作。它可以创建或更改真实数据，因此适用于了解上游 API 的技术用户。

完整的架构、响应字段和状态详情请参阅工具参考。

配送如何真正开始

1. 估价。 价格查询会返回当前报价、距离和预计到达时间（ETA），但不会创建任何内容。
2. 创建。 账户中会新增一个配送申请，并进入估价阶段。默认情况下，此时尚未下单呼叫快递员。
3. 审核。 查看配送申请的最新状态、价格和版本。申请成功后即可等待确认。
4. 确认。 确认后会开始搜索快递员。从这一步起，配送订单正式下达，并可能产生实际费用。
5. 追踪。 分配快递员后，服务端可返回其位置、预计到达时间（ETA）、联系方式和收件人链接。

估价后的报价通常会在约十分钟后过期。创建配送申请时，如果传入 auto_accept: true，则会跳过单独的审核和确认步骤，并可自动下单呼叫快递员。

账户会发生哪些变化

服务端通过 MCP 注解标明读取、写入和破坏性操作。AI 客户端决定何时以及如何请求确认。

创建配送申请时会使用唯一的 request_id，因此使用相同 ID 重复提交会返回同一条配送申请。如果发生网络错误或收到 5xx 响应，不会自动重试确认和取消操作，因为操作可能已经成功。再次尝试前，请先读取当前配送申请。

获取访问权限

1. 注册成为 Yango Delivery 企业客户，并签署配送服务合同。
2. 打开配送账户中的 集成 标签页。
3. 选择 获取令牌。
4. 将令牌添加到 AI 客户端，变量名为 YANGO_DELIVERY_TOKEN。

令牌与企业账户绑定，不会自行过期，但更改账户密码后会重置。

集成令牌以纯文本形式存储在 AI 客户端的本地配置中。请像保护密码一样保护它，切勿提交包含真实令牌的配置。

配置

数据与遥测

向 Yango Delivery 发送请求

服务端在你的计算机上运行，并将配送申请数据直接发送到 b2b.taxi.yandex.net。集成令牌只会附加到发往已配置 API 主机的请求中。即使是 raw_request，也只接受相对路径，并会阻止解析到其他主机的请求。

匿名遥测

默认情况下，服务端会向 usage.gistrec.cloud 发送技术事件：服务端启动、调用的工具名称，以及启动失败时的固定原因代码。

事件包含随机安装 ID、软件包版本、AI 客户端名称和版本、Node.js 版本及操作系统。**不会读取或发送集成令牌、配送申请数据、工具参数或提示词。**遥测超时时间为两秒，不会阻塞工具调用。

如要停用遥测，请添加：

ASKADS_TELEMETRY=0

实现代码位于 src/telemetry.ts。

限制与后台工作

• 没有已记录的沙盒。 请将创建和接受订单视为生产操作。
• 报价有时限。 报价通常会在估价后约 10 分钟过期；接受前请读取当前订单。
• 跟踪需要有效订单。 在分配快递员之前或订单完成之后，位置、预计到达时间、联系方式和跟踪链接可能不可用。
• 未公布具体的 API 配额。 当 API 返回 429 时，服务端会在存在 Retry-After 的情况下遵循该值，并最多重试 YANGO_DELIVERY_MAX_RETRIES 次。
• 没有后台监控。 只有 AI 应用调用时，服务才会工作。如果应用支持计划任务，可以定期检查有效订单。
• 不会自动回滚。 如果接受或取消操作的结果不确定，请在重复操作前读取订单。

技术文档

• MCP 功能目录 — 每个工具的任务导向页面。
• 所有工具 — 输入架构、响应、状态和错误。
• 开发 — 本地设置和项目检查。
• 发布 — 软件包发布和 MCP 目录收录。
• npm 软件包 — 已发布的 mcp-yango-delivery 软件包。
• Yango/Yandex Delivery API — 上游方法文档。

支持

发现了错误或缺少使用场景？创建问题或通过 Telegram 联系我们。

你已读到最后！