跳转至

AI 助手（MCP）

将 aTimeLogger 连接到 ChatGPT 或 Claude，就可以用日常语言询问你的时间：时间都花在了哪里，本周和上周相比如何，从哪里能挤出一小时做新的事情。助手还可以开始和停止计时器、补记你忘记记录的时间，以及修正记录的时间。它的回答可以是卡片，带有你的活动的颜色和图标：带“暂停”和“停止”按钮的进行中计时器、每天和每周的时间线、趋势和报告。示例请见 atimelogger.pro/zh/mcp.html。

在 Claude 中比较两周

你需要准备

  • 一个 aTimeLogger 账户，请参阅同步。
  • Claude 或 ChatGPT。

连接器的地址是：

https://app.atimelogger.pro/mcp

连接 Claude

  1. 打开“Settings”→“Connectors”（设置 → 连接器），点击“Add custom connector”（添加自定义连接器）。
  2. 将其命名为 aTimeLogger，粘贴地址并添加。
  3. 点击“Connect”（连接），使用你的 aTimeLogger 账户登录并允许访问。

在 claude.ai 上连接后，Claude 的桌面版和移动版 App 中也可以使用 aTimeLogger。

连接 ChatGPT

  1. 打开“设置”→“应用”，添加一个新 App。
  2. 将其命名为 aTimeLogger，粘贴地址，并选择“OAuth”登录方式。
  3. 使用你的 aTimeLogger 账户登录并允许访问。

助手可以执行的操作

登录时，你可以选择它的访问权限：

  • 读取：读取你的计时器、历史、报告和活动类型。此项始终包含。
  • 写入：开始、暂停和停止计时器，补记过去的记录，更改记录的时间、备注和标签，以及创建或归档活动类型。取消勾选此项，助手就只能读取。

如果要断开连接，请在 ChatGPT 或 Claude 中移除 aTimeLogger，或在网页版的“设置”→“已连接的应用”（Settings → Connected apps）中移除。

aTimeLogger 不会主动向任何 AI 服务商发送任何数据。只有当你向助手询问你的记录时，这些记录才会进入对话。

你可以问什么

助手读取的是你的每条记录，而不只是总计，所以它可以进行比较和解释：

  • “比较一下我最近 7 天和再往前的一周。”
  • “我工作日的睡眠是不是更少？”
  • “我的工作日实际上几点开始、几点结束？”
  • “我每周还能从哪里再挤出 3 小时练吉他？”

它还可以执行操作并展示结果：

  • “我现在在记录什么？”
  • “开始工作。其实我是 11:30 开始的。”
  • “停止正在进行的活动，开始阅读。”
  • “记录昨天 22:00 到午夜的阅读。”
  • “昨天游泳是 6:30 到 7:30，不是 7:00 到 7:45。”
  • “给那条记录加个备注：读完了第 5 章。”
  • “显示我这一周。”
  • “我这个月的睡眠有什么变化？”
  • “把尤克里里添加到我的爱好里。”它会在创建活动类型之前先询问你。
  • “怎么设置目标？”

用卡片回答“显示我这一周”

活动名称会自动匹配：说“开始开发”，就能找到你的 软件开发 类型。

限制

  • 助手不能删除记录或活动类型。如需删除，请使用 App。
  • 开始计时器时不能添加备注。请在开始后再让它添加备注。
  • 进行中计时器的当前这一段不能移动。请先停止它；停止时间可以往前设定。
  • 时间线最多显示 14 天，历史每次最多读取 100 天。

自行运行

对于想在自己的电脑或服务器上运行全部内容的开发者，aTimeLogger MCP 服务器是开源的。它适用于 Claude Code、Claude Desktop、Cursor、VS Code 和其他 MCP 客户端。它只以文本回答：卡片、创建活动类型和登录功能都由上面的连接器提供。

它需要一个个人访问令牌。在网页版中，打开“设置”→“API 令牌”（Settings → API Tokens），点击“生成令牌”（Generate token）。令牌只显示一次，请立即复制。你可以随时在同一页面上撤销它。

请像对待密码一样对待令牌：任何拥有它的人都可以读取和更改你的记录。

请按照适用于你的助手的设置说明（英文）进行操作。