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

常見問題