Claude 可以管理你的任务

## setup

把 Claude 连接到你的仓库

最快的路径是 MCP 服务器，Claude Desktop 通过一小组工具来驱动它。如果你已经给了 Claude 某个文件夹的直接访问权限，它也可以直接编辑那里的任务文件。两种方式读取的是同一个仓库。

1. 01

   先生成一次仓库契约文件

   用 TaskForge 3.0 或更高版本打开仓库，进入“设置 → AI 与智能体”，保持“生成智能体文件”开启。TaskForge 会写入一个 TaskForge/Settings/ 文件夹，描述你确切的任务格式，这样 Claude 就能用对你的写法，而不是靠猜。

2. 02

   把 MCP 服务器加到 Claude Desktop

   打开 Claude Desktop 的配置文件，加入 taskforge 服务器。npx 会在首次运行时获取它，所以不需要提前安装任何东西。把 TASKFORGE_VAULT 设为你笔记所在的文件夹。

   {
     "mcpServers": {
       "taskforge": {
         "command": "npx",
         "args": ["-y", "taskforge-md", "mcp", "--stdio"],
         "env": {
           "TASKFORGE_VAULT": "/path/to/your/vault"
         }
       }
     }
   }

3. 03

   重启 Claude 并检查工具

   重启之后，Claude Desktop 会在工具列表中显示 taskforge 的工具：add_task、query_tasks、get_task、update_task、complete_task、delete_task。如果它找不到仓库，服务器依然会正常启动，并返回一条明确的消息，告诉 Claude 去设置 TASKFORGE_VAULT。

4. 04

   用大白话直接问它

   现在你可以像跟人说话一样跟 Claude 交流。“有哪些任务逾期了？”“添加一个任务：周五打电话给牙医。”“把发票那条任务标记完成。”Claude 会挑选合适的工具，改动在它运行的那一刻就落进你的 markdown 里。

## prompts that work today

行之有效的提示词

每次调用都会从磁盘重新读取仓库，因此 Claude 操作的始终是最新的文件。如果你在对话中途在 Obsidian 里编辑了某个任务，下一次工具调用就会看到这个改动。

## privacy

一切都留在你的电脑上

taskforge MCP 服务器只读写你指向的仓库中的 markdown 文件，别的什么都不碰。没有账号，没有 API 密钥，中间也没有 TaskForge 服务器参与。无论你用什么方式同步仓库，iCloud、Dropbox 还是 Obsidian Sync，都会把 Claude 的改动带到你的其他设备。

## faq

大家常问的问题