关于 Sortly MCP by usefulapi
Sortly MCP by usefulapi 是托管式服务,可通过 Claude、Cursor 等 MCP 客户端访问 Sortly 库存。它整合库存与预警查询,以及工作任务、采购订单和库存更新操作。
主要功能
- 01搜索物品和文件夹
- 02查看库存与低库存预警
- 03查看工作任务和采购订单
- 04创建和更新库存物品
- 05移动库存并管理任务物品
适用场景
- 01查找库存物品或文件夹
- 02检查低库存预警
- 03跟踪分配给工作任务的物品
- 04起草采购订单
MCP 相关
向 MCP 客户端提供 Sortly 库存、预警、工作任务、采购订单及更新工具。托管服务使用用户的 Sortly API secret key 连接。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://sortly.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-sortly https://sortly.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-sortly":{"type":"http","url":"https://sortly.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-sortly":{"type":"http","url":"https://sortly.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-sortly":{"type":"http","url":"https://sortly.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-sortly":{"serverUrl":"https://sortly.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
20| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| page | integer | 否 | 页码,从 1 开始。 |
| include | array | 否 | 要嵌入的嵌套关联:custom_attributes 和/或 photos。 |
| per_page | integer | 否 | 每页条目数,1–1000(默认值:10)。 |
| folder_id | integer | 否 | 仅列出此文件夹的直接内容。省略则列出根级内容。 |
| include_subfolders | boolean | 否 | 与 folder_id 一起使用:同时返回其下的所有嵌套内容。默认值为 false。 |
详细介绍
usefulapi 提供的 Sortly MCP
通过 Claude、Cursor 或任何 MCP 客户端使用 Sortly — 搜索物品和文件夹、查看库存水平和低库存提醒,并跟踪工作和采购订单。 托管服务,无需本地安装:使用你自己的 Sortly 凭据进行连接。
实时端点: https://sortly.usefulapi.io/mcp · 主页: https://usefulapi.io/sortly
连接
- Claude(claude.ai、Desktop):打开 Customize → Connectors,点击 + Add → Add custom connector,然后粘贴
https://sortly.usefulapi.io/mcp。 - Claude Code: 运行
claude mcp add --transport http sortly https://sortly.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code: 添加到 VS Code。
- Cursor 和其他客户端: 将此 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"sortly": {
"url": "https://sortly.usefulapi.io/mcp"
}
}
}
只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 Sortly 凭据。
分步设置说明、凭据查找位置和常见问题:https://usefulapi.io/sortly/
首次连接时,你需要提供 Sortly API 密钥(app.sortly.com/public-api)。 系统会验证密钥,按用户存储,并将其限定为仅供你使用 — 配置文件中不会包含密钥。
工具
| 工具 | 类型 | 功能 |
|---|---|---|
sortly_list_items | read | 列出物品和文件夹 |
sortly_get_item | read | 获取一个物品或文件夹 |
sortly_search_items | read | 搜索库存 |
sortly_list_recently_updated_items | read | 列出最近更新的物品 |
sortly_list_custom_fields | read | 列出自定义字段 |
sortly_list_units | read | 列出计量单位 |
sortly_list_alerts | read | 列出提醒 |
sortly_list_jobs | read | 列出工作 |
sortly_get_job | read | 获取一项工作 |
sortly_list_purchase_orders | read | 列出采购订单 |
sortly_get_purchase_order | read | 获取一张采购订单 |
sortly_get_purchase_order_receive_status | read | 获取采购订单的收货状态 |
sortly_create_item | write | 创建物品或文件夹 |
sortly_update_item | write | 更新物品或文件夹 |
sortly_move_item | write | 将库存移至其他文件夹 |
sortly_create_alert | write | 创建提醒 |
sortly_create_job | write | 创建工作 |
sortly_pull_items_into_job | write | 将物品调入工作 |
sortly_return_items_from_job | write | 从工作中归还物品 |
sortly_create_purchase_order | write | 起草采购订单 |
sortly_usage_status | meta | 使用情况(免费套餐用量计量) |
sortly_request_feature | meta | 请求添加缺失的功能 |
sortly_upgrade | meta | 升级到 Pro(不限量*) |
sortly_cancel_subscription | meta | 取消 Pro 订阅 |
read 工具为只读;write 工具会修改数据(客户端应先征求确认);meta 工具用于报告使用情况、管理订阅或发送功能请求。
价格
| 套餐 | 价格 | 限额 |
|---|---|---|
| Free | $0 | 每月 50 次工具调用 |
| Pro(每位用户) | $9/mo 或 $90/yr(赠送 2 个月) | 不限量* |
*此服务上的 Pro 套餐每月公平使用限额为 10,000 次工具调用。如需更多,请联系 [email protected]。
Pro 仅适用于此服务。运行 sortly_upgrade 即可订阅(该工具会返回 Stripe Checkout 链接)。你可以随时运行 sortly_cancel_subscription 取消:Pro 将持续至付费期结束,当前付费期不予退款;在此之前运行 sortly_upgrade 可撤销取消操作。或者联系 [email protected]。
许可证
MIT © usefulapi。与 Sortly 无关联,也未获其认可。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。