关于 UpKeep MCP by usefulapi
UpKeep MCP by usefulapi 将 MCP 客户端连接到 UpKeep 维护记录,支持查询资产和工单,也可创建请求及更新工单。
主要功能
- 01浏览工单和请求
- 02查看资产与位置
- 03查看零件和仪表
- 04创建请求和工单
- 05更新工单与库存
适用场景
- 01检查维护工单
- 02核对资产和零件信息
- 03记录仪表读数
- 04提交并批准工作请求
MCP 相关
向 MCP 客户端提供 UpKeep 记录查询和维护操作工具。远程服务通过 OAuth 登录,并要求提供 UpKeep 组织 API 令牌。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://upkeep.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-upkeep https://upkeep.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-upkeep":{"type":"http","url":"https://upkeep.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-upkeep":{"type":"http","url":"https://upkeep.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-upkeep":{"type":"http","url":"https://upkeep.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-upkeep":{"serverUrl":"https://upkeep.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
usefulapi 出品的 UpKeep MCP
读取 UpKeep 工单、资产、零件和计量表;创建请求和工单。
在线端点: https://upkeep.usefulapi.io/mcp · 主页: https://usefulapi.io/upkeep
连接
- Claude(claude.ai、Desktop):打开 Customize → Connectors,点击 + Add → Add custom connector,然后粘贴
https://upkeep.usefulapi.io/mcp。 - Claude Code:
claude mcp add --transport http upkeep https://upkeep.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code: 添加到 VS Code。
- Cursor 和其他客户端: 将此 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"upkeep": {
"url": "https://upkeep.usefulapi.io/mcp"
}
}
}
只添加 URL。请勿在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 UpKeep 凭据。
分步设置说明、凭据查找位置和常见问题解答:https://usefulapi.io/upkeep/
首次连接时,你需要粘贴 UpKeep 组织 API 令牌(位于 Settings → API Tokens;令牌以 uk_pat_ 开头)。
工具
| 工具 | 类型 | 功能 |
|---|---|---|
upkeep_get_account | 读取 | 检查 API 令牌 |
upkeep_list_work_orders | 读取 | 列出工单 |
upkeep_get_work_order | 读取 | 获取工单 |
upkeep_list_assets | 读取 | 列出资产 |
upkeep_get_asset | 读取 | 获取资产 |
upkeep_list_locations | 读取 | 列出位置 |
upkeep_get_location | 读取 | 获取位置 |
upkeep_list_parts | 读取 | 列出零件(库存) |
upkeep_get_part | 读取 | 获取零件 |
upkeep_list_meters | 读取 | 列出计量表 |
upkeep_get_meter | 读取 | 获取计量表 |
upkeep_list_meter_readings | 读取 | 列出计量表读数 |
upkeep_add_meter_reading | 写入 | 添加计量表读数 |
upkeep_list_requests | 读取 | 列出工作请求 |
upkeep_get_request | 读取 | 获取工作请求 |
upkeep_create_request | 写入 | 创建工作请求 |
upkeep_approve_request | 写入 | 批准工作请求 |
upkeep_create_work_order | 写入 | 创建工单 |
upkeep_update_work_order | 写入 | 更新工单 |
upkeep_add_work_order_message | 写入 | 添加工单消息 |
upkeep_update_part_quantity | 写入 | 更新零件数量 |
upkeep_list_users | 读取 | 列出用户 |
upkeep_get_user | 读取 | 获取用户 |
upkeep_list_teams | 读取 | 列出团队 |
upkeep_list_vendors | 读取 | 列出供应商 |
upkeep_list_customers | 读取 | 列出客户 |
upkeep_list_purchase_orders | 读取 | 列出采购订单 |
upkeep_get_purchase_order | 读取 | 获取采购订单 |
upkeep_list_preventive_maintenance | 读取 | 列出预防性维护计划 |
upkeep_usage_status | 元数据 | 使用情况状态(免费套餐用量计量) |
upkeep_request_feature | 元数据 | 申请添加缺失功能 |
upkeep_upgrade | 元数据 | 升级到 Pro(无限*) |
upkeep_cancel_subscription | 元数据 | 取消 Pro 订阅 |
read 工具为只读;write 工具会修改数据(客户端应先征得确认);meta 工具用于报告用量、管理订阅或发送功能申请。
定价
| 套餐 | 价格 | 限额 |
|---|---|---|
| Free | $0 | 每月 50 次工具调用 |
| Pro(按用户计费) | $9/mo 或 $90/yr(免费赠送 2 个月) | 无限* |
*Pro 在此服务上的公平使用限额为每月 10,000 次工具调用。如需更多,请发送邮件至 [email protected]。
Pro 仅适用于此服务。使用 upkeep_upgrade 订阅(它会返回 Stripe Checkout 链接)。你可以随时使用 upkeep_cancel_subscription 取消:Pro 将持续到已付费周期结束,当前周期不予退款;在此之前运行 upkeep_upgrade 可撤销取消。也可以发送邮件至 [email protected]。
许可证
MIT © usefulapi。与 UpKeep 无关联,也未获其认可。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。