关于 Protime MCP by usefulapi
Protime MCP by usefulapi 是面向 Protime 用户的托管 MCP 服务,可供 MCP 客户端读取工时与人事数据。它支持多类业务记录,并通过 OAuth 连接用户凭据。
主要功能
- 01读取打卡、缺勤和排班
- 02查看合同、人员与部门
- 03查询职位和工作地点
- 04读取班次及缺勤定义
适用场景
- 01汇总员工打卡与缺勤信息
- 02查询人员合同和部门资料
MCP 相关
作为 MCP 服务,它向客户端提供 Protime 的只读查询工具,并支持用 OAuth 验证凭据。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://protime.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-protime https://protime.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-protime":{"type":"http","url":"https://protime.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-protime":{"type":"http","url":"https://protime.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-protime":{"type":"http","url":"https://protime.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-protime":{"serverUrl":"https://protime.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
usefulapi 的 Protime MCP
通过 Claude、Cursor 或任意 MCP 客户端使用你的 Protime 账户。读取打卡记录、缺勤、任务分配、合同、人员、部门、职位和班次定义。托管服务,无需本地安装:使用你自己的凭据连接。
在线端点: https://protime.usefulapi.io/mcp · 主页: https://usefulapi.io
连接
- Claude(claude.ai、桌面版):打开 自定义 → 连接器,点击 + 添加 → 添加自定义连接器,然后粘贴
https://protime.usefulapi.io/mcp。 - Claude Code: 运行
claude mcp add --transport http protime https://protime.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code: 添加到 VS Code。
- Cursor 和其他客户端: 将 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"protime": {
"url": "https://protime.usefulapi.io/mcp"
}
}
}
只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 Protime 凭据。
分步设置指南、凭据查找方法和常见问题解答:https://usefulapi.io/protime/
首次连接时,你需要提供租户名称、环境以及 Protime 为你的租户签发的客户端 ID和客户端密钥。服务会验证这些信息并按用户保存。配置文件中无需存放密钥。
工具
| 工具 | 类型 | 功能 |
|---|---|---|
protime_list_clockings | read | 列出打卡记录 |
protime_list_absences | read | 列出缺勤记录 |
protime_list_assignments | read | 列出任务分配 |
protime_list_contracts | read | 列出合同 |
protime_list_people | read | 列出人员 |
protime_list_departments | read | 列出部门 |
protime_list_jobs | read | 列出职位 |
protime_list_work_locations | read | 列出工作地点 |
protime_list_shift_definitions | read | 列出班次定义(代码和名称) |
protime_list_absence_definitions | read | 列出缺勤定义(代码、分组) |
protime_list_absence_groups | read | 列出缺勤分组 |
protime_get_person | read | 获取人员信息 |
protime_usage_status | meta | 使用情况状态(免费额度计数器) |
protime_request_feature | meta | 申请添加缺失功能 |
protime_upgrade | meta | 升级到 Pro(无限制*) |
protime_cancel_subscription | meta | 取消 Pro 订阅 |
read 工具为只读;write 工具会修改数据(客户端应要求确认);meta 工具会报告使用情况、管理订阅或发送功能申请。
定价
| 套餐 | 价格 | 限额 |
|---|---|---|
| 免费 | $0 | 每月 50 次工具调用 |
| Pro(按用户计费) | $9/月 或 $90/年(免费 2 个月) | 无限* |
*Pro 在此服务上的合理使用限额为每月 10,000 次工具调用。如需更多,请发送邮件至 [email protected]。
Pro 仅适用于此服务。使用 protime_upgrade 订阅(它会返回 Stripe Checkout 链接)。你可以随时使用 protime_cancel_subscription 取消:Pro 会持续到付费周期结束,当前周期不退款;在此之前运行 protime_upgrade 可撤销取消操作。你也可以发送邮件至 [email protected]。
许可证
MIT——请参阅 LICENSE。本文档仅供参考;服务由托管方提供。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。