Kolay IK MCP by usefulapi

usefulapi 的 Kolay IK MCP

通过 Claude、Cursor 或任何 MCP 客户端使用你的 Kolay IK 账户。读取员工、休假、工时记录、费用、工资单和日历事件，并创建休假或工时记录、更改事件和员工记录。托管服务，无需本地安装：使用你自己的凭据连接。

在线端点： https://kolay-ik.usefulapi.io/mcp · 主页： https://usefulapi.io

连接

• Claude（claude.ai、Desktop）：打开 Customize → Connectors，点击 + Add → Add custom connector，然后粘贴 https://kolay-ik.usefulapi.io/mcp。
• Claude Code： claude mcp add --transport http kolay-ik https://kolay-ik.usefulapi.io/mcp，然后运行 /mcp 登录。
• VS Code： 添加到 VS Code。
• Cursor 和其他客户端： 将此 URL 添加为远程 MCP 服务：

{
  "mcpServers": {
    "kolay-ik": {
      "url": "https://kolay-ik.usefulapi.io/mcp"
    }
  }
}

只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥：服务会通过 OAuth 为你登录，登录页面会要求你提供 Kolay IK 凭据。

分步设置说明、凭据查找位置和常见问题解答：https://usefulapi.io/kolay-ik/

首次连接时，你需要提供 Kolay IK API token，可在 Kolay IK 的 Ayarlar → Geliştirici Ayarları → API Token Oluştur 中创建。服务会验证该令牌，并按用户保存。无需将密钥放入配置文件。

工具

工具	类型	功能
kolayik_get_me	read	获取令牌所属用户
kolayik_list_people	read	列出人员
kolayik_get_person	read	获取人员信息
kolayik_get_person_summary	read	获取人员摘要
kolayik_get_person_leave_balances	read	获取休假余额
kolayik_list_person_trainings	read	列出某人的培训
kolayik_list_person_fields	read	列出人员数据字段
kolayik_list_units	read	列出组织单位
kolayik_list_approval_processes	read	列出审批流程
kolayik_list_leaves	read	列出休假记录
kolayik_get_leave	read	获取休假记录
kolayik_create_leave	write	创建休假记录
kolayik_list_timelogs	read	列出工时记录
kolayik_get_timelog	read	获取工时记录
kolayik_create_timelog	write	创建工时记录
kolayik_delete_timelog	write	删除工时记录
kolayik_list_transactions	read	列出交易记录
kolayik_get_transaction	read	获取交易记录
kolayik_list_expense_categories	read	列出费用类别
kolayik_list_payrolls	read	列出工资周期
kolayik_get_payroll_sheet	read	获取工资单
kolayik_list_events	read	列出日历事件
kolayik_get_event	read	获取日历事件
kolayik_create_event	write	创建日历事件
kolayik_update_event	write	更新日历事件
kolayik_delete_event	write	删除日历事件
kolayik_list_trainings	read	列出培训
kolayik_get_training	read	获取培训
kolayik_create_person	write	创建人员
kolayik_update_person	write	更新人员
kolayik_usage_status	meta	使用情况（免费套餐用量计量）
kolayik_request_feature	meta	申请添加缺失功能
kolayik_upgrade	meta	升级到 Pro（不限量*）
kolayik_cancel_subscription	meta	取消 Pro 订阅

read 工具为只读；write 工具会更改数据（客户端应在执行前确认）；meta 工具用于报告用量、管理订阅或提交功能请求。

定价

方案	价格	限制
免费	$0	每月 50 次工具调用
专业版（按用户计费）	$9/mo 或 $90/yr（免费 2 个月）	无限*

*此服务上的专业版每月有 10,000 次工具调用的合理使用限制。如需更多，请发送邮件至 [email protected]。

专业版仅适用于此服务。使用 kolayik_upgrade 订阅（该命令会返回 Stripe Checkout 链接）。使用 kolayik_cancel_subscription 随时取消：专业版将持续至付费周期结束，当前周期不予退款；在此之前运行 kolayik_upgrade 可撤销取消操作。或者发送邮件至 [email protected]。

许可证

MIT — 参见 LICENSE。仅提供文档；该服务由托管方托管。