关于 Teetrack
Teetrack 是面向自由职业者和顾问、托管于欧盟的时间追踪服务。其远程 MCP 服务让 AI 助手管理计时器、记录、项目、客户和日历导入草稿,并查询工时与预算摘要。
主要功能
- 01启动和停止计时器
- 02创建和管理工时记录
- 03管理项目、客户和标签
- 04审核并确认日历草稿
- 05查询工时、项目和预算摘要
- 06通过 OAuth 连接托管服务
适用场景
- 01在聊天中记录客户项目工时
- 02查询计费工时与剩余预算
- 03审核日历导入的草稿记录
- 04无需打开追踪器即可管理计时器
MCP 相关
托管的远程 MCP 服务地址为 `https://teetrack.it/api/mcp`,提供时间追踪、项目、客户、日历、设置和摘要工具。MCP 客户端通过 OAuth 连接。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://teetrack.it/api/mcpclaude mcp add --transport http it-teetrack-teetrack https://teetrack.it/api/mcp{"mcpServers":{"it-teetrack-teetrack":{"type":"http","url":"https://teetrack.it/api/mcp"}}}在 Cursor 中打开{"servers":{"it-teetrack-teetrack":{"type":"http","url":"https://teetrack.it/api/mcp"}}}在 VS Code 中打开{"mcpServers":{"it-teetrack-teetrack":{"type":"http","url":"https://teetrack.it/api/mcp"}}}{"mcpServers":{"it-teetrack-teetrack":{"serverUrl":"https://teetrack.it/api/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Teetrack MCP 服务
面向自由职业者的隐私优先时间追踪工具。托管于欧盟,并提供供 AI 助手使用的 MCP 服务。
Teetrack 的远程 MCP(Model Context Protocol)服务允许 Claude、ChatGPT 和 Microsoft Copilot 等 AI 助手在聊天中操作你的时间追踪工具:启动和停止计时器、记录条目、管理项目和客户、审核从日历导入的草稿,并回答“我这个月为 Acme 记录了多少可计费工时?”之类的问题。
连接 URL:
https://teetrack.it/api/mcp
无需安装、无需 API 密钥、无需本地进程——这是一个使用 OAuth 的托管服务(Streamable HTTP)。将 MCP 客户端指向上方的 URL 并登录一次即可。
- 网站:https://teetrack.it
- 设置指南:Claude · ChatGPT · Copilot
快速开始
claude.ai / Claude Desktop
- 设置 → 集成 → 添加自定义集成
- 粘贴
https://teetrack.it/api/mcp - 浏览器窗口会打开 Teetrack 的常规登录页面——批准一次后,连接便会持续有效。
完整操作指南:https://teetrack.it/guides/mcp/claude
ChatGPT
ChatGPT 可通过其连接器/应用设置使用相同的 URL 进行连接。分步指南:https://teetrack.it/guides/mcp/chatgpt
Microsoft Copilot
Copilot 使用相同的 URL 进行连接。分步指南:https://teetrack.it/guides/mcp/copilot
其他 MCP 客户端
任何支持通过 OAuth 连接远程 MCP 服务的客户端都可以连接到 https://teetrack.it/api/mcp。你需要一个 Teetrack 账户——免费套餐即可使用。
身份验证
首次连接时,浏览器会打开 Teetrack 账户的标准登录页面(OAuth)。你只需批准一次;之后,客户端便会持有连接到你账户的授权连接。无需复制令牌,也不会在配置文件中存储任何内容。客户端可见的工具会根据 OAuth 批准期间授予的权限范围进行筛选,因此某些连接可能只会显示下方完整列表中的部分工具。
工具(35)
| 分组 | 数量 | 工具 |
|---|---|---|
| 计时器 | 3 | start_timer、stop_timer、get_running_timer |
| 时间条目 | 5 | list_tracks、get_track、log_time、update_track、delete_track |
| 项目 | 5 | list_projects、get_project、create_project、update_project、delete_project |
| 标签 | 4 | list_tags、create_tag、update_tag、delete_tag |
| 客户 | 5 | list_clients、get_client、create_client、update_client、delete_client |
| 汇总 | 3 | get_time_summary、get_project_summary、get_budget_status |
| 设置 | 3 | get_user_settings、update_user_settings、get_subscription_usage |
| 日历 | 7 | list_calendar_connections、list_calendar_events、get_calendar_suggestions、confirm_draft_track、bulk_confirm_draft_tracks、dismiss_draft_track、trigger_calendar_sync |
计时器
| 工具 | 描述 |
|---|---|
start_timer | 启动新计时器(创建一个没有结束时间的时间条目)。可以同时运行多个计时器。返回新启动的计时条目。 |
stop_timer | 将结束时间设为当前时间,以停止运行中的计时器。如果未提供 ID,则停止最近启动的计时器。返回已停止的时间条目。 |
get_running_timer | 获取所有当前运行的计时器(没有结束时间的时间条目)。返回一个数组(如果没有活动计时器,则为空)。 |
时间条目
| 工具 | 描述 |
|---|---|
list_tracks | 列出时间追踪条目,支持可选筛选条件和分页。返回按开始时间排序的条目(最新的在前)。 |
get_track | 根据 ID 获取单个时间追踪条目。 |
log_time | 记录已完成的时间条目,包含开始时间和结束时间。 |
update_track | 更新现有时间追踪条目。仅修改提供的字段。 |
delete_track | 根据 ID 删除时间追踪条目。 |
项目
| 工具 | 描述 |
|---|---|
list_projects | 列出所有项目,可选择分页。 |
get_project | 根据项目 ID 获取单个项目,包括计费和预算配置。 |
create_project | 创建新项目。 |
update_project | 更新现有项目。仅修改提供的字段。 |
delete_project | 根据 ID 删除项目。 |
标签
| 工具 | 描述 |
|---|---|
list_tags | 列出所有标签及其追踪记录数和追踪总秒数。 |
create_tag | 创建新标签。 |
update_tag | 更新现有标签。仅修改提供的字段。 |
delete_tag | 根据 ID 删除标签。 |
客户
| 工具 | 描述 |
|---|---|
list_clients | 列出所有客户。 |
get_client | 根据 ID 获取单个客户。 |
create_client | 创建新客户。 |
update_client | 更新现有客户。仅修改提供的字段。 |
delete_client | 根据 ID 删除客户。 |
汇总
| 工具 | 描述 |
|---|---|
get_time_summary | 获取按所有时间、今年、本月和今天划分的追踪总时长。返回各时段的秒数。 |
get_project_summary | 获取按工时、可计费金额和天数排列的热门项目。可用于了解时间花在了哪些地方。 |
get_budget_status | 获取所有已配置预算的项目的预算状态。显示已追踪与预算工时/金额的对比,以及是否超出预算。 |
设置
| 工具 | 描述 |
|---|---|
get_user_settings | 获取当前用户的显示和取整设置。 |
update_user_settings | 更新用户设置。仅修改提供的字段。 |
get_subscription_usage | 获取当前订阅层级信息、功能列表、限额和使用量。 |
日历
| 工具 | 描述 |
|---|---|
list_calendar_connections | 列出所有已连接的日历账户(Google、Outlook、iCal)。返回服务提供商、账户邮箱、同步状态和自动导入设置。 |
list_calendar_events | 列出所有已启用日历连接在指定日期范围内的日历事件。不包括全天事件和已取消的事件。 |
get_calendar_suggestions | 列出从日历事件导入的所有待处理工时记录草稿。返回草稿及其当前分配的项目,供审核。 |
confirm_draft_track | 确认从日历事件导入的工时记录草稿。将 draft 设置为 false,使其计入汇总。可先使用 update_track 更改描述或项目。 |
bulk_confirm_draft_tracks | 一次确认多个工时记录草稿。返回已确认记录的数量。 |
dismiss_draft_track | 忽略从日历事件导入的工时记录草稿。该事件在后续同步中不会重新导入。 |
trigger_calendar_sync | 触发日历同步。如果提供 connection_id,则同步该特定连接;否则同步所有已启用的连接。受频率限制:每个连接每 5 分钟最多同步一次。 |
示例提示词
- “为 Acme 网站改版启动计时器——首页文案。”
- “停止计时器,并为昨天下午在同一个项目上记录 2 小时。”
- “我这个月为 Acme 记录了多少可计费工时?预付预算还剩多少?”
- “显示待处理的日历草稿,并确认所有客户会议。”
- “哪个项目占用了我本周最多时间?”
关于 Teetrack
Teetrack 为自由职业者和顾问提供单用户时间追踪和计费服务。按客户和项目追踪工时、监控预算,并导出 PDF/CSV 工时表。托管于欧盟(Hetzner),以 GDPR 为首要原则,不截屏或监控。提供免费套餐,Business 套餐每月 €4。
每种套餐都面向单用户——一个席位,统一定价。由一人构建和运营;每个支持请求都由编写代码的人亲自回复。
开始使用: https://teetrack.it
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。