关于 RotaCloud MCP by usefulapi
面向使用 RotaCloud 管理员工排班和休假的团队提供托管 MCP 服务。它支持查询班次、考勤、可用时间和薪资,并提供创建班次及处理休假申请的工具。
主要功能
- 01浏览班次、用户和地点
- 02读取考勤及打卡状态
- 03查看休假、可用时间和休息日
- 04按薪资周期查看薪资
- 05创建班次并处理休假申请
适用场景
- 01查看班次安排和人员配置
- 02检查考勤及打卡人员
- 03跟踪休假申请和可用时间
- 04查询某薪资周期的薪资
MCP 相关
提供托管 MCP 工具,用于读取 RotaCloud 人力数据并执行排班和休假操作。MCP 客户端连接远程端点,并在设置时提供 RotaCloud API 密钥。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://rotacloud.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-rotacloud https://rotacloud.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-rotacloud":{"type":"http","url":"https://rotacloud.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-rotacloud":{"type":"http","url":"https://rotacloud.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-rotacloud":{"type":"http","url":"https://rotacloud.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-rotacloud":{"serverUrl":"https://rotacloud.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
26| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| limit | integer | 否 | 每页结果数,范围为 1-500(RotaCloud 可能会设置更低的上限;回复中的 total 和 next_offset 可显示剩余结果)。 |
| offset | integer | 否 | 第一个结果的索引;传入上一条回复中的 next_offset。 |
详细介绍
usefulapi 推出的 RotaCloud MCP
通过 Claude、Cursor 或任何 MCP 客户端使用 RotaCloud — 读取 RotaCloud 班次、出勤、休假、可用时间和工资单;创建班次并处理休假申请。 托管服务,无需本地安装:使用你自己的 RotaCloud 凭据连接。
在线端点: https://rotacloud.usefulapi.io/mcp · 主页: https://usefulapi.io/rotacloud
连接
- Claude(claude.ai、Desktop):打开 Customize → Connectors,点击 + Add → Add custom connector,然后粘贴
https://rotacloud.usefulapi.io/mcp。 - Claude Code: 运行
claude mcp add --transport http rotacloud https://rotacloud.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code: 添加到 VS Code。
- Cursor 和其他客户端: 将 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"rotacloud": {
"url": "https://rotacloud.usefulapi.io/mcp"
}
}
}
只添加 URL。请勿在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 RotaCloud 凭据。
分步设置指南、凭据查找方式和常见问题解答:https://usefulapi.io/rotacloud/
首次连接时,你需要提供 RotaCloud API 密钥。 系统会验证你的凭据,按用户存储并限定为你本人使用 — 配置文件中不会保存任何密钥。
工具
| 工具 | 类型 | 功能 |
|---|---|---|
rotacloud_list_accounts | 读取 | 列出账户 |
rotacloud_list_users | 读取 | 列出用户 |
rotacloud_get_user | 读取 | 获取用户 |
rotacloud_list_locations | 读取 | 列出地点 |
rotacloud_list_roles | 读取 | 列出角色 |
rotacloud_list_shifts | 读取 | 列出班次 |
rotacloud_get_shift | 读取 | 获取班次 |
rotacloud_list_swap_requests | 读取 | 列出换班申请 |
rotacloud_list_day_notes | 读取 | 列出每日备注 |
rotacloud_list_attendance | 读取 | 列出出勤记录 |
rotacloud_list_clocked_in | 读取 | 列出已打卡用户 |
rotacloud_list_leave | 读取 | 列出休假 |
rotacloud_list_leave_requests | 读取 | 列出休假申请 |
rotacloud_get_leave_request | 读取 | 获取休假申请 |
rotacloud_list_leave_types | 读取 | 列出休假类型 |
rotacloud_list_holiday_allowances | 读取 | 列出假期额度 |
rotacloud_get_availability | 读取 | 获取可用时间 |
rotacloud_list_days_off | 读取 | 列出休息日 |
rotacloud_list_pay_periods | 读取 | 列出工资周期 |
rotacloud_get_payroll | 读取 | 获取某个工资周期的工资单 |
rotacloud_create_shift | 写入 | 创建班次 |
rotacloud_update_shift | 写入 | 更新班次 |
rotacloud_publish_shifts | 写入 | 发布班次 |
rotacloud_find_shifts | 读取 | 查找班次 |
rotacloud_delete_shifts | 写入 | 删除班次 |
rotacloud_create_leave_request | 写入 | 申请休假 |
rotacloud_approve_leave_request | 写入 | 批准休假申请 |
rotacloud_deny_leave_request | 写入 | 拒绝休假申请 |
rotacloud_usage_status | 元信息 | 使用情况(免费套餐用量计量) |
rotacloud_request_feature | 元信息 | 申请添加缺失功能 |
rotacloud_upgrade | 元信息 | 升级到 Pro(不限量*) |
rotacloud_cancel_subscription | 元信息 | 取消 Pro 订阅 |
read 工具为只读工具;write 工具会修改数据(客户端应在执行前进行确认);meta 工具用于报告使用情况、管理订阅或提交功能申请。
定价
| 计划 | 价格 | 限额 |
|---|---|---|
| 免费版 | $0 | 每月 50 次工具调用 |
| 专业版(每个账户) | $9/mo 或 $90/yr(免费赠送 2 个月) | 不限量* |
*专业版在此服务上的公平使用限额为每月 10,000 次工具调用。如需更多,请发送邮件至 [email protected]。
专业版仅适用于此服务。使用 rotacloud_upgrade 订阅(它会返回 Stripe Checkout 链接)。随时可以使用 rotacloud_cancel_subscription 取消:专业版会持续至已付费周期结束,当前周期不予退款;在此之前运行 rotacloud_upgrade 即可撤销取消。或者发送邮件至 [email protected]。
许可证
MIT © usefulapi。与 RotaCloud 无关联,也未获其认可。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。