连接器指南阅读约 4 分钟35 个 MCP 工具7 种语言

将 TimeTrack MCP 接入 Microsoft Copilot

TimeTrack 时间跟踪:员工、客户、项目、项目时间条目、考勤(打卡进出)、缺勤及缺勤类型、费用、每日和分组的工时报告和计时器。应用密钥和秘密。

HC作者:HelpCode 团队更新于 4 分钟阅读 在 GitHub 开源

无需信用卡 · 7 天试用 · 提供自托管方案

TimeTrack

TimeTrack

TimeTrack time tracking: employees, clients, projects, project time entries, attendance with clock in and out, absences and absence types, expenses, daily and grouped timesheet reports and timers. App key and secret.

个工具

35

区域

INTL

类别

工时跟踪

身份验证

API Key

所需环境变量

TIMETRACK_ACCOUNTTIMETRACK_API_KEYTIMETRACK_API_SECRET
在 Cloud 上一键安装

7 天免费试用 · 无需信用卡

  • 7 天免费试用
    无需信用卡
  • 符合 GDPR,SOC 2 就绪
    数据驻留欧盟,审计日志
  • 在 GitHub 开源
    开源 · AGPL-3.0
  • 支持 ChatGPT、Claude、Gemini
    任何兼容 MCP 的客户端

摘要

TimeTrack 时间跟踪:员工、客户、项目、项目时间条目、考勤(打卡进出)、缺勤及缺勤类型、费用、每日和分组的工时报告和计时器。应用密钥和秘密。

引导式设置

2 分钟将 TimeTrack 连接到 Microsoft Copilot

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 TimeTrack,再把你的 MCP URL 添加到 Microsoft Copilot。无需代码,也无需自行运行服务器。

无需信用卡 · 7 天试用 · 提供自托管方案

试试这样问

TimeTrack 的示例提示

点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。

TimeTrack · 通过 MCP 实时
分享
Opus 4.7

Claude 是 AI,可能会出错。请核对回答。

💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → TimeTrack,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需 git clone,无需本地服务器。

TimeTrack + Microsoft Copilot

TimeTrack 时间跟踪:员工、客户、项目、项目时间条目、考勤(打卡进出)、缺勤及缺勤类型、费用、每日和分组的工时报告和计时器。应用密钥和秘密。

前提条件

请查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:

TIMETRACK_ACCOUNT, TIMETRACK_API_KEY, TIMETRACK_API_SECRET

第一步 — 获取凭据

设置大约需要 3 分钟。

  1. 以管理员身份登录 TimeTrack 网络应用并打开 设置,常规,API。
  2. 将 应用密钥 复制到 TIMETRACK_API_KEY,将 应用秘密 复制到 TIMETRACK_API_SECRET。这两个都是为你生成的;可以随时在此处生成新的秘密,这将使旧的无效。
  3. 将你的 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

第三步 — 在 Microsoft Copilot 中添加连接器

你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(https://cloud.anythingmcp.com/mcp/…)。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Microsoft Copilot 通过在 Copilot Studio 中构建的智能体使用 MCP 服务器:把 AnythingMCP 作为工具添加到智能体,然后把智能体发布到 Microsoft 365 Copilot 和 Teams。Copilot Studio 从 Microsoft 的云端通过 Streamable HTTP 连接,AnythingMCP 支持这种方式。

  1. 在 Copilot Studio 中打开你的智能体(或新建一个),进入 Tools,选择 Add a tool → New tool → Model Context Protocol。
  2. 填写 Server name(例如 AnythingMCP)、说明连接器用途的 Server description,以及 Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。Copilot Studio 根据描述决定何时调用该服务器。
  3. 身份验证选择 API key,把 Type 设为 Header,请求头名称填 X-API-Key,然后选择 Create。
  4. 在 Add tool 中选择 Create a new connection,粘贴 AnythingMCP 的 MCP API 密钥(MCP Servers → 你的服务器 → API keys),然后选择 Add to agent。
  5. 在智能体的 Test 窗格中试一试:提出需要用到 TimeTrack 的工具的请求。
  6. 选择 Publish,然后进入 Channels → Microsoft 365 and Microsoft Teams,保持勾选 Make agent available in Microsoft Copilot,再选择 Add channel。See agent in Teams 会为你安装该智能体;在 Microsoft 365 Copilot 中输入 @ 并选择该智能体。

希望每个用户各自登录?请选择 OAuth 2.0 → Dynamic discovery 代替 API 密钥:每个用户会在智能体首次调用时登录 AnythingMCP。

自托管?请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Copilot Studio 从 Microsoft 的云端连接,因此 localhost 无法使用。

可用工具

工具功能
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 小时的设计。”
  • “哪些缺勤请求正在等待批准?”
  • “显示每位员工在十月份的加班和假期余额。”

常见问题

凭据来自哪里? 以管理员身份登录 TimeTrack 网络应用并打开设置,常规,API:复制应用密钥和应用秘密。TIMETRACK_ACCOUNT 是你的 TimeTrack 地址的第一部分(acme 对于 acme.timetrackenterprise.com)。API 作用于整个账户,而不是单个员工。

它涵盖了什么? 员工、客户、项目和任务类型、项目时间条目、考勤(打卡进出)、缺勤及缺勤类型(带批准)、费用、每日和分组的工时报告(带加班和假期),以及考勤和项目计时器。API 允许每分钟 30 次请求。

哪些工具默认关闭? timetrack_delete_project_time_entry、timetrack_delete_attendance 和 timetrack_delete_absence。仅在连接器页面上切换它们,只有当 AI 应该使用它们时。

这适用于哪个 Copilot? 适用于工作中的 Microsoft 365 Copilot,通过 Copilot Studio 的智能体实现。面向个人账户的 Microsoft Copilot 应用无法添加自己的 MCP 服务器。

我需要什么? 一个可以使用 Copilot Studio 的工作账户(许可证或试用版),用于构建智能体。在 Microsoft 365 Copilot 或 Teams 中使用它的人需要拥有该智能体的访问权限:把它共享给他们,或请管理员为整个组织发布。如果你的组织对 Power Platform 连接器设置了数据策略,这些策略同样适用于 MCP 服务器。

智能体不调用工具。 检查请求头名称是否正好是 X-API-Key,密钥是否属于与 URL 相同的 MCP 服务器,并把 Server description 写得具体:Copilot Studio 根据它决定何时调用服务器。每次修改后重新发布智能体;在已打开的对话中输入 "start over" 即可使用新版本。

下一步

这份指南对你有帮助吗?

2 分钟将 TimeTrack 连接到 Microsoft Copilot

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 TimeTrack,再把你的 MCP URL 添加到 Microsoft Copilot。无需代码,也无需自行运行服务器。

相关指南