关于 OptimoRoute MCP by usefulapi
OptimoRoute MCP by usefulapi 是面向 OptimoRoute 团队的托管 MCP 服务,用于处理配送业务。它既可查询路线和订单,也支持创建订单、规划路线及向司机派送路线。
主要功能
- 01查看路线、订单和司机事件
- 02查询排程、规划与派送状态
- 03创建或批量更新订单
- 04启动路线规划并发送路线
- 05更新司机参数和订单完成信息
适用场景
- 01检查某日的配送路线
- 02查找订单及其完成详情
- 03批量录入订单并启动规划
- 04将路线发送给司机
MCP 相关
它向 MCP 客户端提供 OptimoRoute 路线、订单、规划和司机事件等操作。托管服务通过 OAuth 登录,并要求用户提供 OptimoRoute WS API key。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://optimoroute.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-optimoroute https://optimoroute.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-optimoroute":{"type":"http","url":"https://optimoroute.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-optimoroute":{"type":"http","url":"https://optimoroute.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-optimoroute":{"type":"http","url":"https://optimoroute.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-optimoroute":{"serverUrl":"https://optimoroute.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
15| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| date | string | 是 | YYYY-MM-DD 格式的日期,例如 2026-09-30。 |
| driverSerial | string | 否 | 仅返回该驾驶员的路线(序列号)。 |
| driverExternalId | string | 否 | 仅返回该驾驶员的路线(外部 ID)。 |
| vehicleRegistration | string | 否 | 仅返回该车辆的路线。 |
| includeRoutePolyline | boolean | 否 | 包含编码后的路线折线(数据量较大)。 |
| includeRouteStartEnd | boolean | 否 | 包含每条路线的起点和终点位置。 |
| includeDispatchStatus | boolean | 否 | 包含每条路线是否已发送给驾驶员,以及此后是否有更改。 |
详细介绍
usefulapi 提供的 OptimoRoute MCP
通过 Claude、Cursor 或任何 MCP 客户端使用 OptimoRoute——查看路线、订单、排程和司机事件,并创建订单、运行规划以及向司机发送路线。 托管服务,无需本地安装:使用你自己的 OptimoRoute 凭据连接。
在线端点: https://optimoroute.usefulapi.io/mcp · 主页: https://usefulapi.io/optimoroute
连接
- Claude(claude.ai、Desktop):打开 Customize → Connectors,点击 + Add → Add custom connector,然后粘贴
https://optimoroute.usefulapi.io/mcp。 - Claude Code:
claude mcp add --transport http optimoroute https://optimoroute.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code: 添加到 VS Code。
- Cursor 和其他客户端: 将该 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"optimoroute": {
"url": "https://optimoroute.usefulapi.io/mcp"
}
}
}
只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 OptimoRoute 凭据。
分步设置说明、凭据查找位置及常见问题解答:https://usefulapi.io/optimoroute/
首次连接时,你需要提供 OptimoRoute WS API 密钥(Administration > Settings > WS API)。 系统会验证并按用户存储这些密钥,且仅限你本人使用——配置文件中不会包含密钥。
工具
| 工具 | 类型 | 功能 |
|---|---|---|
optimoroute_get_routes | 读取 | 获取指定日期的路线 |
optimoroute_get_orders | 读取 | 获取订单 |
optimoroute_search_orders | 读取 | 搜索订单 |
optimoroute_get_scheduling_info | 读取 | 获取订单的排程信息 |
optimoroute_get_completion_details | 读取 | 获取订单完成详情 |
optimoroute_get_events | 读取 | 获取移动端事件 |
optimoroute_get_planning_status | 读取 | 获取规划状态 |
optimoroute_get_dispatch_status | 读取 | 获取派遣状态 |
optimoroute_create_order | 写入 | 创建或更新订单 |
optimoroute_create_or_update_orders | 写入 | 批量创建或更新订单 |
optimoroute_start_planning | 写入 | 开始路线规划 |
optimoroute_stop_planning | 写入 | 停止路线规划 |
optimoroute_update_driver_parameters | 写入 | 更新指定日期的司机参数 |
optimoroute_update_completion_details | 写入 | 更新订单完成状态 |
optimoroute_send_routes | 写入 | 向司机发送路线 |
optimoroute_usage_status | meta | 使用情况(免费套餐用量计量) |
optimoroute_request_feature | meta | 请求添加缺失功能 |
optimoroute_upgrade | meta | 升级到 Pro(不限量*) |
optimoroute_cancel_subscription | meta | 取消 Pro 订阅 |
read 工具为只读;write 工具会修改数据(客户端应在执行前确认);meta 工具用于报告使用情况、管理订阅或发送功能请求。
定价
| 套餐 | 价格 | 限额 |
|---|---|---|
| 免费 | $0 | 每月 50 次工具调用 |
| Pro(按用户计费) | $9/mo 或 $90/yr(免费 2 个月) | 不限量* |
*Pro 在此服务上的合理使用限额为每月 10,000 次工具调用。如需更多,请发送邮件至 [email protected]。
Pro 仅适用于此服务。使用 optimoroute_upgrade 订阅(该工具会返回 Stripe Checkout 链接)。你可以随时使用 optimoroute_cancel_subscription 取消:Pro 权益会持续到付费周期结束,当前周期不予退款;在此之前运行 optimoroute_upgrade 可撤销取消操作。你也可以发送邮件至 [email protected]。
许可证
MIT © usefulapi。与 OptimoRoute 无关联,也未获其认可。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。