关于 ClickTime MCP by usefulapi
ClickTime MCP by usefulapi 是面向 ClickTime 用户及其 MCP 客户端的托管 MCP 服务。它可读取工作、工时、请假和报表,并提供记录工时及提交工时表的工具。
主要功能
- 01查看工作、客户和任务
- 02读取工时、请假及报表
- 03创建和修改工时记录
- 04提交或撤回工时表
适用场景
- 01查询项目和工时记录
- 02分析公司工时报告
- 03记录或修正已用工时
- 04提交或撤回工时表
MCP 相关
作为托管 MCP 服务,向 Claude、Cursor 等 MCP 客户端提供 ClickTime 数据查询和写入工具。通过 OAuth 登录并验证 ClickTime API token。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://clicktime.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-clicktime https://clicktime.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-clicktime":{"type":"http","url":"https://clicktime.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-clicktime":{"type":"http","url":"https://clicktime.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-clicktime":{"type":"http","url":"https://clicktime.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-clicktime":{"serverUrl":"https://clicktime.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
usefulapi 提供的 ClickTime MCP
在 Claude、Cursor 或任何 MCP 客户端中使用你的 ClickTime 账户。读取工作、工时表、休假和公司报告,并记录、编辑或提交自己的工时。由托管服务提供,无需本地安装:使用你自己的凭据连接。
在线端点: https://clicktime.usefulapi.io/mcp · 主页: https://usefulapi.io
连接
- Claude(claude.ai、Desktop):打开 Customize → Connectors,点击 + Add → Add custom connector,然后粘贴
https://clicktime.usefulapi.io/mcp。 - **Claude Code:**运行
claude mcp add --transport http clicktime https://clicktime.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code:添加到 VS Code。
- **Cursor 和其他客户端:**将此 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"clicktime": {
"url": "https://clicktime.usefulapi.io/mcp"
}
}
}
只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 ClickTime 凭据。
分步设置说明、凭据查找方法和常见问题解答:https://usefulapi.io/clicktime/
首次连接时,你需要提供 ClickTime API 令牌,可在 ClickTime 的 My Preferences 中找到,然后打开 Authentication Token 选项卡。服务会验证该令牌,并按用户存储。无需将密钥放入配置文件。
工具
| 工具 | 类型 | 功能 |
|---|---|---|
clicktime_get_me | 读取 | 获取我的用户信息 |
clicktime_get_company | 读取 | 获取公司设置 |
clicktime_list_jobs | 读取 | 列出工作(项目) |
clicktime_get_job | 读取 | 获取工作 |
clicktime_list_clients | 读取 | 列出客户 |
clicktime_list_tasks | 读取 | 列出任务 |
clicktime_list_job_task_controls | 读取 | 列出有效的工作和任务组合 |
clicktime_list_job_phases | 读取 | 列出工作阶段 |
clicktime_list_time_entries | 读取 | 列出我的工时记录 |
clicktime_get_time_entry | 读取 | 获取工时记录 |
clicktime_list_timesheets | 读取 | 列出我的工时表 |
clicktime_get_timesheet_by_date | 读取 | 获取涵盖指定日期的工时表 |
clicktime_list_timesheet_actions | 读取 | 列出我的工时表可执行的操作 |
clicktime_list_time_off_types | 读取 | 列出休假类型和余额 |
clicktime_list_time_off | 读取 | 列出我的休假 |
clicktime_list_time_off_requests | 读取 | 列出我的休假申请 |
clicktime_list_expense_sheets | 读取 | 列出我的费用单 |
clicktime_list_expense_items | 读取 | 列出我的费用项目 |
clicktime_list_users | 读取 | 列出用户 |
clicktime_time_report | 读取 | 工时报告(全公司范围) |
clicktime_time_summary | 读取 | 工时摘要(分组) |
clicktime_create_time_entry | 写入 | 记录工时 |
clicktime_update_time_entry | 写入 | 更新工时记录 |
clicktime_submit_timesheet | 写入 | 提交或撤回我的工时表 |
clicktime_create_client | 写入 | 创建客户 |
clicktime_create_job | 写入 | 创建工作 |
clicktime_usage_status | 元数据 | 使用情况(免费套餐用量计量) |
clicktime_request_feature | 元数据 | 请求添加缺失功能 |
clicktime_upgrade | 元数据 | 升级到 Pro(无限制*) |
clicktime_cancel_subscription | 元数据 | 取消 Pro 订阅 |
read 工具为只读;write 工具会修改数据(客户端应先确认);meta 工具用于报告用量、管理订阅或发送功能请求。
定价
| 套餐 | 价格 | 限额 |
|---|---|---|
| 免费 | $0 | 每月 50 次工具调用 |
| 专业版(每位用户) | $9/月 或 $90/年(免费 2 个月) | 不限量* |
*专业版在此服务上的公平使用限额为每月 10,000 次工具调用。如需更多,请发送邮件至 [email protected]。
专业版仅适用于此服务。使用 clicktime_upgrade 订阅(它会返回一个 Stripe Checkout 链接)。你可以随时使用 clicktime_cancel_subscription 取消订阅:专业版将持续到已付费周期结束,当前周期不予退款;在此之前运行 clicktime_upgrade 可撤销取消操作。你也可以发送邮件至 [email protected]。
许可证
MIT — 请参阅 LICENSE。仅提供文档;服务托管于此。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。