摘要
TimeTrack 时间跟踪:员工、客户、项目、项目时间条目、考勤(打卡进出)、缺勤和缺勤类型、费用、每日和分组时间表报告及计时器。应用密钥和密钥。
引导式设置
2 分钟将 TimeTrack 连接到 Claude、ChatGPT 或 Copilot
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 TimeTrack,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
TimeTrack 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → TimeTrack,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
TimeTrack
TimeTrack 时间跟踪:员工、客户、项目、项目时间条目、考勤(打卡进出)、缺勤和缺勤类型、费用、每日和分组时间表报告及计时器。应用密钥和密钥。
设置
设置大约需要 3 分钟。
- 以管理员身份登录 TimeTrack 网络应用并打开 设置、常规、API。
- 将 应用密钥 复制到
TIMETRACK_API_KEY,将 应用密钥 复制到TIMETRACK_API_SECRET。这两个都是为你生成的;可以随时在此生成新的密钥,这将使旧的密钥失效。 - 将你的 TimeTrack 地址的第一部分放入
TIMETRACK_ACCOUNT:对于https://acme.timetrackenterprise.com,就是acme。
每次调用都会在头部发送这两个值 X-TimeTrack-Api-Key 和 X-TimeTrack-Api-Secret。API 作用于整个账户,而不是单个员工。
从哪里开始:timetrack_list_users 返回每个工具用来命名员工的用户名。timetrack_list_clients 和 timetrack_list_projects 返回时间条目所指的客户和项目名称(按名称,而不是按 ID)。
主数据:timetrack_get_user、timetrack_get_client、timetrack_create_client、timetrack_get_project、timetrack_create_project、timetrack_update_project、timetrack_list_tasks(时间记录的任务类型)。
项目时间:timetrack_list_project_time_entries、timetrack_get_project_time_entry、timetrack_create_project_time_entry、timetrack_update_project_time_entry。timetrack_delete_project_time_entry 默认关闭。timetrack_list_expenses 列出在项目上记录的费用。
考勤:timetrack_list_attendances、timetrack_get_attendance、timetrack_create_attendance、timetrack_update_attendance;timetrack_delete_attendance 默认关闭。现在使用 timetrack_start_attendance_timer 和 timetrack_stop_attendance_timer 来打卡;timetrack_get_attendance_timer 告诉你某人是否已打卡。
项目计时器:timetrack_get_project_timer、timetrack_start_project_timer、timetrack_stop_project_timer。
缺勤:timetrack_list_absence_types 提供类型 ID,timetrack_list_absences 和 timetrack_get_absence 读取请求,timetrack_create_absence 提交一个,timetrack_update_absence 批准(状态 1)或拒绝(状态 2)它。timetrack_delete_absence 默认关闭。
报告:timetrack_list_daily_reports 返回每天一个时间表记录,timetrack_get_grouped_report 返回总计,包括加班和假期余额。报告中的持续时间以秒为单位;在时间条目中以分钟为单位。
分页:列表返回 50 条记录,除非你传递 limit(最多 1000);page_number 从 0 开始。
日期:缺勤使用普通日期(YYYY-MM-DD);时间条目、费用、报告和计时器使用时间戳,例如 2026-10-20T09:00:00.000Z。计时器工具需要在 date 中的真实当前时间。
速率限制:每分钟 30 次请求。使用过滤器和较大的 limit,而不是每条记录一次调用。
错误:失败的调用返回 errors,这是一个包含 title、status、code 和 detail 的列表。401:密钥或密钥错误。403:不允许的操作。404:记录未找到或已删除。422:参数错误或更改与现有数据冲突(未知的用户名、客户或项目名称是常见原因)。
先决条件:TIMETRACK_ACCOUNT、TIMETRACK_API_KEY、TIMETRACK_API_SECRET
本地安装连接器
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
打开 http://localhost:3000/connectors/store,选择 TimeTrack 并粘贴在先决条件下列出的环境变量。
可用工具
| 工具 | 功能 |
|---|---|
timetrack_list_users | 列出 TimeTrack 账户的员工:ID、用户名、电子邮件、名、姓、个人编号、语言、小时费率和标志… |
timetrack_get_user | 通过数字 ID 读取一个员工:用户名、电子邮件、名和姓、个人编号、语言、小时费率及管理员、外部… |
timetrack_list_clients | 列出客户(项目预定的客户):ID、名称、启用状态、颜色、备注、电子邮件、电话、地址字段、联系人及… |
timetrack_get_client | 通过数字 ID 读取一个客户:名称、启用状态、联系信息、地址和自由字段。只读 |
timetrack_create_client | 创建一个客户并返回。项目是在客户下创建的,因此新客户需要先创建。写入 TimeTrack |
timetrack_list_projects | 列出项目:ID、项目名称、客户名称、项目启用状态、备注、小时费率、预计时间(计划持续时间,以分钟为单位)及… |
timetrack_get_project | 通过数字 ID 读取一个项目:项目名称、客户名称、项目启用状态、备注、小时费率、预计时间(以分钟为单位)和预算估算… |
timetrack_create_project | 在现有客户下创建一个项目并返回。写入 TimeTrack |
timetrack_update_project | 更改项目:备注、小时费率、计划时间或预算、名称或客户。仅更改你传递的字段。写入 TimeTrack |
timetrack_list_tasks | 列出项目时间记录的任务类型(例如开发或咨询):ID、名称、备注和小时费率。时间条目… |
timetrack_list_project_time_entries | 列出在项目上记录的时间:ID、用户、客户名称、项目名称、任务、开始和结束(时间戳)、工作分钟(不包括休息时间)… |
timetrack_get_project_time_entry | 通过数字 ID 读取一个项目时间条目:员工、客户、项目、任务、开始和结束、工作和休息分钟、费率、可计费标志… |
timetrack_create_project_time_entry | 记录员工在项目上的工作时间并返回条目。客户和项目必须存在,并按名称提供。写入… |
timetrack_update_project_time_entry | 更正项目时间条目:开始、结束、休息、任务、费率、可计费标志或备注。员工、客户和项目不能更改:删除… |
timetrack_delete_project_time_entry | 删除一个项目时间条目。记录的时间将从报告和发票中消失。默认关闭;使用… 更正条目 |
timetrack_list_attendances | 列出考勤条目(没有项目的打卡进出):ID、用户、从、到、工作分钟、休息分钟、备注、手动(输入… |
timetrack_get_attendance | 通过数字 ID 读取一个考勤条目:员工、开始、结束、工作和休息分钟、备注及是否手动输入… |
timetrack_create_attendance | 记录员工的工作时间(已知开始和结束)并返回条目。现在使用… 打卡 |
timetrack_update_attendance | 更正考勤条目:开始、结束、休息或备注。员工不能更改。仅更改你传递的字段。写入… |
timetrack_delete_attendance | 将考勤条目标记为已删除。工作时间将从员工的时间表中消失。默认关闭;更正… |
timetrack_list_absence_types | 列出账户的缺勤类型(假期、病假、补休等):ID、名称和简称。ID 是缺勤… |
timetrack_list_absences | 列出缺勤:ID、用户、从和到(日期)、状态(0 新建且等待批准、1 已批准、2 已拒绝)、缺勤类型(ID)及… |
timetrack_get_absence | 通过数字 ID 读取一个缺勤:员工、第一天和最后一天、状态(0 等待、1 批准、2 拒绝)和缺勤类型。只读 |
timetrack_create_absence | 为员工请求缺勤(假期、病假)并返回。新缺勤的状态为 0,等待批准,除非… |
timetrack_update_absence | 通过设置状态来批准或拒绝缺勤。状态是 API 允许你更改的唯一字段;对于其他日期,删除… |
timetrack_delete_absence | 删除缺勤。默认关闭:已批准的假期或病假通常应通过 timetrack_update_absence 拒绝… |
timetrack_list_expenses | 列出在项目上记录的费用:ID、用户、客户名称、项目名称、名称、价格、数量、可计费、支付类型、详细信息、标签和日期… |
timetrack_list_daily_reports | 读取员工在一段时间内的每日时间表记录,每天一条:工作日期、工作开始、工作结束、目标秒数、工作秒数… |
timetrack_get_grouped_report | 读取员工在一段时间内的总计:目标秒数、工作秒数、工作目标差异(加班或减小时数)… |
timetrack_get_attendance_timer | 读取员工的运行考勤计时器(该人是否已打卡):从、到、工作分钟、休息分钟、手动和备注… |
timetrack_start_attendance_timer | 打卡员工:在给定时间启动考勤计时器。当计时器已经在运行时失败。写入 TimeTrack |
timetrack_stop_attendance_timer | 打卡员工:在给定时间停止运行的考勤计时器,完成考勤条目。写入 TimeTrack |
timetrack_get_project_timer | 读取员工的项目计时器:开始时间、工作秒数、休息秒数、状态标志(运行、暂停和停止)以及客户名称… |
timetrack_start_project_timer | 在给定时间为员工在客户和项目上启动项目计时器。写入 TimeTrack |
timetrack_stop_project_timer | 在给定时间停止员工的运行项目计时器,保存项目时间条目。写入 TimeTrack |
示例提示
- "上个月团队在项目网站重新启动上记录了多少小时,每个人?"
- "现在谁已打卡?"
- "为 jsmith 昨天下午在项目网站重新启动上记录 2.5 小时的设计。"
- "哪些缺勤请求在等待批准?"
- "显示每位员工在十月份的加班和假期余额。"
下一步
这份指南对你有帮助吗?