关于 kiwiHR MCP by usefulapi
kiwiHR MCP by usefulapi 将 kiwiHR 的员工、休假、工时表和项目数据提供给 MCP 客户端,并支持创建或更新部分记录。
主要功能
- 01读取员工与团队信息
- 02查看休假类型和余额
- 03检查工时表与出勤记录
- 04浏览项目和入职流程
- 05创建或更新员工及工时表
适用场景
- 01查询员工和团队信息
- 02检查休假余额与出勤情况
- 03查看或编辑工时表条目
- 04管理员工和项目记录
MCP 相关
通过远程 MCP 服务向 MCP 客户端提供 kiwiHR 的读取和写入工具。首次连接需要 kiwiHR 公司 API key。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://kiwihr.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-kiwihr https://kiwihr.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-kiwihr":{"type":"http","url":"https://kiwihr.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-kiwihr":{"type":"http","url":"https://kiwihr.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-kiwihr":{"type":"http","url":"https://kiwihr.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-kiwihr":{"serverUrl":"https://kiwihr.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
usefulapi 的 kiwiHR MCP
读取 kiwiHR 员工、休假、工时表和项目;创建和更新员工、工时表。
实时端点: https://kiwihr.usefulapi.io/mcp · 主页: https://usefulapi.io/kiwihr
连接
- Claude(claude.ai、Desktop):打开 Customize → Connectors,点击 + Add → Add custom connector,然后粘贴
https://kiwihr.usefulapi.io/mcp。 - Claude Code:
claude mcp add --transport http kiwihr https://kiwihr.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code: 添加到 VS Code。
- Cursor 和其他客户端: 将 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"kiwihr": {
"url": "https://kiwihr.usefulapi.io/mcp"
}
}
}
只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 kiwiHR 凭据。
分步设置指南、凭据查找位置和常见问题解答:https://usefulapi.io/kiwihr/
首次连接时,你需要粘贴 kiwiHR(Tellent HR)公司的 API 密钥(在 kiwiHR 网页应用的 Company Settings / Configuration > Integrations > API Keys 中创建)。
工具
| 工具 | 类型 | 功能 |
|---|---|---|
kiwihr_list_users | read | 列出员工 |
kiwihr_get_user | read | 获取员工信息 |
kiwihr_list_teams | read | 列出团队 |
kiwihr_list_locations | read | 列出地点 |
kiwihr_list_positions | read | 列出职位 |
kiwihr_list_custom_fields | read | 列出自定义字段 |
kiwihr_list_time_off_types | read | 列出休假类型 |
kiwihr_list_time_off_balances | read | 列出休假余额 |
kiwihr_get_time_off_usage | read | 获取休假使用情况 |
kiwihr_list_timesheets | read | 列出工时表 |
kiwihr_get_timesheet | read | 获取工时表 |
kiwihr_get_attendance_statement | read | 获取出勤报表 |
kiwihr_list_attendance_statements | read | 列出出勤报表 |
kiwihr_list_overtime_balances | read | 列出加班余额 |
kiwihr_list_projects | read | 列出项目 |
kiwihr_get_project | read | 获取项目 |
kiwihr_list_journeys | read | 列出流程 |
kiwihr_get_journey | read | 获取流程 |
kiwihr_list_journey_templates | read | 列出流程模板 |
kiwihr_list_journey_types | read | 列出流程类型 |
kiwihr_create_timesheet_entry | write | 创建工时表条目 |
kiwihr_update_timesheet_entry | write | 更新工时表条目 |
kiwihr_delete_timesheet_entry | write | 删除工时表条目 |
kiwihr_create_project | write | 创建项目 |
kiwihr_update_project | write | 更新项目 |
kiwihr_create_user | write | 创建员工 |
kiwihr_update_user | write | 更新员工 |
kiwihr_deactivate_user | write | 停用员工 |
kiwihr_activate_user | write | 激活员工 |
kiwihr_create_journey | write | 创建流程 |
kiwihr_usage_status | meta | 使用状态(免费层级用量计量) |
kiwihr_request_feature | meta | 请求添加缺失的功能 |
kiwihr_upgrade | meta | 升级到 Pro(无限使用*) |
kiwihr_cancel_subscription | meta | 取消 Pro 订阅 |
read 工具为只读;write 工具会修改数据(客户端应在执行前征求确认);meta 工具用于报告用量、管理订阅或发送功能请求。
定价
| 方案 | 价格 | 限额 |
|---|---|---|
| 免费 | $0 | 每月 50 次工具调用 |
| Pro(按用户计费) | $9/mo 或 $90/yr(赠送 2 个月) | 不限量* |
*Pro 在此服务上的公平使用限额为每月 10,000 次工具调用。如需更多,请发送邮件至 [email protected]。
Pro 仅适用于此服务。使用 kiwihr_upgrade 订阅(该命令会返回一个 Stripe Checkout 链接)。随时可以使用 kiwihr_cancel_subscription 取消:Pro 会持续到付费周期结束,当前周期不予退款;在此之前运行 kiwihr_upgrade 可撤销取消操作。或者发送邮件至 [email protected]。
许可证
MIT © usefulapi。与 kiwiHR 无关联,也未获得其认可。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。