摘要
TimeTrack 时间跟踪:员工、客户、项目、项目时间条目、考勤(打卡进出)、缺勤及缺勤类型、费用、每日和分组的工时报告和计时器。应用密钥和秘密。
引导式设置
2 分钟将 TimeTrack 连接到 Claude
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 TimeTrack,再把你的 MCP URL 添加到 Claude。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
AnythingMCP 已收录在 Claude 的连接器目录中:一键添加到 Claude (在新标签页中打开),然后登录并选择 Claude 可以使用哪些 MCP 服务器。
试试这样问
TimeTrack 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → TimeTrack,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
TimeTrack + Claude
TimeTrack 时间跟踪:员工、客户、项目、项目时间条目、考勤(打卡进出)、缺勤及缺勤类型、费用、每日和分组的工时报告和计时器。应用密钥和秘密。
前提条件
请查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:
TIMETRACK_ACCOUNT, TIMETRACK_API_KEY, TIMETRACK_API_SECRET
第一步 — 获取凭据
设置大约需要 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:参数错误或更改与现有数据冲突(未知的用户名、客户或项目名称通常是原因)。
第二步 — 安装适配器
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
第三步 — 在 Claude 中添加连接器
你的服务器 URL: 在 AnythingMCP 中,打开 MCP 服务器 → 此连接器所在的服务器,并复制其 URL(
https://cloud.anythingmcp.com/mcp/…)。在本指南中显示YOUR_SERVER_ID的地方使用它。
推荐路径:在 claude.ai web 上工作,无需编辑任何配置文件。
- 在 Claude 中打开 Plugins(部分套餐仍显示为 Customize)→ Connectors。
- 点击 + Add,然后点击 Add custom connector。
- 输入名称(例如
TimeTrack)和远程 MCP 服务器 URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID,然后点击 Continue,保留检测到的设置,再次点击 Continue。 - 选择 Sign in now,点击 Add,登录 AnythingMCP(OAuth)并允许访问。
下面的所有工具都会出现在你的聊天中:开始输入提示。
可用工具
| 工具 | 功能 |
|---|---|
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 小时的设计。”
- “哪些缺勤请求正在等待批准?”
- “显示每位员工在十月份的加班和假期余额。”
常见问题
它是否适用于 Claude Code 和 Claude Desktop? 是的,将两者指向 https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。
凭据来自哪里? 以管理员身份登录 TimeTrack 网络应用并打开设置,常规,API:复制应用密钥和应用秘密。TIMETRACK_ACCOUNT 是你的 TimeTrack 地址的第一部分(acme 对于 acme.timetrackenterprise.com)。API 作用于整个账户,而不是单个员工。
它涵盖了什么? 员工、客户、项目和任务类型、项目时间条目、考勤(打卡进出)、缺勤及缺勤类型(带批准)、费用、每日和分组的工时报告(带加班和假期),以及考勤和项目计时器。API 允许每分钟 30 次请求。
哪些工具默认关闭? timetrack_delete_project_time_entry、timetrack_delete_attendance 和 timetrack_delete_absence。仅在连接器页面上切换它们,只有当 AI 应该使用它们时。
下一步
这份指南对你有帮助吗?